Introduktion
Brug Regulatory API til lagring af data om overholdelse af lovgivningsmæssige krav pr. produkt, som du kan henvise til, når du booker en forsendelse.
Regulatory API understøtter data for følgende regulatorer:
US Consumer Product Safety Commission (CPSC) – data fra overensstemmelseserklæring (CoC) indsendt som en ansvarsfraskrivelse, en henvisning til CPSC Product Registry eller et fuldt certifikat.
EU-Kommission – fjernelse af de minimis – produktidentifikatorer, der kræves i forbindelse med EU's fjernelse af de minimis-tærsklen på 150 EUR, gældende fra juli 2026, skal ledsage B2C-forsendelser af lav værdi (<150 EUR), der kommer ind i EU.
Denne API indsender ikke poster direkte til det amerikanske Customs and Border Protection (CBP), EU-Kommissionen eller nogen anden myndighed.
Den overordnede arbejdsgang, der bruger Regulatory API, er som følger:
- Brug denne API til at gemme regulatoriske data for et produkt under en bestemt myndighed og et bestemt land. De oplysninger, du skal angive, kan variere. Du kan finde flere oplysninger under Opret en profil.
- Book en forsendelse ved brug af Ship API. Sørg for, at hver vare har et
regulatoryDetails[]-array, og at hvert element i arrayet indeholderregulationCode,productIdogproductIdType. - FedEx sammenfletter gemte vareprofiler og forsendelsesoplysninger.
- FedEx fungerer som registreret importør og indgiver alle nødvendige lovgivningsmæssige dokumenter på dine vegne.
Du kan finde flere oplysninger under Brug af regulatoriske profiler og Ship API.
Fleksibiliteten i Regulatory API minimerer integrationsflader og centraliserer lagring. Alle profiler anvender de samme felter på øverste niveau. Regulatorspecifikke data gemmes i et details[]-array, hvor strukturen af hvert element bestemmes af regulationCode.
Påkrævede profilfelter på øverste niveau omfatter følgende:
regulationCode* – Den tilsynsmyndighed, som oplysningerne gælder for. For eksempel: CPSC eller EU_DE_MINIMIS. Værdien af dette felt bestemmer strukturen af elementet for de detaljerede regulatoriske oplysninger.productId* – Forhandlerens eller kundens produkt-id.produktIdType* – Typen af produkt-id. For eksempel: SKU, PART_NUMBER, REGISTERED_NUMBER, GTIN, UPC, EAN, MPN og OTHER.countryOfImport* – Destination for import.details[]– Strukturen af elementerne i dette array varierer afhængigt af, hvilken regulator der er valgt for forsendelsen. For CPSC-regulerede forsendelser indeholder den fraskrivelses- eller referencemeddelelsessæt, for EU_DE_MINIMIS-regulerede forsendelser indeholder den producentidentifikatorer.
*Disse værdier bruges til at matche værdier i arrayet regulatoryDetails[] af en Ship API-anmodning, så profildata kan sammenflettes med forsendelsesdataene.
Tip: Denne struktur svarer til en post i Ship API'ets commodities[].regulatoryDetails[] -array. Du kan udfylde Ship API-anmodninger ved at kopiere direkte fra en lagret profil. Det er nyttigt, når du har en enkeltstående forsendelse, hvor profiloplysningerne er forældede.
POST til slutpunktet Regulatory Profiles for at oprette en regulatorisk profil.
Se følgende afsnit for at få regulatorspecifikke oplysninger.
Regulatory API gemmer CoC-data, som CBP og CPSC kræver sammen med ACE-posten via PGA-meddelelsessættet. Opret en profil, hvor regulationCode = "CPSC" og countryOfImport = "US."
Et af følgende tre meddelelsessæt skal udfyldes i et details[]-element.
Ud over de nødvendige regulationCode, productId, productIdType og countryOfImport skal du bruge details[] til at angive meddelelsessættene:
disclaimMessageSet– De data, der er nødvendige for ansvarsfraskrivelsen.disclaimCode– A = Produktet er ikke reguleret af CPSC, B = data er ikke påkrævet i henhold til agenturets vejledning.intendedUseCode– Basiskode + underkode. For eksempel: "130.003". Se kode for beregnet brug for at få flere oplysninger.intendedUseDescription– Fritekst. Kun påkrævet nårintendedUseCode= "980.000" (Til anden brug).
referenceMessageSet– De data, der er nødvendige til referencen.productVersion– Produktcertifikatets version-id, der aktuelt er knyttet til certifikatet i CPSC Product Registry.certificateId– Det certifikat-ID, der er udstedt til dig af CPSC Product Registry.
fullMessageSet– Komplette certifikatdata. Se oplysningerne om regulatoriske slutpunkter for at få komplette beskrivelser af objekter og felter, detaljer og eksempler. Primære data omfatter:productDetailsmanufacturerDetailslotDetailscertifierEntitypointOfContactcitationDetails
Bemærk: Du skal administrere CPSC Product Registry-poster direkte hos CPSC. Denne API anvender CPSC-register-ID'er som reference i indberetninger, men kan ikke oprette, læse eller opdatere poster i CPSC-registret.
En intendedUseCode er en sekscifret kode (###.###), som fortæller CBP og de relevante myndigheder, hvad det importerede produkts tilsigtede anvendelse er. Koderne er defineret af CBP i bilag R til ACE CATAIR. CPSC anser kun en specifik delmængde af disse koder som gyldige til elektronisk indberetning, afhængigt af meddelelsessættet. Dette felt er altid påkrævet, når disclaimMessageSet er udfyldt.
CPSC anerkender otte basiskoder: 081, 090, 100, 130, 155, 940, 970 og 980.
Base 130 er den mest anvendte basiskode for CPSC, fordi agenturets ansvarsområde er forbrugerprodukter. Koderne 130.000 til 130.006 er de eneste, der må anvendes i en fuld indsendelse. Disclaim A kan bruge en hvilken som helst 130-underkode undtagen 130.001–130.005 (altså 130.000 eller 130.006). Disclaim B må kun bruge 130.006.
Regulatory API understøtter de dataforpligtelser, der indføres med EU's fjernelse af de minimis-grænsen på 150 EUR. For at oprette en profil skal du angive regulationCode = EU_DE_MINIMIS, countryOfImport til en hvilken som helst EU27-medlemsstat og inkludere lovgivningsmæssige oplysninger for varen.
Feltet productId er dit alfanumeriske produkt-id. EU behandler dette som forhandlerens SKU for forsendelsen.
Ud over de påkrævede regulationCode, productId, productIdType og countryOfImport skal du bruge details[] til at angive:
merchantProductId– Forhandlerens produkt-id. Dette er forskelligt fra productId, hvis du bruger separate identifikatorer på forhandler- og SKU-niveau. hvis ikke, skal det sættes lig medproductId.NonStandardManufacturerProductID– Producentens interne SKU eller id. For eksempel: SH123456-L.standardManufacturerProductId– En standardidentifikator såsom GTIN, UPC eller EAN. For eksempel: 01233456789012. Brug den bogstavelige streng "NA", når produktet ikke har en standardidentifikator.
API’en udsender en ikke-blokerende REGP_EU_MISSING_IDENTIFIERS-advarsel, når en EU_DE_MINIMIS-profil gemmes uden nogen af de tre identifikatorer udfyldt.
Du kan henvise til regulatoriske data, der er gemt af Regulatory API, fra Ship API. Detaljer fra regulatoriske profiler indarbejdes i forsendelsen i efterfølgende systemer, efter forsendelsen er oprettet.
Almindelige arbejdsgange, der bruger Ship API og/eller Regulatory API, inkluderer:
En profil-først-tilgang. Registrer hvert produkt én gang ved hjælp af Regulatory API, og angiv derefter kun
productId + productIdType + regulationCodeiregulatoryDetails[]for varer i din forsendelse. Oplysninger sammenflettes med forsendelsen fra den registrerede profil.En udelukkende inline-tilgang. Hver vare i din forsendelse inkluderer
productId + productIdType + regulationCode +fuldt udfyldtedetails[]. Fuld CPSC-data kan ikke overføres inline. Dette mønster er begrænset til fraskrivelses- og reference-CPSC-meddelelsessæt samt EU_DE_MINIMIS-regulatoren.En hybrid tilgang. For en bestemt forsendelse kan du tilsidesætte eksisterende Regulatory API-data. Inkluder
productId + productIdType + regulationCode +, og vælgdetails[]. Inline-data om detaljer tilsidesætter alle data, der er gemt af Regulatory API. Alle detaljedata, der ikke er inkluderet i forsendelsens inline-detaljer, men som findes i profilen, sammenflettes efter, at forsendelsen er oprettet.
Response