Consolidation API

La Consolidation API consente di consolidare il ritiro di spedizioni singole per lo sdoganamento in un unico passaggio alla dogana e, dopo lo sdoganamento, di suddividere la spedizione in spedizioni più piccole all'interno del Paese di destinazione affinché vengano distribuite ai singoli destinatari. Questa API è utile per i mittenti che desiderano consolidare le loro spedizioni internazionali FedEx Express^® e FedEx Ground^®.
Consolidation Ground Shipment è un servizio riservato alle spedizioni verso il Canada e consente ai mittenti statunitensi qualificati di consolidare le spedizioni FedEx Ground per la distribuzione in Canada tramite FedEx Logistics^® o un broker di vostra scelta. Una volta che la spedizione supera la dogana canadese come unica spedizione, questa viene suddivisa in spedizioni singole più piccole in Canada. Dopo che la vostra spedizione verrà sdoganata, avrete accesso all'intera gamma di servizi FedEx.

Nota: il codice cliente deve essere abilitato per i servizi Consolidation API per eseguire qualsiasi transazione API.

La Consolidation API consente lo sdoganamento a destino come spedizione singola. L'intera spedizione è spedita (e registrata) a nome di un solo importatore (IOR). La spedizione deve inoltre provenire da un unico esportatore. I singoli colli della spedizione vengono consegnati al destinatario indicato su ciascuna etichetta FedEx Express Shipping o FedEx Express Manifest.
Il consolidamento della spedizione offre anche un unico punto di sdoganamento (SPOC, Single Point of Clearance), che consente di inviare una spedizione consolidata che include colli verso più Paesi dell'Unione Europea.
Gli standard e le restrizioni per le dimensioni, il peso e i tipi di merce di International Priority Freight (IPF) si applicano ai singoli colli di una spedizione consolidata di merci pesanti o voluminose.
Nota: per poter elaborare le vostre spedizioni consolidate, dovete avere un contratto di servizio con FedEx. Per ulteriori informazioni, contattate i vostri referenti commerciali FedEx.

La Consolidation API permette ai clienti di utilizzare DirectDistribution per le spedizioni internazionali quando spediscono più di un collo, a condizione che il Paese di destinazione di tutti i colli sia lo stesso.
Il servizio Direct Distribution migliorerà i tempi di consegna, ridurrà le commissioni di sdoganamento e i costi di magazzino per i mittenti. FedEx consoliderà le spedizioni che viaggiano verso la stessa località (Paese estero) per lo sdoganamento e poi le dividerà per la consegna diretta ai vostri clienti.
I clienti ora possono anche inviare spedizioni dal Canada agli Stati Uniti tramite l'International DirectDistribution (IDD) (ex servizio di distribuzione transfrontaliera). Le soluzioni FedEx International DirectDistribution Surface (IDD Surface) offrono ai clienti di Canada e Messico un'opzione di consegna transfrontaliera consolidata per spedire a più destinatari negli Stati Uniti. International DirectDistribution (IDD) deve avere sede in Canada o Messico ed è necessario configurare un ID punto di consegna per il Codice Cliente specificato.

I report dettagliati della fattura commerciale consolidata (FCC) rappresentano uno dei report doganali minimi necessari affinché la spedizione consolidata oltrepassi con successo il confine internazionale nel Paese di destinazione.

Dettagli spedizione Fattura commerciale consolidata fornisce le seguenti informazioni:

• Il report Dettagli spedizione FCC fornisce le informazioni sulla spedizione per tutti i colli Broker Entry (PAPS) nel consolidamento e li raggruppa/elenca per "Acquirente" (ovvero parte "Venduto a").
  Nota: Le spedizioni secondarie sono elencate nella fattura commerciale consolidata sotto una delle seguenti condizioni:
  
  • Le spedizioni secondarie che non si qualificano per la Sezione 321 sono elencate nella Fattura commerciale consolidata per la voce doganale dall'intermediario designato.
  • Il mittente specifica che tutte le spedizioni secondarie nel consolidamento devono essere inviate per la registrazione al Broker.

L'IDD Linehaul Report fornisce le seguenti informazioni:

• Quali acquirenti e le relative spedizioni si qualificano per la Sezione 321 e quali si qualificano per PAPS.
• Il punto di consegna e l'indirizzo.
• Informazioni sul punto di consegna di terze parti o la struttura.

Nota: Questo rapporto è anche noto come Consolidated Customs Linehaul Report e viene generato per le spedizioni in entrata negli Stati Uniti dal Canada o dal Messico.

