---
title: "Integrazioni e API: file, ordini e POD | OptiRoutes"
description: "Collega OptiRoutes al tuo ERP: caricamento Excel e CSV, FTP o SFTP, API dei file per ordini e POD firmate, API dei report, esportazione dei percorsi e webhook."
url: https://optiroutes.com/it/integrations/
lang: it-IT
updated: 2026-10-24
---

# Integrazioni e API

OptiRoutes si collega ai sistemi che usi già. Gli ordini arrivano da un file Excel o CSV, da FTP o SFTP, oppure tramite una API dei file sicura; bolle di consegna firmate, esportazioni dei percorsi e report tornano indietro allo stesso modo. Un'API dei report fornisce i tuoi dati agli strumenti di BI, e indirizzi web ricevono rapporti di consegna ed esportazioni dei percorsi in tempo reale.

## Quali integrazioni offre OptiRoutes?

| Esigenza | Come la gestisce OptiRoutes |
| --- | --- |
| Caricare gli ordini del giorno | Caricamento Excel o CSV, caricamento automatico da FTP, SFTP o API dei file, in CSV, JSON o TXT a larghezza fissa. |
| Raccogliere le POD firmate | Chiamate all'API dei file per giorno o per ordine, oppure uno ZIP al giorno; copie via e-mail. |
| Inviare i percorsi al tuo sistema | Esportazione dei percorsi in CSV, XLSX, XML, JSON o TXT, in un file, sul tuo FTP, nella cartella dell'azienda o a un indirizzo web. |
| Alimentare la BI o il tuo ERP | L'API dei report: ordini, percorsi, autisti, clienti, POD e un riepilogo giornaliero delle consegne. |
| Reagire a ogni consegna | Un indirizzo per i rapporti di consegna che riceve ogni rapporto nel momento in cui viene fatto. |
| Pagare il servizio | Stripe Checkout per le ricariche prepagate e la ricarica automatica. |

## Caricare gli ordini da un file, FTP o SFTP

L'integrazione più semplice è il file che il tuo sistema esporta già. Nella schermata Ordini, **Carica consegne** legge un file Excel o CSV; associ una volta sola ogni campo del sistema (indirizzo, nome del cliente, numero d'ordine, quantità e così via) al nome della tua colonna, e ogni file successivo si carica allo stesso modo. Per un file TXT a larghezza fissa indichi le posizioni dei caratteri anziché i nomi delle colonne. Le righe si possono saltare tramite una parola chiave nelle osservazioni, una seconda parola chiave può sostituire l'indirizzo, e decidi tu se un numero d'ordine esistente viene aggiornato o aggiunto come nuovo.

Per eliminare l'intervento manuale, scegli un metodo di caricamento automatico nelle impostazioni:

- **Il file server di OptiRoutes**: il tuo sistema deposita il file giornaliero, con la data come nome, nella cartella della tua azienda sul server FTP o sul server SFTP cifrato.
- **Il tuo server FTP**: OptiRoutes si collega con l'utente che gli fornisci e carica il file con la data di oggi nel nome, oppure il file aggiornato più di recente.
- **Importazione ed esportazione automatiche**: gli ordini si caricano da soli e anche i percorsi vengono pianificati, senza bisogno di alcun clic.
- **L'API dei file**: il tuo software carica il file degli ordini via HTTPS, come descritto più avanti.

Nella schermata Clienti, un file Excel o CSV con numero cliente, nome, indirizzo, tempo di fermata e orari di apertura e chiusura crea o aggiorna i clienti e le loro finestre temporali.

## L'API dei file: ordini in entrata, POD e report in uscita

Ogni azienda in OptiRoutes ha una propria cartella privata di file: gli ordini che carica, le bolle di consegna firmate con foto e firme, le esportazioni dei percorsi e i report di fine giornata. L'**API dei file** permette ai tuoi sistemi di leggere e scrivere direttamente in quella cartella via HTTPS, senza un server FTP in mezzo. Il manager dell'azienda passa da FTP ad API in **Impostazioni → API e file** e lì crea le chiavi: non serve alcuna richiesta all'assistenza, e le nuove aziende partono già con l'API.

| Cartella | Contenuto | Chi scrive |
| --- | --- | --- |
| orders_files/ | Il file giornaliero degli ordini e le esportazioni dei percorsi. | Tu (ordini), OptiRoutes (esportazioni) |
| pod/YYYY/MM/DD/ | Le POD firmate di quel giorno: il PDF firmato, la firma e le foto. | OptiRoutes |
| pod/ | Le bolle di consegna originali da firmare nell'app per gli autisti, un PDF per numero d'ordine. | Tu |
| reports/YYYY/MM/ | Report di fine giornata e dei resi. | OptiRoutes |
| podBaseFile/ | Il modulo base della POD. | Tu |
| inbox/ | Una cartella libera per i file che vuoi consegnare. | Tu |

La cartella dell'azienda nell'API dei file.

