Potete utilizzare la Regulatory API per archiviare i dati relativi alla conformità normativa di ciascun prodotto, a cui fare riferimento durante la creazione di una spedizione.

La Regulatory API supporta i dati relativi alle seguenti autorità di regolamentazione:

• Commissione statunitense per la sicurezza dei prodotti di consumo (CPSC, Consumer Product Safety Commission): dati relativi al certificato di conformità (CoC, Certificate of Compliance) inviati sotto forma di dichiarazione di esclusione di responsabilità, di riferimento al Registro dei prodotti della CPSC o di certificato completo.

• Commissione europea - Abolizione della soglia de minimis: identificatori dei prodotti richiesti in seguito all'abolizione, da parte dell'UE, della soglia de minimis di 150 €, con effetto dal mese di luglio 2026, a corredo delle spedizioni business-to-consumer di basso valore (<150 €) in entrata nell'UE.

Quest'API non invia direttamente le richieste all'Ufficio doganale e di protezione delle frontiere (CBP, Customs and Border Protection) degli Stati Uniti, alla Commissione europea né ad alcun'altra autorità. 

Il flusso di lavoro complessivo che utilizza la Regulatory API è il seguente:

1. Utilizzate quest'API per archiviare i dati normativi relativi a un prodotto in riferimento a un'autorità di regolamentazione e a un Paese specifici. I dati richiesti potrebbero variare. Per maggiori dettagli, vedete la sezione Creazione di un profilo.
2. Create una spedizione utilizzando la Ship API. Assicuratevi che tutta la merce riporti un array regulatoryDetails[] e che ogni elemento contenga i parametri regulationCode, productId e productIdType.
3. FedEx integra i profili delle merci immagazzinate con i dati di spedizione.
4. FedEx funge da Importatore e presenta tutti i documenti normativi necessari per vostro conto.

Per maggiori dettagli, vedete la sezione Utilizzo dei profili normativi e della Ship API.

La flessibilità della Regulatory API riduce al minimo le interfacce di integrazione e centralizza l'archiviazione. Ogni profilo utilizza gli stessi campi principali. I dati specifici del regolatore sono memorizzati in un array details[], la cui struttura degli elementi è determinata dal campo regulationCode.  

I campi obbligatori del profilo di primo livello sono i seguenti:

• regulationCode*: autorità di regolamentazione a cui si riferiscono tali informazioni, ad esempio CPSC o EU_DE_MINIMIS. Il valore di questo campo definisce la struttura dell'elemento per le informazioni normative dettagliate. 
• productId*: identificativo prodotto del commerciante o del cliente.
• productIdType*: tipo di identificativo prodotto, ad esempio SKU, PART_NUMBER, REGISTERED_NUMBER, GTIN, UPC, EAN, MPN, e OTHER. 
• countryOfImport*: Paese di destinazione dell'import.
• details[]: la struttura degli elementi di questo array varia a seconda del gestore scelto per la spedizione. Per le spedizioni soggette alla normativa CPSC, contiene set di messaggi di esclusione di responsabilità (Disclaim) o di riferimento (Reference); per le spedizioni soggette alla normativa EU_DE_MINIMIS, contiene gli identificativi dei produttori. 

* Questi valori vengono utilizzati per abbinare i valori presenti nell'array regulatoryDetails[] di una richiesta della Ship API, in modo che i dati del profilo possano essere integrati nei dati della spedizione.

Suggerimento: questa struttura rispecchia una voce dell'array commodities[].regulatoryDetails[] della Ship API. Potete compilare le richieste della Ship API copiando i dati direttamente da un profilo salvato. Ciò risulta utile quando dovete effettuare una spedizione una tantum in cui i dati del profilo non sono aggiornati.  

Inviate una richiesta all'endpoint Profili normativi per creare un profilo normativo.

Per ulteriori dettagli relativi alle singole autorità di regolamentazione, consultate le sezioni seguenti. 

La Regulatory API archivia i dati CoC richiesti dal CBP e dalla CPSC assieme alla dichiarazione ACE tramite il set di messaggi PGA. Create un profilo in cui regulationCode = "CPSC" e countryOfImport = "US".  

In un elemento details[] deve essere inserito uno dei tre set di messaggi seguenti.

Oltre ai campi obbligatori regulationCode, productId, productIdType e countryOfImport, utilizzate l'elemento details[] per fornire i set di messaggi:  

• disclaimMessageSet: dati necessari per la dichiarazione di esclusione di responsabilità.

  • disclaimCode: A = il prodotto non è soggetto alla regolamentazione della CPSC; B = i dati non sono richiesti in base alle linee guida dell'agenzia. 
  • intendedUseCode: codice base + codice secondario, ad esempio "130.003". Per maggiori informazioni, vedete la sezione Codici di uso previsto.
  • intendedUseDescription: testo libero. Obbligatorio solo se intendedUseCode = "980.000" (per altri usi). 

