DAVATEL API单一迁移

雇佣合同 2026-08-11 API v1.1

目标

此更新将 API 与当前的 DAVATEL 表单同步。为了避免以后进行新的修改，不要维护静态形式：引用动态字段和需求端点。

必须实施的流程

GET /api/v1/order-fields
客户选择主要费率和附加费率。
POST /api/v1/order-requirements
准确显示返回的字段/要求。
POST /api/v1/orders 作为 multipart/form-data.
保存 referencia 返回并查询 GET /api/v1/orders/:referencia.

新的强制控制

客户端类型： 个人或公司。
国际银行账号（IBAN）： 必填且须验证。
纤维： 如果主机包含光纤，则表明安装是否使用相同的地址；如果否，请提供地址、邮政编码、城镇和省份。
已修复： 新/携号转网和携号转网的数量。
每个手机： 新颖/便携且始终为 SIM/ESIM；如果可移植，则当前数量。
固定/移动规则也适用于其他产品。
DNI 正面和背面。
数据/文件的隐私授权/处理和授权。可选的商业同意。

兼容性

钥匙 campo_ID 保持不变。
campo_14 保留你的密码，但正确的标题是省份.
tarifa_ids 仍接受；推荐 productos.
consentimiento_rgpd 保留为隐私别名，但不取代 autorizacion_documentos_cliente.

产品详细信息示例

[
  {
    "tarifa_id": 2,
    "unidades": [
      {"moviles":[{"tipo":"PORTABILIDAD","sim":"ESIM","numero":"600000000"}]}
    ]
  }
]

发布前验证

使用新手机+SIM卡注册。
移动便携+eSIM+号码注册。
没有 IBAN 应返回 HTTP 400。
任何 SIM/eSIM 都不应返回 HTTP 400。
没有编号的携号转网应返回 HTTP 400。
光纤到另一个没有省份的地址应返回 HTTP 400。
注册成功应返回 HTTP 201， referencia 和 contrato_version.
查询已创建的引用并查看其状态。

文档

开发者门户 ·另见 API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml 以及技术包中包含的 Postman 系列。