Introduktion
Använd Regulatory API för att lagra uppgifter om regelefterlevnad för varje produkt, som du kan referera till när du skapar en försändelse.
Regulatory API stöder data från följande regulatorer:
U.S. Consumer Product Safety Commission (CPSC) – Certificate of Compliance (CoC)-data skickad som en ansvarsfriskrivning, en hänvisning till CPSC Product Registry eller ett fullständigt certifikat.
EU-kommissionen – avskaffande av de minimis – produktidentifierare som krävs enligt EU:s avskaffande av de minimis-tröskelvärdet på 150 EUR, från och med juli 2026, för business-to-consumer-försändelser med lågt värde (<150 EUR) som förs in i EU.
Det här API:et lämnar inte in deklarationer direkt till U.S. Customs and Border Protection (CBP), EU-kommissionen eller någon annan myndighet.
Det övergripande arbetsflödet som använder Regulatory API är som följer:
- Använd det här API:et för att lagra regulatoriska data för en produkt kopplad till en viss specifik regulator och ett specifikt land. Vilka uppgifter du behöver ange kan variera. Mer information finns under Skapa en profil.
- Skapa en försändelse genom att använda Ship API. Säkerställ att varje vara innehåller en lista
regulatoryDetails[]och att varje post inkluderarregulationCode,productId,productIdType. - FedEx slår samman lagrade varuprofiler och försändelseinformation.
- FedEx handlar som registrerad importör och skickar in alla nödvändiga regulatoriska dokument för din räkning.
Mer information finns under Användning av regulatoriska profiler och Ship API.
Flexibiliteten i Regulatory API minskar integrationsytan och centraliserar lagring. Varje profil använder samma toppnivåfält. Regulatorspecifika data lagras i en lista details[] där varje post har en struktur som bestäms av regulationCode.
Obligatoriska toppnivåfält i profilen inkluderar följande:
regulationCode* – Den regulatoriska myndighet som uppgifterna gäller för. Till exempel: CPSC eller EU_DE_MINIMIS. Värdet i det här fältet definierar strukturen för varje post med detaljerad regulatorisk information.productId* – Säljarens eller kundens produktidentifierare.productIdType* – Typen av produktidentifierare. Till exempel: SKU, PART_NUMBER, GTIN, UPC, EAN, MPN och OTHER.countryOfImport* – Importens destinationsland.details[]– Strukturen för posterna i den här listan varierar beroende på vilken regulator du har valt för försändelsen. För försändelser reglerade av CPSC innehåller den disclaim- eller reference-meddelandeset. För försändelser reglerade av EU_DE_MINIMIS innehåller den tillverkaridentifierare.
* De här värdena används för att matcha värden i listan regulatoryDetails[] i en Ship API-begäran så att data från profilen kan läggas till i försändelsedata.
Tips: Strukturen motsvarar en post i listan commodities[].regulatoryDetails[] i Ship API Du kan fylla i Ship API-begäranden genom att kopiera direkt från en lagrad profil. Det är användbart när du har en engångsförsändelse med inaktuella profildata.
Använd POST mot slutpunkten Regulatory Profiles för att skapa en regulatorisk profil.
Se följande avsnitt för regulatorspecifika uppgifter.
Regulatory API lagrar de CoC-data som och CPSC kräver tillsammans med ACE-deklaration via PGA-meddelandesetet. Skapa en profil där regulationCode="CPSC" and countryOfImport ="US."
Ett av följande tre meddelandeset måste vara ifyllt i en details[]-post.
Utöver de obligatoriska regulationCode, productId, productIdType och countryOfImport, använd details[] för att tillhandahålla meddelandeseten:
disclaimMessageSet– De uppgifter som behövs för ansvarsfriskrivningen.disclaimCode– A = Produkten regleras inte av CPSC. B = Uppgifterna krävs inte enligt myndighetens riktlinjer.intendedUseCode– Baskod + underkod. Till exempel: "130.003". Mer information finns under Avsedda användningskoder.intendedUseDescription– Fritext. Krävs endast närintendedUseCode= "980.000" (För annan användning).
referenceMessageSet– De uppgifter som behövs för referensen.productVersion– Produktcertifikatets versions-ID som för närvarande är kopplat till certifikatet i CPSC Product Registry.certificateId– Det certifierings-ID som har utfärdats till dig av CPSC Product Registry.registryProductId– Produktens ID som har utfärdats till dig av CPSC Product Registry.
fullMessageSet– Fullständiga certifikatdata. Se informationen om Regulatory Endpoint (slutpunkten för Regulatory API) för fullständiga objekt- och fältbeskrivningar, detaljer och exempel. Primärdata inkluderar:productDetailsmanufacturerDetailslotDetailscertifierEntitypointOfContactcitationDetails
Obs! Du måste hantera CPSC Product Registry-poster direkt med CPSC. Det här API:et refererar till CPSC-register-ID:n för referensanmälningar men skapar, läser eller uppdaterar inte poster i CPSC-registret.
En intendedUseCode är en sexsiffrig kod (###.###) som anger för CBP och berörda myndigheter vad den importerade produkten är avsedd att användas till. Koderna definieras av CBP i Appendix R i ACE CATAIR. CPSC betraktar endast en specifik delmängd av de här koderna som giltiga för sina eFiling-inlämningar, beroende på medelandesetet. Det här fältet är alltid obligatoriskt när disclaimMessageSet fylls i.
CPSC definierar åtta baskoder: 081, 090, 100, 130, 155, 940, 970 och 980.
Base 130 är den mest använda baskoden för CPSC eftersom myndighetens ansvarsområde omfattar konsumentprodukter. Koderna 130.000 till 130.006 är de enda som får användas vid en fullständig inlämning. Disclaimer A får använda alla 130-underkoder förutom 130.001–130.005 (dvs. 130.000 eller 130.006). Disclaimer B får bara använda 130.006.
Regulatory API stöder de datakrav som har införts i och med EU:s avskaffande av de minimis-tröskeln på 150 EUR. För att skapa en profil, ange regulationCode = EU_DE_MINIMIS, countryOfImport till valfritt EU27-medlemsland och inkludera regulatoriska uppgifter för varan.
Fältet productId är din alfanumeriska produktidentifierare. EU behandlar det här som säljarens SKU för försändelsen.
Utöver de obligatoriska regulationCode, productId, productIdType och countryOfImport, använd details[] tillhandahålla:
merchantProductId– Säljarens produktidentifierare. Det här skiljer sig från productId om du använder separata identifierare på säljar- och SKU-nivå. Om inte, ange tillproductId.nonStandardManufacturerProductId– Tillverkarens interna SKU (artikelnummer) or ID (identifierare). Till exempel: SH123456-L.standardManufacturerProductId– En standardidentifierare såsom GTIN, UPC eller EAN. Till exempel: 01233456789012. Använd den exakta strängen "NA" när produkten saknar en standardidentifierare.
API:et genererar en icke-blockerande varning REGP_EU_MISSING_IDENTIFIERS när en EU_DE_MINIMIS-profil lagras utan att någon av de tre identifierarna är ifyllda.
Du kan referera till regulatoriska data lagrade av Regulatory API via Ship API. Uppgifter från regulatoriska profiler inkluderas i försändelsen i ett senare steg efter att försändelsen har skapats.
Vanliga arbetsflöden som utnyttjar Ship API och/eller Regulatory API inkluderar:
Ett profilbaserat arbetssätt. Registrera varje produkt en gång genom att använda Regulatory API och ange sedan endast
productId + productIdType + regulationCodeiregulatoryDetails[]för varor i din försändelse. Uppgifter från den registrerade profilen slås samman med försändelsen.Ett enbart inlinebaserat arbetssätt. Varje vara i din försändelse inkluderar
productId + productIdType + regulationCode +fullständigt ifyllddetails[]. Fullständiga CPSC-data kan inte anges inline. Det här mönstret är begränsat till att endast hänvisa till CPSC disclaim- eller reference-meddelandeset och regulatorn EU_DE_MINIMIS.Ett hybridarbetssätt. För en särskild försändelse kan du ersätta befintliga data i Regulatory API. Inkludera
productId + productIdType + regulationCode +väljdetails[]. Inline-detaljdata har företräde framför alla data som lagras i Regulatory API. Alla detaljdata som inte inkluderas i försändelsens inline-detaljer men som finns i profilen slås samman med försändelsen efter att den har skapats.
Response