Koywe
Novedades
En esta página
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

AntesAhora
Crear un contacto de Colombia por API sin documentoSe creabaResponde 400 con CT00050
Crear el contacto desde la plataformaYa pedía documentoSin cambios

Qué cambia

  • Al crear un contacto de Colombia, documentType y documentNumber son 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

DocumentodocumentType
Cédula de Ciudadanía (CC)CED_CIU
Cédula de Extranjería (CE)CED_EXT
Número de Identificación Tributaria (NIT)NIT
PasaportePP

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 documentType y documentNumber cuando 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 documentType y documentNumber. Hazlo con esos dos campos; un documento enviado en documents[] al editar no se guarda.