Convalida API
La convalida è una fase obbligatoria per alcune API prima che possano essere utilizzate nell'ambiente di produzione FedEx. Il processo determina se la vostra implementazione soddisfa un certo numero di requisiti per ottenere il funzionamento sicuro ed efficiente della soluzione nell'ambiente di produzione FedEx. A seconda dell'API, potrebbero essere necessari diversi livelli di revisione.
Convalida dell'etichetta
La convalida dell'etichetta di spedizione è un processo più avanzato per alcune API in cui la compliance delle etichette generate dall'ambiente di test è valutata da un apposito team FedEx.
API che non richiedono la convalida:
API Authorization
FedEx Locations Search API
Postal Code Validation API
Rate and Transit Times API
Service Availability API
Visibilità integrata di base
Address Validation API
Ground End of Day Close API
Pickup Request API
Freight LTL API
Trade Documents Upload API
API che richiedono la convalida dell'etichetta di spedizione:
Open Ship API
Ship API
Consolidation API
Procedura di convalida dell'etichetta di spedizione per Stati Uniti, Canada e Asia Pacifico
Una volta terminato lo sviluppo della vostra applicazione con accesso web, dovrete completare la fase di test utilizzando le credenziali di prova (codici cliente di prova, Chiave API e Chiave Segreta). La vostra Chiave API e la Chiave Segreta verranno mostrate nella pagina di Riepilogo Progetto e saranno consultabili in qualsiasi momento.
Generate le etichette di prova nell'ambiente di prova FedEx associato all'applicazione, quindi inviatele al team FedEx addetto alla valutazione per ottenere l'approvazione.
Nota: il gruppo di Analisi del codice a barre necessita di tre giorni lavorativi per la valutazione delle etichette.
Per evitare ritardi nel processo, vi invitiamo a seguire le seguenti best practice:
- Le etichette devono essere stampate e scansionate con una risoluzione di almeno 600 DPI. NON INVIATE immagini restituite direttamente dall'API.
- Per le stampanti termiche, il tipo di immagine dell'etichetta deve essere richiesto in base al modello della stampante. Ad esempio: ZPLII per le stampanti Zebra (i tipi di immagine PNG e PDF sono progettati solo per la stampa laser).
- Quando create le etichette campione per la valutazione, utilizzate gli indirizzi del mittente/destinatario. Create etichette campione esclusivamente per i servizi specifici per cui si fa richiesta.
- L'etichetta FedEx® Collect on Delivery (C.O.D.) deve includere anche l'etichetta di reso C.O.D. corrispondente.
- Le spedizioni FedEx International Express® devono includere anche l'etichetta della Lettera di Vettura Aerea aggiuntiva/secondaria.
- Le spedizioni multicollo devono includere un'etichetta per ciascun collo nella spedizione.
- Inviate un'email con il documento scansionato e il Frontespizio dell'Etichetta a: label@fedex.com
- Le etichette cartacee vanno inviate all'indirizzo seguente:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Nota: se non presentano difetti visibili (ad esempio linee che attraversano il codice a barre, macchie di inchiostro o danni fisici di altro tipo), le etichette scansionate passeranno l'ispezione e verranno approvate.
In caso di invio di etichette per email, occorre prestare attenzione alla qualità della stampa e all'eventuale allargamento/restringimento accidentale delle etichette (ad es. ridimensionamento in scala). Questi sono i due motivi principali per cui le etichette non superano il processo di valutazione.
Dopo il test con le API FedEx, dovrete avviare il processo di convalida spostando il progetto in produzione nel FedEx Developer Portal. Una volta completata questa operazione, vedrete la Chiave API e la Chiave segreta di produzione. La Chiave segreta di produzione verrà visualizzata una sola volta, ma potrete rigenerarla in un secondo momento.
Aggiungete un Codice Cliente di produzione all'organizzazione e assegnatelo al progetto. Attivate le API che volete usare nel progetto. Una volta fatto, riceverete l'ID client di produzione che potete includere nella cover di richiesta dell'etichetta.
Compilate per intero la Cover dell'etichetta con le informazioni di contatto e i servizi che desiderate implementare. Includete inoltre il vostro codice cliente e la chiave di produzione.
Il gruppo di analisi del codice a barre valuterà le etichette di prova presentate, approvandole o rifiutandole. Verrete contattati da parte del gruppo riguardo il superamento o meno della valutazione. Se le etichette sono approvate, proseguirete con lo step successivo. In caso contrario, dovrete correggere le etichette come indicato e ripresentarle per una nuova valutazione.
Una volta che le etichette di prova ottengono l'approvazione per la produzione, il gruppo di analisi del codice a barre autorizzerà le credenziali di produzione a trasmettere la transazione con l'etichetta di spedizione identificata e invierà una notifica via email dell'avvenuta convalida.
Nota: L'approvazione è su base progettuale.
Sostituite l'URL e le credenziali di prova con quelle di produzione.
Procedura di convalida dell'etichetta di spedizione per ogni altro Paese/territorio
Argentina (AR) |
0.810.DE.FEDEX (0.810.3333339) |
Belize (BZ) |
501.223.1577 |
Bolivia (BO) |
591.2.212.0000 |
Brasile (BR) |
Chiamata in portoghese: 0.810.DE.FEDEX (0.810.3333339)
|
Cile (CL) |
56.22361.6000 |
Colombia (CO) |
57.1.291.01.00 |
Costa Rica (CR) |
800.GO.FEDEX (800.46.33339) |
Dominica (DM) |
767.448.0992 |
Repubblica Dominicana (DO) |
809.565.3636 |
Ecuador (EC) |
02.394.8430 |
El Salvador (SV) |
503.2250.8800 |
Guiana francese (GF) |
594.37.93.96 |
Grenada (GD) |
473.440.2206 |
Guatemala (GT) |
1.801.00.FEDEX o 2411.2100 |
Guyana (GY) |
592.227.6976 / 9 o 592.227.6975 |
Honduras (HN) |
504.2221.2010 |
Messico (MX) |
55.5228.9904 |
Nicaragua (NI) |
505.2264.8500 |
Panama (PA) |
507.271.3838 |
Paraguay (PY) |
595.21.616.6100 |
Perù (PE) |
511.517.1600 |
Suriname (SR) |
597.494290 / 495254 |
Uruguay (UY) |
598.2628.0100 |
Venezuela (VE) |
0.800.DE.FEDEX (0.800.33.333.39) |
Anguilla (AI) |
264.497.3575 |
Antigua e Barbuda (AG) |
268.462.4858 / 4 |
Aruba (AW) |
297.582.9039 |
Bahamas (BS) |
242.322.5656 o 242.677.1950 |
Barbados (BB) |
1.800.GO.FEDEX (1.800.463.3339) |
Bermuda (BM) |
441.295.3854 |
Isole Vergini Britanniche (VG) (Tortola e Virgin Gorda) |
1.800.GO.FEDEX (1.800.463.3339) |
Caraibi olandesi: Bonaire, Saba, Sint Eustatius (BQ) |
5999.737.3000 |
Isole Cayman (KY) |
1.800.GO.FEDEX (1.800.463.3339) |
Curaçao (CW) |
5999.737.3000 |
Guadalupa e St. Barthélemy (GP) |
0590.26.85.44 |
Haiti (HT) |
509.3702.2348 |
Giamaica (JM) |
1.888.GO.FEDEX (1.888.463.3339) |
Martinica (MQ) |
596.42.41.00 |
Montserrat (MS) |
664.491.2714 |
Porto Rico (PR) |
1.800.GO.FEDEX (1.800.463.3339) |
St. Martin (controllo francese) (MF) |
5999.737.3000 |
St. Maarten (controllo olandese) (SX) |
5999.737.3000 |
St Kitts e Nevis (KN) |
869.465.1305 / 4155 |
St Lucia (LC) |
758.452.1320 / 1388 |
St Vincent (VC) |
784.456.1649 |
Trinidad e Tobago (TT) |
1.800.GO.FEDEX (1.800.463.3339) |
Turks e Caicos (TC) |
649.946.4682 |
Isole Vergini Americane (St. Croix, St. John e St. Thomas) (VI) |
1.800.GO.FEDEX (1.800.463.3339) |
Clienti Proprietary: convalida dell'etichetta
La convalida dell'etichetta di spedizione rappresenta una procedura più complessa per determinate API. Seguite le indicazioni del vostro rappresentante CT e/o inviate un'email con le etichette di prova e le informazioni di contatto corrette. Elencate inoltre le API che intendete adottare. Includete il Codice Cliente e la chiave di produzione.
Fornitori di terze parti: convalida della soluzione
Per spostare il vostro progetto di API FedEx in produzione e distribuire l'integrazione FedEx ai clienti, è necessaria la convalida di FedEx. Completate il Frontespizio di convalida dell'integratore (ricevuto per email) e inviatelo all'indirizzo validationmtp@fedex.com includendo tutte le richieste necessarie per la convalida della soluzione.
La convalida è una fase obbligatoria per alcune API prima che possano essere utilizzate nell'ambiente di produzione FedEx. Il processo determina se la vostra implementazione soddisfa un certo numero di requisiti per ottenere il funzionamento sicuro ed efficiente della soluzione nell'ambiente di produzione FedEx. A seconda dell'API, potrebbero essere necessari diversi livelli di revisione.
