API DAVATEL v1.9 per distributori
Comparatore di tariffe, catalogo, attivazione completa e studi di risparmio su luce e gas. Contratto vigente: 2026-09-14-COMERCIAL-PREPAGO-V6.
Aggiornamento importante sulle attivazioni
L’API convalida gli stessi dati operativi del modulo DAVATEL. Un’attivazione incompleta non viene salvata: restituisce HTTP 400 indicando il campo mancante.
PRIVATOLAVORATORE AUTONOMOAZIENDADNI fronte e retroIBAN obbligatorioSIM/eSIM per tutte le linee mobili2 consensi obbligatori
MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO: tutti richiedono una ricevuta bancaria; il LAVORATORE AUTONOMO aggiunge la ricevuta dei contributi; l’AZIENDA aggiunge il CIF, la copertina o prima pagina dell’atto costitutivo e la pagina che indica l’amministratore. Le due pagine dell’atto devono essere inviate come file separati. Per l’AZIENDA, il DNI fronte e retro è quello dell’amministratore.
Nuovi operatori e riservatezza
Il catalogo pubblico include le offerte residenziali autorizzate di MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO. Dalla V25, anche le offerte private, BTL e per clienti esistenti partecipano all’API quando visibili e valide, mantenendo le condizioni di idoneità. Vodafone Mi Negocio Pro accetta solo EMPRESA con portabilità; Lowi accetta PARTICULAR e AUTONOMO.
MOVISTAR visibile senza tariffeHUMANITY unificatoOfferte private soggette a requisiti
Catalogo AVATEL aggiornato
AVATEL è pubblicato come unico operatore per tutte le sue coperture. L’API include l’offerta Back to School/NOVA, CLICtv e i nuovi pacchetti aggiuntivi.
Massimo 5 linee AVATELLinee aggiuntive senza accumulo di gigaCanal Local a 5 €Pagamenti una tantum separati
Ogni tariffa restituisce condiciones_publicas, vigencia_desde, vigencia_hasta, solo_cliente_nuevo, periodicidad_precio, max_lineas_cliente e gigas_acumulables. Le tariffe scadute non vengono mostrate. I prodotti con periodicidad_precio=PAGO_UNICO non vengono aggiunti al canone mensile.
Revisione V7: costo minimo del pacchetto
Si confrontano combinazioni complete di opzioni mobili e TV compatibili. L’ordine privilegia il canone totale attuale; a parità, il canone ordinario più basso dopo le promozioni, poi gli altri criteri. Restano valide le regole per i dati per linea, i pacchetti condivisi e MULTISIM.
I campi precio_total, precio_normal_total e fases_precio mantengono il loro formato. Autenticazione ed endpoint non cambiano.
Aggiornamento commerciale V13
Le ricerche supportano tipo_cliente. Il prezzo attuale, le fasi per data e le piattaforme scelte vengono restituiti con ogni offerta. Una quota di 1, 2 o 3 servizi OTT è rappresentata da selezioni specifiche compatibili. Le tariffe precedenti non vengono usate per attivare nuovi pacchetti.
fases_precio può includere desde_fecha e hasta_fecha (YYYY-MM-DD) quando una promozione ha una data di scadenza fissa. Le precedenti fasi mensili restano valide per le altre tariffe. Consultare sempre /order-requirements prima di mostrare il modulo.
Autenticazione
X-API-Key: dvt_live_... X-Davatel-Domain: www.tudominio.es
Non esporre la chiave in JavaScript pubblico. Usare un backend/proxy proprio.
Endpoint v1
| Metodo | Percorso | Utilizzo |
|---|---|---|
| GET | /api/v1/status | Connessione, versione e contratto. |
| GET | /api/v1/operators | Operatori pubblici. |
| GET | /api/v1/rate-types | Tipi di tariffa per i filtri. |
| GET | /api/v1/rates | Catalogo senza commissioni. |
| GET | /api/v1/rates/:id | Dettaglio di una tariffa. |
| POST | /api/v1/rates/search | Comparatore di tariffe: prezzo e servizi. |
| GET | /api/v1/order-fields | Campi cliente e sistema. |
| POST | /api/v1/order-requirements | Requisiti esatti per la selezione. |
| POST | /api/v1/orders | Creare un’attivazione completa. |
| GET | /api/v1/orders | Elencare le attivazioni del distributore. |
| GET | /api/v1/orders/:referencia | Consultare un’attivazione. |
Flusso consigliato
- Consultare
/order-fields. - Scegliere una tariffa o un pacchetto.
- Chiamare
/order-requirements. - Mostrare esattamente i campi indicati.
- Invia
/orders.
POST /api/v1/order-requirements
{
"tipo_cliente": "EMPRESA",
"tarifa_id": 2,
"productos": [{"tarifa_id":2,"cantidad":1}]
}Campi di sistema obbligatori
| Campo | Regola |
|---|---|
tipo_cliente | PARTICULAR, AUTONOMO o EMPRESA. |
iban | Obbligatorio e convalidato. |
fibra_misma_direccion | Obbligatorio se la tariffa principale include fibra. Se NO: indirizzo, CAP, località e provincia. |
detalles_productos | Fisso e mobili. Ogni mobile richiede tipo e SIM/ESIM. La portabilità richiede numero e tipo_origen (CONTRATO/PREPAGO); PREPAGO richiede anche l’ICC della scheda di origine come testo. Le nuove offerte Vodafone/Lowi richiedono operador_origen per ogni portabilità. |
aceptacion_privacidad_cliente | Obbligatorio. |
autorizacion_documentos_cliente | Obbligatorio. |
comunicaciones_comerciales_cliente | Facoltativo. |
dni_anverso e dni_reverso | Obbligatori. Per EMPRESA sono quelli dell’amministratore. JPG, PNG, WEBP o PDF, massimo 8 MB per file. |
recibo_bancario | Obbligatorio per MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO. |
recibo_autonomo | Obbligatorio per i lavoratori autonomi con i quattro nuovi operatori. |
cif_empresa | Obbligatorio quando tipo_cliente=EMPRESA. |
escrituras_portada | Copertina o prima pagina dell’atto costitutivo, in un file separato. Obbligatorio per EMPRESA con i quattro nuovi operatori. |
escrituras_administrador | Pagina che indica l’amministratore, in un altro file. Obbligatorio per EMPRESA con i quattro nuovi operatori. |
Esempio detalles_productos
[
{
"tarifa_id": 2,
"unidades": [
{
"moviles": [
{"tipo":"PORTABILIDAD","sim":"ESIM","numero":"600000000","tipo_origen":"PREPAGO","operador_origen":"Orange","icc":"8934000000000000001"}
]
}
]
},
{
"tarifa_id": 5,
"unidades": [
{"fijo":{"tipo":"NUEVO","numero":""}}
]
}
]Valori: NUEVO/PORTABILIDAD e SIM/ESIM.
Chiavi cliente stabili
Usare sempre campo_ID restituito da /order-fields. Il precedente campo_14 mantiene la stessa chiave, ma la sua etichetta corretta è PROVINCIA.
Per EMPRESA, DAVATEL interpreta campo_3 come ragione sociale, non richiede cognomi e mostra campo_5 come CIF.
Errori che impediscono attivazioni incomplete
{"ok":false,"error":"validation_error","campo":"iban","mensaje":"Falta el campo obligatorio: IBAN"}
{"ok":false,"error":"validation_error","campo":"detalles_productos","mensaje":"Falta SIM/eSIM de la línea móvil 1 de CONECTA SENCILLO"}Elettricità e gas
La versione 1.9 permette di inviare bollette, consultare lo studio, scaricare il rapporto di risparmio, indicare che il cliente non aderisce o inviare la richiesta di attivazione.
POST /api/v1/energy-studies · GET /api/v1/energy-studies · GET /api/v1/energy-studies/:referencia/report · POST /decline · POST /contract
Televisione e streaming
Le opzioni proprie di un operatore si combinano solo con quell’operatore. La TV DAVATEL è universale. Netflix, Prime Video, Disney Plus, Movistar Plus, HBO Max, SkyShowtime, DAZN Motor, DAZN Fútbol, DAZN Premium e Filmin non sono considerati da soli televisione lineare.
Sicurezza del browser
La chiave X-API-Key rimane esclusivamente sul server. Il widget e lo strumento di test usano il proxy proprio incluso e non ricevono mai la chiave.
Compatibilità
consentimiento_rgpd continua a essere accettato come alias per la privacy, ma non sostituisce l’autorizzazione dei documenti. tarifa_ids resta disponibile; si consiglia productos. Le chiavi campo_ID non cambiano.
L’API convalida nuovamente il prodotto principale e tutte le opzioni aggiuntive in order-requirements e orders. Gli elenchi «SOLO PARA TARIFAS» nella descrizione del prodotto o nelle condizioni pubbliche devono essere rispettati; una combinazione non consentita restituisce HTTP 400 con error=incompatible_tariff_combination.
File per l’integrazione
MIGRACION_A_API_V1_9.md · openapi-davatel-v1.yaml · DAVATEL_API.postman_collection.json · davatel-api-sdk.js · davatel-widget.js · PROXY_SEGURO_NODE.js