Qapla'
Accedi
Qapla'

API e webhook per spedizioni, etichette e tracking

API REST con una chiave per canale e sandbox. I webhook avvisano i tuoi sistemi a ogni cambio di stato, con gli stessi stati per tutti i corrieri. E se l'integrazione la scrive la tua AI, c'è la skill qapla-api.

Documentazione pubblica Sandbox per ogni canale Webhook in tutti i piani
Animazione: una richiesta alla API di Qapla' legge una spedizione BRT e riceve lo stato normalizzato; poco dopo arriva un webhook con il passaggio a In consegna.
REST e JSON
Chiamate HTTPS, risposte in JSON.
Una chiave per canale
Ogni negozio o canale ha la sua chiave API.
Sandbox
Lo stesso endpoint, con il flag di test.
9 stati standard
Uguali per 450+ corrieri.

Cosa puoi fare con le API di Qapla'

Tutto il ciclo della spedizione, dall'ordine alla consegna. Per ogni gruppo di endpoint trovi il piano in cui è disponibile.

AreaCosa faiEsempiPiano

Tracking

Leggi lo stato di ogni spedizione, con gli stessi stati per tutti i corrieri e lo storico degli eventi.

getShipmentgetQaplaStatus Tutti i piani

Webhook

Ricevi una chiamata a ogni cambio di stato, senza interrogare i corrieri.

status_change Tutti i piani

Quote e tariffe

Confronta le tariffe dei contratti con i tuoi corrieri prima di creare la spedizione.

quote Dal Plus

Spedizioni ed etichette

Crei spedizioni ed etichette con il corriere scelto, in PDF o ZPL.

pushShipmentlabel Qapla' One

Import ordini

Porti in Qapla' gli ordini da canali custom, gestionali ed ERP.

pushOrder Qapla' One

Punti di ritiro e indirizzi

Cerchi i punti di ritiro vicini al cliente e verifichi gli indirizzi prima di spedire.

pickupPointsaddress A consumo

I nomi dei metodi e i parametri completi sono nella documentazione delle API 1.3.

Webhook: lo stato arriva a te, già tradotto

Registri un URL e Qapla' lo chiama a ogni cambio di stato. Non interroghi 450+ corrieri con formati diversi: ricevi sempre uno dei 9 stati standard, con il dettaglio quando c'è un'eccezione.

  • Attesa ritiro
  • Partito
  • In transito
  • In consegna
  • Tentativo fallito
  • Ritardo
  • Eccezione
  • Punto di ritiro
  • Consegnato

Gestionale, ERP, marketplace o helpdesk si aggiornano da soli. Per lo stato dentro i ticket c'è anche Qapla' Companion, senza codice.

Documentazione dei webhook
POST https://tuo-sito.it/qaplaapplication/json
{
"event": "status_change",
"reference": "10493",
"courier": "Corriere 1",
"courierStatus": "Mancata consegna: destinatario assente",
"qaplaStatus": "Giacenza",
"exception": "destinatario assente",
"date": "2026-10-16 09:12"
}

Dalla sandbox alla produzione, senza riscrivere

Provi tutto con il flag sandbox, poi cambi chiave. Gli endpoint e le risposte restano gli stessi.

Sandbox

Per i test
Chiave
Chiave API del canale
Flag
sandbox attivo
Spedizioni
Nessuna spedizione reale
Webhook
Arrivano al tuo URL di test

Produzione

Live
Chiave
Chiave API di produzione
Flag
sandbox disattivo
Spedizioni
Reali, con i tuoi contratti
Monitoraggio
Chiamate ed errori dal pannello
Animazione: nel terminale si chiede a Claude di integrare il tracking di Qapla'; l'assistente legge la skill qapla-api, crea il client, configura il webhook e supera i test in sandbox.

L'integrazione la può scrivere la tua AI

Due strumenti, per due lavori diversi.

Skill qapla-api
Una skill pubblica che spiega al tuo assistente endpoint, autenticazione, esempi ed errori. Gli dai il compito, lui scrive il client e i test.
MCP server
Lo standard aperto per collegare Claude, ChatGPT o i tuoi agenti ai dati del tuo account Qapla', con le sue credenziali. Dal piano Plus.
Scopri AI e Agenti

Domande frequenti

Le API di Qapla' sono incluse nei piani?

Tracking e webhook sono inclusi in tutti i piani. Il confronto delle tariffe via API è dal piano Plus; creazione di spedizioni ed etichette e import ordini via API sono in Qapla' One. Ricerca dei punti di ritiro e verifica degli indirizzi sono a consumo.

Sì. Ogni canale ha la sua chiave API e con il flag sandbox provi le chiamate senza creare spedizioni reali. In produzione cambiano solo la chiave e il flag: gli endpoint restano gli stessi.

Registri un URL e Qapla' lo chiama a ogni cambio di stato della spedizione, con lo stato già normalizzato per tutti i corrieri. Il tuo gestionale, ERP o helpdesk si aggiorna senza interrogare i corrieri.

Sì. La skill pubblica qapla-api spiega al tuo assistente AI endpoint, autenticazione, esempi ed errori. Con l'MCP server, Claude, ChatGPT o i tuoi agenti leggono i dati del tuo account con le sue credenziali.

No. Con le 16 piattaforme eCommerce native colleghi il negozio senza scrivere codice. Le API servono per canali custom, gestionali, ERP o flussi che vuoi automatizzare.

Integra Qapla' questo pomeriggio

Documentazione pubblica, sandbox per ogni canale, skill per la tua AI.

Più marchi, ERP o volumi alti? Parla con il team di Qapla' One