24 pola listu przewozowego CMR: definicje i mapowanie JSON

Dlaczego numery pól mają znaczenie

List przewozowy CMR używa tego samego układu 24 pól od Konwencji z 1956 roku dotyczącej umowy międzynarodowego przewozu towarów drogą. Oprogramowanie przewozowe, systemy celne i narzędzia rachunkowe, które odwołują się do „pola 7" lub „pola 21", oznaczają to samo pole, niezależnie od języka lub kraju. Prawidłowe jednorazowe wykonanie mapowania eliminuje powtarzające się źródło zamieszania między nawykami papierowymi a danymi strukturalnymi.

Schemat ekstrahowania eCMR Capture odzwierciedla ten układ, z kluczami jako box_NN_description, więc konsument JSON może powiązać każdą wartość z określonym polem numerowanym na dokumencie fizycznym. Schemat znajduje się w src/lib/extraction/schema.ts w bazie kodów eCMR Capture; nazwy pól i kolejność poniżej pochodzą z tego pliku.

Pola wymagane a opcjonalne

Nie każde pole jest obowiązkowe, aby umowa transportu była ważna. Artykuł 6 Konwencji CMR wymienia obowiązkowe szczegóły: miejsce i datę wystawienia, nadawcę, przewoźnika, miejsca przejęcia i dostawy, odbiorcę, rodzaj i opakowanie towarów, liczbę paczek, wagę i opłaty; Artykuł 5 wymaga, aby dokument był podpisany przez nadawcę i przewoźnika. Schemat eCMR Capture (REQUIRED_BOXES w src/lib/extraction/schema.ts) oznacza pola 1, 2, 3, 4, 7, 8, 9, 11, 16, 21, 22, 23 i 24 jako wymagane dla jego własnego przepływu pracy przeglądu — obowiązkowe szczegóły Konwencji plus oba podpisy i, w zbiorze produktu, odbiorcy. Pozostałe są warunkowe lub opcjonalne na mocy Konwencji, a ich brak jest normalnym, ważnym stanem, a nie wadą.

Pełna tabela pól

Pole	Nazwa	Zawiera	Typowy problem jakości danych	Klucz JSON
1	Nadawca	Imię, nazwisko, adres, kraj strony wysyłającej towary	Pieczęć nakłada się na ręcznie napisany adres	box_01_sender
2	Odbiorca	Imię, nazwisko, adres, kraj strony odbierającej	Odbiorca zmieniony w trakcie, nie zaktualizowany na dokumencie	box_02_consignee
3	Miejsce dostawy	Miasto, kraj i data dostawy towarów	Pole daty pozostawione puste przy wysyłce	box_03_place_of_delivery
4	Miejsce przejęcia	Miasto, kraj i data zebrania towarów	Ręcznie napisana nazwa miasta nieczytelna lub skrócona	box_04_place_of_taking_over
5	Załączone dokumenty	Lista dokumentów towarzyszących (faktura, lista pakunkowa, zezwolenia)	Wolna lista tekstowa, niespójna formatacja	box_05_documents_attached
6	Znaki i numery	Znaki wysyłki, identyfikatory kontenerów lub palet	Często pozostawiane puste	box_06_marks_and_numbers
7	Liczba paczek	Liczba paczek lub jednostek	Korekta przekreślona i przepisana	box_07_number_of_packages
8	Sposób opakowania	Jak towary są pakowane (palety, skrzynie, luzem)	Skrócone lub kodowane terminy specyficzne dla nadawcy	box_08_method_of_packing
9	Rodzaj towaru	Opis przewożonych towarów	Generyczny opis, np. „ładunek ogólny"	box_09_nature_of_goods
10	Numer statystyczny	Klasyfikacja celna lub statystyczna (kod HS)	Powszechnie nieobecny, nie wymagany do ważności	box_10_statistical_number
11	Masa brutto (kg)	Całkowita masa przesyłki	Dwuznaczność jednostki (kg vs tony) w ręcznie napisanych dokumentach	box_11_gross_weight_kg
12	Objętość (m³)	Objętość przesyłki	Często pominięty, gdy waga jest podstawą rozliczeń	box_12_volume_m3
13	Instrukcje nadawcy	Instrukcje dotyczące ceł i innych formalności	Długi wolny tekst, trudno strukturalizować	box_13_senders_instructions
14	Fracht zwrotny	Warunki zwrotu opakowań lub palet	Rzadko używane, łatwo przegapić, gdy obecne	box_14_return_freight
15	Pobranie przy dostawie	Kwota i waluta do zebrania przy dostawie	Symbol waluty pominięty, dwuznaczna kwota	box_15_cash_on_delivery
16	Przewoźnik	Imię, nazwisko, adres, kraj przedsiębiorstwa transportowego	Mylony z polem 17 w przewozie wieloetapowym	box_16_carrier
17	Następny przewoźnik	Imię, nazwisko, adres, kraj kolejnego przewoźnika, jeśli istnieje	Pozostawiony pusty w przewozie jednoetapowym, prawidłowo	box_17_successive_carrier
18	Zastrzeżenia przewoźnika	Obserwacje przewoźnika dotyczące stanu towarów przy odbiorze	Ręcznie napisane notatki na marginesie, niska czytelność	box_18_carriers_reservations
19	Szczególne umowy	Umowy między stronami poza standardową umową	Mylone z polem 13	box_19_special_agreements
20	Do zapłaty przez	Czy nadawca czy odbiorca płaci za transport	Pole wyboru niejasne, gdy skanowane przy niskiej rozdzielczości	box_20_to_be_paid_by
21	Wystawiono w	Miejsce i data wystawienia dokumentu	Data stempla różni się od daty ręcznie napisanej	box_21_drawn_up_at
22	Podpis nadawcy	Podpis nadawcy, potwierdzający wysyłkę	Podpis obecny, ale brak miejsca/daty	box_22_signature_of_sender
23	Podpis przewoźnika	Podpis przewoźnika, potwierdzający przejęcie do transportu	Zamiast podpisu używana pieczęć	box_23_signature_of_carrier
24	Podpis odbiorcy	Podpis odbiorcy, potwierdzający otrzymanie towarów	Zebrano na oddzielnym liście dostawy, nie na samym CMR	box_24_signature_of_consignee

