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