Changelog API Grafeno: 2026-07-13

Improved: [API de Onboarding, Cobranças, Transferências e Beneficiários] Suporte a CNPJs alfanuméricos

Adicionamos suporte ao novo formato de CNPJ alfanumérico nas APIs de Onboarding, Cobranças, Transferências e Beneficiários.

Com a mudança regulatória que introduz o CNPJ alfanumérico, as 12 primeiras posições do número passam a aceitar letras (A–Z) e dígitos (0–9), mantendo as 2 últimas posições (dígitos verificadores) sempre numéricas. A estrutura geral de 14 caracteres e a máscara permanecem inalteradas — muda apenas a composição dos caracteres. A partir desta atualização, o campo documentNumber dessas APIs aceita e retorna valores nesse novo formato.

APIs impactadas:

• Onboarding — criação de contas Grafeno.
• Cobranças — criação e consulta de cobranças.
• Transferências — criação e consulta de transferências.
• Beneficiários — cadastro e consulta de beneficiários.

Exemplo de formato

JB.EJV.1L5/0001-71

{
  "documentNumber": "JBEJV1L5000171"
}

Impacto esperado para integrações

• Nenhum impacto esperado. O campo documentNumber sempre foi tratado como string no contrato das nossas APIs, então valores alfanuméricos são aceitos sem qualquer alteração de tipo ou de estrutura.
• A entrega é aditiva e retrocompatível. CNPJs numéricos continuam funcionando normalmente.
• Recomendação: integrações que aplicam validações ou formatações próprias sobre o documentNumber (por exemplo, regex que aceita apenas dígitos, ou conversão do valor para tipo numérico) devem revisar essa lógica para acomodar caracteres alfabéticos e evitar rejeições indevidas.

Tratar o documentNumber como string desde o início garantiu que essa evolução regulatória não exigisse nenhuma quebra de contrato: suas integrações passam a operar com CNPJs alfanuméricos sem necessidade de reimplementação.

Acesse a documentação de referência Grafeno para mais detalhes sobre os campos e formatos suportados.