API

Se hai già il tuo gestionale,
collegalo direttamente

Dodici comandi coprono tutto il ciclo, dal preventivo all'etichetta alla tracciatura. Basta una chiave, e la chiave te la generi tu dal portale.

Apri la documentazione Chiedi l'accesso

Chiedi il prezzo, poi spedisci

Prima chiedi il prezzo di quel pacco, poi crei la spedizione. Nella risposta trovi il numero di tracciatura e l'indirizzo da cui scarichi l'etichetta in PDF, con la stessa chiave.

Autenticazione con una sola chiave, nell'intestazione
Ogni chiave è legata a un contratto corriere, così tieni separati i flussi
Se superi le spedizioni comprese hai tre giorni di margine, poi l'API si ferma con un messaggio che dice quante ne hai usate e quante ne avevi

curl -X POST https://moovexpress.com/api/v1/rates \
  -H "Authorization: Bearer LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "shipTo": { "postalCode": "90100",
                "state": "PA", "country": "IT" },
    "packages": [ { "weight": 3, "length": 30,
                    "width": 20, "height": 15 } ],
    "codValue": 80
  }'

I comandi

Tutto quello che serve, niente di più

Metodo	Indirizzo	Cosa fa
GET	/api/v1/account	Verifica la chiave: contratto collegato, listino e credito
POST	/api/v1/rates	Il prezzo di quel pacco sul contratto della chiave
POST	/api/v1/shipments	Crea la spedizione: numero di tracciatura e indirizzo dell'etichetta
GET	/api/v1/shipments	Le tue spedizioni, con i filtri
GET	/api/v1/shipments/{id}	Il dettaglio di una spedizione
DELETE	/api/v1/shipments/{id}	Annulla una spedizione
GET	/api/v1/shipments/{id}/label	Scarica l'etichetta in PDF
GET	/api/v1/tracking/{numero}	Lo stato aggiornato, con la cronologia degli eventi
POST	/api/v1/pickups	Prenota il ritiro per una o più spedizioni
POST	/api/v1/shipping-lists	Chiude la giornata in distinta e trasmette al corriere
GET	/api/v1/stocks	I pacchi fermi in giacenza
PATCH	/api/v1/stocks/{id}	Chiede lo svincolo: riconsegna o reso

Avvisi verso il tuo sistema

Possiamo avvisare il tuo sistema quando cambia lo stato di una spedizione. Ogni invio è firmato, così sei sicuro che arrivi da noi, e se non rispondi subito riproviamo. Per non perdere niente conviene comunque tenere una lettura periodica come rete di sicurezza. Si attiva su richiesta.

Quanto costano

Le API sono comprese nel servizio: se le usi per spedire la tua merce non paghi nulla in più. Si applica un pacchetto a parte solo a chi rivende MoovExpress fuori dal portale, e in quel caso se ne parla prima.

Provale

Ti diamo la chiave e la documentazione: in un pomeriggio capisci se ti va bene.

Chiedi l'accesso