Colômbia — Guia de documentos de identidade
Use esta página quando não souber qual tipo de documento o usuário possui ou qual endpoint Verifik chamar. Cada documento colombiano tem emissor e caminho de API diferentes.
Tabela de decisão rápida
| Se a pessoa tem… | Nome comum | Endpoint Verifik | Campos obrigatórios | Comprimento típico | Aceito nesta API |
|---|---|---|---|---|---|
| CC | Cédula de Ciudadanía (ID nacional) | GET/POST /v2/co/cedula | documentType=CC, documentNumber | 3–10 dígitos (hoje comum: 8 ou 10 NUIP) | 5–10 dígitos |
| PPT (nomes / dados civis) | Permiso de Protección Temporal | GET/POST /v2/co/cedula | documentType=PPT, documentNumber | Até 7 dígitos (alguns sistemas preenchem até 15) | 5–10 dígitos neste caminho |
| PPT (status migratório) | Mesmo permiso, Migración Colombia | GET/POST /v2/co/foreigner-id/ppt | documentNumber, expeditionDate | Até 7 dígitos | String obrigatória + data DD/MM/AAAA |
| CE | Cédula de Extranjería (residentes estrangeiros) | GET/POST /v2/co/foreigner-id/ce | documentNumber, expeditionDate | Geralmente 6–7 dígitos | String obrigatória + data DD/MM/AAAA |
| PEP | Permiso Especial de Permanencia (imigração) | GET/POST /v2/co/foreigner-id/pep | documentNumber, expeditionDate | 15 dígitos (fixo) | String obrigatória + data DD/MM/AAAA |
Como informar o número
- Envie somente dígitos — sem pontos, espaços ou traços (Verifik remove caracteres não numéricos).
- Não preencha com zeros à esquerda salvo se for assim no documento físico ou no seu sistema.
- Erro 409: verifique o limite em
/v2/co/cedula(5–10) ouexpeditionDateausente/incorreta nas rotas foreigner-id.
Distinção importante: PEP
| Termo | Significado | Produto Verifik |
|---|---|---|
| PEP (documento) | Permiso Especial de Permanencia — permissão de imigração | /v2/co/foreigner-id/pep |
| Pessoas politicamente expostas (PEP) | Triagem PLD / conformidade | /v2/co/politically-exposed-persons (CC ou NIT) — veja PEP colombiano (PLD) |
Não envie número de PEP de imigração ao endpoint PLD de pessoas politicamente expostas, nem o contrário.
Perguntas frequentes
Devo usar CC ou CE?
CC se a pessoa é cidadã colombiana (Cédula de Ciudadanía). CE se é residente estrangeiro (Cédula de Extranjería). Fontes governamentais e endpoints Verifik diferentes.
Qual endpoint PPT devo usar?
Use /v2/co/cedula com documentType=PPT para dados de nome/identidade semelhantes à cédula. Use /v2/co/foreigner-id/ppt para status migratório da Migración Colombia — inclua expeditionDate.
Por que meu número CC retorna 409?
Em /v2/co/cedula, documentNumber deve ter 5–10 dígitos após normalização. Menos de 5 dígitos ou formatação que deixa poucos dígitos é rejeitado antes da consulta upstream.