Jednostki i kody
Listy kodów, których używa ocost.document.v1, standard za każdą z nich i to, jak Ocost przechodzi od wydrukowanego słowa do kodu. Wartość, która nie jest kodem swojej listy, to null, nigdy wydrukowany tekst.
Jednostki
lines[].unit to kod z UNECE Recommendation 20 albo opakowanie z Recommendation 21 jako X i jego kod. Te Ocost zapisuje najczęściej:
| Kod | Znaczenie | Drukowane jako |
|---|---|---|
C62 | Jeden, sztuka | Stück, Stk, St., шт., од. |
H87 | Sztuka | Z e-faktur |
HUR | Godzina | Std., h, год. |
DAY | Dzień | Tag, день |
MON | Miesiąc | Monat, міс. |
KGM | Kilogram | kg, кг |
MTR | Metr | m, lfm, м |
MTK | Metr kwadratowy | m², qm, м² |
LTR | Litr | l, л |
KWH | Kilowatogodzina | kWh, кВт·год |
SET | Komplet | Satz, компл. |
LS | Ryczałt | pauschal, psch. |
E48 | Jednostka usługi | послуга |
XCT | Karton | Karton, Ktn |
XPK | Paczka | Paket, VE, уп. |
XPX | Paleta | Palette, Pal. |
Ocost prosi model odczytu o kod. Niemieckie, ukraińskie lub rosyjskie słowo, które model poda zamiast kodu, mapuje stała tabela. Słowo, które nie oznacza jednej jednostki, na przykład Kiste, pozostaje nieznane. unit ma wtedy wartość null, nigdy C62. Kod z e-faktury zostaje bez zmian. Samo PF to paleta XPX.
Waluty
currency to kod ISO 4217. Wydrukowany znak staje się swoim kodem: € to EUR, £ GBP, ₴ i грн UAH, zł PLN. Znak używany w kilku krajach, na przykład $ lub kr, zależy od kraju wystawcy. Bez obu Ocost bierze zwykłą walutę dostawcy, a w przeciwnym razie walutę Twojej firmy.
Kraje
country adresu to kod ISO 3166-1 alpha-2, na przykład DE, UA lub GB.
Kategorie VAT
vat_breakdown[].category i lines[].vat_category to UNCL 5305 w użyciu EN 16931: S, Z, E, AE, K, G, O oraz L, M, B dla własnych kategorii Hiszpanii i Włoch. Wartości objaśniają każdą. Strona każdego kraju pokazuje, jak się je tam drukuje.
Sposoby płatności
payment.means_code to UNCL 4461: 58 to polecenie przelewu SEPA, 59 polecenie zapłaty SEPA, 48 karta. payment.means mówi to samo słowem.
Typy dokumentów
kind i kind_detail są własne dla Ocost. type_code to UNCL 1001, na przykład 380 dla faktury lub 381 dla faktury korygującej. Gdy dokument go nie drukuje, Ocost zapisuje kod jego rodzaju.
Identyfikatory
identifiers[].scheme to własna lista Ocost, na przykład EU_VAT, DE_STNR, UA_EDRPOU, PL_NIP, US_EIN lub MD_IDNO. Wartości wymieniają je wszystkie. Strony krajów mówią, jak sprawdzany jest każdy z nich.
Kategorie
Wyszukiwanie filtruje według category, ośmiocyfrowego kodu ECLASS, na przykład 24000000.
Liczby i daty
Kwoty i ilości to dokładne liczby JSON, stawki to procenty, a daty to ISO 8601. Dokument mówi, jak je czytać.