Czytanie JSON: pole, pewność, źródło

Każde pole w wyjściu ekstrahowania ma wynik pewności i znacznik źródła (extracted, missing lub illegible), ponieważ skanowany lub sfotografowany dokument nie zawsze daje czystą wartość. Konsument JSON — system rachunkowy, skrypt importu TMS — może użyć wyniku pewności, aby zdecydować, czy wartość wymaga przeglądu człowieka przed zaufaniem.

Pola złożone są strukturalne, a nie płaskie ciągi. Strony (pola 1, 2, 16, 17) zawierają imię i nazwisko, adres, kraj i opcjonalnie numer VAT. Miejsca (pola 3, 4, 21) zawierają miasto, kraj i opcjonalną datę ISO. Podpisy (pola 22, 23, 24) zawierają flagę podpisu, opcjonalnie miejsce i datę oraz czy obraz podpisu jest obecny — płaciąg na pole stracił rozróżnienia, które system poniżej potrzebuje.

Często mylone pola

Pole 6 (znaki i numery) jest często mylone z polem 10 (numer statystyczny): oba są krótkie, oba są często puste i żaden nie pojawia się w obowiązkowych szczegółach Artykułu 6. Pole 13 (instrukcje nadawcy) i pole 19 (szczególne umowy) oba zawierają wolny tekst poza umową podstawową, ale pole 13 dotyczy formalności takich jak cła, podczas gdy pole 19 dotyczy warunków handlowych uzgodnionych między stronami. Pole 22 potwierdza, że towary zostały przekazane, pole 23 że przewoźnik je przyjął, a pole 24 że odbiorca je otrzymał — trzy odrębne zdarzenia, czasami na formularzach niestandardowych połączone w jeden blok podpisu.

Jak eCMR Capture się wpisuje

eCMR Capture odczytuje dokument CMR — papier, skan lub zdjęcie — i zwraca dokładnie tę strukturę 24 pól jako JSON z pewością i znacznikiem źródła dla każdego pola, zgodnie z src/lib/extraction/schema.ts. Nie interpretuje ani nie waliduje warunków handlowych w polach 13, 19 lub 20; ekstrahuje to, co jest napisane. Spróbujcie go na /pl/wyprobuj; pełna dokumentacja pola znajduje się na /docs.