International DirectDistribution Services – La tabella dei servizi FedEx Express e FedEx Ground elenca i servizi FedEx U.S. disponibili per le spedizioni International DirectDistribution dopo l'ingresso di queste ultime negli Stati Uniti.

Servizi FedEx Express - International Priority DirectDistribution (IPD)

FedEx Ground Services - International DirectDistribution (IDD) Surface Solutions

Di seguito vengono riportati i servizi di spedizione disponibili per la Consolidation API.

Servizi FedEx Express International DirectDistribution

• I servizi International Priority DirectDistribution (IPD) e International Economy DirectDistribution (IED) offrono spedizioni consolidate FedEx Express^® che vengono sdoganate in un unico passaggio alla dogana, per poi essere consegnate ai singoli destinatari nel Paese di destinazione. Tali servizi vengono forniti unicamente su contratto.
• Il servizio International DirectDistribution (IDD) consente di effettuare spedizioni oltre confine consolidate dal Canada e dal Messico a diversi destinatari negli Stati Uniti.

Servizio FedEx Express International DirectDistribution Freight

• Potete consolidare ed effettuare spedizioni di merci pesanti multicollo (superiori a 150 libbre/68 chilogrammi) utilizzando FedEx International Priority DirectDistribution Freight (IDF). Per le spedizioni IDF, tutti i colli devono essere disposti su pallet. International Priority DirectDistribution Freight (IDF) consente di utilizzare un'unica Lettera di Vettura Aerea internazionale FedEx^® per consolidare le spedizioni provenienti da un'unica sede di origine verso diversi destinatari in un unico Paese di destinazione. Dopo l'ingresso negli Stati Uniti, la spedizione può essere gestita tramite i servizi FedEx U.S., tra cui FedEx Express, FedEx Ground e FedEx Home Delivery.

Le spedizioni consolidate possono essere elaborate in modo sincrono o asincrono a seconda del numero di colli per spedizione o della merce a livello di collo in una spedizione.
Per l'elaborazione sincrona, una transazione deve avere meno di 40 colli secondari per consolidamento.
Se la transazione viene elaborata in modo sincrono, la risposta conterrà le etichette dei colli e i rapporti di spedizione come la FC.
Se la transazione è elaborata in modo asincrono, la risposta conferma solo che la richiesta è stata inserita con successo per l'elaborazione asincrona. La spedizione stessa potrebbe non essere stata elaborata con successo e quindi si dovrà utilizzare il metodo Risultati spedizione consolidata per verificare se le spedizioni sono state elaborate con successo. Prima di recuperare i risultati, è necessario attendere un po' di tempo affinché le spedizioni vengano elaborate correttamente.

Per elaborare la spedizione in modo asincrono, potete seguire i seguenti passaggi –

1. Create Consolidation: utilizzate questo endpoint per creare un nuovo consolidamento con un indice unico. Se la richiesta viene elaborata correttamente, verrà generato un numero di monitoraggio consolidato.
   Nota: se l'indice non viene fornito nella richiesta, il numero di monitoraggio verrà considerato come indice.
2. Create Consolidation Shipment: utilizzate questo endpoint per creare una spedizione asincrona con più di 40 colli. Se la richiesta viene elaborata correttamente, verrà generato un jobID della spedizione consolidato.
3. Consolidation Shipment Results: utilizzate questo endpoint con il jobID generato per ottenere il numero di monitoraggio della spedizione e le etichette.
4. Confirm Consolidation: utilizzate questo endpoint con il tipo di consolidamento e l'indice generato per confermare il consolidamento creato. Se la richiesta viene elaborata correttamente, viene generato un jobID
5. Confirm Consolidation Results: utilizzate questo endpoint con il jobID generato in Confirm Consolidation per ottenere i numeri di monitoraggio, le etichette e la documentazione  del consolidamento.

Per elaborare la spedizione in modo sincrono, potete seguire i seguenti passaggi –

1. Create Consolidation: utilizzate questo endpoint per creare un nuovo consolidamento con un indice unico. Se la richiesta viene elaborata correttamente, verrà generato un numero di monitoraggio consolidato.
   Nota: se l'indice non viene fornito nella richiesta, il numero di monitoraggio verrà considerato come indice.
2. Create Consolidation Shipment: utilizzate questo endpoint per creare una spedizione sincrona con 40 colli o meno. Se la richiesta viene elaborata correttamente, vengono generati i numeri di monitoraggio della spedizione consolidata e le etichette.
3. Confirm Consolidation: utilizzate questo endpoint con il tipo di consolidamento e l'indice generato per confermare il consolidamento creato. Se la richiesta viene elaborata correttamente, viene generato un jobID
4. Confirm Consolidation Results: utilizzate questo endpoint con il jobID generato in Confirm Consolidation per ottenere i numeri di monitoraggio, le etichette e la documentazione del consolidamento.

