Benvenuti all’ultima parte della nostra miniserie sulle API di EasyCargo! Oggi ci immergeremo nell’effettivo processo di pianificazione del carico, passo dopo passo. Vi mostreremo come l’API semplifica le operazioni logistiche: dalla creazione di un account utente, alla definizione degli spazi di carico, alla generazione di report di stampa. Se volete sapere come ottimizzare i vostri processi utilizzando l’API di EasyCargo, siete nel posto giusto!

Prima di passare all’azione, vi consigliamo di leggere le parti precedenti della nostra serie:

• Guida teorica alle API – tutte le basi e i concetti da conoscere
• Guida pratica alle richieste e ai test API – come impostare un cliente API e testare gli endpoint con ReqBin

Se avete già acquisito queste nozioni di base, siamo pronti a partire!

Processo di pianificazione del caricamento passo dopo passo

Per utilizzare le seguenti richieste API, è necessario aggiungere un token di autenticazione all’intestazione della richiesta. Le procedure di autenticazione dettagliate sono riportate nel nostro precedente articolo. Per ottenere un token di autenticazione, è necessario disporre di una chiave API associata al proprio account utente. Contattate il nostro team di assistenza per generare la chiave. Si noti che i token di autenticazione sono validi solo per 1,5 ore. Dopo questo tempo, scadono e non funzionano più.

Impostazioni di accesso dell’utente

La prima e più importante fase del processo di pianificazione del carico è la creazione di un account, ad esempio per il personale del magazzino. Utilizzare l’endpoint /api/v1/users per creare un nuovo utente con permessi specifici. Come si vedrà nella richiesta API qui sotto, è necessario fornire alcune informazioni sul nuovo utente. Se l’operazione è stata eseguita correttamente, il nuovo utente apparirà immediatamente in EasyCargo nella scheda Utenti.

Nel codice sottostante, si vede una richiesta all’endpoint /api/v1/users con un corpo contenente i dettagli dell’utente per il quale si vuole creare un account. È necessario inserire il nome, il cognome, l’indirizzo e-mail di accesso e il tipo di utente. Il tipo di utente può essere Amministratore (rappresentato dal numero 1 nel corpo della richiesta) o Utente normale (rappresentato dal numero 2).

Vedere il modello completo di richiesta API: https://reqbin.com/duacb1ye

Definizione dei vani di carico

Prima di iniziare a caricare, è necessario definire dove avverrà il carico. L’endpoint /api/v1/cargospaces consente di definire diversi tipi di container. Ogni vano deve includere lunghezza, larghezza, altezza e carico massimo. Per ora supportiamo solo i contenitori, ma stiamo lavorando su altre opzioni! Una volta definito, il contenitore apparirà nell’interfaccia di EasyCargo, confermando che non si è commesso alcun errore. È possibile utilizzare immediatamente il container creato per la pianificazione del carico.

Nel codice sottostante, si può vedere una richiesta all’endpoint /api/v1/cargospaces con un corpo contenente i dettagli del container che si desidera creare. Specificare il nome, la larghezza, l’altezza, la lunghezza e il peso massimo. Quindi, selezionare il sistema di misura (1 per il sistema metrico e 2 per quello imperiale) e il tipo di vano di carico. Questo è preimpostato su 1, che rappresenta il container.

Vedere il modello completo di richiesta API:: https://reqbin.com/8ieqp8ey

Gestione degli articoli da caricare

Una volta definiti i vani di carico, è il momento di aggiungere gli articoli. Utilizzate l’endpoint /api/v1/shipment-inputs per specificare le dimensioni, il peso e i vincoli di ciascun articolo. L’interfaccia di EasyCargo confermerà visivamente il successo della creazione del carico, visualizzando tutti gli articoli inseriti e le loro specifiche.

Nel codice sottostante creiamo una nuova spedizione con 82 pezzi di un tipo di articolo utilizzando l’endpoint /api/v1/shipment-inputs. Nel corpo della richiesta, specifichiamo il nome del carico, il sistema di misura e gli articoli. Per gli articoli, si possono specificare dimensioni e vincoli. In questo esempio, creeremo articoli in un gruppo di priorità chiamato Berlino, perché è lì che vogliamo spedire i frigoriferi. Permetteremo loro di ruotare e impilare liberamente. Per completezza, va detto che purtroppo al momento non è possibile cambiare il colore degli articoli tramite l’API, né visualizzare o meno il nome dell’articolo sulle scatole.

Vedere il modello completo di richiesta API: https://reqbin.com/ozixloob

Generazione del piano di carico ottimale

Una volta ottenuti tutti i dettagli di carico, possiamo passare alla generazione del piano di carico effettivo. EasyCargo calcolerà automaticamente il posizionamento più efficiente del carico, tenendo conto dell’uniformità del carico, della sequenza di carico e dei requisiti di consegna. Sebbene l’API non sia ancora in grado di effettuare da sola l’ottimizzazione, in EasyCargo basta fare clic su Carica e il sistema farà i conti per voi! Dopo l’ottimizzazione iniziale, avete la possibilità di regolare manualmente il carico. Il piano finale soddisferà quindi tutti i vostri requisiti specifici.

Rapporti di stampa del piano di carico

Una volta completato il piano di carico, è possibile generare un rapporto dettagliato con il layout del carico e la visualizzazione 3D. L’endpoint /api/v1/shipment-reports/{id} fornisce il rapporto in formato PDF per una facile condivisione con colleghi e partner. Guardate come appare il rapporto di carico!

Nel codice sottostante si può vedere come ottenere tutti i dettagli del carico utilizzando l’endpoint /api/v1/shipment-report/{id}. Per prima cosa dobbiamo ottenere l’ID del report inviando una richiesta GET a /api/v1/shipments. Poi prendiamo l’ID dalla risposta e lo includiamo nell’URL della richiesta successiva (/api/v1/shipment-report/{id}). La risposta conterrà tutti i dettagli che vedete nell’immagine sottostante, in un PDF stampabile.

Vedere il modello completo di richiesta API: https://reqbin.com/ust8mrq2

Condivisione e collaborazione

Avete bisogno di condividere il piano di carico con il vostro team o i vostri partner? L’endpoint /api/v1/shipments fornisce tutte le informazioni di carico, compresa una vista 3D interattiva. Aprite il link di carico pubblico in EasyCargo e visualizzate il posizionamento degli articoli risultante.

Nel codice sottostante, recuperiamo tutti i dettagli della nostra spedizione creata in precedenza utilizzando l’endpoint /api/v1/shipments/{id}. Per ottenere l’ID della spedizione, inviare prima una richiesta GET a /api/v1/shipments. Una volta identificato l’ID della spedizione, inviare una richiesta GET a /api/v1/shipments/{id} per ottenere tutti i dettagli della spedizione, compresi il link pubblico, il link al rapporto stampa e le altre informazioni elencate di seguito.

Vedere il modello completo di richiesta API: https://reqbin.com/y5p3zysj

L’API di EasyCargo è un esempio di come le interfacce ben progettate possano accelerare operazioni logistiche complesse. Consente di pianificare e gestire in modo efficiente i carichi grazie all’automazione e agli algoritmi intelligenti. Con una facile integrazione, è possibile utilizzare l’API per ottimizzare i processi logistici e ottenere report chiari per una pianificazione più semplice. Che siate nuovi alle API o sviluppatori esperti, le opzioni di integrazione sono ampie. Contattateci per una consulenza personale sull’implementazione di EasyCargo nella vostra azienda. Insieme troveremo la soluzione migliore per voi!