Nota que não fecha não passa.
A soma dos itens é comparada com o total da própria nota. Se não bate até o centavo, ela não conta como lida.
NF-e, NFC-e ou cupom SAT. Envie a chave e receba cada item com produto, marca e categoria, com o total conferido até o centavo e pronto para usar.
27
estados com NF-e, o Brasil inteiro
23
estados com NFC-e, o cupom do varejo
3
modelos de nota: NF-e, NFC-e e cupom SAT
R$ 0,00
de diferença aceita entre os itens e o total
Sem foto de nota e sem ninguém digitando item por item.
Os 44 números impressos na NF-e e no cupom, ou o QR Code do cupom. Por API, em volume, ou pelo celular de quem comprou.
Emitente, data, cada item, descontos, pagamento e total, a partir do registro oficial da nota.
Cada item ligado a produto, marca e categoria, num formato que entra direto no seu sistema.
A descrição abreviada que vem na nota vira produto, marca e categoria. É o dado que mostra o que saiu da prateleira, loja por loja.
DET LIQ YPE NEUTRO 500ML
REFRIG GUAR ANTARC 2L FD6
PAP HIG NEVE FL DUPLA 12UN
OLEO SOJA LIZA 900ML CX20
Nada de conferir foto de cupom. Ou a nota fecha, ou você sabe exatamente por que não.
A soma dos itens é comparada com o total da própria nota. Se não bate até o centavo, ela não conta como lida.
Lida, inválida ou ainda indisponível: cada envio volta com um status que você pode mostrar direto para quem enviou.
A nota fiscal eletrônica nos 27 estados. Para pessoa física, ela vem com todos os itens; para empresa com inscrição estadual, vem o resumo da nota.
O cupom do varejo em 23 estados, o que cobre 86,5% das NFC-e de uma amostra real de campanha. No Rio Grande do Sul, pelo QR Code.
Ainda sem NFC-e: TO, PA, RR e RJ.
O cupom SAT de São Paulo, para cupons já emitidos.
Medido com notas reais em 03/10/2026.
Envie a chave, receba um aviso quando a leitura terminar e use a nota já estruturada no seu sistema.
curl -X POST https://app.lupanf.suddensoft.com/api/v1/submissions \
-H "Authorization: Bearer $LUPA_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"access_key": "35261052614873000138550010000123451406182731"}'
HTTP/1.1 202 Accepted Content-Type: application/json{ "data": { "token": "qR7vK2mXwP9sLd4nT8yZbE1cH6uJ0gAfVoWiNkYrQ3s", "id": "01a0fcc0-5be0-7d2e-9f41-3c8e5a7b2d90", "status": "queued", "status_label": "Na fila", "is_in_flight": true, "can_retry": false, "access_key": "35261052614873000138550010000123451406182731", "federative_unit": "SP", "failure": null, "summary": null, "attempts": null, "retry_after": null, "created_at": "2026-10-02T13:14:20+00:00", "completed_at": null } }
POST https://seu-sistema.com.br/webhooks/lupa X-Lupa-Signature: b8f19461bbb05e60ac3452d5e8c27e91d991568dd3dd723a39e99cdcd7647f1b X-Lupa-Timestamp: 1790946970 X-Lupa-Idempotency-Key: 01a0fcc0-5be0-7d2e-9f41-3c8e5a7b2d90:submission.completed Content-Type: application/json{ "event": "submission.completed", "data": { "token": "qR7vK2mXwP9sLd4nT8yZbE1cH6uJ0gAfVoWiNkYrQ3s", "id": "01a0fcc0-5be0-7d2e-9f41-3c8e5a7b2d90", "status": "completed", "status_label": "Concluída", "is_in_flight": false, "can_retry": false, "access_key": "35261052614873000138550010000123451406182731", "federative_unit": "SP", "failure": null, "summary": null, "attempts": 1, "retry_after": null, "created_at": "2026-10-02T13:14:20+00:00", "completed_at": "2026-10-02T13:16:09+00:00", "receipt": { "id": "01a0fcc2-05a8-7a6b-8c5d-e4f1a2b3c4d5", "access_key": "35261052614873000138550010000123451406182731", "merchant": { "document": "52614873000138", "name": "Atacado Boa Praça", "city": "Jundiaí", "federative_unit": "SP" }, "issued_at": "2026-10-02T13:14:05+00:00", "total_cents": 86000, "discount_cents": 3006, "other_cents": 0, "payment_method": "Boleto Bancário", "item_count": 4, "reconciled": true, "items": [ { "line_number": 1, "raw_description": "REFRIG GUARANA ANTARCTICA 2L FD 6UN", "quantity": 4, "unit": "FD", "unit_price": "47.9400000000", "total_cents": 19176, "gtin": "7896153041723", "product": { "name": "Refrigerante Guaraná Antarctica 2L", "brand": "Antarctica", "category": "Refrigerantes", "category_path": "bebidas\/refrigerantes" }, "resolution": { "layer": "gtin", "confidence": 100, "needs_review": false } }, { "line_number": 2, "raw_description": "OLEO SOJA LIZA 900ML CX 20UN", "quantity": 1, "unit": "CX", "unit_price": "159.8000000000", "total_cents": 15980, "gtin": "7896153042188", "product": { "name": "Óleo de Soja Liza 900ml", "brand": "Liza", "category": "Oleos", "category_path": "mercearia\/oleos" }, "resolution": { "layer": "gtin", "confidence": 100, "needs_review": false } } // + linhas 3 e 4, no mesmo formato ] } } }
A mesma leitura serve a campanhas, programas de relacionamento e áreas que precisam provar uma compra.
Valide a compra de cada participante sem conferir foto: a nota existe, é do período e leva o produto da campanha.
Pague o cashback no item certo, da marca certa, e não sobre o valor inteiro da nota.
Saiba quais marcas saem em cada loja e em cada estado, item por item.
Confirme que a nota apresentada é real e que o valor bate com o reembolso pedido.
Teste agora com uma nota sua, ou fale com a gente para levar a Lupa para a sua operação.
Fale com a gente para levar a Lupa para a sua operação.