Per modificare o eliminare un consolidamento o una spedizione consolidata creati, si possono seguire i seguenti passaggi:

• Modify Consolidations: utilizzate questo endpoint per modificare le informazioni di una richiesta di consolidamento esistente prima che il consolidamento venga confermato.
• Delete Consolidation Shipment: utilizzate questo endpoint per annullare le spedizioni FedEx Express, Express Freight e Ground che non sono state affidate a FedEx. Se la richiesta viene elaborata correttamente, viene visualizzo lo stato di consolidamento spedizione eliminato e viene generata la risposta "cancelledShipment": true.
• Delete Consolidation: utilizzate questo endpoint per eliminare un consolidamento prima che venga confermato.
  Nota: questa operazione eliminerà anche tutti i colli di spedizione che sono stati processati come parte del consolidamento.
• Retrieve Consolidation: utilizzate questo endpoint per recuperare i dettagli del consolidamento.

Di seguito sono riportate le caratteristiche principali associate alla Consolidation API:

Crea consolidamenti

Utilizzate questo endpoint per creare un consolidamento con le informazioni di consolidamento richieste.
Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Account Number – Il Codice Cliente della spedizione FedEx
• requestedConsolidation
  • Consolidation Type - Specificate il tipo di consolidamento.
  • Mittente: fornite le informazioni sul mittente e Numero di identificazione fiscale (TIN)
  • Label Specification - Specificate i dettagli sul tipo di immagine, sul formato della stampante e sul supporto dell'etichetta.
  • International Distribution Detail
    • Declared Currencies
    • Total Dimensions
    • Clearance Facility Location Id
  • Customs Clearance Detail: specificate l'importatore.
  • Consolidation Documents – Specificate la documentazione richiesta quando il consolidamento è confermato.

Se la richiesta viene elaborata correttamente, viene creato il consolidamento e generati l'ID monitoraggio master e la Consolidation Key. Nella risposta non verrà generata alcuna etichetta.

Modifica consolidamenti

Utilizzate questo endpoint per modificare le informazioni di una richiesta di consolidamento esistente prima che il consolidamento venga confermato.
Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Consolidation Key – Specificate il tipo di consolidamento, l'indice e la data di consolidamento generati in Create Consolidation.
• Account Number – Il Codice Cliente della spedizione FedEx.
• requestedConsolidation
  • Consolidation Type: specificate il tipo di consolidamento.
  • Mittente
  • Label Specification - Specificate i dettagli sul tipo di immagine, sul formato della stampante e sul supporto dell'etichetta. È possibile indicare anche dettagli specifici del cliente come il contenuto della doc-tab, le etichette regolamentari e i dati della maschera sull'etichetta
  • Customs Clearance – Specificate i dettagli dello sdoganamento con l'importatore.

Se la richiesta viene elaborata correttamente, verranno aggiornate le informazioni previste e restituiti i dettagli aggiornati del consolidamento.

Recupera consolidamenti

Utilizzate questo endpoint per recuperare i consolidamenti associati alla chiave di consolidamento specificata. Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Account Number – Il Codice Cliente della spedizione FedEx.
• Consolidation Key – Specificate il tipo di consolidamento, l'indice e la data di consolidamento generati in Create Consolidation

Se la richiesta viene elaborata correttamente, vengono recuperati i dettagli del consolidamento.

Elimina consolidamenti

Utilizzate questo endpoint per eliminare il consolidamento aperto prima che il consolidamento venga confermato.
Nota: se necessario, questo endpoint deve essere utilizzato prima di confermare il consolidamento.

Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Account Number – Il Codice Cliente della spedizione FedEx.
• Consolidation Key – Specificate il tipo di consolidamento, l'indice e la data di consolidamento.
• TrackingId – Specificate l'ID monitoraggio master generato in Create Consolidation.

Se la richiesta viene elaborata correttamente, viene eliminato il consolidamento e nell'output viene restituito lo stato dell'elemento cancelledShipment come true.

Crea spedizione consolidata

