Migrazione singola API DAVATEL

Contratto di servizio 2026-08-11 API v1.1

Obiettivo

Questo aggiornamento sincronizza l'API con il modulo DAVATEL corrente. Per evitare nuove modifiche in un secondo momento, non mantenere un modulo statico: fare riferimento al campo dinamico e agli endpoint dei requisiti.

Flusso che deve essere implementato

GET /api/v1/order-fields
Il cliente seleziona la tariffa principale e quella aggiuntiva.
POST /api/v1/order-requirements
Mostra esattamente i campi/requisiti restituiti.
POST /api/v1/orders come multipart/form-data.
Salva il referencia restituito e interrogazione GET /api/v1/orders/:referencia.

Nuovi controlli obbligatori

tipo_cliente: PERSONA FISICA o AZIENDA.
IBAN: Obbligatorio e convalidato.
Fibra: se quello principale prevede fibra, indicare se l'impianto utilizza lo stesso indirizzo; Se NO, indirizzo, CAP, città e provincia.
Risolto: NUOVO/PORTABILITÀ e numero se portabilità.
Ogni cellulare: NOVITÀ/PORTABILITÀ e sempre SIM/ESIM; se portabilità, numero attuale.
Le regole fisse/mobili si applicano anche ai prodotti aggiuntivi.
DNI fronte e retro.
Autorizzazione/trattamento privacy e autorizzazione dati/documenti. Consenso commerciale facoltativo.

Compatibilità

Le chiavi campo_ID non cambiano.
campo_14 Mantiene la password, ma lo è il titolo corretto PROVINCIA.
tarifa_ids ancora accettato; è raccomandato productos.
consentimiento_rgpd rimane come alias privacy, ma non sostituisce autorizacion_documentos_cliente.

Esempio di dettagli del prodotto

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

Convalida prima della pubblicazione

Registrazione con nuovo cellulare + SIM.
Registrazione con portabilità mobile + eSIM + numero.
Senza IBAN dovrebbe restituire HTTP 400.
Nessuna SIM/eSIM deve restituire HTTP 400.
La portabilità senza numero dovrebbe restituire HTTP 400.
La fibra verso un altro indirizzo senza provincia dovrebbe restituire HTTP 400.
La registrazione riuscita dovrebbe restituire HTTP 201, referencia e contrato_version.
Interroga il riferimento creato e verificane lo stato.

Documentazione

Portale per sviluppatori · Vedi anche API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml e la collezione Postino inclusa nel pacchetto tecnico.