top of page
  • Facebook
  • Instagram
  • Twitter
  • YouTube
  • Pinterest

Dane do integracji odpraw celnych: od mapy pól do testu odbioru

Zdjęcie autora: agencjacelnaszczec
agencjacelnaszczec
19 paź
4 minut(y) czytania

Dane do integracji odpraw celnych uporządkujesz, przypisując każdemu polu źródło, właściciela i regułę kontroli. Jeśli prowadzisz wdrożenie, zacznij od próbnego zestawu dokumentów i uzgodnionej mapy pól. Następnie sprawdź, jak system obsłuży brak informacji, korektę i ponowne przesłanie tego samego pliku.

Wybierz zakres pierwszej próby

Pierwsza próba powinna pokazać drogę danych od dokumentu do osoby przygotowującej odprawę. Dlatego opisz jej początek, koniec oraz warunek zatrzymania procesu. Nie musisz od razu łączyć wszystkich systemów firmy.

Stały plik z kontrolą człowieka

Przekazujesz uzgodniony plik i dokument źródłowy. Następnie odbiorca porównuje wartości oraz zgłasza braki. Taki wariant pozwala sprawdzić mapę danych przed zamówieniem połączenia API.

Wymiana przez integratora

Integrator analizuje dostępne interfejsy Twojego sklepu i ERP. Natomiast z agencją ustalasz informacje potrzebne do obsługi celnej. Zakres współpracy celnej dla osCommerce B2B uzgodnij przed przyjęciem projektu technicznego.

Dane do integracji odpraw celnych: znaczenie pól

Komputer i dokumenty połączone linią obiegu danych w biurze celnym.

Słownik opisuje znaczenie pola, a nie tylko jego nazwę. Na przykład etykieta „wartość” bez waluty i wskazania dokumentu pozostawia miejsce na różne interpretacje. Dlatego przy każdym polu zapisz też format, jednostkę oraz sposób zgłoszenia niezgodności.

Rozdziel dane stałe od informacji dotyczących konkretnej transakcji. Kartoteka produktu może zawierać opis materiału i zastosowania. Natomiast ilość dla danej przesyłki pobierasz z dokumentów tej dostawy, po sprawdzeniu ich zgodności.

  • Identyfikacja: wskaż numer sprawy oraz relację do dokumentów i pozycji. Dzięki temu odbiorca rozpozna ten sam przypadek w kolejnych systemach.

  • Znaczenie: opisz, czy pole dotyczy produktu, transakcji czy transportu. Ponadto wskaż dokument stanowiący źródło informacji.

  • Kontrola: określ dozwolony format, warunek kompletności oraz osobę rozstrzygającą rozbieżność. Jeśli brakuje wartości, nie zastępuj jej domysłem.

  • Zmiana: ustal sposób oznaczenia poprawki i datę jej przyjęcia. Następnie zachowaj możliwość porównania z wcześniejszą wersją.

W praktyce rozbieżność może wynikać z innej jednostki w sklepie i na fakturze. Zapisz więc jawnie, czy system przekazuje sztuki, opakowania lub inną uzgodnioną jednostkę. Próba powinna wykazać taką różnicę przed dalszą pracą.

Powiąż pozycje i zachowaj wersję dokumentu

Numer zamówienia nie opisuje samodzielnie całej historii dostawy. Dlatego w projekcie oddziel powiązanie dokumentów od ich treści. Następnie ustal, które identyfikatory pozwalają odtworzyć drogę pojedynczej pozycji.

Rozpatrz przykład testowy: jedno zamówienie obejmuje dostawy rozłożone na osobne przesyłki. W takim przypadku integracja powinna pokazać, które ilości dotyczą każdej przesyłki. Samo skopiowanie pełnego zamówienia do kolejnych spraw może zaciemnić ten podział.

Podobnie potraktuj korektę faktury. W zestawie dokumentów powiąż korektę z fakturą, której dotyczy. Natomiast odbiorca musi rozpoznać dokument przyjęty do dalszej pracy. Uzgodnij też, kto zatrzyma proces po korekcie otrzymanej już po przekazaniu danych.

Nie nadpisuj historii samym aktualnym stanem kartoteki. Jeśli zmienisz opis produktu, wcześniejsza sprawa powinna nadal wskazywać dokumenty wykorzystane podczas jej obsługi. Tę zasadę wpisz do kryteriów odbioru integracji.

Sprawdź błędy przed odbiorem połączenia ERP/API

Udany odczyt pliku potwierdza tylko część działania rozwiązania. Dlatego osobno sprawdź zgodność danych oraz reakcję na błąd. Przygotuj oczekiwany wynik każdego przypadku, zanim integrator uruchomi próbę.

  1. Pełny zestaw: porównaj pola z dokumentami źródłowymi. Następnie potwierdź powiązanie każdej pozycji z właściwą przesyłką.

  2. Brak pola: usuń wymaganą informację w kopii testowej. Sprawdź, czy system zatrzyma sprawę i wskaże osobę odpowiedzialną.

  3. Duplikat: prześlij ponownie ten sam zestaw. W efekcie system powinien rozpoznać powtórzenie zgodnie z uzgodnioną regułą.

  4. Korekta: zmień wartość w nowej wersji dokumentu. Następnie sprawdź widoczność zmiany oraz wcześniejszej wersji.

  5. Przerwa połączenia: zasymuluj nieudaną wymianę w środowisku testowym. Ustal, jak operator rozpozna status i bezpiecznie ponowi przekazanie.

