Użyj interfejsu API Regulatory, aby przechowywać dane dotyczące zgodności z przepisami dla poszczególnych produktów, do których to danych możesz się odwołać podczas tworzenia przesyłki.

Interfejs Regulatory API obsługuje dane dla następujących organów regulacyjnych:

• Amerykańska komisja ds. bezpieczeństwa produktów konsumenckich (Consumer Product Safety Commission, CPSC) — dane certyfikatu zgodności (CoC) przesłane jako zastrzeżenie, odniesienie do rejestru produktów CPSC lub pełny certyfikat.

• Komisja Europejska — zniesienie de minimis — identyfikatory produktów wymagane w ramach unijnego zniesienia progu de minimis w wysokości 150 EUR, wchodzącego w życie od lipca 2026 r., muszą być dołączone do przesyłek konsumenckich o niskiej wartości (< 150 EUR) wwożonych do UE.

Niniejszy interfejs API nie dokonuje wpisów bezpośrednio do amerykańskiej służby celnej i ochrony granic (Customs and Border Protection, CBP), Komisji UE ani żadnego innego organu. 

Ogólny przepływ pracy wykorzystujący Regulatory API jest następujący:

1. Użyj tego API do przechowywania danych regulacyjnych dla produktu w ramach określonego regulatora i kraju. Dane, które musisz podać, mogą się różnić. Więcej szczegółów znajdziesz w sekcji Tworzenie profilu.
2. Utwórz przesyłkę za pomocą interfejsu Ship API. Upewnij się, że każdy towar zawiera tablicę regulatoryDetails[] i że każdy element zawiera regulationCode, productId i productIdType.
3. FedEx łączy przechowywane profile towarów i informacje o przesyłce.
4. FedEx pełni rolę oficjalnego importera i składa wszystkie niezbędne dokumenty regulacyjne w Twoim imieniu.

Więcej informacji zawiera sekcja Korzystanie z profili regulacyjnych i interfejsu Ship API.

Elastyczność interfejsu Regulatory API minimalizuje powierzchnie integracyjne i centralizuje magazynowanie. Każdy profil używa tych samych pól najwyższego poziomu. Dane specyficzne dla regulatora są przechowywane na tablicy details[], której kształt elementu jest określony przez regulationCode.  

Wymagane pola profilu najwyższego poziomu obejmują:

• regulationCode* — agencja regulacyjna, której dotyczą szczegóły. Na przykład: CPSC lub EU_DE_MINIMIS. Ta wartość określa kształt elementu dla szczegółowych informacji regulacyjnych.
• productId* — identyfikator produktu sprzedawcy lub klienta.
• productIdType* — typ identyfikatora produktu. Na przykład: SKU, PART_NUMBER, REGISTERED_NUMBER, GTIN, UPC, EAN, MPN i OTHER.
• countryOfImport* — kraj docelowy importu.
• details[] — kształt elementów w tej tablicy zmienia się w zależności od tego, który regulator został przez Ciebie wybrany dla przesyłki. W przypadku przesyłek regulowanych przez CPSC zawiera on zestawy komunikatów typu Zastrzeżenie lub Odniesienie; w przypadku przesyłek regulowanych przez EU_DE_MINIMIS zawiera identyfikatory producenta. 

* Wartości te służą do dopasowywania wartości w tablicy regulatoryDetails[] żądania Ship API, dzięki czemu dane profilu mogą być scalane z danymi przesyłki.

Wskazówka: Ta struktura odzwierciedla wpis na tablicy interfejsu Ship API commodities[].regulatoryDetails[]. Możesz wypełnić żądania interfejsu Ship API, kopiując je bezpośrednio z zapisanego profilu. Jest to przydatne, gdy masz jednorazową przesyłkę, w której szczegóły profilu są nieaktualne.  

Wykonaj polecenie POST do punktu końcowego Profile regulacyjne, aby utworzyć profil regulacyjny.

Szczegółowe informacje dotyczące regulatora podano w poniższych sekcjach. 

Interfejs Regulatory API przechowuje dane CoC wymagane przez CBP i CPSC wraz z wpisem ACE za pośrednictwem zestawu wiadomości PGA. Utwórz profil, w którym regulationCode = „CPSC” i countryOfImport = „US”.  

Jeden z poniższych trzech zestawów komunikatów musi być wypełniony w elemencie details[].

Oprócz wymaganych regulationCode, productId, productIdType i countryOfImport użyj details[], aby podać zestawy komunikatów:  

• disclaimMessageSet — dane potrzebne do zastrzeżenia.

  • disclaimCode — A = produkt nie jest regulowany przez CPSC; B = dane nie są wymagane zgodnie z wytycznymi agencji. 
  • intendedUseCode — kod bazowy + kod podrzędny. Na przykład „130.003”. Więcej informacji można znaleźć w sekcji Kody przeznaczenia.
  • intendedUseDescription — dowolny tekst. Wymagane tylko wtedy, gdy intendedUseCode = "980.000" (do innych zastosowań).

