AWB & Gestione Corrieri — Generazione e Spedizione
Reparto: Magazzino & Logistica
Ruolo: Operatore Picking & Spedizione, Responsabile Magazzino
Obiettivo: Generare documenti di trasporto in modo corretto, rapido e senza errori — indipendentemente dal corriere scelto
Le due modalità corriere in CRMconnect
CRMconnect offre due metodi per la generazione degli AWB, per scenari diversi:
| Corriere Diretto | Innoship | |
|---|---|---|
| Modulo | /admin/couriers |
/admin/innoship |
| Corrieri disponibili | Cargus, FanCourier, Palex | 230+ corrieri in 35 paesi |
| Utilizzo ottimale | Consegne nazionali, volume medio, integrazione diretta con corriere preferito | Alto volume, consegne internazionali, confronto servizi/prezzi |
| Configurazione | Credenziali API per corriere, punto di ritiro | Chiave API Innoship + ID esterno |
| Audit | Logger interno per ogni chiamata API | innoship_audit_log per richiesta |
Opzione 1 — Corriere Diretto (Cargus / FanCourier / Palex)
Configurazione (admin, una sola volta)
Dove: /admin/couriers/settings
Cargus:
- Scheda Cargus → URL API base, chiave abbonamento, nome utente, password
- Sincronizza i punti di ritiro dall'API → seleziona la tua sede
FanCourier:
- Scheda FanCourier → URL base, URL report, nome utente, password, ID cliente
- Al salvataggio → il modulo verifica la connettività e recupera i punti di lavoro registrati
Palex:
- Configurazione simile → credenziali API Palex
- Sincronizza i punti di ritiro
Generale:
- Seleziona il corriere preferito (preselezionato per default ad ogni nuovo AWB)
- Seleziona il magazzino predefinito (punto di ritiro preselezionato)
Genera AWB — passo dopo passo
Finalizza la Lista di Imballaggio con tutti i dettagli del pacco:
- Peso (kg) — obbligatorio
- Dimensioni: lunghezza × larghezza × altezza (cm) — obbligatorio
- Indirizzo di consegna — copiato dall'ordine, modificabile
Apri la lista di imballaggio approvata → pulsante Genera AWB
Seleziona:
- Corriere (Cargus / FanCourier / Palex)
- Punto di ritiro (il tuo magazzino)
- Servizio (standard, express, cambio pacco, ecc.)
Conferma → AWB generato:
- Numero AWB restituito e salvato nel sistema
- Stato lista di imballaggio →
wh_in_transit - Stato ordine →
Spedizione (4) - Etichetta disponibile per la stampa (PDF A4 o termico)
Stampa etichetta → applica sul pacco → consegna al corriere
Tracking e audit
- Tracking — apri l'AWB dalla lista Corrieri → il modulo chiama l'API del corriere in tempo reale → stato consegna attuale
- Audit/diagnostica —
/admin/couriers→ Log → ogni chiamata API con: timestamp, endpoint, payload, stato HTTP, risposta → utile per AWB non generati
Opzione 2 — Innoship (230+ corrieri, 35 paesi)
Quando usare Innoship
- Hai alto volume e vuoi confrontare automaticamente le tariffe tra corrieri
- Consegni internazionalmente (35 paesi) — DPD, GLS, DHL, TNT, FedEx e altri
- Vuoi un unico punto di integrazione per tutti i corrieri, non API separate
- Hai bisogno della stampa batch delle etichette per le spedizioni del giorno
Configurazione (admin, una sola volta)
Dove: /admin/innoship/settings
innoship_api_key— chiave API dal tuo account Innoshipinnoship_external_id— ID esterno del tuo account- Verifica connettività → Innoship conferma la lista dei corrieri disponibili
Genera AWB tramite Innoship — passo dopo passo
Finalizza la Lista di Imballaggio con peso + dimensioni + indirizzo
Apri la lista di imballaggio approvata → pulsante Genera AWB → seleziona Innoship
Dalla lista Innoship seleziona:
- Corriere (uno qualsiasi dei 230+)
- Servizio (standard, express, consegna weekend, contrassegno, ecc.)
- Paese di destinazione (per le consegne internazionali)
Conferma → Innoship elabora via API:
- Restituisce: numero AWB + codice tracking
- Il CRM salva in
wh_omni_shipments - Log creato in
innoship_audit_log - Stato lista di imballaggio →
wh_in_transit - Stato ordine OMS →
Spedizione (4) - Se WooCommerce/Shopify → numero tracking inviato automaticamente al canale
Stampa etichetta → applica sul pacco
Stampa batch (lotto giornaliero)
Dove: /admin/innoship → Lista AWB → seleziona multipli → Stampa Batch
Ideale per magazzini ad alto volume: seleziona tutti gli AWB del giorno e stampa in un unico passaggio.
Tracking Innoship
- Dalla lista AWB → clic su un AWB → stato attuale dalla rete del corriere
- Audit →
innoship_audit_log→ ogni richiesta: cosa è stato inviato, cosa è stato ricevuto, eventuali errori
Confronto tra le due opzioni — quando scegliere quale
| Situazione | Raccomandazione |
|---|---|
| Consegni esclusivamente in Italia con 1-2 corrieri stabili | Corriere Diretto |
| Hai ordini internazionali o in 35+ paesi | Innoship |
| Vuoi confrontare automaticamente i prezzi tra corrieri | Innoship |
| Hai un contratto dedicato con un singolo corriere | Corriere Diretto |
| Alto volume con stampa batch giornaliera | Innoship (stampa batch nativa) |
| Vuoi tracking unificato per tutti i corrieri | Innoship |
Puoi usare entrambi contemporaneamente — ordini diversi possono usare corrieri diversi in base alla destinazione o al servizio.
Stato pacco — tracciabilità completa
| Stato OMS | Stato Lista Imballaggio | Significato |
|---|---|---|
1 - Nuovo |
— | Nuovo ordine ricevuto |
3 - Confermato |
ready_for_packing |
Picking in corso |
3 - Confermato |
packed |
Imballato, AWB non ancora generato |
4 - Spedizione |
wh_in_transit |
AWB generato, pacco con il corriere |
5 - Consegnato |
wh_delivered |
Consegna al destinatario confermata |
8 - Cancellato |
— | Annullato, stock rilasciato |
Cosa vede il cliente
Portale Clienti (se attivo):
- Numero AWB e corriere scelto
- Link di tracking diretto al rispettivo corriere
- Aggiornamenti di stato in tempo reale
Portale Distributore B2B:
- Sezione Consegne → tracking AWB per gli ordini
- Stato trasporto sincronizzato
Problemi comuni e come risolverli
| Problema | Controlla | Soluzione |
|---|---|---|
| AWB non viene generato | Log Corrieri o Audit Innoship | Credenziali scadute? Dimensioni mancanti? Indirizzo non valido? |
| Etichetta non si stampa | Visualizzatore PDF installato? | Scarica manualmente il PDF dalla lista AWB |
| Il tracking non si aggiorna | API corriere funzionante? | Sincronizzazione manuale o controlla Audit Innoship |
| AWB generato con indirizzo errato | Controlla indirizzo in Lista Imballaggio | Annulla AWB (dal portale corriere) → ricreare con indirizzo corretto |
Consigli pratici
Compila peso e dimensioni al momento dell'imballaggio, non dopo. Senza questi campi l'AWB non può essere generato. Pesa il pacco con i prodotti dentro — non stimare.
Per le spedizioni internazionali — usa Innoship. L'integrazione diretta con i corrieri nazionali funziona solo per consegne domestiche. Qualsiasi consegna fuori dall'Italia → Innoship.
Il numero AWB è definitivo dopo la generazione. Se hai inserito l'indirizzo sbagliato o il prodotto errato, devi annullare l'AWB dal portale del corriere e ricrearlo nel CRM. Non puoi modificare un AWB già emesso.