• referenceMessageSet: dati necessari per il riferimento.

  • productVersion: identificativo versione del certificato del prodotto attualmente associato al certificato nel Registro dei prodotti della CPSC. 
  • certificateId: ID del certificatore assegnato dal Registro dei prodotti della CPSC.

• fullMessageSet: dati completi del certificato. Per una descrizione completa degli oggetti e dei campi, nonché per ulteriori dettagli ed esempi, consultate le informazioni relative agli endpoint normativi. I dati primari comprendono: 

  • productDetails
  • manufacturerDetails
  • lotDetails
  • certifierEntity
  • pointOfContact
  • citationDetails

Nota: le voci del Registro dei prodotti della CPSC devono essere gestite direttamente con la CPSC. Questa API fa riferimento agli ID del registro CPSC per le richieste di tipo Reference, ma non crea, legge né aggiorna i record del registro CPSC.

Un valore intendedUseCode è un codice a sei cifre (###.###) che indica al CBP e alle agenzie competenti che cosa è destinato ad essere utilizzato per il prodotto importato. I codici sono definiti dal CBP nell'Appendice R dell'ACE CATAIR. Ai fini delle presentazioni tramite eFiling, la CPSC considera valido solo un sottoinsieme specifico di tali codici, a seconda del set di messaggi. Questo campo è sempre obbligatorio quando viene compilato disclaimMessageSet. 

La CPSC riconosce otto codici di base: 081, 090, 100, 130, 155, 940, 970 e 980.

Il codice di base più utilizzato dalla CPSC è il 130, poiché l'ambito di competenza dell'agenzia riguarda i prodotti di consumo. In una richiesta completa è possibile utilizzare solo i codici da 130.000 a 130.006. Il codice Disclaim A può utilizzare qualsiasi sottocodice della serie 130, ad eccezione dei codici da 130.001 a 130.005 (ad esempio, 130.000 o 130.006), mentre il codice Disclaim B può essere utilizzato solo nel caso 130.006.

La Regulatory API è conforme agli obblighi in materia di dati introdotti dall'abolizione, da parte dell'UE, della soglia de minimis di 150 €. Per creare un profilo, impostate regulationCode = EU_DE_MINIMIS, countryOfImport su uno qualsiasi degli Stati membri dell'UE-27 e inserite i dettagli normativi relativi alla merce. 

Il campo productId è l'identificativo alfanumerico del prodotto. L'UE considera questo codice come SKU commerciale della spedizione.

Oltre ai campi obbligatori regulationCode, productId, productIdType e countryOfImport, utilizzate l'elemento details[] per fornire: 

• merchantProductId: identificativo prodotto del commerciante. Questo valore è diverso da productId se si utilizzano identificatori distinti a livello di commerciante e di SKU; in caso contrario, impostate questo valore uguale a productId.
• nonStandardManufacturerProductId: codice SKU o ID interno del produttore, ad esempio SH123456-L. 
• standardManufacturerProductId: un identificativo standard come GTIN, UPC o EAN, ad esempio 01233456789012. Quando il prodotto non dispone di un identificatore standard, utilizzate la stringa letterale "NA".

Quando viene salvato un profilo EU_DE_MINIMIS senza che nessuno dei tre identificatori sia stato compilato, l'API genera un avviso non bloccante di tipo REGP_EU_MISSING_IDENTIFIERS. 

Potete consultare i dati normativi archiviati dalla Regulatory API tramite la Ship API. I dati dei profili normativi vengono integrati nella spedizione a valle, una volta che questa è stata creata. 

Tra i flussi di lavoro più comuni che utilizzano la Ship API e/o la Regulatory API figurano i seguenti:

1. Un approccio incentrato sul profilo. Registrate ogni prodotto una sola volta utilizzando la Regulatory API, quindi indicate solo productId + productIdType + regulationCode nell'array regulatoryDetails[] per le merci presenti nella spedizione. I dettagli vengono importati nella spedizione dal profilo registrato. 

2. Un approccio esclusivamente in-line. Ogni merce nella spedizione include productId + productIdType + regulationCode + un elemento details[] interamente compilato. Non è possibile includere i dati CPSC completi in-line; questo modello è limitato ai set di messaggi CPSC di tipo Disclaim e Reference e al regolatore EU_DE_MINIMIS.

3. Un approccio ibrido. Per una determinata spedizione, potete sovrascrivere i dati esistenti della Regulatory API. Includete productId + productIdType + regulationCode + selezionate details[]. I dettagli in-line hanno la precedenza su quelli memorizzati dalla Regulatory API. Qualsiasi dato non presente nei dettagli in-line della spedizione, ma presente nel profilo, viene unito dopo la creazione della spedizione.