API DAVATEL v1.9 pentru distribuitori
Căutare de tarife, catalog, contractare completă și studii de economisire la electricitate și gaze. Contract în vigoare: 2026-09-14-COMERCIAL-PREPAGO-V6.
Actualizare importantă privind contractarea
API-ul validează aceleași date operaționale ca formularul DAVATEL. O cerere de contractare incompletă nu se salvează: se returnează HTTP 400 cu indicarea câmpului lipsă.
PERSOANĂ FIZICĂLUCRĂTOR INDEPENDENTCOMPANIEAmbele fețe ale DNIIBAN obligatoriuSIM/eSIM pentru toate liniile mobile2 consimțăminte obligatorii
MÁSMÓVIL, PEPEPHONE, JAZZTEL și SIMYO: toți solicită o dovadă bancară; LUCRĂTORUL INDEPENDENT adaugă dovada contribuției pentru activitatea independentă; COMPANIA adaugă CIF, coperta sau prima pagină a actului constitutiv și pagina care identifică administratorul. Cele două pagini ale actului constitutiv trebuie trimise ca fișiere separate. Pentru COMPANIE, cele două fețe ale DNI aparțin administratorului.
Operatori noi și confidențialitate
Catalogul public include ofertele rezidențiale autorizate de la MÁSMÓVIL, PEPEPHONE, JAZZTEL și SIMYO. Din V25, ofertele private, BTL și pentru clienții existenți sunt incluse și în API când sunt vizibile și valabile, cu păstrarea condițiilor de eligibilitate. Vodafone Mi Negocio Pro acceptă doar EMPRESA cu portabilitate; Lowi acceptă PARTICULAR și AUTONOMO.
MOVISTAR vizibil fără tarifeHUMANITY unificatOferte private supuse eligibilității
Catalog AVATEL actualizat
AVATEL este afișat ca un singur operator pentru toate zonele sale de acoperire. API-ul include oferta Back to School/NOVA, CLICtv și noile pachete suplimentare.
Maximum 5 linii AVATELLinii suplimentare fără reportarea datelorCanal Local la 5 €Plăți unice separate
Fiecare tarif returnează condiciones_publicas, vigencia_desde, vigencia_hasta, solo_cliente_nuevo, periodicidad_precio, max_lineas_cliente și gigas_acumulables. Tarifele expirate nu sunt afișate. Produsele cu periodicidad_precio=PAGO_UNICO nu se adaugă la taxa lunară.
Revizia V7: costul minim al pachetului
Sunt comparate combinații complete de opțiuni mobile și TV compatibile. Ordinea prioritizează taxa totală curentă; la egalitate, cea mai mică taxă normală după promoții, apoi celelalte criterii de departajare. Se păstrează regulile privind datele pe linie, pachetele partajate și MULTISIM.
Câmpurile precio_total, precio_normal_total și fases_precio își păstrează formatul. Autentificarea și endpointurile nu se modifică.
Actualizare comercială V13
Căutările acceptă tipo_cliente. Prețul curent, etapele în funcție de dată și platformele selectate sunt returnate cu fiecare ofertă. Un număr de 1, 2 sau 3 servicii OTT este reprezentat prin selecții concrete compatibile. Tarifele anterioare nu sunt folosite pentru contractarea unor pachete noi.
fases_precio poate include desde_fecha și hasta_fecha (YYYY-MM-DD) când o promoție are o dată de încheiere fixă. Etapele anterioare pe luni se păstrează pentru celelalte tarife. Consultați întotdeauna /order-requirements înainte de a afișa formularul.
Autentificare
X-API-Key: dvt_live_... X-Davatel-Domain: www.tudominio.es
Nu expuneți cheia în JavaScript public. Folosiți un backend/proxy propriu.
Endpointuri v1
| Metodă | Rută | Utilizare |
|---|---|---|
| GET | /api/v1/status | Conexiune, versiune și contract. |
| GET | /api/v1/operators | Operatori publici. |
| GET | /api/v1/rate-types | Tipuri de tarife pentru filtre. |
| GET | /api/v1/rates | Catalog fără comisioane. |
| GET | /api/v1/rates/:id | Detaliile unui tarif. |
| POST | /api/v1/rates/search | Căutare de tarife: preț și servicii. |
| GET | /api/v1/order-fields | Câmpuri de client și de sistem. |
| POST | /api/v1/order-requirements | Cerințele exacte pentru selecție. |
| POST | /api/v1/orders | Crearea unei cereri de contractare complete. |
| GET | /api/v1/orders | Listarea cererilor de contractare ale distribuitorului. |
| GET | /api/v1/orders/:referencia | Consultarea unei cereri de contractare. |
Flux recomandat
- Consultați
/order-fields. - Alegeți un tarif sau un pachet.
- Apelați
/order-requirements. - Afișați exact câmpurile indicate.
- Trimite
/orders.
POST /api/v1/order-requirements
{
"tipo_cliente": "EMPRESA",
"tarifa_id": 2,
"productos": [{"tarifa_id":2,"cantidad":1}]
}Câmpuri de sistem obligatorii
| Câmp | Regulă |
|---|---|
tipo_cliente | PARTICULAR, AUTONOMO sau EMPRESA. |
iban | Obligatoriu și validat. |
fibra_misma_direccion | Obligatoriu dacă tariful principal include fibră. Dacă NO: adresă, cod poștal, localitate și provincie. |
detalles_productos | Telefonie fixă și mobilă. Fiecare linie mobilă necesită tipul și SIM/ESIM. Portabilitatea necesită numărul și tipo_origen (CONTRATO/PREPAGO); PREPAGO necesită și ICC-ul cartelei de origine ca text. Noile oferte Vodafone/Lowi necesită operador_origen pentru fiecare portare. |
aceptacion_privacidad_cliente | Obligatoriu. |
autorizacion_documentos_cliente | Obligatoriu. |
comunicaciones_comerciales_cliente | Opțional. |
dni_anverso și dni_reverso | Obligatorii. Pentru EMPRESA sunt documentele administratorului. JPG, PNG, WEBP sau PDF, maximum 8 MB per fișier. |
recibo_bancario | Obligatoriu pentru MÁSMÓVIL, PEPEPHONE, JAZZTEL și SIMYO. |
recibo_autonomo | Obligatoriu pentru lucrătorii independenți la cei patru operatori noi. |
cif_empresa | Obligatoriu când tipo_cliente=EMPRESA. |
escrituras_portada | Coperta sau prima pagină a actului constitutiv, într-un fișier separat. Obligatoriu pentru EMPRESA la cei patru operatori noi. |
escrituras_administrador | Pagina care identifică administratorul, într-un alt fișier. Obligatoriu pentru EMPRESA la cei patru operatori noi. |
Exemplu 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 și SIM/ESIM.
Chei stabile pentru client
Folosiți întotdeauna campo_ID returnat de /order-fields. Vechiul campo_14 păstrează aceeași cheie, dar eticheta corectă este PROVINCIE.
Pentru EMPRESA, DAVATEL interpretează campo_3 ca denumire a companiei, nu solicită nume de familie și afișează campo_5 ca CIF.
Erori care împiedică activările 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"}Electricitate și gaze
Versiunea 1.9 permite trimiterea facturilor, consultarea studiului, descărcarea raportului de economisire, indicarea refuzului clientului de a contracta sau trimiterea cererii de contractare.
POST /api/v1/energy-studies · GET /api/v1/energy-studies · GET /api/v1/energy-studies/:referencia/report · POST /decline · POST /contract
Televiziune și streaming
Opțiunile proprii unui operator se combină doar cu acel operator. TV DAVATEL este universală. Netflix, Prime Video, Disney Plus, Movistar Plus, HBO Max, SkyShowtime, DAZN Motor, DAZN Fútbol, DAZN Premium și Filmin nu sunt considerate, singure, televiziune liniară.
Securitatea browserului
Cheia X-API-Key rămâne exclusiv pe server. Widgetul și instrumentul de testare folosesc proxy-ul propriu inclus și nu primesc niciodată cheia.
Compatibilitate
consentimiento_rgpd este acceptat în continuare ca alias pentru confidențialitate, dar nu înlocuiește autorizarea documentelor. tarifa_ids rămâne disponibil; se recomandă productos. Cheile campo_ID nu se modifică.
API-ul validează din nou produsul principal și toate opțiunile suplimentare în order-requirements și orders. Listele „SOLO PARA TARIFAS” din descrierea produsului sau din condițiile publice trebuie respectate; o combinație nepermisă returnează HTTP 400 cu error=incompatible_tariff_combination.
Fișiere pentru integrare
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