• referenceMessageSet — dane potrzebne do odniesienia.

  • productVersion — identyfikator wersji certyfikatu produktu obecnie powiązany z certyfikatem w rejestrze produktu CPSC.
  • certificateId — identyfikator jednostki certyfikującej wydany przez rejestr produktów CPSC.

• fullMessageSet — pełne dane certyfikatu. Pełne opisy obiektów i pól, szczegóły i przykłady znajdują się w informacjach Regulatory Endpoint. Dane podstawowe obejmują: 

  • productDetails
  • manufacturerDetails
  • lotDetails
  • certifierEntity
  • pointOfContact
  • CitationDetails

Uwaga: Musisz zarządzać wpisami rejestru produktów CPSC bezpośrednio z CPSC. Ten interfejs API odwołuje się do identyfikatorów rejestru CPSC dla wypełnień referencyjnych, ale nie tworzy, nie odczytuje ani nie aktualizuje rekordów rejestru CPSC.

intendedUseCode to sześciocyfrowy kod (###.###) informujący CBP i odpowiednie agencje o przeznaczeniu importowanego produktu. Kody są zdefiniowane przez CBP w dodatku R do ACE CATAIR. CPSC uznaje tylko określony podzbiór tych kodów ważny dla swoich zgłoszeń eFiling, w zależności od zestawu komunikatów. To pole jest zawsze wymagane, gdy disclaimMessageSet jest wypełnione. 

CPSC rozpoznaje osiem kodów bazowych: 081, 090, 100, 130, 155, 940, 970 i 980.

Najczęściej używanym kodem bazowym dla CPSC jest Base 130, ponieważ zakres agencji to produkty konsumenckie. Przy pełnym zgłoszeniu można wykorzystać tylko kody od 130.000 do 130.006. Zastrzeżenie A może używać dowolnego kodu podrzędnego 130 z wyjątkiem 130.001–130.005 (tj. 130.000 lub 130.006). Zastrzeżenie B może używać tylko kodu 130.006.

Interfejs Regulatory API obsługuje zobowiązania dotyczące danych wprowadzone w wyniku zniesienia przez UE progu de minimis w wysokości 150 euro. Aby utworzyć profil, należy ustawić regulationCode = EU_DE_MINIMIS, countryOfImport do dowolnego państwa członkowskiego UE27 i podać szczegóły regulacyjne dla takiego towaru.

Pole productId zawiera alfanumeryczny identyfikator produktu. UE traktuje to jako SKU sprzedawcy dla przesyłki.

Oprócz wymaganych regulationCode, productId i productIdType użyj details[], aby podać:

• merchantProductId — identyfikator produktu sprzedawcy. Jest to parametr różniący się od productId, jeśli używasz oddzielnych identyfikatorów na poziomie sprzedawcy i SKU; jeśli nie, ustaw to równe productId.
• nonStandardManufacturerProductId — wewnętrzny numer SKU lub identyfikator producenta. Na przykład: SH123456-L.
• standardManufacturerProductId — standardowy identyfikator, taki jak GTIN, UPC lub EAN. Na przykład: 01233456789012. Użyj literału tekstowego „NA”, gdy produkt nie ma standardowego identyfikatora.

Interfejs API emituje nieblokujące ostrzeżenie REGP_EU_MISSING_IDENTIFIERS, gdy profil EU_DE_MINIMIS jest przechowywany bez wypełnienia któregokolwiek z trzech identyfikatorów. 

Możesz odwołać się do danych regulacyjnych przechowywanych przez interfejs Regulatory API z interfejsu Ship API. Szczegóły z profili regulacyjnych są włączane do przesyłki w kolejnych etapach po utworzeniu przesyłki. 

Typowe przepływy pracy wykorzystujące interfejs Ship API i/lub interfejs Regulatory API obejmują:

1. Podejście zorientowane na profil. Zarejestruj każdy produkt raz za pomocą interfejsu Regulatory API, a następnie podaj tylko productId + productIdType + regulationCode w regulatoryDetails[] dla towarów w przesyłce. Szczegóły są łączone z przesyłką z zarejestrowanego profilu.

2. Podejście tylko do wbudowania. Każdy towar w Twojej przesyłce zawiera productId + productIdType + regulationCode + w pełni wypełnione details[]. Pełnych danych CPSC nie można przesyłać w trybie wbudowania; ten wzorzec jest ograniczony do zastrzeżeń i odniesień do zestawów wiadomości CPSC oraz regulatora EU_DE_MINIMIS.

3. Podejście hybrydowe. W przypadku konkretnej przesyłki możesz zastąpić istniejące dane interfejsu Regulatory API. Uwzględnij productId + productIdType + regulationCode + wybierz details[]. Dane szczegółowe wbudowane zastępują wszelkie dane przechowywane przez interfejs Regulatory API. Wszelkie dane szczegółowe niezawarte we wbudowanych szczegółach przesyłki, ale obecne w profilu, są scalane po utworzeniu przesyłki.