Единицы и коды

Списки кодов, которые использует 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. Документ объясняет, как их читать.

См. также