Notas recebidas
A captura baixa, das fontes oficiais, as notas que fornecedores emitem contra as suas empresas — as notas de entrada. Você consulta tudo pela API, pelo painel ou pelo MCP, baixa o XML e pode receber um aviso por webhook quando chega uma nota nova.
| Documento | Fonte | Histórico disponível ao ligar |
|---|---|---|
| NF-e (modelo 55) | SEFAZ — Ambiente Nacional (distribuição de DF-e) | cerca de 3 meses |
| NFS-e | ADN — Ambiente de Dados Nacional da NFS-e | todo o histórico que a fonte guarda |
O que entra e o que não entra
Entra toda nota em que a empresa figura como tomadora (NFS-e), destinatária (NF-e) ou intermediária.
Não entra:
- as notas que a própria empresa emitiu. A fonte as entrega junto, e nós as separamos — a lista de notas recebidas nunca mistura entrada com saída;
- NFC-e — a SEFAZ não distribui a nota de consumidor ao comprador;
- NFS-e de município que não compartilha com o ADN. O ADN recebe as notas do padrão nacional e as que os municípios enviam a ele. Uma nota emitida num sistema municipal que não compartilha pode não aparecer — não é falha da captura, é a cobertura da fonte.
A SEFAZ entrega ao destinatário, primeiro, um resumo da NF-e (emitente, valor, data, situação).
O XML completo é liberado depois que a empresa registra a Ciência da Operação. O registro
automático da Ciência entra em operação numa próxima etapa; até lá, as NF-e recebidas aparecem, em
geral, como resumo — xml_integral: false.
Como ligar
- Plano. A captura é incluída por plano, separadamente para NF-e e NFS-e. Fale com o suporte para incluir.
- Certificado. A empresa precisa de certificado A1 ativo e válido — é com ele que a captura se identifica na fonte. Veja Certificado digital.
- Ligar por empresa, no painel (página da empresa) ou pela API, com uma chave de produção: a captura lê as notas reais, não existe captura em homologação.
A partir daí, o histórico disponível é baixado, e a captura passa a consultar as fontes periodicamente. Detalhes em Ligar e consultar.
Onde está cada coisa
| Ligar, desligar, consultar, baixar o XML | Ligar e consultar |
| Aviso quando chega uma nota | Webhook das notas recebidas |
| Todos os campos e respostas | Referência da API da captura |
| Agentes de IA | As ferramentas estado_da_captura, listar_notas_recebidas, xml_da_nota_recebida e ligar_ou_desligar_captura, no MCP |
A configuração do webhook devolve a chave de assinatura da conta, e ela acabaria no histórico da conversa do agente. Por isso ela é feita só no painel ou pela API.