Одиниці та коди
Переліки кодів, які використовує ocost.document.v1, стандарт за кожним і те, як Ocost переходить від надрукованого слова до коду. Значення, яке не є кодом свого переліку, дорівнює null, а не надрукованому тексту.
Одиниці
lines[].unit — це код UNECE Recommendation 20 або пакування за Recommendation 21 як X і його код. Ці коди Ocost пише найчастіше:
| Код | Значення | Надруковано як |
|---|---|---|
C62 | Одиниця, штука | Stück, Stk, St., шт., од. |
H87 | Штука | З електронних рахунків |
HUR | Година | Std., h, год. |
DAY | День | Tag, день |
MON | Місяць | Monat, міс. |
KGM | Кілограм | kg, кг |
MTR | Метр | m, lfm, м |
MTK | Квадратний метр | m², qm, м² |
LTR | Літр | l, л |
KWH | Кіловат-година | kWh, кВт·год |
SET | Комплект | Satz, компл. |
LS | Фіксована сума | pauschal, psch. |
E48 | Одиниця послуги | послуга |
XCT | Картонна коробка | Karton, Ktn |
XPK | Пакунок | Paket, VE, уп. |
XPX | Палета | Palette, Pal. |
Ocost просить у моделі читання код. Німецьке, українське чи російське слово, яке вона дає натомість, перекладає на код фіксована таблиця. Слово, що не називає жодної окремої одиниці, як-от Kiste, лишається невідомим. Тоді unit дорівнює null, а не C62. Код електронного рахунку зберігається як є. Просте PF — це палета XPX.
Валюти
currency — це код ISO 4217. Надрукований знак стає своїм кодом: € — це EUR, £ — GBP, ₴ і грн — UAH, zł — PLN. Знак кількох країн, як-от $ чи kr, визначається за країною того, хто виставив документ. Якщо немає ні того, ні іншого, Ocost бере звичну валюту постачальника, а якщо її немає, то валюту вашої компанії.
Країни
country адреси — це код ISO 3166-1 alpha-2, наприклад DE, UA або GB.
Категорії ПДВ
vat_breakdown[].category і lines[].vat_category — це UNCL 5305 за EN 16931: S, Z, E, AE, K, G, O. L, M, B — власні категорії Іспанії та Італії. Значення пояснює кожну. Кожна сторінка країни показує, як їх там друкують.
Способи оплати
payment.means_code — це UNCL 4461: 58 — кредитовий переказ SEPA, 59 — пряме дебетування SEPA, 48 — картка. payment.means каже те саме словом.
Типи документів
kind і kind_detail — власні значення Ocost. type_code — це UNCL 1001, наприклад 380 для рахунку або 381 для кредит-ноти. Якщо документ його не друкує, Ocost пише код його виду.
Ідентифікатори
identifiers[].scheme — власний перелік Ocost, як-от EU_VAT, DE_STNR, UA_EDRPOU, PL_NIP, US_EIN або MD_IDNO. Значення перелічує їх усі. Сторінки країн кажуть, як перевіряється кожен.
Категорії
Пошук фільтрує за category, кодом ECLASS з восьми цифр, наприклад 24000000.
Числа і дати
Суми й кількості — точні числа JSON, ставки — відсотки, дати — ISO 8601. Документ пояснює, як їх читати.