Cada transação emite o documento fiscal certo.
O agente observa o fluxo de transações e, a cada venda liquidada, valida o CPF/CNPJ do comprador, emite o documento fiscal correto para o país — NF-e no Brasil, CFDI no México, Factura na Argentina — e armazena o PDF + XML. Sem pânico fiscal no fim do mês, sem notas rejeitadas.
Cada venda liquidada, um documento fiscal válido.
O agente valida o CNPJ do comprador antes de emitir qualquer coisa, depois emite a NF-e pela NFe.io, armazena o PDF e o XML e sela ambos por hash à transação de origem. Uma rejeição da SEFAZ volta como um código estruturado contra o qual o agente tenta de novo — não um print do portal.
- ID fiscal validado de cara — CNPJ / RFC / CUIT inválido nunca chega à SEFAZ
- O destino escolhe o documento: NF-e no BR, CFDI no MX, Factura na AR
- PDF + XML selados à transação para uma trilha de auditoria reconstruível
Emita a NF-e da venda #883 e arquive o PDF + XML.
Achei a venda #883 — validando primeiro o CNPJ do comprador, depois emitindo a NF-e e selando os documentos à transação.
A conversa é a parte fácil.
A conformidade fiscal é onde os carrinhos morrem. Uma NF-e que não sai trava um envio; um CFOP errado dispara uma rejeição da SEFAZ; um RFC ruim derruba um CFDI. Cada país tem seu próprio documento, sua própria validação, seus cerca de 50 códigos de rejeição — e a maioria das equipes os descobre uma nota rejeitada de cada vez.
Faturar em lote no fim do mês e caçar as rejeições na mão
codespar_invoice emite em cada transação liquidada, em tempo real
Validar CNPJ / RFC / CUIT manualmente antes de cada emissão
codespar_kyc valida o ID fiscal do comprador antes de o documento ser emitido
Remapear CFOP e presets de impostos para cada novo país em que você entra
O documento certo — NF-e / CFDI / Factura — escolhido pelo destino
Guardar PDFs em um drive compartilhado e torcer para encontrá-los na auditoria
PDF + XML armazenados e selados à transação no ledger de auditoria
Fiscal pan-LATAM, no piloto automático.
Uma meta-tool cobre a região. codespar_invoice resolve o destino para o rail fiscal correto — NFe.io para a NF-e brasileira e os provedores de CFDI / Factura para o México e a Argentina — valida primeiro o ID fiscal do comprador pelo codespar_kyc, emite o documento e armazena o PDF + XML vinculados à transação. As rejeições voltam como códigos estruturados contra os quais o agente pode tentar de novo, não prints do portal.
Transação confirmada como paga
codespar_kycCNPJ / RFC / CUIT verificado
Rail de KYCcodespar_invoiceNF-e / CFDI / Factura
NFe.ioPDF + XML arquivados
Vinculado à transação
O agente assina o fluxo de transações liquidadas. Para cada evento ele roda codespar_kyc para validar o ID fiscal da contraparte e então codespar_invoice, que o roteador resolve para o provedor fiscal do país. O PDF + XML emitidos são armazenados e selados por hash à transação de origem, de modo que a trilha de auditoria reconstrói cada obrigação fiscal de ponta a ponta.
Algumas linhas. O loop inteiro.
const session = await codespar.sessions.create(); for await (const tx of settledTransactions) { // validate the buyer's tax ID first — bad ID, no document await session.execute("codespar_kyc", { taxId: tx.buyer.taxId }); // right document for the country, picked by destination const doc = await session.execute("codespar_invoice", { rail: tx.country === "BR" ? "nfe" : "cfdi", // NF-e · CFDI · Factura buyer: tx.buyer, items: tx.items, companyId: tx.companyId, }); await session.verificationStatus(doc.toolCallId); // PDF + XML sealed }
codespar_invoiceEmite NF-e (NFe.io), CFDI ou Factura conforme o destino; armazena PDF + XML.
codespar_kycValida CNPJ / RFC / CUIT antes de o documento ser emitido para evitar rejeições.
Audit ledgerSela por hash cada documento fiscal à sua transação para uma trilha reconstruível.
Coloque no ar ainda hoje.
Abra o sandbox, aponte uma sessão para os seus provedores e rode o loop inteiro contra rails reais em minutos — não no trimestre que levaria para construir tudo na mão.