Migrare unică API DAVATEL

Contract de servicii 2026-08-11 API v1.1

Țintă

Această actualizare sincronizează API-ul cu formularul DAVATEL curent. Pentru a evita noi modificări ulterioare, nu mențineți o formă statică: consultați câmpul dinamic și punctele finale de cerințe.

Flux care trebuie implementat

GET /api/v1/order-fields
Clientul selectează tarifele principale și suplimentare.
POST /api/v1/order-requirements
Afișați exact câmpurile/cerințele returnate.
POST /api/v1/orders ca multipart/form-data.
Salvați referencia returnat și interogare GET /api/v1/orders/:referencia.

Noi controale obligatorii

client_type: PERSOANA FIZICA sau COMPANIE.
IBAN: Obligatoriu și validat.
Fibră: dacă cel principal include fibră, indicați dacă instalația folosește aceeași adresă; Dacă NU, adresa, codul poștal, orașul și provincia.
Fix: NOU/PORTABILITATE și numărul dacă este portabil.
Fiecare mobil: NOU/PORTABILITATE și întotdeauna SIM/ESIM; dacă portabilitate, numărul curent.
Regulile fixe/mobile se aplică și produselor suplimentare.
DNI fata si spate.
Autorizarea/prelucrarea confidențialității și autorizarea datelor/documentelor. Consimțământ comercial opțional.

Compatibilitate

Cheile campo_ID nu se modifică.
campo_14 Îți păstrează parola, dar titlul corect este PROVINCIE.
tarifa_ids încă acceptat; este recomandat productos.
consentimiento_rgpd Rămâne ca alias de confidențialitate, dar nu înlocuiește autorizacion_documentos_cliente.

Exemplu de detalii despre produs

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

Validare înainte de publicare

Înregistrare cu mobil nou + SIM.
Înregistrare cu portabilitate mobilă + eSIM + număr.
Fără IBAN, ar trebui să returneze HTTP 400.
Niciun SIM/eSIM nu ar trebui să returneze HTTP 400.
Portabilitatea fără număr ar trebui să returneze HTTP 400.
Fibra către o altă adresă fără provincie ar trebui să returneze HTTP 400.
Înregistrarea cu succes ar trebui să returneze HTTP 201, referencia și contrato_version.
Interogați referința creată și verificați starea acesteia.

Documentare

Portal pentru dezvoltatori · Vezi și API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml și colecția Postman inclusă în pachetul tehnic.