Creare etichette per pacchi con FileMaker e l'API DHL
La connessione di FileMaker all'API REST di DHL consente la creazione automatica di etichette per pacchi per la spedizione. In questa guida, passo dopo passo, imparerete a programmare FileMaker in modo che la vostra soluzione FileMaker comunichi con l'API REST di DHL per richiedere e scaricare le etichette dei pacchi.
L'API DHL può essere utilizzata per automatizzare un'ampia gamma di processi di spedizione e tracciamento. Oltre a creare etichette per i pacchi (etichette di spedizione), gli utenti possono automatizzare il tracciamento per monitorare lo stato dei loro pacchi in tempo reale. L'API consente anche di creare etichette di reso per semplificare le restituzioni ai clienti. Inoltre, i documenti di spedizione importanti, come le dichiarazioni doganali per le spedizioni internazionali, possono essere creati direttamente e integrati nel processo di spedizione. Inoltre, è possibile dare priorità alle spedizioni o aggiungere alcune opzioni di spedizione come il contrassegno o l'assicurazione. L'API DHL offre quindi una soluzione completa per ottimizzare l'intero processo di spedizione e integrarlo completamente in sistemi esistenti come FileMaker. In questa guida vi mostreremo come creare etichette per pacchi con l'API.
Quattro piattaforme ERP FileMaker con CRM e gestione delle merci per ottimizzare i processi operativi.
Richiesta di informazioni
Prerequisiti
- Un account cliente commerciale DHL con accesso all'API DHL Business Customer.
- I dati di accesso all'API REST di DHL, ossia la chiave API, il nome utente e la password.
- FileMaker Pro versione 16 o superiore, poiché queste versioni supportano in modo nativo le richieste HTTP richieste.
1. impostare l'account cliente DHL business e l'accesso API
Prima di poter integrare l'API DHL in FileMaker, è necessario accedere all'API DHL:
- Andate alla pagina del portale per sviluppatori DHL: Portale per gli sviluppatori DHL.
- Registratevi con il vostro account cliente commerciale.
- Richiedere i dati di accesso all'API (chiave API, nome utente, password).
- Verificate il vostro accesso e attivate il servizio "DHL Shipping API".
2. primi passi con l'API DHL
L'API DHL utilizza le richieste HTTP per inviare e ricevere dati. Le funzioni più importanti per la creazione di un'etichetta per pacchi sono
- AutenticazioneAutenticazione di base con nome utente e password.
- Creare un'etichetta (parcel label)Inviate i dati di spedizione e ricevete l'etichetta in formato PDF.
- Recupero dell'etichettaIl ritorno è in formato PDF binario, che può essere salvato e utilizzato in un campo contenitore in FileMaker.
3. Script FileMaker per l'accesso all'API DHL
FileMaker utilizza il comando Inserisci da URL in combinazione con le opzioni di cURL per inviare richieste HTTP all'API e ricevere risposte.
3.1 Preparare l'autenticazione
DHL utilizza l'autenticazione di base. In FileMaker, ciò si ottiene fornendo il nome utente e la password in formato Base64. Di seguito troverete un esempio di come preparare l'autenticazione:
Base64Encode("Nome utente:Password")
In FileMaker, è possibile inserire questa stringa direttamente nel campo Inserisci da URL-con le opzioni cURL corrispondenti.
3.2 Creare note di spedizione
L'API richiede alcune informazioni come l'indirizzo del mittente, l'indirizzo del destinatario, il peso, il metodo di spedizione, ecc. Di seguito è riportato un semplice esempio di richiesta all'API DHL per creare un'etichetta.
Script: Creare l'etichetta del pacco
- Aprite la finestra dell'area di lavoro dello script in FileMaker.
- Creare un nuovo script, ad esempio "Crea etichetta pacco".
- Aggiungere le seguenti variabili per salvare i dati di invio:
Impostare la variabile [ $url; valore: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Impostare la variabile [ $auth; Valore: "Base64Encode(username:password)" ]
Impostare la variabile [ $payload; Valore: "{'Version': '2.0', 'shipmentDetails': {...} }" ]
# Inserire qui i dati di spedizione in formato JSON
Esempio di richiesta JSON (payload) inviata a DHL:
{
"Versione: "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Spedizione": {
"Mittente": {
"Nome": "La tua azienda",
"Indirizzo": {
"StreetName": "Street",
"BuildingNumber": "1",
"Codice postale": "12345",
"Città": "città",
"Codice paese": "DE"
}
},
"Ricevitore": {
"nome": "destinatario",
"Indirizzo": {
"StreetName": "Via del destinatario",
"BuildingNumber": "10",
"Codice postale": "54321",
"Città": "città destinataria",
"Codice paese": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Metodo di spedizione (ad es. pacco nazionale)
"WeightInKG": "2.5", # Peso della confezione
"CustomerReference": "123456", numero di riferimento #
"Data di spedizione": "2023-09-01".
}
},
"LabelResponseType": "URL".
}
]
}
Utilizzare il Inserisci da URL-per inviare la richiesta a DHL e creare l'etichetta:
Inserisci da URL [ Selezione ; Destinazione: $response ; URL: $url ; Opzioni cURL:
"-X POST --header \"Authorisation: Basic " & $auth & "\"". &
"--header \"Content-Type: application/json\"" &
"--data " & $payload ]
3.3 Scaricare e salvare l'etichetta
L'etichetta creata viene restituita dall'API sotto forma di file PDF. È possibile salvarla in un campo contenitore di FileMaker.
- Inserite un campo contenitore nel vostro database FileMaker per salvare il file PDF.
- Modificare lo script in modo che il file PDF venga scaricato in questo campo contenitore:
Inserisci da URL [ Selezione ; Destinazione: campo Tabella::Contenitore ; URL: "response-PDF-URL" ]
Il campo response-PDF-URL viene restituito dall'API DHL dopo che l'etichetta è stata creata con successo e contiene l'URL in cui è possibile scaricare il PDF.
Corso accelerato di FileMaker
FileMaker veloce ed efficace
apprendimento in 20 capitoli.
Partecipare gratuitamente
4. creare il carico utile JSON con FileMaker
Di seguito è riportato uno script FileMaker che mostra come è possibile costruire il payload JSON con i dati dei campi FileMaker. In questo esempio, assumiamo che i campi del vostro database FileMaker contengano informazioni sul mittente, sul destinatario e sui dettagli della spedizione e chiamiamo la vostra tabella "Table" con i nomi dei campi corrispondenti, che dovrete adattare di conseguenza nella vostra soluzione FileMaker. La struttura JSON corrisponde a quella che si può inviare all'API DHL.
Esempio di script in FileMaker:
# Impostazione delle variabili per la struttura JSON
Impostare la variabile [ $jsonSender; Valore: JSONSetElement ("{}" ;
[ "Nome" ; Tabella::SenderCompany ; JSONString ] ;
[ "Address.StreetName" ; Tabella::SenderStreet ; JSONString ] ;
[ "Address.BuildingNumber" ; Tabella::SenderHouseNumber ; JSONString ] ;
[ "Address.PostalCode" ; Tabella::SenderPLZ ; JSONString ] ;
[ "Indirizzo.Città" ; Tabella::SenderCity ; JSONString ] ;
[ "Address.CountryCode" ; Table::SenderCountry ; JSONString ]
)]
Impostare la variabile [ $jsonReceiver; Valore: JSONSetElement ( "{}" ;
[ "Nome" ; Tabella::RecipientName ; JSONString ] ;
[ "Address.StreetName" ; Tabella::RecipientStreet ; JSONString ] ;
[ "Address.BuildingNumber" ; Tabella::RecipientHouseNumber ; JSONString ] ;
[ "Address.PostalCode" ; Tabella::RecipientPLZ ; JSONString ] ;
[ "Indirizzo.Città" ; Tabella::DestinatarioCittà ; JSONString ] ;
[ "Address.CountryCode" ; Table::RecipientCountry ; JSONString ]
)]
Impostare la variabile [ $jsonShippingDetails; Valore: JSONSetElement ( "{}" ;
[ "ProductCode" ; Tabella::ProductCode ; JSONString ] ;
[ "WeightInKG" ; Tabella::Peso spedizione ; JSONNumber ] ;
[ "CustomerReference" ; Table::ReferenceNumber ; JSONString ] ;
[ "ShipmentDate" ; Table::ShipmentDate ; JSONString ]
)]
# Struttura dell'intero documento JSON
Impostare la variabile [ $payload; Valore: JSONSetElement ( "{}" ;
[ "Versione" ; "2.0" ; JSONString ] ;
[ "ShipmentOrder[0].sequenceNumber" ; "1" ; JSONString ] ;
[ "ShipmentOrder[0].Shipment.Shipper" ; $jsonSender ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.Receiver" ; $jsonEmpfänger ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.ShipmentDetails" ; $jsonVersanddetails ; JSONObject ] ;
[ "ShipmentOrder[0].LabelResponseType" ; "URL" ; JSONString ]
)]
Il payload JSON generato viene salvato nella variabile $payload che si può usare come definizione della variabile $payload nello script Crea etichetta pacchetto di cui sopra.
ERP FileMaker personalizzabile con interfacce di gestione merci e logistica.
Ulteriori informazioni Domande frequenti su FileMaker e sull'API DHL
- Che cos'è l'interfaccia DHL e come si può integrare con FileMaker?
- L'interfaccia DHL consente l'invio automatico dei dati dei pacchi a DHL e il recupero delle etichette dei pacchi e dei dati di tracciamento della spedizione. In FileMaker, è possibile utilizzare questa interfaccia per automatizzare i processi di spedizione e generare etichette per i pacchi direttamente dal database.
- Quali sono i vantaggi dell'integrazione dell'interfaccia DHL in FileMaker?
- L'integrazione consente di risparmiare tempo e di evitare errori, poiché i dati di spedizione vengono trasferiti direttamente dal database di FileMaker a DHL. È inoltre possibile generare automaticamente etichette per i pacchi e integrare il tracciamento delle spedizioni nel sistema, aumentando così l'efficienza del processo di spedizione.
- Di quali informazioni ho bisogno per utilizzare l'interfaccia DHL in FileMaker?
- Sono necessari i dati di accesso all'API DHL (codice cliente, nome utente, password) e gli endpoint dell'API DHL. Queste informazioni vengono fornite da DHL dopo la registrazione per l'accesso all'interfaccia.
- Come posso generare etichette per pacchi tramite l'interfaccia DHL in FileMaker?
- Una volta inseriti in FileMaker i dati di spedizione, come l'indirizzo del destinatario, il peso e il metodo di spedizione, è possibile inviare queste informazioni all'interfaccia DHL tramite uno script API. In cambio, si riceve un numero di pacco e un'etichetta stampabile che può essere salvata in FileMaker o stampata direttamente.
- È possibile integrare il monitoraggio delle spedizioni in FileMaker?
- Sì, con l'interfaccia DHL è possibile recuperare il numero di tracking e salvarlo in FileMaker. È possibile utilizzare l'API per interrogare lo stato attuale di un pacco in tempo reale e visualizzare queste informazioni direttamente nel database.
- L'interfaccia DHL in FileMaker è adatta solo per le spedizioni nazionali?
- No, l'interfaccia DHL supporta sia le spedizioni nazionali che quelle internazionali. A seconda della destinazione e del tipo di spedizione, è possibile trasferire vari parametri all'API DHL in FileMaker per generare etichette e informazioni di spedizione per diversi Paesi.
- Quanto è sicuro l'uso dell'API DHL con FileMaker?
- La comunicazione con l'API DHL avviene tramite HTTPS, che garantisce una trasmissione sicura dei dati. In FileMaker, è necessario assicurarsi che i dati sensibili, come i dati di accesso all'API e le informazioni sui clienti, siano memorizzati e protetti in campi criptati.
- È possibile creare processi automatizzati per l'interfaccia DHL in FileMaker?
- Sì, è possibile creare script in FileMaker che inviano automaticamente i dati di spedizione a DHL, recuperano le etichette dei pacchi e aggiornano regolarmente il tracking della spedizione. Questi processi possono anche essere eseguiti su base programmata per consentire la completa automazione del processo di spedizione.
- Quali requisiti ha DHL per l'integrazione dell'interfaccia in FileMaker?
- DHL richiede che l'API sia implementata correttamente, compresa la conformità alle specifiche API descritte nella documentazione API di DHL. È inoltre necessario assicurarsi che l'applicazione venga rilasciata per l'uso produttivo dopo che DHL ne ha verificato l'implementazione.
- Cosa devo fare se si verifica un problema durante l'utilizzo dell'interfaccia DHL in FileMaker?
- Se si verificano problemi durante la comunicazione con l'API DHL, è necessario controllare innanzitutto le risposte alle richieste API in FileMaker. I codici di errore e i messaggi di DHL spesso forniscono informazioni dettagliate sul problema. Se le difficoltà persistono, è possibile consultare l'assistenza DHL o la documentazione tecnica dell'API per risolvere il problema.
Sintesi
Collegando FileMaker all'API REST di DHL, è possibile automatizzare in modo efficiente la creazione di etichette per pacchi. I passaggi più importanti sono riassunti di seguito:
- Richiedere e configurare i dati di accesso all'API.
- Creare script in FileMaker per inviare i dati di spedizione a DHL.
- Ricezione e salvataggio di etichette in formato PDF.
- Integrare la gestione degli errori per monitorare le risposte dell'API.
Questa configurazione consente di integrare completamente il processo di spedizione in FileMaker e di creare etichette per pacchi direttamente dal database.
