Migração única da API DAVATEL

Contrato de contratação 2026-08-11 API v1.1

Alvo

Esta atualização sincroniza a API com o formulário DAVATEL atual. Para evitar novas modificações posteriormente, não mantenha um formulário estático: consulte o campo dinâmico e os pontos finais dos requisitos.

Fluxo que deve ser implementado

GET /api/v1/order-fields
O cliente seleciona as tarifas principal e adicional.
POST /api/v1/order-requirements
Mostrar exatamente os campos/requisitos devolvidos.
POST /api/v1/orders como multipart/form-data.
Guarde o referencia devolvido e consulta GET /api/v1/orders/:referencia.

Novos controlos obrigatórios

tipo_cliente: INDIVÍDUO ou EMPRESA.
IBAN: Obrigatório e validado.
Fibra: se o principal incluir fibra, indicar se a instalação utiliza o mesmo endereço; Se NÃO, morada, código postal, cidade e província.
Corrigido: NOVO/PORTABILIDADE e número em caso de portabilidade.
Cada telemóvel: NOVO/PORTABILIDADE e sempre SIM/ESIM; se for portabilidade, número atual.
As regras fixas/móveis também se aplicam a produtos adicionais.
DNI frente e verso.
Autorização/processamento de privacidade e autorização de dados/documentos. Consentimento comercial opcional.

Compatibilidade

As Chaves campo_ID não mudam.
campo_14 Mantém a sua palavra-passe, mas o título correto é PROVÍNCIA.
tarifa_ids ainda aceite; é recomendado productos.
consentimiento_rgpd Permanece como alias de privacidade, mas não substitui autorizacion_documentos_cliente.

Exemplo de detalhes do produto

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

Validação antes da publicação

Registo com novo telemóvel + SIM.
Registo com portabilidade móvel + eSIM + número.
Sem IBAN deverá retornar HTTP 400.
Nenhum SIM/eSIM deve devolver HTTP 400.
A portabilidade sem número deve retornar HTTP 400.
Fibra para outro endereço sem província deverá retornar HTTP 400.
O registo bem-sucedido deve retornar HTTP 201, referencia e contrato_version.
Consulta a referência criada e verifica o seu estado.

Documentação

Portal do programador · Ver também API_DISTRIBUIDORES_DAVATEL.md, openapi-davatel-v1.yaml e a coleção Postman incluída no pacote técnico.