DAVATEL API Migration (One-time)

Service Agreement 2026-08-11 · API v1.1

Objective

This update synchronizes the API with the current DAVATEL form. To avoid the need for future modifications, do not use a static form; instead, refer to the dynamic endpoints for fields and requirements.

Workflow to be implemented

GET /api/v1/order-fields
The customer selects a primary plan and any additional services.
POST /api/v1/order-requirements
Display exactly the fields/requirements returned.
POST /api/v1/orders such as multipart/form-data.
Save the referencia returned data and consult GET /api/v1/orders/:referencia.

New mandatory checks

customer_type: INDIVIDUAL or BUSINESS.
IBAN: Required and validated.
Fiber: If the primary plan includes fiber, indicate whether the installation is at the same address; if NOT, provide the address, postal code, town/city, and province.
Landline: NEW/PORTABILITY; if it is a porting request, include the phone number.
Each mobile line: NEW/PORTABILITY and specify SIM/eSIM; if it is a porting request, include the current phone number.
The rules for landline/mobile services also apply to additional products.
National ID card (DNI) (front and back).
Privacy/processing authorization and data/document authorization. Optional commercial consent.

Compatibility

The keys campo_ID are unchanged.
campo_14 the key is retained, but the correct label is PROVINCE.
tarifa_ids remains accepted; it is recommended productos.
consentimiento_rgpd remains as a privacy alias, but does not replace autorizacion_documentos_cliente.

Example of product details

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

Validation before publishing

New mobile subscription + SIM.
Mobile subscription with number portability + eSIM + phone number.
If the IBAN is missing, it must return HTTP 400.
If a SIM/eSIM is missing, it must return HTTP 400.
If the phone number is missing during portability, it must return HTTP 400.
If the province is missing for fiber service at a different address, it must return HTTP 400.
A successful subscription must return HTTP 201, referencia and contrato_version.
Check the created reference and verify its status.

Documentation

Developer Portal · See also API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml and the Postman collection included in the technical package.