— API & Webhooks

Connetti E-Manager
al tuo stack.
Il tuo ERP ci parla già.

API REST documentate e webhook push real-time. Collega il tuo gestionale, WMS o e-commerce proprietario a E-Manager in ore, non mesi.

API key in 30 secSandbox inclusoDocumentazione in italiano
api.e-manager.io — terminale
$ curl -X POST https://api.e-manager.io/v1/shipments \
-H "Authorization: Bearer em_sk_live_●●●●●●●●" \
-d '{"order_id":"ORD-2891","carrier":"gls"}'

HTTP/2 201 Created
 
{
"id": "shp_k8mxp3",
"status": "created",
"carrier": "gls",
"tracking_code": "33291847562IT",
"label_url": "https://cdn.e-manager.io/…/label.pdf"
}
POST/v1/ordersGET/v1/labels/{id}POST/v1/webhooksGET/v1/tracking/{code}GET/v1/invoicesPOST/v1/keysGET/v1/logsGET/v1/sandbox/*POST/v1/ordersGET/v1/labels/{id}POST/v1/webhooksGET/v1/tracking/{code}GET/v1/invoicesPOST/v1/keysGET/v1/logsGET/v1/sandbox/*

Il problema

I tuoi sistemi non si parlano.
Ogni dato si muove tardi, a mano, male.

Il gestionale non sa quando arriva un ordine

Aspetti il file di fine giornata, o lo copi a mano. Il magazzino inizia a lavorare con ore di ritardo.

Stato spedizioni aggiornato manualmente

Il WMS interroga E-Manager ogni ora, o peggio ogni notte. Il cliente sa prima di voi che il pacco è arrivato.

Export CSV che si rompono in silenzio

Ogni connessione con file, FTP o email è un punto di rottura. La colpa non è mai chiara fino a quando è troppo tardi.

Mesi di sviluppo per ogni connettore

Il team IT passa settimane a costruire integrazioni custom. Poi cambia qualcosa e si ricomincia da capo.

−3hal giorno recuperate eliminando sincronizzazioni manuali tra gestionale, WMS e piattaforma spedizioni
webhook · evento in arrivo
Content-Type: application/json
X-Em-Signature: sha256=a8f3…
 
{
"event": "shipment.delivered",
"occurred_at": "2024-01-16T14:31:00Z",
"data": {
"id": "shp_k8mxp3",
"carrier": "gls",
"city": "Milano, MI"
}
}
 
← 200 OK in 43ms · firmato HMAC-SHA256 ✓

Come funziona

Tre passi.
I tuoi sistemi si connettono da soli.

01

Attivi l'accesso dal pannello

Dal pannello E-Manager → Impostazioni → Integrazioni, crei una chiave in 30 secondi. Scegli cosa può fare e per quale ambiente.

Permessi granulariSandbox inclusoNessun codice
Impostazioni → Integrazioni
em_sk_live_••••••••••••✓
ordinispedizionitracking
Produzione attiva
02

I tuoi sistemi inviano e ricevono dati

Il tuo gestionale, WMS o e-commerce proprietario parla con E-Manager in tempo reale: importa ordini, genera etichette, aggiorna stati.

OrdiniSpedizioniEtichetteTracking
ERP→ordine importato✓
WMS→etichetta ricevuta✓
Gestionale→stato aggiornato✓
03

Ti avvisiamo ad ogni evento

Spedizione consegnata? Anomalia rilevata? Etichetta pronta? Il tuo sistema riceve una notifica istantanea. Zero polling, zero ritardi.

Push real-timeRetry automaticiLog completo
Evento ricevuto
shipment.delivered
GLS · Milano · 14:31
POST → il tuo sistema ✓

Cosa puoi fare

Tutto quello che serve
per automatizzare ogni flusso.

POST
/v1/orders

Importa ordini automaticamente

Il tuo e-commerce proprietario invia gli ordini a E-Manager senza CSV. Entrano nel flusso in pochi secondi.

GET
/v1/labels/{id}

Genera etichette dal gestionale

ERP o WMS chiede l'etichetta e la riceve. PDF, ZPL, A6: il formato che vuoi, pronto in meno di un secondo.

GET
/v1/tracking/{code}

Ricevi aggiornamenti stato in tempo reale

Quando lo stato cambia, il tuo sistema lo sa subito. Nessun polling, nessun aggiornamento manuale.

POST
/v1/webhooks

Notifiche push su ogni evento

Configuri una volta gli eventi che ti interessano. Da quel momento arrivano automaticamente, firmati HMAC-SHA256.

GET
/v1/invoices

Controlla le fatture dei corrieri

E-Manager analizza i costi reali di ogni spedizione. Esportabile verso il tuo sistema contabile senza copia-incolla.

GET
/v1/sandbox/*

Testa tutto prima del go-live

Ogni account include un ambiente di test isolato. Simula eventi, prova le integrazioni, vai in produzione solo quando sei pronto.

POST
/v1/keys

Permessi per ogni sistema

Ogni integrazione ha la sua chiave con permessi limitati. Nessun sistema ha più di quello che gli serve.

GET
/v1/logs

Storico completo degli scambi

Ogni chiamata, ogni notifica, ogni risposta: registrata nel log. Se qualcosa non arriva, lo vedi subito e puoi riprovare.

Per chi è

Chi ha un sistema proprietario
non ha più scuse per non integrare.

Responsabile IT / CTO

Non volevamo più CSV manuali tra i sistemi. Con l'API di E-Manager abbiamo automatizzato in una settimana quello che prima richiedeva mesi di sviluppo custom.

Endpoint standard documentati, nessun connettore da mantenere, ambiente di test incluso.

Operations Manager

Quando E-Manager genera l'etichetta, il nostro WMS lo sa immediatamente. Nessuno deve più copiare nulla, e se qualcosa va storto lo vediamo nel log.

Notifiche push real-time, retry automatici, log di ogni scambio sempre disponibile.

E-commerce con sistema proprietario

Avevamo un gestionale custom che non parlava con nessuno. Adesso gli ordini entrano in E-Manager da soli e le etichette tornano indietro in automatico.

Integrazione bidirezionale, nessun cambio al sistema esistente, setup guidato.

Titolare / Direzione

Prima ogni aggiornamento richiedeva un intervento manuale. Adesso i sistemi si parlano da soli e l'unica cosa che vedo è il risultato.

Visibilità in tempo reale, zero errori da copia-incolla, scalabilità senza aggiungere persone.

Il confronto

Integrazioni manuali
vs API E-Manager.

Senza API
Con E-Manager API
✕File CSV ogni notte, dati di ieri
✓Dato aggiornato al secondo, sempre
✕Il gestionale non sa quando arriva un ordine
✓Ordine importato in automatico, in meno di un minuto
✕Stato spedizione aggiornato a mano
✓Notifica push appena cambia qualcosa
✕Mesi di sviluppo per ogni connettore
✓Endpoint documentati, pronti da subito
✕Nessun log degli scambi tra sistemi
✓Storico completo con replay su ogni evento
✕Test solo in produzione con dati reali
✓Sandbox isolato, eventi simulabili on demand

FAQ

Domande frequenti

01

Ho bisogno di un developer per usare le API?

Per le operazioni più comuni — importare ordini, ricevere aggiornamenti stato, configurare le notifiche — bastano competenze tecniche di base. E-Manager fornisce documentazione completa in italiano e un ambiente di test per provare prima del go-live. Per integrazioni complesse, il nostro team di onboarding affianca il tuo IT.

02

Quanto tempo ci vuole per la prima integrazione?

La chiave di accesso è pronta in 30 secondi dal pannello. Un'integrazione di base — importazione ordini + notifiche stato — richiede in media 1-3 giorni di sviluppo sul lato del tuo sistema. Metti in conto qualche giorno di test nell'ambiente sandbox prima del go-live.

03

Esiste un ambiente di test prima di andare in produzione?

Sì. Ogni account include un sandbox isolato su api-sandbox.e-manager.io con dati fittizi. Puoi simulare eventi, generare etichette di test e provare tutto senza toccare i dati reali. Il sandbox usa le stesse API della produzione.

04

Come funzionano le notifiche in tempo reale?

Registri un indirizzo HTTPS nel pannello e selezioni gli eventi che ti interessano: ordine ricevuto, etichetta pronta, spedizione consegnata, anomalia rilevata. Ogni volta che uno di questi eventi accade, E-Manager invia una notifica POST al tuo indirizzo. Se il tuo sistema non risponde, riprova automaticamente fino a 6 volte.

05

Posso limitare cosa può fare ogni integrazione?

Sì. Ogni chiave di accesso ha permessi configurabili per area: ordini, spedizioni, tracking, fatture. Puoi creare una chiave che legge solo il tracking e un'altra che può creare spedizioni, senza che si sovrappongano.

06

L'API supporta più magazzini o più account cliente?

Sì. Se gestisci più sedi o operi come 3PL con più clienti, puoi operare su ogni account separatamente usando lo stesso punto di accesso. Serve una chiave con permesso multi-account abilitato, configurabile dal pannello.

06 — Inizia adesso

Il tuo gestionale può parlare
con E-Manager da domani.

API key in 30 secSandbox inclusoNessuna carta richiesta