NFC-e e XML: como automatizar a entrada de notas no estoque

O que é o XML da nota, como baixar pela chave de acesso e como a leitura automática elimina a digitação e a conversão manual de fardos, caixas e peças.

Documento fiscal sendo validado e convertido em unidade de estoque

Toda a estrutura de controle de um restaurante — CMV, ficha técnica, custo médio, quebra de estoque — se apoia num único ponto: o que entrou, entrou certo.

E esse ponto é, quase sempre, uma pessoa cansada digitando nota fiscal.

A conta é fácil de fazer. Um restaurante de porte médio recebe entre 60 e 120 notas por mês, com 8 a 30 itens cada. São de 500 a 3.000 linhas para lançar, cada uma exigindo interpretar a descrição do fornecedor, converter a embalagem para a unidade base e conferir o valor. Ninguém faz isso mês após mês sem errar — e cada erro contamina o estoque, o CMV e a margem ao mesmo tempo.

A boa notícia é que essa informação já está estruturada. Você só não está usando.

O XML: o dado que você já tem e não usa

Toda NF-e e toda NFC-e emitida no Brasil gera um arquivo XML — um documento estruturado, legível por máquina, com todos os dados da operação: emitente, destinatário, cada item, quantidade, unidade comercial, valor unitário, impostos e total.

Um trecho simplificado de item:

<det nItem="3">
  <prod>
    <cProd>78412</cProd>
    <xProd>REFRIG COLA FARDO 6X310ML</xProd>
    <uCom>FD</uCom>
    <qCom>4.0000</qCom>
    <vUnCom>21.5000</vUnCom>
    <vProd>86.00</vProd>
  </prod>
</det>

Perceba o que o XML entrega de graça: descrição, unidade comercial (FD = fardo), quantidade (4) e valor unitário (R$ 21,50). Não há nada para digitar — o dado é exato, veio do emissor e é juridicamente válido.

E perceba também o que ele não entrega: quanto isso vale em litros. É exatamente aí que a automação simples para e a maioria dos sistemas devolve o trabalho para o operador.

Como obter o XML das suas compras

São quatro caminhos, do mais para o menos confiável:

  1. Peça ao fornecedor. É obrigação dele disponibilizar o XML da NF-e. Um e-mail configurado para receber automaticamente resolve a maior parte do volume, sem custo.
  2. Portal da SEFAZ do seu estado. Com o certificado digital da empresa, você baixa todas as notas emitidas contra o seu CNPJ. É a fonte mais completa.
  3. Chave de acesso. Aqueles 44 dígitos impressos no rodapé do DANFE permitem consultar e baixar a nota individualmente.
  4. QR Code do cupom (NFC-e). Nas compras de balcão em atacadista, o cupom traz um QR Code que leva direto à nota na SEFAZ. É o caminho para aquela compra emergencial de sábado, feita no cartão da empresa.

Sobre o caso mais comum na prática: boa parte das compras de restaurante é feita em atacado de balcão e sai como NFC-e, não NF-e. Muito sistema de gestão só importa NF-e — e é por isso que, mesmo com “importação automática”, metade das compras continua sendo digitada à mão.

O problema que a automação simples não resolve

Importar o XML e jogar os dados numa tabela é a parte fácil. O problema real começa depois.

Volte ao item do exemplo:

xProd: "REFRIG COLA FARDO 6X310ML"
uCom:  "FD"
qCom:  4

O seu estoque não controla “FD”. Controla litros. Então alguém precisa saber que:

1 fardo  = 6 unidades × 310 ml = 1.860 ml = 1,86 L
4 fardos = 7,44 L
Custo por litro = (4 × 21,50) ÷ 7,44 = R$ 11,56/L

Agora multiplique isso por cada linha de cada nota. E lembre que:

  • Não existe padrão nas descrições. O mesmo produto vira REFRIG COLA FD 6X310, REFRI COLA FARDO C/6, COCA 310ML PACK 6UN ou RFG COLA 6/310 dependendo do fornecedor e do dia.
  • A unidade comercial mente. UN pode significar uma lata, uma caixa com 24 ou uma peça de 4,3 kg. CX pode ser 12 ou 20.
  • Peso variável existe. Carne vendida por peça tem peso diferente em cada nota.
  • O fornecedor troca a embalagem sem avisar. O fardo de 6×310 ml vira 6×350 ml e a descrição continua a mesma.