Le chiamate coprono la verifica della chiave, l'elenco di una cartella, il download, il caricamento (fino a 50 MB per file) e l'eliminazione dei file caricati, l'elenco dei file POD di un giorno per ordine e tipo e il download di tutti i file POD di un giorno come un unico ZIP. La guida include esempi di codice in Python, C# e Node.js e uno script PowerShell che mantiene sincronizzata una cartella del tuo server con la cartella dell'azienda, così un team abituato all'FTP può continuare a lavorare allo stesso modo. Leggila nella [guida all'API dei file](https://srv2.optiroutes.com/api/v1/docs?lang=it).

## Come sono protette le chiavi API?

- **Privilegi minimi**: ogni chiave riceve solo le autorizzazioni di cui ha bisogno: solo POD firmate, lettura di tutti i file, oppure caricamento di ordini e file nella inbox.
- **Indirizzi consentiti**: una chiave può essere limitata agli indirizzi IP fissi del tuo server.
- **Scadenza e rotazione**: una chiave può scadere dopo un certo numero di giorni; crea una nuova chiave, passa a quella e poi revoca la vecchia, senza interruzioni del servizio.
- **Revoca immediata**: una chiave revocata smette di funzionare entro 30 secondi.
- **Audit**: ogni chiamata viene registrata con ora, indirizzo, file e risposta, e mostrata al manager.
- **Conservazione sicura**: OptiRoutes conserva solo un'impronta SHA-256 di ogni chiave; le connessioni sono in HTTPS con TLS 1.2 o superiore, e una chiave accede solo alla cartella della propria azienda.

Limiti: 300 richieste al minuto per chiave, 50 MB per file, 20 chiavi attive per azienda e fino a 5.000 voci nell'elenco di una cartella.

## L'API dei report e di push

Per gli strumenti di reportistica e i connettori ERP, un'API separata all'indirizzo api-users.optiroutes.com fornisce i dati della tua azienda sotto forma di report e accetta dati inviati. Un indirizzo e un token, emessi da OptiRoutes per la tua azienda, coprono tutte le chiamate. La pagina della documentazione ti permette di incollare il token e vedere quali report sono disponibili per te e la mappatura delle colonne del tuo account: [leggi la documentazione API](https://api-users.optiroutes.com/api-docs/en).

| Report | Che cosa restituisce |
| --- | --- |
| orders | Ordini e consegne, con percorso e autista. |
| routes | Percorsi, con autista e numero di fermate. |
| drivers | Dati degli autisti. |
| customers | Dati e indirizzi dei clienti. |
| pod | Documentazione delle consegne. |
| delivery-summary | Un riepilogo giornaliero per stato. |

Due chiamate di push funzionano in senso inverso: l'invio degli ordini scrive il file degli ordini del giorno e avvia il caricamento automatico, e l'invio di autisti, linee e veicoli sostituisce l'intera flotta, come un file della flotta. Poiché l'elenco di autisti inviato vale come flotta completa, invia sempre tutti gli autisti, non solo le modifiche.

## Esportazione dei percorsi e webhook

L'esportazione dei percorsi scrive i percorsi selezionati in CSV, XLSX, XML, JSON o TXT a larghezza fissa. Una tabella delle colonne stabilisce quali campi escono e con quale intestazione, si possono aggiungere colonne originali del tuo file degli ordini e, con la gestione degli articoli, un secondo file elenca ogni articolo. Le esportazioni possono andare sul tuo computer, sul tuo server FTP o nella cartella dell'azienda, e con JSON l'esportazione può anche essere inviata a un indirizzo web; se l'invio non riesce, il sistema riprova una volta.

Per ogni consegna nel momento in cui avviene, compila l'**indirizzo per i rapporti di consegna** nelle impostazioni dell'app per gli autisti: ogni rapporto di consegna degli autisti viene inviato anche lì, così un altro tuo sistema si aggiorna da solo.

## E-mail, pagamenti, mappe e messaggistica

- **E-mail**: le bolle di consegna firmate partono dal tuo account Gmail con una password per le app di Google; report come quello dei pallet di fine giornata arrivano al tuo indirizzo e-mail per i report; dalla Cassa i clienti paganti ricevono le ricevute e gli autisti le conferme di versamento.
- **Pagamenti**: le ricariche si pagano su una pagina di pagamento sicura di Stripe, con una carta salvata facoltativa per la ricarica automatica.
- **Indirizzi e mappe**: gli indirizzi si scelgono dai suggerimenti di Google e vengono verificati sulla mappa prima della pianificazione.
- **Navigazione**: l'app per gli autisti passa ogni fermata a Waze, o ad Apple Maps su iPhone, per indirizzo o per coordinate esatte.
- **SMS e WhatsApp**: messaggi di arrivo e link di tracciamento ai clienti, avvisi ai manager, linee ai subvettori e immagini dei percorsi agli autisti su WhatsApp.

Stai pianificando un'integrazione con il tuo ERP o sistema di magazzino? Dicci che cosa devi collegare.

[Inizia la prova gratuita](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Domande frequenti

### OptiRoutes può caricare automaticamente gli ordini dal nostro ERP?

Sì. Il tuo ERP può depositare un file giornaliero sul server FTP o SFTP di OptiRoutes, sul tuo server FTP, oppure caricarlo tramite l'API dei file, e OptiRoutes lo carica da solo.

### Come portiamo le POD firmate nel nostro sistema?

Tramite l'API dei file: elenca e scarica i file POD di un giorno, oppure scaricali tutti come un unico ZIP. Una copia viene anche inviata via e-mail secondo le tue regole di inoltro.

### Chi crea le chiavi per l'API dei file?

Il manager dell'azienda, in Impostazioni, API e file. Le chiavi hanno autorizzazioni, indirizzi consentiti e scadenza facoltativi, e si possono revocare in qualsiasi momento.

### Esiste un'API per i report?

Sì. L'API dei report restituisce ordini, percorsi, autisti, clienti, POD e un riepilogo giornaliero delle consegne, con un token emesso da OptiRoutes.

### In quali formati di file possiamo esportare i percorsi?

CSV, XLSX, XML, JSON e TXT a larghezza fissa, con le colonne e le intestazioni che scegli.

---

OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/it/