Collegamento Eshop con ACS Courier: lettere di vettura, tracking e controllo delle spedizioni

Il collegamento con ACS trasferisce i dati di un ordine pronto al processo di spedizione e restituisce all'Eshop il numero della lettera di vettura.

La documentazione ufficiale ACS descrive servizi REST con chiave API e dati dell'account. Lo specifico metodo di creazione delle lettere di vettura riguarda spedizioni in Grecia e a Cipro: un ordine internazionale non deve quindi seguire automaticamente lo stesso percorso. L'impresa deve confermare quali servizi siano attivi nel proprio contratto. Il collegamento tecnico viene progettato attorno al modo reale di stoccaggio, preparazione e consegna dei colli, non soltanto alla creazione riuscita di una lettera di vettura di prova.

Prima di creare una lettera di vettura si leggono destinatario, indirizzo, codice postale, telefono, peso, numero di colli e importo del contrassegno quando necessario. L'ordine acquisisce uno stato di preparazione chiaro, affinché il magazzino sappia quando può stampare. Il numero di spedizione viene salvato insieme alla data e all'associazione del pacco. Per ordini suddivisi in più colli serve un modello di spedizioni separato; altrimenti il cliente potrebbe vedere un solo tracking mentre altri colli sono ancora in sospeso.

Un problema comune è ripetere il comando dopo un ritardo di rete. L'assenza di una risposta immediata non dimostra che la lettera di vettura non sia stata creata. Il connettore deve prima verificare l'associazione salvata e lo stato dell'attività. Contrassegni, annullamenti e modifiche di indirizzo richiedono regole prima della stampa e dopo la consegna al corriere. Gestire queste eccezioni aiuta il team a evitare nuove etichette in contrasto con ciò che ha già lasciato il magazzino.

Il magazzino deve distinguere se una modifica riguardi l'ordine o il collo già preparato. Per ACS si crea una schermata spedizioni con destinatario, peso, modalità di pagamento e collegamento alla lettera di vettura. L'operatore conferma i dati prima di stampare, mentre una ristampa usa l'associazione esistente. Se ci sono due magazzini, si definisce da dove parte ogni collo e quali dati di fatturazione utilizzare. L'ordine commerciale non si completa solo perché esiste un'etichetta. Il team conserva la possibilità di verificare la preparazione effettiva e la consegna al vettore.

In un negozio di cosmetici, due operatori aprono lo stesso ordine. Il primo conferma peso, destinatario e importo del contrassegno e richiede una lettera di vettura. Il secondo deve vedere che l'attività è in corso e non creare una nuova spedizione. Se la risposta tarda, l'attività resta in verifica fino alla conferma del risultato. Salvato il numero, la ristampa legge quella specifica etichetta. Una modifica dell'importo dopo la preparazione viene segnalata e non passa silenziosamente nell'aggiornamento al cliente.

Proviamo la creazione simultanea per un ordine, la ristampa e l'interruzione di rete dopo l'invio. Ci aspettiamo una sola associazione attiva per collo e uno stato comprensibile per risultati incerti. Verifichiamo codice postale, paese, colli e contrassegno sull'etichetta. Proviamo anche l'annullamento prima della consegna e la modifica del destinatario dopo la stampa della lettera di vettura. Il team approva i campioni fisici di stampa e le istruzioni per le eccezioni. Consegniamo una procedura di riconciliazione per verificare ordine, collo e numero ACS senza crearne uno nuovo.