01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Tipo de Documento:Legislação
Módulo:Conector VTEX
Caminho: Conector VTEX > Agendamento de Carga > Clientes B2B
Função:CARGAS DO VTEX - ITGVRJ_0007
País:
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DSUPXOMNI-4492

02. SITUAÇÃO/REQUISITO

Foi detectada a necessidade de ajustes no CNPJs para passar a serem emitidos em formato alfanumérico, como medida para ampliar a capacidade de registros, diante da limitação do modelo apenas numérico.

O sistema estava preparado apenas para lidar com CNPJs compostos exclusivamente por números, o que gera inconsistências quando são utilizados valores alfanuméricos. Diante dessa mudança, tornou-se necessário adaptar o sistema para receber, validar, processar e armazenar corretamente CNPJs alfanuméricos, garantindo, ao mesmo tempo, a compatibilidade com os registros numéricos já existentes.

03. PRÉ-REQUISITOS

Ter disponível clientes com CNPJ alfanumérico para realizar a carga de Clientes B2B.

Ter disponível fornecedores CNPJ alfanumérico para realizar a carga de Fornecedor.

Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.

04. SOLUÇÃO

Foram implementadas as adequações necessárias no sistema para permitir o tratamento e envio de CNPJs alfanuméricos na carga de Clientes B2B e Fornecedores.

Contudo, foi identificado um impedimento externo na plataforma VTEX:

Ao realizar a carga de Cliente B2B ou de Fornecedor informando CNPJ alfanumérico, está ocorrendo o erro "CNPJ must have exactly 14 digits".

Após realizar abertura de chamado para o suporte da VTEX, eles confirmaram que a correção desta limitação está prevista apenas para o segundo semestre de 2026.

Desta forma, devemos levar em conta que, até lá, qualquer envio com CNPJ alfanumérico continuará sendo rejeitado pela VTEX.

05. REQUISITOS DE VERSÃO

Se estiver na versão 26.01, atualizar o sistema para o service pack 26.01.001 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA