Migration unique de l'API DAVATEL

Contrat de service 2026-08-11 API v1.1

Cible

Cette mise à jour synchronise l'API avec le formulaire DAVATEL actuel. Pour éviter de nouvelles modifications ultérieurement, ne conservez pas de formulaire statique : reportez-vous aux points de terminaison des champs et des exigences dynamiques.

Flux à mettre en œuvre

GET /api/v1/order-fields
Le client sélectionne les tarifs principaux et complémentaires.
POST /api/v1/order-requirements
Afficher exactement les champs/exigences renvoyés.
POST /api/v1/orders comme multipart/form-data.
Enregistrez le referencia renvoyé et requête GET /api/v1/orders/:referencia.

Nouveaux contrôles obligatoires

type_client : INDIVIDUEL ou ENTREPRISE.
IBAN : Obligatoire et validé.
Fibre : si la principale inclut la fibre, indiquer si l'installation utilise la même adresse ; Si NON, adresse, code postal, ville et province.
Corrigé : NOUVEAU/PORTABILITÉ et numéro si portabilité.
Chaque mobile : NOUVEAU/PORTABILITÉ et toujours SIM/ESIM ; si portabilité, numéro actuel.
Les règles Fixe/Mobile s'appliquent également aux produits supplémentaires.
DNI recto et verso.
Autorisation/traitement de confidentialité et autorisation de données/documents. Consentement commercial facultatif.

Compatibilité

Les clés campo_ID ne changent pas.
campo_14 Conserve votre mot de passe, mais le titre correct est PROVINCE.
tarifa_ids toujours accepté ; il est recommandé productos.
consentimiento_rgpd reste comme alias de confidentialité, mais ne remplace pas autorizacion_documentos_cliente.

Exemple de détails du produit

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

Validation avant publication

Inscription avec nouveau mobile + SIM.
Inscription avec portabilité mobile + eSIM + numéro.
Sans IBAN, HTTP 400 devrait être renvoyé.
Aucune carte SIM/eSIM ne doit renvoyer HTTP 400.
La portabilité sans numéro doit renvoyer HTTP 400.
La fibre optique vers une autre adresse sans province devrait renvoyer HTTP 400.
L'enregistrement réussi doit renvoyer HTTP 201, referencia et contrato_version.
Interrogez la référence créée et vérifiez son statut.

Documentation

Portail des développeurs · Voir aussi API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml et la collection Postman incluse dans le package technique.