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 w przypadku tego profilu.
• productIdType* — typ identyfikatora produktu. Na przykład: SKU, PART_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 i potrzebna jest ręczna aktualizacja.  

Aby utworzyć profil regulacyjny, użyj punktu końcowego Profil regulacyjny. W jednym żądaniu możesz uwzględnić maksymalnie 25 profili regulacyjnych.

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.
  • registryProductId —  identyfikator używany podczas rejestracji produktu w rejestrze produktów CPSC. To pole jest opcjonalne. Możesz użyć pola productId najwyższego poziomu, aby podać tę wartość, ale jeśli przechowujesz profil za pomocą tego interfejsu API z identyfikatorem produktu najwyższego poziomu, który różni się od identyfikatora użytego do rejestracji produktu, możesz podać identyfikator rejestru tutaj. Jeśli pominiesz tę wartość, pole productId służy do odniesienia do rejestru 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.

Kody zamierzonego użytkowania

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 jako dowolne państwo członkowskie 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 Regulatory API i Ship 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 i regulationCode w regulatoryDetails[] dla towarów w przesyłce. Szczegóły są łączone z przesyłką z zarejestrowanego profilu. 

2. Podejście hybrydowe. W przypadku konkretnej przesyłki możesz zastąpić istniejące dane interfejsu Regulatory API. Uwzględnij productId, productIdType i regulationCode i 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.