RompeAPI
Los contactos de Colombia piden documento
Publicado el
Hasta ahora, crear un contacto de Colombia por API no pedía documento. Desde el 20 nov 2026, todo contacto de Colombia (countrySymbol: "CO") necesita un documento de identidad. Es la misma regla que ya aplica en Brasil, y la que la plataforma ya pedía al crear un contacto.
Antes y ahora
| Antes | Ahora | |
|---|---|---|
| Crear un contacto de Colombia por API sin documento | Se creaba | Responde 400 con CT00050 |
| Crear el contacto desde la plataforma | Ya pedía documento | Sin cambios |
Qué cambia
- Al crear un contacto de Colombia,
documentTypeydocumentNumberson obligatorios. - Al editarlo, se valida de nuevo si cambias el país o el documento.
- Al eliminar documentos, el contacto tiene que conservar al menos uno de los aceptados.
Si falta el documento, la API responde 400 con el código CT00050.
Documentos aceptados
| Documento | documentType |
|---|---|
| Cédula de Ciudadanía (CC) | CED_CIU |
| Cédula de Extranjería (CE) | CED_EXT |
| Número de Identificación Tributaria (NIT) | NIT |
| Pasaporte | PP |
RC, NOP y DIE no se aceptan para contactos de Colombia. El detalle de cada tipo está en Contactos y cuentas bancarias.
JSON
{
"firstName": "Juan",
"lastName": "Pérez",
"countrySymbol": "CO",
"businessType": "PERSON",
"type": "PERSON",
"documentType": "CED_CIU",
"documentNumber": "1234567890"
}Contactos que ya existen
Los contactos de Colombia que creaste sin documento no cambian y la API no los rechaza al crear una orden. Pero un pago por ACH o de cuenta a cuenta a uno de ellos se crea y después falla, porque para inscribir la cuenta de destino se necesita el documento del titular.
Qué hacer:
- Envía
documentTypeydocumentNumbercuando crees contactos de Colombia. - Si ya tienes contactos de Colombia sin documento, agrégales uno antes de pagarles por ACH o de cuenta a cuenta: actualiza el contacto con
documentTypeydocumentNumber. Hazlo con esos dos campos; un documento enviado endocuments[]al editar no se guarda.