É por isso que a “importação de XML” da maioria dos sistemas entrega apenas metade do trabalho: os dados entram, mas a conversão para a unidade base — a parte que realmente alimenta a ficha técnica e o custo médio — continua manual.

O que a IA resolve aqui (e o que ela não resolve)

Interpretar REFRIG COLA FARDO 6X310ML e concluir “6 unidades de 310 ml, total 1,86 litros” é um problema de linguagem, não de contabilidade. É reconhecer padrão em texto informal, com abreviação inconsistente e sem gramática — exatamente o que modelos de linguagem fazem bem e o que regras fixas (if descrição contém "FARDO"...) fazem mal.

Um bom motor de importação, então, trabalha em duas camadas separadas:

Camada de interpretação (IA). Lê a descrição livre e propõe a estrutura: embalagem, multiplicador, volume unitário, unidade base de destino.

Camada de matemática (determinística). Aplica a conversão com aritmética exata, garantindo que o subtotal pago permaneça intacto até o último centavo e que a unidade de destino seja compatível com a do insumo.

Essa separação importa muito. A IA pode errar uma interpretação — e é aceitável que erre. O que não pode acontecer é a conta errar. Por isso a conversão em si nunca deve ser feita pelo modelo de linguagem: ele propõe a estrutura, a matemática determinística executa.

Desconfie de automação sem etapa de aprovação. Um sistema que importa a nota e lança direto no estoque, sem uma tela em que você confere e chancela as conversões propostas, está trocando um erro visível (a digitação) por um erro invisível — que é bem pior, porque ninguém o encontra até o inventário não fechar.

Como fica o fluxo na prática

Com interpretação automática e homologação humana, a rotina de entrada vira:

  1. Chega a nota — por e-mail do fornecedor, upload do XML ou leitura do QR Code do cupom no celular.
  2. O sistema extrai os itens direto do XML: descrição, quantidade, unidade comercial, valor.
  3. A IA propõe a conversão de cada item para a unidade base do seu estoque.
  4. Você revisa numa tela só — aprovando em lote o que está óbvio, corrigindo o que não está e marcando o que não controla estoque (material de limpeza, descartável).
  5. Ao confirmar, o estoque sobe, o custo médio ponderado se recalcula e as fichas técnicas afetadas — inclusive as sub-receitas — atualizam em cadeia.
  6. O que você corrigiu vira aprendizado. Da próxima vez que aquele fornecedor mandar a mesma descrição, a conversão já vem pronta e certa.

O passo 6 é o que separa uma automação que melhora com o tempo de uma que exige a mesma correção todo mês. Depois de algumas semanas, a maior parte das notas de fornecedores recorrentes passa direto, e a revisão vira uma conferência de trinta segundos.

O que muda quando a entrada para de ser gargalo

Não é só economia de tempo — embora as 6 a 10 horas mensais recuperadas já paguem o esforço sozinhas. O que muda é a natureza do dado:

  • O custo médio deixa de ser uma foto de três meses atrás e passa a refletir a compra de ontem.
  • As fichas técnicas param de envelhecer em silêncio, porque cada nota importada as recalcula.
  • O estoque teórico fica confiável o bastante para que a quebra medida no inventário signifique alguma coisa.
  • O CMV deixa de ser um número de fechamento contábil e vira indicador de operação, disponível a qualquer momento. É a diferença entre descobrir o problema no dia 5 do mês seguinte e descobrir no dia em que ele aconteceu.

O objetivo final não é digitar menos. É que, quando você olhar o CMV do mês, possa confiar no número — e agir com base nele em vez de discutir se ele está certo.

Pare de calcular CMV na planilha.

Importe a NFC-e, deixe a IA converter as embalagens e veja a margem real de cada prato se atualizar sozinha. 15 dias grátis, sem cartão.

Começar meu teste de 15 dias