Utilizzate questo endpoint per aggiungere i colli della spedizione sotto una chiave di consolidamento.
Nota: per creare una spedizione consolidata sono necessarie almeno 2 spedizioni.

Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Label Response Options – Deve essere URL_ONLY/LABEL
• Open Shipment Action - CONFIRM
• Account Number – Il Codice Cliente della spedizione FedEx.
• Consolidation Key – Specificate il tipo di consolidamento, l'indice e la data di consolidamento generati in Create Consolidation
• requestedShipment
  • Consolidation Type - Specificate il tipo di consolidamento
  • Dati del mittente
  • Dati del destinatario
  • Tipo di ritiro
  • Service Type – Indicate i tipi di servizio Express/Ground
  • Tipo di imballaggio
  • Shipping Payment Type (SENDER/THIRD_PARTY e Payor ACCOUNT)
  • Customs Clearance Detail
  • Package Line Items
    • peso
    • merci

Qualora alla richiesta venga data una risposta positiva per 40 o meno colli secondari per consolidamento in una spedizione, i dati della spedizione verranno caricati nei sistemi FedEx e verranno generati i numeri di monitoraggio e le etichette dei colli. Qualora alla richiesta venga data una risposta positiva per più di 40 colli secondari per consolidamento in una spedizione, questa conferma che la richiesta è stata inserita con successo e restituisce il jobId per il successivo recupero del risultato utilizzando Risultati spedizione consolidata.

Conferma consolidamento

Utilizzate questo endpoint per confermare il Consolidamento.
Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Codice Cliente
• processingOptionType - ALLOW_ASYNCHRONOUS
• Consolidation Key
• Label Specification

Se la richiesta viene elaborata correttamente, questa fornirà i risultati dell'elaborazione asincrona, il jobID e i dettagli completi di consolidamento, tra cui il tipo di spedizione (shipmentRoleType), i dettagli della spedizione richiesta (requestedShipments) e altre informazioni sulla spedizione.

Conferma risultati consolidamenti

Utilizzate questo endpoint per completare un consolidamento. Se il consolidamento viene completato, la risposta restituisce i buffer delle etichette e tutti i documenti applicabili.

Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• jobId
• Codice Cliente

La risposta positiva a questa richiesta restituirà i risultati confermati della spedizione di consolidamento che includono il numero di monitoraggio, il documento di spedizione o le informazioni specifiche sull'etichetta.

Risultati spedizione consolidata

Utilizzate questo endpoint per convalidare e caricare i dati della spedizione aperta nei sistemi FedEx dopo aver aggiunto tutti i colli nella richiesta di spedizione. Questo endpoint offre la possibilità di verificare se l'elaborazione asincrona delle spedizioni aperte è stata completata. In caso affermativo, vengono restituiti in risposta etichette e documenti applicabili. Le società operative per questa richiesta sono FedEx Express e FedEx Ground.
Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• jobId
• Codice Cliente

Se la richiesta viene elaborata correttamente, vengono forniti i dettagli della spedizione, che comprendono il numero di monitoraggio della spedizione e le etichette.

Elimina spedizioni consolidate

Utilizzate questo endpoint per eliminare le spedizioni FedEx Express, Express Freight e Ground che non sono state affidate a FedEx.
Le informazioni di input chiave associate a questa richiesta sono le seguenti:

• Codice Cliente
• Numero di monitoraggio
• deletionControl - DELETE_ALL_PACKAGES

Se la richiesta viene elaborata correttamente, viene visualizzo lo stato di consolidamento spedizione eliminato e viene generata la risposta "cancelledShipment": true.

• È consentito un numero massimo di 300 colli per singola spedizione.
• Attualmente per un consolidamento FedEx è consentito un totale di 400 colli per singolo consolidamento.
• Massimo 999 merci (FedEx Express e FedEx Ground, a seconda dei casi) per consolidamento. Solitamente il numero delle merci in un consolidamento è decisamente inferiore.
• Le spese di trasporto e gli oneri doganali possono essere fatturate solo al mittente o a terzi.
• Non è possibile spedire un singolo collo di peso inferiore a 68 kg o 151 libbre con una spedizione International Priority DirectDistribution Freight.
• Dati relativi a dimensioni e peso di colli piccoli che non superino le attuali limitazioni relative a dimensioni e peso di FedEx Express, FedEx Ground e FedEx Home Delivery all'interno degli Stati Uniti.
• Il pagamento in contrassegno non è disponibile con la Consolidation API di FedEx.
• È possibile selezionare una sola valuta per il valore doganale dell'intera transazione. Dopo l'apertura della spedizione consolidata FedEx, la valuta selezionata per il primo collo della spedizione verrà propagata agli altri colli del consolidamento.
• Se spedite i pacchi utilizzando FedEx Ground o FedEx Home Delivery, dovete inserire le misure in libbre (LB) e pollici (IN).