Migración única API DAVATEL

Contrato de contratación 2026-08-11 · API v1.1

Objetivo

Esta actualización sincroniza la API con el formulario actual de DAVATEL. Para evitar nuevas modificaciones posteriores, no mantenga un formulario estático: consulte los endpoints dinámicos de campos y requisitos.

Flujo que debe implementar

GET /api/v1/order-fields
El cliente selecciona tarifa principal y adicionales.
POST /api/v1/order-requirements
Mostrar exactamente los campos/requisitos devueltos.
POST /api/v1/orders como multipart/form-data.
Guardar la referencia devuelta y consultar GET /api/v1/orders/:referencia.

Nuevos controles obligatorios

tipo_cliente: PARTICULAR o EMPRESA.
IBAN: obligatorio y validado.
Fibra: si la principal incluye fibra, indicar si la instalación usa la misma dirección; si NO, dirección, CP, población y provincia.
Fijo: NUEVO/PORTABILIDAD y número si es portabilidad.
Cada móvil: NUEVO/PORTABILIDAD y siempre SIM/ESIM; si es portabilidad, número actual.
Las reglas de fijo/móvil se aplican también a productos adicionales.
DNI anverso y reverso.
Autorización de privacidad/tramitación y autorización de datos/documentos. Consentimiento comercial opcional.

Compatibilidad

Las claves campo_ID no cambian.
campo_14 conserva su clave, pero el título correcto es PROVINCIA.
tarifa_ids sigue aceptado; se recomienda productos.
consentimiento_rgpd sigue como alias de privacidad, pero no sustituye autorizacion_documentos_cliente.

Ejemplo de detalles de producto

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

Validación antes de publicar

Alta con móvil nuevo + SIM.
Alta con portabilidad móvil + eSIM + número.
Sin IBAN debe devolver HTTP 400.
Sin SIM/eSIM debe devolver HTTP 400.
Portabilidad sin número debe devolver HTTP 400.
Fibra en otra dirección sin provincia debe devolver HTTP 400.
Alta correcta debe devolver HTTP 201, referencia y contrato_version.
Consultar la referencia creada y comprobar su estado.

Documentación

Portal de desarrolladores · Consulte también API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml y la colección Postman incluida en el paquete técnico.