ADRES (BDUA)

Consulta a afiliação de uma pessoa ao Sistema General de Seguridad Social en Salud na Base de Datos Única de Afiliados (BDUA), a partir da ADRES. POST /co/adres/affiliation-status/v1

Campo	Tipo	Notas
`document_number`	string	Obrigatório. Entre 3 e 30 caracteres.
`document_type`	enum	Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). O padrão é `CC`.

curl https://api.croma.run/co/adres/affiliation-status/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'

A resposta reporta a identidade registrada e cada afiliação no registro:

Campo	Notas
`found`	`false` quando o documento não está registrado na BDUA; nesse caso os campos de identidade são `null` e `affiliations` fica vazio.
`full_name`	Nomes e sobrenomes registrados, ou `null` quando não é encontrado.
`department` / `municipality`	Localização registrada.
`affiliations[]`	Uma entrada por afiliação reportada: `entity` (a EPS), `regime` (`CONTRIBUTIVO`/`SUBSIDIADO`), `status`, `effective_date`, `termination_date` e `affiliate_type`.

Uma termination_date de 31/12/2999 indica que a afiliação continua vigente com essa entidade. As informações de afiliação refletem o que a EPS reporta à ADRES.

Esta consulta pode demorar mais que uma solicitação típica. É um trabalho assíncrono. Por padrão a solicitação aguarda de forma síncrona e retorna { data }, ou você pode fazer polling ou usar um callback_url. Os valores aceitos de document_type estão enumerados na referência da API.

Referência completa

Tipos de documento aceitos, esquemas e um playground interativo.

Primeiros passos

Países

Referência completa