API DAVATEL v1.9 para distribuidores
Comparador de tarifários, catálogo, adesão completa e estudos de poupança de eletricidade e gás. Contrato em vigor: 2026-09-14-COMERCIAL-PREPAGO-V6.
Atualização importante da adesão
A API valida os mesmos dados operacionais que o formulário DAVATEL. Uma adesão incompleta não é guardada: devolve HTTP 400 e indica o campo em falta.
PARTICULARTRABALHADOR INDEPENDENTEEMPRESAFrente e verso do DNIIBAN obrigatórioSIM/eSIM em todas as linhas móveis2 consentimentos obrigatórios
MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO: todos exigem comprovativo bancário; o TRABALHADOR INDEPENDENTE acrescenta o comprovativo da contribuição de trabalhador independente; a EMPRESA acrescenta o CIF, a capa ou primeira página da escritura e a página onde consta o administrador. As duas páginas da escritura devem ser enviadas como ficheiros separados. No caso de EMPRESA, a frente e o verso do DNI são os do administrador.
Novos operadores e confidencialidade
O catálogo público inclui as ofertas residenciais autorizadas de MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO. Desde a V25, as ofertas privadas, BTL e para clientes existentes também entram na API quando estão visíveis e em vigor, mantendo as condições de elegibilidade. Vodafone Mi Negocio Pro só admite EMPRESA com portabilidade; Lowi admite PARTICULAR e AUTONOMO.
MOVISTAR visível sem tarifáriosHUMANITY unificadoOfertas privadas sujeitas a elegibilidade
Catálogo AVATEL atualizado
A AVATEL é apresentada como um único operador para todas as suas coberturas. A API inclui a oferta Back to School/NOVA, CLICtv e os novos pacotes adicionais.
Máximo de 5 linhas AVATELLinhas adicionais sem acumulação de dadosCanal Local por 5 €Pagamentos únicos separados
Cada tarifário devolve condiciones_publicas, vigencia_desde, vigencia_hasta, solo_cliente_nuevo, periodicidad_precio, max_lineas_cliente e gigas_acumulables. Os tarifários expirados não são apresentados. Os produtos com periodicidad_precio=PAGO_UNICO não são somados à mensalidade.
Revisão V7: custo mínimo do pacote
São comparadas combinações completas de adicionais móveis e de televisão compatíveis. A ordenação dá prioridade à mensalidade total em vigor; em caso de empate, à menor mensalidade normal após as promoções e, depois, aos restantes critérios de desempate. Mantêm-se as regras de dados por linha, pacotes partilhados e MULTISIM.
Os campos precio_total, precio_normal_total e fases_precio mantêm o seu formato. A autenticação e os endpoints não mudam.
Atualização comercial V13
As pesquisas aceitam tipo_cliente. O preço atual, as fases por data e as plataformas escolhidas são devolvidos com cada oferta. Uma quota de 1, 2 ou 3 serviços OTT é representada por seleções concretas compatíveis. Os tarifários anteriores não são utilizados para novas adesões a pacotes.
fases_precio pode incluir desde_fecha e hasta_fecha (YYYY-MM-DD) quando uma promoção tem uma data de fim fixa. Mantêm-se as fases antigas por meses para os restantes tarifários. Consulte sempre /order-requirements antes de apresentar o formulário.
Autenticação
X-API-Key: dvt_live_... X-Davatel-Domain: www.tudominio.es
A chave não deve ser exposta em JavaScript público. Utilize um backend/proxy próprio.
Endpoints v1
| Método | Caminho | Utilização |
|---|---|---|
| GET | /api/v1/status | Ligação, versão e contrato. |
| GET | /api/v1/operators | Operadores públicos. |
| GET | /api/v1/rate-types | Tipos de tarifário para filtros. |
| GET | /api/v1/rates | Catálogo sem comissões. |
| GET | /api/v1/rates/:id | Detalhe de um tarifário. |
| POST | /api/v1/rates/search | Comparador de tarifários: preço e serviços. |
| GET | /api/v1/order-fields | Campos de cliente e de sistema. |
| POST | /api/v1/order-requirements | Requisitos exatos para a seleção. |
| POST | /api/v1/orders | Criar uma adesão completa. |
| GET | /api/v1/orders | Listar as adesões do distribuidor. |
| GET | /api/v1/orders/:referencia | Consultar uma adesão. |
Fluxo recomendado
- Consultar
/order-fields. - Escolher um tarifário ou pacote.
- Chamar
/order-requirements. - Apresentar exatamente os campos indicados.
- Enviar
/orders.
POST /api/v1/order-requirements
{
"tipo_cliente": "EMPRESA",
"tarifa_id": 2,
"productos": [{"tarifa_id":2,"cantidad":1}]
}Campos de sistema obrigatórios
| Campo | Regra |
|---|---|
tipo_cliente | PARTICULAR, AUTONOMO ou EMPRESA. |
iban | Obrigatório e validado. |
fibra_misma_direccion | Obrigatório se o tarifário principal incluir fibra. Se NO: morada, código postal, localidade e província. |
detalles_productos | Fixo e móveis. Cada móvel exige tipo e SIM/ESIM. A portabilidade exige número e tipo_origen (CONTRATO/PREPAGO); PREPAGO exige também o ICC do cartão de origem como texto. As novas ofertas Vodafone/Lowi exigem operador_origen em cada portabilidade. |
aceptacion_privacidad_cliente | Obrigatório. |
autorizacion_documentos_cliente | Obrigatório. |
comunicaciones_comerciales_cliente | Opcional. |
dni_anverso e dni_reverso | Obrigatórios. Para EMPRESA são os do administrador. JPG, PNG, WEBP ou PDF, máximo de 8 MB por ficheiro. |
recibo_bancario | Obrigatório em MÁSMÓVIL, PEPEPHONE, JAZZTEL e SIMYO. |
recibo_autonomo | Obrigatório para trabalhadores independentes nos quatro novos operadores. |
cif_empresa | Obrigatório quando tipo_cliente=EMPRESA. |
escrituras_portada | Capa ou primeira página da escritura, num ficheiro separado. Obrigatório para EMPRESA nos quatro novos operadores. |
escrituras_administrador | Página onde consta o administrador, noutro ficheiro. Obrigatório para EMPRESA nos quatro novos operadores. |
Exemplo 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":""}}
]
}
]Valores: NUEVO/PORTABILIDAD e SIM/ESIM.
Chaves estáveis de cliente
Utilize sempre campo_ID devolvido por /order-fields. O antigo campo_14 mantém a mesma chave, mas o seu título correto é PROVÍNCIA.
Para EMPRESA, a DAVATEL interpreta campo_3 como nome da empresa, não exige apelidos e apresenta campo_5 como CIF.
Erros que impedem adesões incompletas
{"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"}Eletricidade e gás
A versão 1.9 permite enviar faturas, consultar o estudo, descarregar o relatório de poupança, indicar que o cliente não adere ou enviar o pedido de adesão.
POST /api/v1/energy-studies · GET /api/v1/energy-studies · GET /api/v1/energy-studies/:referencia/report · POST /decline · POST /contract
Televisão e streaming
Os adicionais próprios só se combinam com o respetivo operador. A TV DAVATEL é universal. Netflix, Prime Video, Disney Plus, Movistar Plus, HBO Max, SkyShowtime, DAZN Motor, DAZN Fútbol, DAZN Premium e Filmin não são considerados, por si só, televisão linear.
Segurança do navegador
A chave X-API-Key permanece exclusivamente no servidor. O widget e a ferramenta de teste utilizam o proxy próprio incluído e nunca recebem a chave.
Compatibilidade
consentimiento_rgpd continua a ser aceite como alias de privacidade, mas não substitui a autorização de documentos. tarifa_ids está disponível; recomenda-se productos. As chaves campo_ID não mudam.
A API volta a validar o produto principal e todos os adicionais em order-requirements e orders. As listas «SOLO PARA TARIFAS» da descrição do produto ou das condições públicas são obrigatórias; uma combinação não permitida devolve HTTP 400 com error=incompatible_tariff_combination.
Ficheiros para integração
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