En esta página
Los contactos de Brasil exigen documento y aceptan CNPJ alfanumérico
Qué hacer: si tu integración crea contactos de Brasil sin documento, envía documentType (CPF o CNPJ) y documentNumber. Si validas el CNPJ de tu lado, actualiza el validador para aceptar letras en los primeros 12 caracteres. Los contactos que ya existen no cambian.
Qué pasaba
Al crear un contacto con countrySymbol: "BR" sin documento, el contacto se creaba igual y el pago fallaba después, en el proveedor.
Qué cambió
El documento es obligatorio. Al crear un contacto con countrySymbol: "BR" sin CPF ni CNPJ, la API responde 400 con el código CT00048:
{
"ok": false,
"error": {
"code": "CT00048",
"message": "documentType and documentNumber (CPF or CNPJ) are required for Brazil contacts"
}
}El CNPJ puede ser alfanumérico. Desde julio de 2026 la Receita Federal asigna CNPJ alfanuméricos a empresas nuevas: 12 caracteres entre letras y números, seguidos de 2 dígitos verificadores numéricos. Los CNPJ numéricos siguen siendo válidos, así que la API acepta los dos formatos, con o sin máscara y también en minúsculas.
Un contacto de empresa con un CNPJ alfanumérico se crea así:
curl -X POST 'https://api.koywe.com/api/v1/organizations/{organizationId}/merchants/{merchantId}/contacts' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"firstName": "Empresa Ejemplo Ltda",
"countrySymbol": "BR",
"businessType": "COMPANY",
"type": "BUSINESS",
"documentType": "CNPJ",
"documentNumber": "12.ABC.345/01DE-35"
}'Las reglas completas (cuándo se valida al crear y al editar, formatos y duplicados) están en Contactos y cuentas bancarias.