# Cupom fiscal vira cadastro

> Skill gratuita para o Claude, da Trentin Solutions. Você manda as fotos das notas e cupons de compra, de um ou vários fornecedores, tudo junto. O Claude lê cada nota, confere as contas, cadastra os produtos novos, soma as reposições, calcula o custo médio e sugere o preço de venda na sua planilha.

- Página: https://trentinsolutions.com.br/skills/cupom-fiscal-vira-cadastro
- Download: https://trentinsolutions.com.br/downloads/cupom-fiscal-vira-cadastro.zip
- Versão: 1.0 · atualizada em 2026-10-09 · idioma: pt-BR
- Preço: gratuita · licença CC BY 4.0 (uso livre, inclusive comercial, mantendo o crédito)
- Autor: Ivaldo Trentin, arquiteto de soluções · Trentin Solutions · https://trentinsolutions.com.br
- Requisitos: Claude. Para gravar direto no Google Sheets, conector do Google Drive ou acesso a navegador.

## Para que serve

Dar entrada nas compras de mercadoria sem digitar nota por nota: produtos cadastrados com código, custo e preço sugerido, e estoque atualizado com as reposições.

## O que ela lê

1. XML de NF-e ou NFC-e (fonte mais confiável).
2. Cupom fiscal com QR code (NFC-e): lê o QR, valida a chave de acesso e consulta os itens na página pública da SEFAZ. Se a consulta pedir CAPTCHA, lê pela foto.
3. Nota ou cupom sem QR code (cupom antigo, DANFE, talão, pedido): leitura da foto linha a linha, conferindo cada conta.
4. Compra sem nota: foto ou mensagem com nome, quantidade, valor e fornecedor.

Aceita lote misturado: várias fotos, XMLs e links de fornecedores diferentes. Agrupa as fotos de cada nota e descarta fotos repetidas.

## Onde ela grava

- Planilha do Google Sheets existente (pelo link): só acrescenta linhas, sem escrever em colunas com fórmula.
- Excel existente: devolve uma cópia atualizada.
- Planilha nova, com as abas Produtos, Compras, Fornecedores, Despesas, Conferência, Config e Como usar.

## Como funciona

1. Destino e markup (perguntado só na primeira vez).
2. Lote: agrupar fotos por nota, separar fornecedores, descartar repetidas.
3. Leitura pela fonte mais confiável: XML, SEFAZ pelo QR ou foto.
4. Conferência: quantidade × unitário em cada linha, soma contra o total impresso, chave de acesso válida, nota já lançada.
5. Cadastro: casamento por EAN, código do fornecedor ou descrição. Produto novo ganha código (provisório se a nota não trouxer) e preço sugerido; reposição soma no estoque e mantém o preço.
6. Prévia com novos, reposições e dúvidas. Grava só depois do ok.

## Como o custo é calculado

- Desconto e frete da nota são rateados nos itens, na proporção do valor de cada um.
- Kits vendidos avulsos são abertos por unidade (quantidade × unidades por kit; custo ÷ unidades).
- Custo médio ponderado: soma de todos os custos do produto ÷ soma das quantidades compradas.
- Preço sugerido = custo unitário × markup, arredondado para cima até um preço redondo (configurável).
- Exemplo: 3 kits de 6 marca-textos a R$ 15,00, com R$ 2,25 de desconto rateado, dão 18 unidades a R$ 2,38. Com markup 2×, o preço sugerido é R$ 5.

## Regras que ela nunca quebra

- Nota que não fecha com o total não é lançada sem a decisão da pessoa.
- Prévia antes de gravar.
- Nunca apaga, reordena ou sobrescreve dados, nem escreve em célula com fórmula.
- Nota lançada uma vez só (chave de acesso ou fornecedor + número).
- Não inventa: código criado é provisório, preço calculado é sugerido, trecho ilegível vira pergunta.
- Não resolve CAPTCHA nem digita senha. Não busca fotos de produtos.

## Conteúdo do pacote

- SKILL.md, README.md, LICENSE.md
- references/leitura.md: como ler cada tipo de nota, kits, compra × despesa
- references/formato.md: formato dos dados e da configuração
- references/planilhas.md: planilha nova, Excel, Google Sheets e mapa de colunas
- scripts/ler_xml_nfe.py: lê XML de NF-e e NFC-e
- scripts/ler_qrcode.py: lê o QR code das fotos e valida a chave de acesso
- scripts/lancar.py: confere, casa com o cadastro e grava a planilha

## Instalação

1. Baixe o .zip.
2. Envie o arquivo na área de Skills das configurações do Claude.
3. Mande as notas: "Lança essas notas na minha planilha de estoque", com as fotos e o link.

## Perguntas frequentes

**Como cadastrar produtos de uma nota fiscal numa planilha usando IA?** Instale esta skill no Claude e mande as fotos ou o XML das notas com o link da planilha. Ela confere, cadastra e só grava depois da sua aprovação.

**Funciona com vários fornecedores ao mesmo tempo?** Sim, pode mandar tudo junto.

**E se a planilha tiver outro formato?** Ela monta um mapa de colunas para você confirmar e só acrescenta linhas.

**Ela busca fotos dos produtos?** Não.

**Substitui o contador?** Não; organiza o controle de estoque e custo.

## Apoie

A skill é gratuita. Quem quiser agradecer pode mandar um Pix de qualquer valor para a chave aleatória b73301d4-682f-46a0-857a-3a7653c2befb (Ivaldo Idalgo Trentin Junior Ltda).