NOTE: - FedEx Account number is required for FedEx International Connect Plus (FICP) service shipments from APAC to US or PR with duty & tax Bill-to recipient:
- If any of the shipment commodities’ Country of Manufacture is CN/HK
Questa API consente di creare una spedizione aperta e di aggiungere colli in un lasso di tempo, piuttosto che inserire tutte le informazioni sulla spedizione e sui colli in una sola volta. La spedizione rimane aperta per un periodo di cinque giorni dopo la data di spedizione, durante i quali è possibile aggiungere e modificare i colli. Dopo che la spedizione è confermata, si possono generare i documenti di spedizione come etichette, AWB o rapporti. Alla fine del quinto giorno, la spedizione dovrà essere confermata, altrimenti verrà rimossa.
Nota: le spedizioni aperte vengono rimosse se non confermate entro la fine del quinto giorno dalla data di spedizione.
L'API spedizione aperta è utile quanto volete aggiungere a una spedizione vari colli durante un lasso di tempo, non siete sicuri di quanti colli andrete ad aggiungere o quando la completerete. Vi offre la flessibilità di preparare la spedizione nel corso della giornata finché non sarete pronti per spedire.
Le spedizioni create utilizzando questa APi sono spesso composte da più colli, ma possono contenere anche un solo collo.
Per spedire una spedizione multicollo a un singolo destinatario, utilizzate l'API spedizione aperta e aggiungete alla spedizione i singoli colli o più colli.
Di seguito vengono descritti i servizi associati all'API.
Di seguito vengono descritte le funzioni associate all'API.
Gestisci spedizioni aperte
Questa funzione permette ai mittenti di creare, modificare e annullare spedizioni aperte, oltre a recuperare le spedizioni aperte già create per scopi di revisione o verifica. Consente di confermare la spedizione completata per trasferire i dati della spedizione a FedEx e generare i documenti di spedizione appropriati. Inoltre, identifica e segnala eventuali errori nella transazione e fornisce lo stato appropriato.
Le informazioni chiave di questa funzione sono accountNumber, Shipment Data, groupPackageCount, index per indicare il pacco principale nella spedizione. La funzione fa in modo che i dati della spedizione vengano caricati nei sistemi FedEx e che vengano generati i numeri di monitoraggio, le etichette e i rapporti della spedizione.
Gestisci colli della spedizione aperta
Questa funzione consente di aggiungere, modificare e annullare i colli nella spedizione aperta già creata. Potete inoltre recuperare i colli esistenti in una spedizione aperta.
Ottieni risultati della spedizione aperta (asincrono)
Questa funzione consente di recuperare i risultati della spedizione confermata in modo asincrono. Quando una spedizione aperta con 40 o più colli viene confermata, l'API la elabora in modo asincrono.
Quando la spedizione viene elaborata in modo asincrono, la risposta conferma unicamente che la richiesta è stata inserita con successo, ma la spedizione stessa potrebbe non essere stata elaborata adeguatamente. La risposta restituisce il jobId per recuperare il risultato in seguito. Questa funzione utilizza il jobId per recuperare i risultati della Spedizione Aperta (CREA, MODIFICA E CONFERMA), che potrebbero essere etichette e report di spedizione. Inoltre, identifica e segnala eventuali errori nella spedizione e fornisce lo stato appropriato.
Nota: se ci sono errori nella risposta della spedizione asincrona, correggeteli e presentate una nuova richiesta di spedizione.
Questa sezione descrive in dettaglio il flusso di lavoro dell'API spedizione aperta. Il flusso di lavoro è gestito in due modi o utilizzando due opzioni di elaborazione.
Flusso di lavoro per 40 colli o meno
Conferma spedizione aperta è l'ultimo endpoint di questo flusso che convalida le informazioni sulla spedizione e sui colli e genera le etichette e tutti gli altri rapporti della spedizione. Fornisce inoltre i dettagli degli errori restituiti durante la convalida. Gli errori possono essere corretti utilizzando gli endpoint Modifica spedizione aperta o Modifica colli della spedizione aperta e confermando nuovamente la spedizione.
Flusso di lavoro per più di 40 colli
Ottieni risultati della spedizione aperta è l'ultimo endpoint di questo flusso che recupera i risultati della spedizione aperta confermata, come le etichette e tutti gli altri rapporti della spedizione aperta confermata. Se la risposta indica degli errori, questi vanno corretti utilizzando gli endpoint Modifica spedizione aperta o Modifica colli della spedizione aperta dopodiché è necessario confermare la spedizione utilizzando l'endpoint Conferma spedizione aperta e utilizzare l'endpoint Ottieni risultati della spedizione aperta per recuperare i risultati confermati della spedizione aperta.
Di seguito vengono descritte le funzioni associate all'API.
Crea spedizione aperta
Utilizzate questo endpoint per creare una spedizione aperta con le informazioni richieste in merito alla spedizione e per definire almeno un collo.
Di seguito sono riportate le informazioni di input necessarie per creare una spedizione aperta.
Qualora alla richiesta venga data una risposta positiva, questa elabora la spedizione e genera il numero di monitoraggio, che è il numero di monitoraggio principale del primo collo. La risposta non genera le etichette.
Aggiungi colli alla spedizione aperta
Utilizzate questo endpoint per aggiungere uno o più colli alla spedizione aperta esistente prima di confermarla. Potete inviare una richiesta separata per ogni collo via via che preparate la spedizione nel corso della giornata. Con questa richiesta potete inoltre aggiungere più colli.
Nota: il numero totale di colli non deve superare il limite di colli della spedizione aperta.
Di seguito sono riportate le informazioni di input necessarie per aggiungere colli alla spedizione aperta.
Qualora alla richiesta venga data una risposta positiva, questa genera il numero di monitoraggio del collo aggiunto.
Modifica colli della spedizione aperta
Utilizzate questo endpoint per modificare uno o più colli della spedizione aperta esistente prima di confermarla. Potete modificare anche il collo principale, che è il primo collo aggiunto alla spedizione aperta.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Nota: quando inserite valori decimali per lunghezza, larghezza o altezza nei Web Services, solo la parte intera viene utilizzata per il calcolo delle tariffe. Ad esempio, se inserite 9,4, il sistema userà 9 nel calcolo.
Qualora alla richiesta venga data una risposta positiva, questa aggiorna i colli in questione e restituisce i dettagli della spedizione aggiornati.
Elimina colli dalla spedizione aperta
Utilizzate questo endpoint per eliminare uno o più colli dalla spedizione aperta già creata prima di confermarla.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa elimina i colli in questione e nell'output restituisce lo stato dell'elemento deletedPackagesFromOpenshipment come true.
Nota: se il collo principale viene eliminato, il successivo collo in sequenza diventa il collo principale, al quale viene riassegnato il numero di monitoraggio principale, pertanto la sequenza dei numeri diminuisce in base al numero dei colli eliminati.
Recupera collo dalla spedizione aperta
Utilizzate questo endpoint per recuperare uno o più colli dalla spedizione aperta già creata per scopi di revisione o verifica.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa recupera i colli in questione.
Modifica spedizione aperta
Utilizzate questo endpoint per modificare una spedizione aperta con le informazioni richieste prima di confermarla.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa aggiorna i dettagli della spedizione aperta già creata e nell'output restituisce il numero di monitoraggio dei colli modificati e i dettagli modificati della spedizione.
Recupera spedizione aperta
Utilizzate questo endpoint per recuperare la spedizione aperta già creata per scopi di revisione o verifica.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa recupera la spedizione aperta in questione.
Elimina spedizione aperta
Utilizzate questo endpoint per eliminare la spedizione aperta prima di confermarla.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa elimina la spedizione aperta e tutti i colli associati e nell'output restituisce lo stato dell'elemento deletedOpenshipment come true.
Conferma spedizione aperta
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.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva per 40 colli o meno, questa carica i dati della spedizione nei sistemi FedEx e genera le etichette dei colli e tutti gli altri rapporti della spedizione.
Qualora alla richiesta venga data una risposta positiva per più di 40 colli, questa conferma che la richiesta è accodata e restituire il jobId per recuperare i risultati in seguito.
Nota: nella spedizione aperta deve essere incluso almeno un collo prima di poterla confermare.
Ottieni risultati della spedizione aperta
Utilizzate questo endpoint per ottenere i dati della spedizione aperta confermata. Questo endpoint va utilizzato unicamente quando la spedizione contiene più di 40 colli e il jobId viene restituito nella conferma.
Di seguito sono riportate le informazioni di input necessarie associate a questa richiesta:
Qualora alla richiesta venga data una risposta positiva, questa restituisce i risultati della spedizione aperta confermata come le etichette dei colli e tutti gli altri rapporti della spedizione. Se la risposta indica degli errori, questi vanno corretti utilizzando gli endpoint Modifica spedizione aperta o Modifica colli della spedizione aperta dopodiché è necessario confermare la spedizione utilizzando l'endpoint Conferma spedizione aperta e utilizzare l'endpoint Ottieni risultati della spedizione aperta per recuperare i risultati confermati della spedizione aperta.
Una spedizione aperta multicollo comprende due o più colli spediti agli stessi indirizzi di destinatario. Il primo collo nella richiesta di spedizione è considerato il collo principale.
Per creare una spedizione multicollo effettuate la seguente procedura.
Dopo la conferma della spedizione, viene utilizzata una delle seguenti opzioni di elaborazione.
Elaborazione sincrona della spedizione
L'elaborazione sincrona è un metodo di elaborazione ottimale, che viene utilizzato internamente quando una spedizione contiene 40 colli o meno (numero totale di colli/groupPackagecount<=40) con una quantità limitata di merci.
Le richieste di spedizione con 40 colli o meno saranno elaborate sincronicamente e le etichette e altri documenti/rapporti di spedizione saranno generati all'istante. Questo processo è ottimale se il mittente ha fretta e le etichette devono essere stampate immediatamente dopo la conferma della spedizione.
Nota: il limite massimo di 40 colli è indicativo, non è un limite fisso. Il limite dipende anche dalla combinazione di colli e merci nella spedizione. Per maggiori informazioni, contattate il Servizio Clienti FedEx locale.
Esempio: se la richiesta di spedizione aperta contiene 10 colli, una volta confermata, dopo aver aggiunto 10 colli, sarà elaborata in modalità sincrona. Nella risposta verranno create 10 etichette, e verranno forniti gli URL delle etichette o le etichette codificate come richiesto.
Il seguente flusso di lavoro di alto livello mostra l'elaborazione sincrona della spedizione aperta.
Nota:
Elaborazione asincrona della spedizione
L'API elabora internamente la spedizione in modo asincrono quando il numero totale dei colli supera i 40 (ossia totalPackageCount>40). È il metodo ideale quando il volume dei colli è elevato e desiderate inviare periodicamente spedizioni in blocco. L'invio di spedizioni in blocco utilizza diverse risorse e operazioni FedEx costose, quando viene effettuato in una sola volta. Con questa opzione di elaborazione, FedEx assicura internamente che le spedizioni in blocco vengano elaborate facilmente, e voi potete ottenere i dati delle etichette periodicamente.
Quando la spedizione viene elaborata in modo asincrono, la risposta conferma unicamente che la richiesta è stata accodata con successo, ma la spedizione stessa potrebbe non essere elaborata adeguatamente nonché restituire il jobId per recuperare il risultato in seguito.
Nota: questo processo richiede un po' di tempo perché la spedizione venga elaborata con successo prima di recuperare il risultato.
Per recuperare il risultato della spedizione asincrona, utilizzate l'endpoint Ottieni risultati della spedizione aperta e fornite i dettagli di jobId e accountNumber nella richiesta. La risposta a questa richiesta restituirà i dati del risultato della spedizione con i dettagli dell'etichetta o i dettagli dell'errore nella spedizione.
Esempio: se la spedizione contiene 45 colli, una volta confermata sarà elaborata in modalità asincrona. Nella risposta verrà restituito un jobId. Utilizzate quindi l'endpointOttieni risultati della spedizione aperta per recuperare i risultati della spedizione e i dati dell'etichetta.
Il seguente flusso di lavoro di alto livello mostra l'elaborazione asincrona della spedizione.
Nota:
Print As You Go (PASGO)
La funzione Print as You Go (PASGO) consente di creare e aggiungere colli alle spedizioni aperte multicollo PASGO, permettendovi di stampare le etichette immediatamente man mano che aggiungete ogni collo. Ciò significa che potete stampare le etichette man mano, senza aspettare che la spedizione venga chiusa.
Note
L'API FedEx supporta un'ampia gamma di etichette, tra cui tre opzioni principali, ossia etichette termiche, di carta comune e personalizzabili. È possibile utilizzare gli endpoint dell'API spedizione per produrre un'ampia varietà di etichette.
FedEx offre 2 formati di etichette per supportare i servizi di spedizione:
etichette termine;
L'API FedEx consente di stampare etichette per qualsiasi tipologia di spedizione, come FedEx Express®, FedEx Ground® e FedEx International Ground®, utilizzando varie stampanti per etichette termiche.
L'API supporta etichette termiche con le seguenti dimensioni.
I tipi di etichette 10 x 21,6 cm e 10 x 25,4 cm includono una scheda doc aggiunta con codici a barre identici. Un codice a barre viene visualizzato sull'etichetta principale e l'altro sulla scheda doc. Questo valore del tipo di stock di etichette è utile per i pacchi di pneumatici poiché è possibile posizionare un'etichetta sul battistrada del pneumatico e l'etichetta della scheda documento aggiuntiva con una copia duplicata del codice a barre e le istruzioni operative per il fianco del pneumatico. L'uso di questi tipi di stock di etichette riduce le rietichettature degli pneumatici e le scansioni dimensionali aumentate ottimizzano il recupero. Per maggiori informazioni sul materiale delle etichette, consultate la sezione Tipi di materiale per etichette.
Nota: la doc-tab è una linguetta adesiva rimovibile con informazioni di spedizione aggiuntive che possono essere selezionate per un materiale, mentre si stampano le etichette di spedizione utilizzando una stampante termica.
Elementi delle etichette termiche
Le etichette termiche contengono i seguenti tre elementi principali.
Informazioni chiave per generare un'etichetta termica
Di seguito sono riportate le informazioni chiave necessarie per generare un'etichetta termica.
Valori validi:
ImageType: necessario per formattare l'etichetta termica per la stampante utilizzata; fornisce il tipo di flusso di dati o bitmap da restituire
Valori validi:
Nota: tutte le etichette necessarie per una spedizione sono generate e restituite in un unico buffer.
Stampanti termiche supportate
Con l'API FedEx si raccomanda l'uso delle seguenti stampanti termiche.
Nota: queste stampanti sono tutte compatibili con la modalità pagina ASCII Eltron Programming Language (EPL2). Le stampanti termiche sono supportate sia come scrittura diretta sulla stampante collegata a una porta seriale del sistema, sia come stampante nativa installata in Windows per connessioni LPT, seriali o USB. Le versioni del firmware delle stampanti fornite da FedEx possono variare in base alla regione.
Numero di etichette termiche stampate per servizio
La seguente tabella indica il numero di ogni tipo di etichetta necessaria per uno specifico servizio speciale. Tutte le etichette necessarie vengono generate da una call al FedEx Common Label Server (CLS), e questo restituisce un unico buffer a eccezione delle etichette C.O.D. Return.
Numero di etichette termiche stampate per servizio negli USA
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
FedEx Express U.S. |
1 etichetta di spedizione |
FedEx Ground U.S. / FedEx Home Delivery |
1 etichetta di spedizione |
Numero di etichette termiche stampate per servizio internazionale di esportazione negli USA
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
FedEx Express U.S. Export International |
1 etichetta di spedizione 2 etichette destinatario |
Opzione FedEx Express U.S. Export International Broker Select |
1 etichetta di spedizione 2 etichette destinatario |
FedEx Ground U.S. Export International |
1 etichetta di spedizione |
FedEx Ground U.S. Export International C.O.D. |
1 etichetta di spedizione 2 etichette C.O.D. Lettera di Vettura ritorno |
Numero di etichette termiche stampate per servizio nazionale in Canada
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
FedEx Express intra-Canada |
Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione |
FedEx Ground intra-Canada |
1 etichetta di spedizione |
FedEx Ground intra-Canada C.O.D. |
1 etichetta di spedizione 2 etichette C.O.D. Lettera di Vettura ritorno |
Numero di etichette termiche stampate per servizio internazionale di esportazione in Canada
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
FedEx Express Canada Export International |
Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Express Canada Export International Broker Select |
Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Ground Canada (CA) Export International |
1 etichetta di spedizione |
Numero di etichette termiche stampate per spedizioni in entrata in Filippine e Thailandia
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
Spedizioni in entrata nelle Filippine |
2 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato 3 copie della fattura commerciale |
Spedizioni di merci in entrata in Thailandia |
3 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato |
Spedizioni di documenti in entrata in Thailandia |
2 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato |
Doc-tab
Se stampate etichette di spedizione usando una stampante termica, potete scegliere un lotto di etichette che include una doc-tab, ovvero una linguetta adesiva rimovibile con informazioni di spedizione aggiuntive. Potete configurare queste informazioni di spedizione utilizzando vostri dati di spedizione o scegliere di stampare dati configurabili specifici per le vostre esigenze di spedizione.
etichette laser.
L'API FedEx supporta la stampa di etichette con stampante laser. Queste etichette vengono solitamente stampate su carta U.S. Letter o A4 e piegate a metà per essere inserite nella busta standard per etichette FedEx. Le etichette stampate con una stampante laser vengono generate in formato PDF e non necessitano di essere scalate o ridimensionate. Per maggiori informazioni sul materiale delle etichette, consultate la sezione Tipi di materiale per etichette.
Prerequisiti
Alle etichette PDF si applicano i seguenti requisiti.
L'opzione etichetta PDF elimina la necessità di specificare il parametro di orientamento dell'immagine (larghezza e altezza) o la risoluzione dello schermo per visualizzare correttamente l'etichetta nel browser.
Elementi delle etichette laser
Le etichette laser contengono i seguenti tre elementi principali.
Informazioni chiave per generare un'etichetta laser
Per generare un'etichetta laser sono necessari i seguenti elementi dell'API FedEx.
Valori validi:
Nota: se richiedete un'etichetta in carta comune, i dati restituiti sono un'immagine di etichetta codificata Base64, che deve essere decodificata Base64 prima di visualizzare il file dell'etichetta.
Stampanti laser supportate
Per questo tipo di etichetta è supportata la maggior parte delle stampanti laser, tuttavia le etichette non saranno accettate se stampate su una stampante a getto d'inchiostro.Nota: se utilizzate una stampante laser a colori, la definizione del colore deve essere impostata sul nero, anche se nella stampante è presente solo una cartuccia nera.
Numero di etichette laser stampate per servizio
La seguente tabella indica il numero di ogni tipo di etichetta necessaria per uno specifico servizio speciale. Tutte le etichette necessarie vengono generate da una call al FedEx Common Label Server (CLS), e questo restituisce un unico buffer a eccezione delle etichette C.O.D. Return.
Numero di etichette laser stampate per servizio negli USA
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Ground / FedEx Home Delivery U.S. |
1 etichetta di spedizione |
Numero di etichette laser stampate per servizio internazionale di esportazione negli USA
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Express U.S. Export International |
1 etichetta di spedizione nella risposta; è necessario stampare minimo 3 etichette: 1 sul collo e 2 nella busta dei documenti |
FedEx Express U.S. Export International Broker Select |
1 etichetta di spedizione nella risposta; è necessario stampare minimo 3 etichette: 1 sul collo e 2 nella busta dei documenti |
FedEx Ground U.S. Export International |
1 etichetta di spedizione |
FedEx Ground U.S. Export International C.O.D. |
1 etichetta di spedizione 2 etichette C.O.D. Lettera di Vettura ritorno |
Numero di etichette laser stampate per servizio nazionale in Messico
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Express Intra-Mexico |
FedEx Express Intra-Mexico Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione |
Numero di etichette laser stampate per servizio nazionale in Canada
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Express Intra-Canada |
FedEx Express Intra-Canada Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione |
FedEx Ground Intra-Canada |
1 etichetta di spedizione |
FedEx Ground Intra-Canada C.O.D. |
1 etichetta di spedizione 2 etichette C.O.D. Lettera di Vettura ritorno |
Numero di etichette laser stampate per servizio internazionale di esportazione in Canada
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Express Canada Export International |
FedEx Express Canada Export International Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Express Canada Export International Broker Select |
FedEx Express Canada Export International Broker Select Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Ground Canada (CA) Export International |
1 etichetta di spedizione |
Numero di etichette laser stampate per servizio internazionale di esportazione in Canada
Tipo di servizio |
Etichetta laser - Formato PDF |
FedEx Express Canada Export International |
FedEx Express Canada Export International Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Express Canada Export International Broker Select |
FedEx Express Canada Export International Broker Select Spedizione non contenente sostanze pericolose/ghiaccio secco: 1 etichetta di spedizione 2 etichette destinatario |
FedEx Ground Canada (CA) Export International |
1 etichetta di spedizione |
Numero di etichette laser stampate per spedizioni in entrata in Filippine e Thailandia
Tipo di servizio |
Etichette termiche (FedEx CLS restituisce il numero appropriato di etichette nella risposta) |
Spedizioni in entrata nelle Filippine |
2 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato 3 copie della fattura commerciale |
Spedizioni di merci in entrata in Thailandia |
3 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato |
Spedizioni di documenti in entrata in Thailandia |
2 etichette di spedizione con codice cliente stampato 1 etichetta destinatario senza codice cliente stampato |
Etichetta personalizzata
FedEx consente di personalizzare l'etichetta generata da FedEx. Potete aggiungere del testo relativo alla vostra attività e scegliere il tipo di codice a barre (simbologia) utilizzato sui documenti e sulle etichette FedEx nella parte personalizzata delle etichette termiche.
Per supportare la vostra applicazione di spedizione, l'API FedEx spedizione aperta fornisce due opzioni per personalizzare l'etichetta di spedizione.
Nota: il contenuto leggibile a occhio e il codice a barre nella parte comune dell'etichetta non possono essere modificati.
Etichetta di convalida personalizzata
Potete creare etichette personalizzate non di spedizione sia a livello di collo che di spedizione, specificando le informazioni personalizzate che desiderate, la loro formattazione e la loro posizione sull'etichetta personalizzata. Le etichette personalizzate possono essere generate solo in formato termico.
Personalizzare un'etichetta termica
L'API FedEx fornisce due formati di etichette termiche che potete personalizzare con un file grafico o di testo per evitare di creare un'etichetta personalizzata. Queste etichette supportano tutti i servizi di spedizione FedEx. I formati sono i seguenti:
Questi tipi di etichette forniscono una sezione personalizzabile di 5 cm. Questa caratteristica vale per l'etichetta termica stampata su una stampante termica impostata a 203 o 300 DPI.
Regole per etichette personalizzate
Le regole sull'utilizzo dei formati delle etichette sono le seguenti.
Nota: si possono aggiungere solo immagini a colori a singolo bit poiché le etichette verranno stampate in bianco e nero.
Elementi di inserimento grafica per etichette personalizzate
L'API fornisce immagini PNG (Portable Network Graphic) per le etichette FedEx Express e FedEx Ground. La grafica dell'etichetta PNG è una replica delle etichette termiche o in carta comune supportate dall'API. Questa opzione vi permette di collocare la grafica dell'etichetta PNG sul vostro materiale per evitare di creare un'etichetta personalizzata.
Quando utilizzate la grafica PNG 10,16 x 15,24 cm incorporata nel vostro documento di spedizione, si applicano i seguenti requisiti
Materiale dell'etichetta
Le etichette PNG 4" x 6" (10,16 x 15,24 cm) vanno utilizzate unicamente con materiale peel-and-stick. I team di convalida etichette FedEx Ground e FedEx Express rifiuteranno le etichette PNG 4" x 6" (10,16 x 15,24 cm) non presentate su materiale peel-and-stick, comprese le etichette stampate su carta comune.
Stampante
Si raccomandano stampanti laser per stampare le etichette. Va evitato l'uso di stampanti a getto d'inchiostro poiché mancano di coerenza nella creazione di codici a barre scansionabili. L'etichetta PNG 10,16 x 15,24 cm non può essere stampata utilizzando una stampante a colori, a meno che la definizione del colore sia impostata sul nero, anche se nella stampante è presente solo una cartuccia nera. Tale impostazione è necessaria per ottenere la corretta definizione del codice a barre per la scansione negli hub FedEx.
Scalatura
L'immagine restituita nella transazione di spedizione è di 200 punti per pollice (DPI) e misura 10,16 cm lunghezza x 15,24 cm altezza o 800 x 1200 pixel. Questa etichetta ha un orientamento verticale ed è progettata per essere stampata in un'area di 10,16 x 15,24 cm. Una volta stampata, l'etichetta dovrebbe misurare 10,16 x 15,24 cm.
Per produrre l'etichetta e i codici a barre nei DPI richiesti, è necessario scalare (o ridimensionare) l'immagine prima della stampa. Il modo in cui scalare l'immagine dipende dall'applicazione utilizzata per visualizzare e stampare l'etichetta. Per scalare l'immagine PNG per un'etichetta 10,16 x 15,24 cm, esattamente 10,16 cm di larghezza e 15,24 cm di lunghezza.
Checklist per il controllo delle etichette
Tutti i codici a barre
Per la convalida è richiesto quanto segue.
Qualità della stampa
Di seguito vengono elencanti i problemi più comuni che causano il rifiuto delle etichette.
Dettagli leggibili a occhio per le etichette Ground
Per la lettura a occhio nelle etichette FedEx Ground, è necessario verificare i seguenti elementi.
Dettagli leggibili a occhio per le etichette Express
Per ottenere la convalida, sull'etichetta devono essere stampati gli elementi elencati di seguito.
All'API spedizione aperta si applicano le seguenti regole.
Response