Invia gli ordini da Zapier, Make o dal tuo gestionale
Quando succede qualcosa in un altro programma, quel programma ci manda l'ordine con una chiamata web. Non è un'app dentro Zapier o Make: usi il loro passo Webhook o HTTP.
Invia gli ordini da Zapier, Make o dal tuo gestionale
Quando succede qualcosa in un altro programma, quel programma ci manda l'ordine con una chiamata web. Non è un'app dentro Zapier o Make: usi il loro passo Webhook o HTTP.
Circa 15 minuti
Cosa ti serve prima
- Una chiave API con il permesso di scrivere ordini.La crei in Sviluppatori. Si vede una volta sola: copiala subito.
- Un account del programma che manda l'ordine.Su Zapier il passo Webhooks by Zapier non è nel piano gratuito, secondo il loro aiuto. Su Make serve l'app HTTP.
Passo per passo
1. Crea la chiave
Apri Sviluppatori, premi Nuova chiave e scegli solo Scrivere ordini.
2. Su Zapier: aggiungi il passo Webhooks by Zapier
Scegli l'azione POST. In URL scrivi https://www.spediamo-facile.it/api/v1/orders/single. In Payload Type scegli json. Le coppie di chiave e valore vanno in Data.
3. Su Make: aggiungi il modulo Make a request dell'app HTTP
In Method scegli POST, stesso indirizzo. In Body content type scegli application/JSON e in Body input method scegli Data structure.
4. Aggiungi l'intestazione con la chiave
Nella sezione Headers. Nome: Authorization. Valore: Bearer seguito da uno spazio e dalla tua chiave.
5. Abbina i campi
Servono almeno externalId, il numero che l'ordine ha nel tuo programma. Gli altri sono nell'esempio qui sotto. I campi in più vengono ignorati.
6. Prova con un ordine
Lancia il passo di prova e guarda la risposta: created vale 1 se l'ordine è nuovo, updated vale 1 se esisteva già.
Esempi
Un ordine con campi semplici
curl https://www.spediamo-facile.it/api/v1/orders/single \
-H "Authorization: Bearer LA_TUA_CHIAVE" \
-H "Content-Type: application/json" \
-d '{
"externalId": "GEST-1001",
"recipientName": "Anna Bianchi",
"address": "Via Verdi 2",
"postalCode": "00184",
"city": "Roma",
"province": "RM",
"country": "IT",
"phone": "0600000000",
"email": "anna@example.com",
"productTitle": "Maglia",
"quantity": 2,
"weight": "0,5"
}'Prova: come controllare che funzioni
La risposta dice created
Apri Ordini: lo trovi tra quelli da spedire, oppure da correggere se manca qualche dato.
Mandalo una seconda volta
Con lo stesso externalId l'ordine si aggiorna: nessun doppione, e quello che hai cambiato a mano resta.
Se qualcosa non va
Risposta 401
La chiave è sbagliata o è stata revocata. Controlla che ci sia Bearer con uno spazio prima della chiave.
Risposta 403
La chiave non ha il permesso di scrivere ordini. Creane una con Scrivere ordini.
Risposta 400
Il messaggio nomina il campo e il valore sbagliato, per esempio il peso. Correggilo nel passo e riprova.
Risposta 429
Troppe chiamate in poco tempo. Aspetta un minuto: l'ordine non è stato creato.
Cosa facciamo e cosa no
Non è un'app ufficiale su Zapier o Make
Usi i loro passi generici. Non c'è un elenco di azioni già pronto.
Un articolo per chiamata
Per più articoli usa POST /api/v1/orders con l'elenco, come spiegato nella guida alle API.
Il tracking non torna da solo
Per riceverlo nel tuo programma imposta un webhook in uscita in Sviluppatori, Webhook.
Documentazione ufficiale
- Webhooks by Zapier, aiuto di Zapier Letta il 5 novembre 2026.
- Modulo HTTP di Make Letta il 5 novembre 2026.