Bloqueia
Campo [Nome Fantasia] em branco
Campo [Razão Social] em branco
AtençãoFora do Brasil, na inclusão, deixar a razão social vazia não dá erro: ela é preenchida sozinha com o nome fantasia. No Brasil os dois são digitados.
Todos
Recusa e não grava. Chega como statuscode 400 com a frase abaixo.
Pergunta antes de gravar. Confirmando, a tela reenvia com o campo de confirmação ligado.
Campo que aparece desabilitado por permissão, em vez de recusar na gravação.
O Tipo de Emitente decide quais regras valem: funcionário, vendedor e cliente têm travas próprias.
O que decide quase tudo nesta tela é o Tipo de Emitente. O mesmo cadastro serve a
cliente, fornecedor, transportadora, funcionário e vendedor, e as siglas marcadas na grade de
tipos ligam regras diferentes — FUN (funcionário) e VEN (vendedor)
são as que mais aparecem em chamado.
Países: as regras mudam com parametros.codicfj — 004 Brasil,
001/002 Paraguai, 003 Bolívia. A validação de documento é
a que mais varia.
Conferidos em toda gravação, na ordem abaixo — a primeira que falhar é a que aparece.
Campo [Nome Fantasia] em branco
Campo [Razão Social] em branco
AtençãoFora do Brasil, na inclusão, deixar a razão social vazia não dá erro: ela é preenchida sozinha com o nome fantasia. No Brasil os dois são digitados.
Campo [Cidade] em branco
Campo [Endereço] em branco
ConferirA cidade é um lookup: id digitado que não existe é descartado pela tela ao sair do campo, e o campo fica vazio.
Selecione ao menos um Tipo de Emitente
QuandoA grade de tipos está vazia. É o campo que liga as demais regras — ver a nota do começo.
Só o Brasil valida dígito verificador. Nos demais países o documento é texto livre — e na Bolívia ele é obrigatório, sem conferência de formato.
CNPJ inválido!
CPF inválido!
QuandoSó no Brasil. O documento é formatado e o dígito verificador conferido; qual dos dois é decidido pelo próprio documento — 14 dígitos é pessoa jurídica.
ConferirDocumento com dígito errado, colado com caractere invisível, ou CPF digitado num campo esperando CNPJ.
Campo [NIT] em branco
QuandoSó na Bolívia: o documento é obrigatório. Nos demais países fora do Brasil ele pode ficar vazio.
Documento repetido é bloqueio no Brasil e pergunta fora dele. A identificação, ao contrário, é bloqueio em qualquer lugar.
Já existe esse CNPJ/CPF no emitente [ 1023474 ]!
QuandoNo Brasil, outro emitente já tem esse documento. O id do emitente existente vem na mensagem — vale conferir antes de criar outro.
EscapaGrupo ADM. E o CNPJ da própria empresa é livre.
PermissãoTipo de grupo ADM. Não há regra nomeada para isso.
Já existe esse CNPJ/CPF no emitente [ 1023474 ]!
QuandoFora do Brasil, a mesma situação vira pergunta: confirmando, grava mesmo assim. É o que o sistema antigo faz.
Já existe essa identificação [ABC123] no emitente [ 1023474 ]!
QuandoOutro emitente já usa essa identificação, em qualquer país. Identificação vazia não é conferida.
Emitente marcado como funcionário tem travas próprias, e elas valem só onde o RH não é do próprio sistema — Brasil e Bolívia têm módulo de RH e ficam de fora dessas travas.
Não é permitido incluir funcionário!
QuandoIncluir emitente marcado como FUN, fora das bases com RH próprio.
PermissãoTipo de grupo ADM. Funcionário normalmente entra pelo módulo de RH, não por aqui.
Não é permitido modificar funcionário!
QuandoAlterar um emitente que já é funcionário, fora das bases com RH próprio.
PermissãoTipo de grupo ADM, CON, GRH, GCO ou FAT.
Não é permitido modificar funcionário com contrato!
QuandoO funcionário tem contrato de RH — a trava aperta.
PermissãoTipo de grupo ADM ou FAT, só esses dois. Um usuário do RH (GRH) altera funcionário comum e não altera funcionário com contrato.
Marcar ou desmarcar o papel de vendedor mexe na estrutura comercial, então no Brasil isso é decisão do Crédito — não de quem edita o cadastro.
Sem Coordenador definido!
QuandoBrasil, emitente marcado como VEN sem coordenador de venda informado.
Apenas Crédito pode trocar classificação de Vendedor!
QuandoBrasil, filial com análise de crédito, alteração em que a marcação VEN mudou — tanto ao marcar quanto ao desmarcar.
NoteSó dispara quando a marcação muda. Alterar outros campos de um emitente que já é vendedor passa normalmente.
PermissãoTipo de grupo CRE, CCR ou CR2 — os grupos de Crédito.
Bloquear um cliente que ainda tem pedido não faturado deixa esse pedido preso: ele não vira venda e ninguém vê por quê. Por isso a ação exige permissão própria.
Existem pedidos em aberto para este emitente (214 pedido(s), peso 4310804.549) — bloquear exige a regra BLOQUEAR_EMITENTE_COM_PEDIDOS_ABERTOS.
QuandoBrasil, marcando Bloqueado num emitente que tem pedido de venda ainda não faturado, com peso maior que zero. A quantidade de pedidos e o peso vêm na mensagem.
Só na transiçãoRegravar um emitente que já estava bloqueado não passa por aqui — a conferência é do momento em que ele é bloqueado, como o clique no sistema antigo.
EscapaOs tipos de faturamento configurados na filial como "não contam como pedido aberto" ficam de fora da conta. A exceção da filial de COLINA saiu em 12/09/2026 — o sistema antigo deixou de tê-la, e a trava vale em todo o Brasil.
SairFaturar ou cancelar os pedidos, ou conceder a regra a quem bloqueia.
PermissãoBLOQUEAR_EMITENTE_COM_PEDIDOS_ABERTOS, no grupo de acesso ou no usuário. Master passa.
Diferença em relação ao sistema antigo: lá a trava mora no clique do campo — sem a regra, ele desmarca o Bloqueado e cancela a gravação. Aqui ela recusa com a mensagem acima, e o campo continua como a pessoa deixou. Desmarcar em silêncio gravaria o oposto do que foi pedido.
O sistema antigo também olhava só o primeiro pedido em aberto do retorno, e contava itens já excluídos do pedido. Aqui vale "existe algum pedido em aberto com peso maior que zero" — a trava alcança casos que lá passavam.
Conta bancária deve conter o dígito, separado por "-"
QuandoBrasil e Paraguai (001): conta preenchida sem o hífen. Conta vazia passa.
Exemplo aceito12345-6
CEP deve ter 8 dígitos.
Não foi possível consultar o CEP agora: …
O serviço de CEP respondeu HTTP 500
QuandoNa busca de endereço pelo CEP. As duas últimas são falha do serviço externo, não do cadastro — o endereço continua podendo ser digitado à mão.
A consulta de cadastro so aceita CNPJ (14 caracteres).
Contribuinte nao habilitado na SEFAZ.
QuandoNa consulta do cadastro do contribuinte na SEFAZ. A segunda é resposta do fisco, não recusa do sistema: aquele CNPJ não está habilitado naquela UF.
NoteA consulta usa o certificado digital da filial. Falhando por certificado, a mensagem é outra e menciona o erro técnico.
Os dados de crédito têm gravação própria — limite de venda, tolerância de atraso, seguradora, prazos e observação financeira. É essa aba que alimenta as cores e as travas do Pedido de Venda.
Limite de venda não pode ser negativo.
Tolerância de atraso não pode ser negativa.
Valor aprovado pela seguradora não pode ser negativo.
NoteZero é aceito nos três — e limite zerado tem efeito no pedido: aparece como "emitente sem limite de venda cadastrado" na análise de crédito.
Não pode apagar observação financeira.
QuandoO emitente já tinha observação financeira e a gravação vem com ela vazia.
Por quêA observação é histórico de crédito — pode ser alterada, não apagada. Para "limpar", substitua por um texto que registre o que mudou.
Alguns campos não recusam na gravação: eles chegam travados na tela. Quando alguém diz "o campo está cinza", é esta seção. A trava vale só no Brasil, e só em filial com análise de crédito.
| Campo | Fica travado quando |
|---|---|
| Bloqueado | Brasil, filial com análise de crédito, e o usuário sem a regra HABILITA_ALTERACAO_ANALISE_CREDITO |
| Encerrado | |
| Observação financeira | |
| Endereço | Mesma condição, mas só na alteração — na inclusão o endereço é digitável por qualquer um |
| Código folha de pagamento | A base usa o módulo de RH — aí o código vem de lá e não se digita aqui. Independe de país e de regra |
Fora do Brasil, ou em filial sem análise de crédito, nenhum desses campos é travado. Se o usuário está no Paraguai e diz que o campo está cinza, a causa é outra — provavelmente o registro estar em modo de consulta.
Nesta tela quase tudo é tipo de grupo; há uma única regra nomeada. Usuário master passa por cima das regras nomeadas.
| Regra | Libera o quê |
|---|---|
HABILITA_ALTERACAO_ANALISE_CREDITO |
Os campos Bloqueado, Encerrado, Observação financeira e Endereço, no Brasil com análise de crédito (seção H) |
BLOQUEAR_EMITENTE_COM_PEDIDOS_ABERTOS |
Bloquear um emitente que ainda tem pedido de venda em aberto (seção E) |
| Tipo de grupo | Destrava nesta tela |
|---|---|
| ADM | Gravar documento duplicado (Brasil) · incluir funcionário · alterar funcionário, inclusive com contrato |
| FAT | Alterar funcionário, inclusive com contrato |
| CON, GRH, GCO | Alterar funcionário sem contrato |
| CRE, CCR, CR2 | Trocar a classificação de Vendedor (Brasil, com análise de crédito) |
Outras regras de emitente cadastradas que esta tela não consulta:
BLOQUEAR_EMITENTE,
EDITAR_ENDERECO_EMITENTE, HABILITA_CAMPOS_GERAIS_ANALISE_CREDITO,
HABILITA_EDICAO_FATURISTA_EMITENTE, IMPORTA_CONTAS_EMITENTES_DOMINIO e
TOKEN_ORCAMENTO_EMITENTE_PRAZO_MENOR_30_DIAS. Conceder qualquer uma delas
não muda nada na tela web hoje.
Toda resposta sai com HTTP 200; quem diz o que aconteceu é o
statuscode dentro do corpo.
| statuscode | Significa |
|---|---|
| 400 | Validação de negócio recusou — é o caso de tudo neste documento |
| 404 | Emitente não encontrado |
| 401 | Sessão expirada |
| 503 | Banco ocupado — restore ou manutenção |
A gravação do emitente é uma transação só, e ela escreve em várias tabelas — cabeçalho, tipos, propriedades, timbrados, prazos, contas. Falhando no meio, nada é gravado: não existe emitente salvo pela metade. Ao reproduzir um erro, a base volta ao estado anterior sozinha.
Ao abrir chamado, copie o código de ocorrência de 8 caracteres dos erros inesperados — com ele o suporte acha a linha exata no log, entre todos os clientes.
| Onde | O que está fixo no código |
|---|---|
| Alterar funcionário | Listas de tipo de grupo: ADM, CON, GRH, GCO, FAT e, com contrato, ADM, FAT |
| Trocar classificação de vendedor | Grupos de crédito CRE, CCR, CR2 |
| Travas de funcionário | Valem fora de Brasil e Bolívia — são as bases sem RH próprio |
| Dígito na conta bancária | Exigido só em Brasil e Paraguai (001) |
O que ainda não existe na versão web, e por isso não aparece neste documento: a importação de emitentes. Vários campos da aba Crédito/Prazo que o sistema antigo desabilita por permissão — percentual de desconto, grade de prazos, percentual de adiantamento, segmentação, crédito monitorado — ainda não têm a trava de campo aqui: eles gravam pelas validações da seção G, sem a permissão de campo da seção H.
Nenhuma regra bate com essa busca. Tente um trecho menor da mensagem, ou limpe os filtros.