DAVATEL 分销商 API v1.9
套餐查询、目录、完整业务办理以及电力和燃气节省分析。当前接口协议： 2026-09-14-COMERCIAL-PREPAGO-V6.
业务办理重要更新
API 验证与 DAVATEL 表单相同的业务数据。不完整的业务申请不会保存，而会返回 HTTP 400 并指出缺失字段。
个人自雇人士企业DNI 证件正反面必须填写 IBAN所有移动线路均须指定 SIM/eSIM2 项必需同意声明
MÁSMÓVIL、PEPEPHONE、JAZZTEL 和 SIMYO： 所有这些运营商均要求银行凭证；自雇人士还须提供自雇缴费凭证；企业还须提供 CIF、公司章程封面或首页，以及载明管理人的页面。两页章程必须作为独立文件发送。企业提交的 DNI 正反面须属于管理人。
新运营商与保密性
公共目录包含 MÁSMÓVIL、PEPEPHONE、JAZZTEL 和 SIMYO 经授权的住宅客户优惠。自 V25 起，私人、BTL 和存量客户优惠在可见且有效时也纳入 API，并保留适用资格条件。Vodafone Mi Negocio Pro 仅接受 EMPRESA 且须携号转网；Lowi 接受 PARTICULAR 和 AUTONOMO。
MOVISTAR 可见但无资费统一 HUMANITY须符合资格的私人优惠
已更新的 AVATEL 目录
AVATEL 的所有覆盖区域统一显示为一个运营商。API 包含 Back to School/NOVA 优惠、CLICtv 及新的附加包。
最多 5 条 AVATEL 线路附加线路流量不可结转Canal Local 价格为 5 €单独列出一次性付款
每项资费返回 condiciones_publicas, vigencia_desde, vigencia_hasta, solo_cliente_nuevo, periodicidad_precio, max_lineas_cliente 和 gigas_acumulables。已过期的资费不会显示。具有以下属性的产品： periodicidad_precio=PAGO_UNICO 不会计入月费。
V7 修订：组合套餐最低费用
比较兼容的移动和电视附加产品的完整组合。排序优先考虑当前总月费；相同时优先选择促销结束后常规月费较低的组合，再应用其他排序规则。保留每条线路流量、共享流量池及 MULTISIM 规则。
字段 precio_total, precio_normal_total 和 fases_precio 保留原有格式。身份验证和端点保持不变。
V13 商业更新
搜索支持 tipo_cliente。每个优惠均返回当前价格、按日期划分的阶段和所选平台。1、2 或 3 个 OTT 服务名额以具体的兼容选择表示。旧资费不用于新组合套餐的办理。
fases_precio 可以包含 desde_fecha 和 hasta_fecha （YYYY-MM-DD），适用于有固定结束日期的促销。其他资费保留原有按月划分的阶段。请务必查询 /order-requirements 再显示表单。
身份验证
X-API-Key: dvt_live_... X-Davatel-Domain: www.tudominio.es
不得在公开的 JavaScript 中暴露密钥。请使用自己的后端或代理。
v1 端点
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/v1/status | 连接、版本和接口协议。 |
| GET | /api/v1/operators | 公开运营商。 |
| GET | /api/v1/rate-types | 用于筛选的资费类型。 |
| GET | /api/v1/rates | 不含佣金的目录。 |
| GET | /api/v1/rates/:id | 资费详情。 |
| POST | /api/v1/rates/search | 套餐查询：价格和服务。 |
| GET | /api/v1/order-fields | 客户和系统字段。 |
| POST | /api/v1/order-requirements | 所选组合的确切要求。 |
| POST | /api/v1/orders | 创建完整业务申请。 |
| GET | /api/v1/orders | 列出分销商的业务申请。 |
| GET | /api/v1/orders/:referencia | 查询业务申请。 |
推荐流程
- 查询
/order-fields. - 选择资费或组合套餐。
- 调用
/order-requirements. - 严格显示指定字段。
- 发送
/orders.
POST /api/v1/order-requirements
{
"tipo_cliente": "EMPRESA",
"tarifa_id": 2,
"productos": [{"tarifa_id":2,"cantidad":1}]
}必填系统字段
| 字段 | 规则 |
|---|---|
tipo_cliente | PARTICULAR、AUTONOMO 或 EMPRESA。 |
iban | 必填且须验证。 |
fibra_misma_direccion | 主套餐包含光纤时必填。若为 NO：须提供地址、邮编、城市和省份。 |
detalles_productos | 固定电话和移动线路。每条移动线路须提供类型及 SIM/ESIM。携号转网须提供号码和 tipo_origen（CONTRATO/PREPAGO）；PREPAGO 还须以文本形式提供原卡 ICC。新的 Vodafone/Lowi 优惠要求每次携号转网提供 operador_origen。 |
aceptacion_privacidad_cliente | 必填。 |
autorizacion_documentos_cliente | 必填。 |
comunicaciones_comerciales_cliente | 选填。 |
dni_anverso 和 dni_reverso | 必需。对于 EMPRESA，应为管理人的证件。支持 JPG、PNG、WEBP 或 PDF，每个文件最大 8 MB。 |
recibo_bancario | MÁSMÓVIL、PEPEPHONE、JAZZTEL 和 SIMYO 要求提供。 |
recibo_autonomo | 四家新运营商均要求自雇人士提供。 |
cif_empresa | 在以下情况下必填： tipo_cliente=EMPRESA. |
escrituras_portada | 公司章程封面或首页，须作为独立文件。四家新运营商均要求 EMPRESA 提供。 |
escrituras_administrador | 载明管理人的页面，须放在另一文件中。四家新运营商均要求 EMPRESA 提供。 |
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":""}}
]
}
]值： NUEVO/PORTABILIDAD 和 SIM/ESIM.
固定客户字段键
请始终使用 campo_ID 由以下接口返回： /order-fields。原有字段 campo_14 保留相同的键，但正确标签为 省份.
对于 EMPRESA，DAVATEL 将 campo_3 作为公司名称，不要求填写姓氏，并将 campo_5 显示为 CIF。
防止不完整申请的错误
{"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"}电力和燃气
版本 1.9 支持提交账单、查询分析、下载节省报告、标明客户不办理，或提交业务申请。
POST /api/v1/energy-studies · GET /api/v1/energy-studies · GET /api/v1/energy-studies/:referencia/report · POST /decline · POST /contract
电视与流媒体
运营商自有附加产品仅可与该运营商组合。DAVATEL TV 通用。Netflix、Prime Video、Disney Plus、Movistar Plus、HBO Max、SkyShowtime、DAZN Motor、DAZN Fútbol、DAZN Premium 和 Filmin 本身不视为线性电视。
浏览器安全
密钥 X-API-Key 仅保留在服务器上。小组件和测试器使用附带的自有代理，绝不会接收密钥。
兼容性
consentimiento_rgpd 仍可用作隐私同意的别名，但不能替代文件授权。 tarifa_ids 仍然可用；建议使用 productos。字段键 campo_ID 保持不变。
API 会在以下接口重新验证主产品及所有附加产品： order-requirements 和 orders。必须遵守产品说明或公开条件中的“SOLO PARA TARIFAS”列表；不允许的组合会返回 HTTP 400，并附带 error=incompatible_tariff_combination.
集成文件
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