Atenção! Esta funcionalidade ainda não está disponível para todos os clientes e será disponibilizada gradualmente. Acompanhe as próximas atualizações para saber quando ela estará disponível em seu ambiente.
Ao importar o XML de uma nota fiscal em Compras, o Sienge normalmente exige que cada item da nota fiscal seja vinculado a um insumo cadastrado no sistema. Essa regra também se aplica quando o insumo faz parte de um kit, composição ou lista técnica.
Em alguns casos, como notas administrativas, de serviços, regularizações ou compras que não possuem relação direta com itens físicos de estoque, esse vínculo item a item pode dificultar o lançamento da nota.
Para esses casos, é possível utilizar o vínculo por valor.
Nesse modo, o atendimento do pedido de compra é realizado com base no valor da nota e das entregas vinculadas, sem a necessidade de validar individualmente cada item da nota fiscal.
A conferência dos valores ocorre em dois momentos:
- No vínculo dos itens: o sistema compara o valor dos itens da NF-e com o valor das entregas do pedido vinculadas.
- Na aba Título: o sistema valida a totalização dos valores.
Cada uma dessas etapas possui uma tolerância de divergência configurável.
Os itens do XML continuam sendo importados para a nota fiscal, mas não são utilizados para realizar a validação individual dos insumos. Os demais dados fiscais do XML continuam alimentando o título normalmente.
Pré-requisitos
- Recurso de vínculo por valor disponível no ambiente (liberação controlada pelo Sienge).
- Tolerância de divergência configurada nas autorizações de suprimentos, para uso por usuários comuns.
- Acesso à tela de vínculo de itens da NF-e em Compras (importação de XML).
- Perfil de usuário: administrador do sistema ou usuário comum (o comportamento muda conforme o perfil — ver seção específica).
Nota! O vínculo por valor vem desativado por padrão e é ativado sob demanda, de forma controlada. Enquanto não estiver ativado no ambiente, a coluna Vínculo por valor e as tolerâncias de divergência não aparecem, e o lançamento de XML continua exigindo a validação de itens como hoje.
Passo a passo
Validações dispensadas
No modo por valor, o sistema não executa nenhuma destas validações:
- Preço unitário do insumo
- Frete
- IPI
- Quantidade
Item do XML correspondente a KIT tem o mesmo comportamento dos demais: é atendido como item simples, sem abrir os componentes.
A conferência passa a ser por valor — em dois pontos
Em vez de conferir item a item, o sistema verifica o valor em dois momentos, cada um com sua própria tolerância de divergência (detalhadas na Parte 2):
1ª parte: Associação entre os itens da nota fiscal e a entrega do pedido de compra (N→1)
Existe uma validação na associação entre os itens da nota fiscal e os itens da entrega do pedido de compra. Essa validação considera o valor do preço unitário do item da nota fiscal x a quantidade, comparando-o com o valor da quantidade entregue × o preço líquido do insumo.
Existe uma configuração nas Autorizações de Suprimentos que permite uma divergência entre esses valores. Essa configuração está na opção 19, na subseção "Nota Fiscal".
2ª parte: A segunda validação, que é a descrita neste tópico, ocorre na aba "Título".
Essa validação também possui uma configuração que permite divergência entre os valores. Trata-se da opção 20, na subseção "Notas Fiscais" das Autorizações de Suprimentos.
É a combinação dessas duas conferências que libera ou bloqueia o lançamento, sempre respeitando as tolerâncias configuradas nas autorizações de suprimentos.
Atenção! Divergência acima do limite percentual configurado na permissão bloqueia o atendimento. O limite vale para todos os usuários comuns. Lançamentos com divergência dentro do limite ficam registrados na auditoria do Sienge, visível ao cliente.
Quantidade e estoque
- A quantidade informada para atendimento é rateada em partes iguais entre os itens selecionados da NF-e.
- O estoque é movimentado pela quantidade atendida do pedido, nunca pelas quantidades declaradas no XML.
- As informações fiscais do título continuam sendo preenchidas a partir do XML, como no fluxo atual.
Restrição desta entrega (N:1)
Nesta primeira versão, o vínculo por valor permite associar vários itens da NF-e a um único item de entrega do pedido (N:1). Ao marcar o vínculo por valor de uma entrega, a seleção de outras entregas fica bloqueada; e com mais de uma entrega já selecionada, o vínculo por valor fica indisponível.
Confira na imagem a tela de vínculo de itens da NF-e: coluna “Vínculo por valor” na tabela “Entregas de Pedidos Pendentes”.
Parte 2) Configurar a tolerância de divergência
A tolerância define quanta divergência de valor o usuário comum pode ter ao concluir um vínculo por valor. É configurada em: Segurança › Autorizações › Usuários (ou Perfis) › Suprimentos — seção Notas Fiscais de Compra.
Há dois pontos de conferência, cada um com sua tolerância:
Tolerância | Onde é aplicada | Como funciona |
Divergência de valor nos itens | No momento do vínculo dos itens da NFe com o insumo do pedido.
| Percentual único. Compara os itens da NF-e selecionados com as entregas do pedido selecionadas. |
Divergência no valor total (valor ou percentual). | No salvamento da aba Título da nota fiscal de compra. | Valor absoluto OU percentual — mutuamente exclusivos. Compara o total da NF-e com o valor dos pedidos efetivamente atendidos. |
Dica! O valor 0 (zero) significa “nenhuma divergência tolerada” — qualquer diferença bloqueia o usuário comum. As tolerâncias funcionam igual nos modos por usuário e por perfil, e são transportadas na cópia de autorizações.
Confira na imagem a autorizações de suprimentos: campos de tolerância de divergência na seção “Notas Fiscais de Compra”.
Parte 3) Passo a passo: lançar XML por valor
- Importe o XML da nota fiscal e abra a tela de vínculo de itens em Compras.
- Selecione o(s) item(ns) da NF-e que deseja lançar.
- Na tabela Entregas de Pedidos Pendentes, marque a entrega do pedido que será atendida.
- Marque o checkbox da coluna Vínculo por valor para a entrega selecionada.
- Na tabela Entregas de Pedidos Pendentes, marque a entrega do pedido que será atendida. Em seguida, marque o checkbox da coluna Vínculo por valor para a entrega selecionada e salve.
- Caso o valor seja idêntico, o vínculo será concluído.
- Caso exista divergência entre o valor do item da NF-e e o valor atendido do insumo no pedido, para usuários comuns, o sistema validará a permissão 19 em Segurança > Autorizações > Usuários/Perfis > Suprimentos > seção Notas Fiscais de Compra. Somente será realizado o vínculo se o usuário tiver permissão suficiente.
- Por fim, para concluir o lançamento da nota fiscal de compra, realize o salvamento da aba Título da nota. Nesse momento, o sistema analisará o valor total da nota fiscal e o comparará com o valor total atendido do pedido de compra. Caso exista divergência de valor, para usuários comuns, o sistema validará a permissão 20 em Segurança > Autorizações > Usuários/Perfis > Suprimentos > seção Notas Fiscais de Compra.
Confira na imagem o fluxo de seleção: item da NF-e → entrega do pedido → opção “Vínculo por valor”.
Confira na imagem o salvamento das informações na aba Título da nota.
Resultado esperado
O lançamento do XML é concluído sem as conferências de preço do insumo, frete, IPI e quantidade. Os itens da nota entram como informativos e os kits não são desmembrados; o estoque é movimentado pela quantidade atendida do pedido e o título recebe os dados fiscais do XML.
Parte 4) Comportamento por perfil
Situação | Administrador do sistema | Usuário comum |
Divergência de valor: no momento do vínculo do item da NFe com o insumo do pedido | Conclui o vínculo mesmo com divergência acima de qualquer limite, sem bloqueio. | Conclui apenas quando a divergência está dentro da tolerância configurada. |
Divergência acima do limite: no salvamento da aba título da Nota | Não é bloqueado; o lançamento fica registrado na auditoria do Sienge. | É bloqueado. A seleção é preservada para correção. |
Validações de preço, frete, IPI e quantidade | Dispensadas no modo por valor. | Dispensadas no modo por valor. |
Parte 5) Mensagens e bloqueios
Quando a divergência excede o limite tolerado, o usuário comum recebe uma mensagem de bloqueio informando o total da NF-e, o total do pedido, a divergência apurada e o percentual (ou valor) permitido. Exemplos:
O vínculo por valor não pode ser concluído. Total da NF-e: R$2.561,65. Total do pedido: R$ 8.900,00. Divergência: 71,21%. Percentual permitido: 0,00%,
O vínculo por valor não pode ser concluído. Total da NF-e: R$2.561,65. Total do pedido: R$ 8.000,00. Divergência: 67,97%. Percentual permitido: 67,95%,
Informação: Não é possível salvar o título. O total da nota fiscal (R$3.546,90) diverge do total atendido nos pedidos (R$3.941,00) em R$394,10, acima da tolerância permitida de R$100,00. Revise os valores da nota ou o atendimento dos pedidos. Se a divergência estiver correta, é necessária autorização de suprimentos para confirmar.
Cenários comuns
Kit desmembrado na nota
A nota traz vários itens (ex.: componentes de um kit) que, juntos, atendem um único item do pedido. Eles são vinculados por valor a essa entrega, com a quantidade rateada proporcionalmente, sem explodir a composição.
Divergência dentro e fora da tolerância
Com tolerância de 2%, uma NF-e de R$ 10.000,00 contra um pedido de R$ 9.850,00 é liberada (1,52%). Contra um pedido de R$ 9.500,00, é bloqueada para o usuário comum (5,26%).
Pontos de atenção e limites
- O estoque é sempre movimentado pela quantidade atendida do pedido, nunca pela quantidade do XML.
- Devolução, cancelamento e NF-e complementar da nota lançada por valor não fazem parte deste comportamento.
- Atendimentos parciais sucessivos do mesmo pedido por várias notas lançadas por valor não estão contemplados.
- Não há explosão automática de kit, reconciliação de composições nem validação quantitativa item x kit.
- Regras fiscais, escrituração e fluxo financeiro seguem inalterados.
Esperamos que este artigo tenha ajudado!