Zapisz wynik próby wraz z dokumentem porównawczym. Dzięki temu odbierzesz konkretną funkcję, a nie sam komunikat „wysłano”. Różnicę między danymi sklepu a komunikacją celną wyjaśnia poradnik o integracji odpraw przez API, ERP i AI.

Wyznacz granice odczytu dokumentów przez AI

AI możesz rozważyć przy odczycie i porównywaniu informacji z dokumentów. Jednak wynik traktuj jako propozycję wymagającą kontroli. Przykładowo dokumentacja Ollama opisuje odpowiedzi zgodne ze schematem JSON, czyli uporządkowaną strukturę wyniku.

Poprawna struktura nie dowodzi zgodności wartości z fakturą. Dlatego zachowaj odnośnik do źródła odczytu i wyraźnie oznacz brak pewnego wyniku. Osoba odpowiedzialna powinna porównać propozycję z dokumentem przed wykorzystaniem danych.

Ustal również zakres dostępu aplikacji oraz miejsce przetwarzania dokumentów. Ponadto zaprojektuj ręczny obieg na czas niedostępności modelu. Nie przyjmuj w projekcie, że AI samodzielnie zatwierdzi klasyfikację towaru lub zgłoszenie celne.

Oddziel status techniczny od statusu sprawy

Potwierdzenie odbioru pliku nie oznacza zakończenia odprawy. Dlatego nadaj statusom jednoznaczne nazwy i opisz zdarzenie, które uruchamia każdą zmianę. Operator powinien odróżnić oczekiwanie na dane od oczekiwania na kontrolę człowieka.

W próbnej wymianie zapisz czas przekazania i identyfikator zestawu. Następnie porównaj je z potwierdzeniem odbiorcy. Jeśli odpowiedź nie nadejdzie, system powinien pokazać niepewny wynik zamiast samodzielnie uznać sprawę za zakończoną.

Podobnie rozdziel identyfikację podmiotu od identyfikacji dokumentu. Komisja Europejska opisuje EORI jako numer identyfikujący podmioty w operacjach celnych. Natomiast numer faktury wskazuje dokument, dlatego nie zamieniaj tych pól w mapie danych.

Najczęściej zadawane pytania (FAQ)

Czy mapę danych przygotowuję przed wyborem API?

Tak. Najpierw określ znaczenie informacji i wymagania procesu. Następnie integrator dobierze sposób wymiany do możliwości Twojego oprogramowania.

Czy SKU wystarczy jako opis towaru?

SKU identyfikuje pozycję w katalogu. Natomiast opis towaru powinien umożliwiać jego ocenę, dlatego zakres potrzebnych informacji uzgodnij z agencją.

Jak traktować brakującą wartość?

Oznacz brak i skieruj sprawę do wskazanej osoby. Nie podstawiaj zera ani wartości z wcześniejszej transakcji bez sprawdzenia dokumentów.

Czy plik ze sklepu jest komunikatem PUESC?

Nie zakładaj takiej zgodności. Usługi sieciowe PUESC korzystają z komunikatów XML zgodnych ze schematami XSD, dlatego eksport danych wymaga osobnej oceny technicznej.

Czy agencja dostarcza gotowe połączenie z ERP?

Oferta dotyczy współpracy celnej. Natomiast możliwość i zakres połączenia technicznego musisz potwierdzić z agencją oraz swoim integratorem.

Czy integracja gwarantuje mniejsze koszty odprawy?

Nie. Porównaj koszty obsługi dokumentów z wydatkami na wdrożenie i utrzymanie. Ponadto cena usługi celnej wymaga indywidualnego uzgodnienia.

Źródła i następny krok

Stan źródeł: 19.10.2026. Komisja Europejska opisuje zgłoszenie celne jako dokument zawierający informacje o towarach. Dlatego projekt wymiany danych powinien uwzględniać wymagania konkretnej sprawy.

Specyfikacje usług sieciowych PUESC opisują komunikację elektroniczną i wymagania dotyczące struktury komunikatów. Natomiast powyższa lista stanowi propozycję organizacji projektu. Nie jest specyfikacją gotowego konektora.

Przygotuj mapę pól, przykładowe dokumenty oraz wyniki prób. Następnie ustal zakres obsługi celnej sklepu osCommerce B2B. Dzięki temu oddzielisz wymagania odprawy od prac technicznych integratora.

Agencja Celna Szczecin, Celna 1, Szczecin. Telefon: +48 797 548 918. Sprawdzenie źródeł technicznych: 19.10.2026.

 
 
 

Komentarze


bottom of page