Consulta automática de Notas Destinadas dentro do seu produto
A Spedy consulta a SEFAZ automaticamente, traz as notas destinadas ao CNPJ dos seus clientes, cuida da manifestação e devolve XML e DANFE. Na mesma API que já emite.
Uma requisição
GET /v1/Notas do CNPJ do seu cliente, com filtro por período, situação e manifestação.
Webhooks
inbound_invoice.detected
inbound_invoice.completed
O seu sistema reage quando a nota chega, sem ficar batendo na API.
Distribuidora Vale Norte
3526 0812 3456 7890 0012
R$ 4.180,00
Aguardando manifestação
Integração fiscal consome time sênior que devia estar no seu produto
O seu sistema sabe o que o cliente vende. E o que ele compra?
A emissão você já resolveu. A entrada é o outro lado da conta, e é onde a maioria dos ERPs ainda depende do cliente subir XML na mão.
O seu cliente pede e você não tem o dado
Contas a pagar, entrada de mercadoria e conferência de crédito dependem da nota de compra. Sem ela, o módulo fica pela metade.
Construir do zero não é uma sprint
Distribuição DFe, certificado por empresa, controle de NSU, retentativa, limite de consulta da SEFAZ. Nada disso vira feature no roadmap do seu produto.
A manifestação tem regra e prazo
Ciência vale 10 dias, as outras três são definitivas e duas exigem justificativa. Errar isso na produção do cliente não tem desfazer.
Cada cliente novo é mais um certificado para gerenciar
Multiempresa muda o problema de escala: validade, renovação e falha de consulta viram chamado no seu suporte, não no da SEFAZ.
Não é outra integração. É a mesma API da emissão
No modelo mais comum do mercado, emitir e consultar são dois produtos: dois contratos, dois setups, duas integrações. Aqui muda a chamada.
Três passos, nenhum deles fiscal
Certificado, distribuição DFe, controle de NSU e limite de consulta da SEFAZ ficam do nosso lado.
- 01
Habilite a empresa do seu cliente
Uma chamada nas configurações da empresa liga a consulta automática e define a data de início. Também dá para fazer pela tela, se preferir.
- 02
Receba o webhook quando a nota aparecer
A Spedy consulta a SEFAZ automaticamente e dispara inbound_invoice.detected. O seu sistema reage no evento, sem polling.
- 03
Manifeste e consuma o documento
Registrada a manifestação, chega o inbound_invoice.completed com o XML autorizado e o DANFE prontos para o seu fluxo.
Request
GET /v1/inbound-product-invoices
Authorization: Bearer <sua-chave>
initialDate="2026-08-01"
endDate="2026-08-31"
manifestationStatus="pending"
limit=50
Response
{
"data": [
{
"accessKey": "35260812345678900012...",
"issuer": { "name": "Distribuidora Vale Norte" },
"totalAmount": 4180.00,
"manifestationStatus": "acknowledged",
"isComplete": true
}
],
"nextCursor": null
}Dois pré-requisitos, ditos agora e não na call
O recurso precisa estar no contrato e cada empresa precisa de certificado digital válido cadastrado. O fluxo acima é o da NF-e, a nota de produto; a NFS-e tomada tem consulta própria, no mesmo contrato. Ver a documentação.
A regra da manifestação você não precisa implementar
São quatro eventos, cada um com o seu prazo. Reversibilidade e justificativa já vêm validadas na chamada: o seu produto só oferece o botão.
Dar ciência
Registra que o cliente sabe da nota, sem validar a operação. Pode ser trocada por outra depois.
Confirmar a operação
A compra aconteceu como está descrita. Fecha a maioria dos casos e não tem como desfazer.
Desconhecer a operação
A nota saiu contra o CNPJ do cliente e ele não reconhece nada daquilo. Fica registrado na SEFAZ.
Operação não realizada
A operação era conhecida, mas não se concretizou. Recusa de mercadoria é o caso mais comum.
A manifestação transmite na hora. O documento completo chega no webhook, no ritmo da SEFAZ.
O documento é a matéria-prima. O produto é o que vem depois
A Spedy entrega o documento estruturado. O que o seu time faz com ele diferencia o seu sistema.
Contas a pagar automático
A nota entra estruturada, com valor, vencimento e emissor. O cliente confere em vez de digitar.
Entrada de mercadoria sem digitação
Os itens do XML viram entrada de estoque no seu ERP, com código, quantidade e custo.
Conciliação entre pedido e nota
Compare o que foi comprado com o que o fornecedor faturou e aponte a divergência.
Alerta de nota indevida
Nota sem pedido correspondente vira notificação, dentro do prazo de manifestação.
Escrituração e repasse ao contador
XML autorizado e DANFE prontos para a rotina contábil, sem baixar nada do portal.
Base para crédito tributário
Crédito só existe sobre documento consultado e manifestado. A entrada estruturada é a base do cálculo.
O trabalho existe de qualquer jeito. A escolha é de quem faz
Nada disso é diferencial do seu produto, e tudo custa time sênior.
Sem integração
O seu cliente continua subindo XML na mão, um por um
Construindo em casa
Com a Spedy
Conexão com a SEFAZ
Distribuição DFe, NSU e rejeições
Um endpoint REST e dois webhooks
Certificado dos clientes
Guarda e renovação de um A1 por empresa
Cadastro por empresa, multiempresa nativo
Manifestação
Quatro eventos, prazos e justificativa
Um campo na chamada, regra aplicada
Limite de consulta
Agendamento próprio e risco de bloqueio
Busca periódica gerenciada pela Spedy
Mudança de legislação
Alguém acompanhando cada nota técnica
Do nosso lado, sem release do seu produto
Você não precisa migrar a emissão dos seus clientes
A primeira pergunta de quase toda call técnica, respondida antes dela.
Dá para contratar só a consulta
Se os seus clientes emitem por outro caminho, a consulta de notas destinadas funciona sozinha.
Um contrato para toda a base
Multiempresa nativo: você habilita empresa por empresa dentro do mesmo contrato.
Sandbox antes de produção
Valida o fluxo inteiro em ambiente de teste e só depois aponta a integração para produção.
Franquia do mês
3.240 / 5.000
As duas pontas na mesma volumetria
Sem contrato separado por tipo de documento e sem franquia por empresa da sua base.
A infraestrutura fiscal de quem não quer reinventar a roda
Processamos notas para alguns dos maiores negócios digitais do Brasil.
Vagner Alves & Danilo Singh
Founders · Spedy desde 2021
+12.000
empresas atendidas
+60 milhões
notas fiscais emitidas
+R$ 10 bilhões
em volume processado
+70
integrações disponíveis
Startup brasileira aplica IA para eliminar o principal gargalo na emissão de notas fiscais
Split de pagamentos: por que a Reforma Tributária vai mudar o caixa de todo negócio digital no Brasil
Startup de automação fiscal cresce 143% e se prepara para surfar a onda da reforma tributária
Quantos dos seus clientes já pediram contas a pagar automático?
A consulta de notas destinadas é o dado que falta para esse módulo existir. Chame o time e a gente mostra o endpoint funcionando com um CNPJ de teste.
O que perguntam sobre a consulta de notas destinadas
O que é a consulta de notas destinadas?
É a busca automática das notas destinadas ao CNPJ de uma empresa, ou seja, emitidas por terceiros contra ela: as notas de compra. A Spedy consulta a distribuição da SEFAZ com o certificado digital da empresa e devolve os documentos estruturados para o seu sistema, por API e webhook. É o caminho inverso da emissão, que a nossa API já resolvia.
Para quem é esse recurso?
Para quem desenvolve software: ERPs, SaaS de gestão, plataformas e software houses que atendem várias empresas e querem oferecer contas a pagar, entrada de mercadoria ou conferência fiscal sem depender do cliente final subir XML na mão.
Preciso contratar outro produto para consultar as notas?
Não. Emissão e consulta vivem na mesma API, com a mesma chave e o mesmo contrato: muda a chamada. Isso costuma ser a diferença para quem já avaliou outros fornecedores, onde emitir e consultar são dois produtos separados, cada um com o seu setup e a sua integração.
Como o meu sistema fica sabendo que chegou nota nova?
Por webhook. A Spedy dispara inbound_invoice.detected quando encontra a nota na SEFAZ e inbound_invoice.completed quando o documento completo fica disponível, depois da manifestação. Existe um endpoint de sincronização sob demanda, mas ele tem limite de chamadas por CNPJ e não deve ser usado como forma de descobrir notas novas.
Com que frequência a Spedy consulta a SEFAZ?
De hora em hora, de forma automática, por empresa habilitada. A SEFAZ impõe intervalo mínimo entre consultas por CNPJ e bloqueia temporariamente quem exagera, então esse agendamento fica do nosso lado.
O que preciso para habilitar um cliente?
Duas coisas: o recurso de notas destinadas no seu contrato e certificado digital válido cadastrado para a empresa. Com isso, uma chamada nas configurações da empresa liga a importação automática e define a data de início. Também dá para ligar pela tela, se preferir não implementar essa parte.
Funciona para NFS-e, a nota de serviço tomada?
Sim. A consulta de NFS-e tomadas usa o mesmo recurso do contrato e o mesmo webhook: o campo model diz se o documento é NF-e (productInvoice) ou NFS-e (serviceInvoice). A diferença é a fonte e o fluxo: a NFS-e vem do Ambiente Nacional, e não da SEFAZ, e chega completa, com XML e DANFSe na importação, sem manifestação para liberar o documento. Ver a consulta de NFS-e tomadas.
Preciso implementar as regras de manifestação?
Não. São quatro eventos: ciência, confirmação, desconhecimento e operação não realizada. A ciência vale 10 dias e é provisória. As outras três valem 180 dias e são definitivas, e desconhecer ou informar operação não realizada exige justificativa de 15 a 255 caracteres. Prazo, reversibilidade e validação da justificativa já vêm aplicados na chamada.
Quando o XML autorizado fica disponível?
Depois da manifestação. A nota chega em duas etapas: primeiro o resumo, com emissor, valor e chave de acesso, que não vale para escrituração, e depois o documento completo, com o XML autorizado e o DANFE. A manifestação é transmitida na hora, mas a liberação depende da redistribuição da SEFAZ e leva alguns minutos.
Consigo trazer o histórico de notas antigas?
Até onde a SEFAZ permite. A distribuição mantém cerca de 90 dias de histórico, então uma data de início mais antiga que isso não traz documento nenhum.
Preciso migrar a emissão dos meus clientes para a Spedy?
Não. Dá para contratar só a consulta de notas destinadas e manter a emissão onde ela está hoje. Se você já emite pela nossa API, é o mesmo contrato e a mesma chave.
Como funciona a contratação?
É o mesmo modelo da API da Spedy: sem taxa de setup e com uma franquia mensal de notas que vale para as duas pontas, o que os seus clientes emitem e o que eles recebem. A franquia certa depende do volume da sua base, e é isso que o time levanta na conversa.
Existe sandbox para testar antes?
Sim. A API tem ambiente de testes, e o parâmetro de ambiente também existe na consulta de notas destinadas. Você valida o fluxo inteiro antes de apontar a integração para produção.