Одиниці та коди

Переліки кодів, які використовує 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. Документ пояснює, як їх читати.

Див. також