Skip to main content
Todos los casos de uso
Cumplimiento fiscalSaaS

Cada venta liquidada, su documento fiscal.

Cuando tu sistema marca una venta como pagada, el agente emite el documento que exige el país con codespar_invoice: NF-e o NFS-e en Brasil por NFe.io, CFDI en México por FacturAPI, Factura en Argentina por AFIP. Lee el estado fiscal del documento y lo corrige cuando hace falta. NFe.io no tiene ambiente de prueba: una clave de prueba se rechaza, y un proyecto live emite una NF-e real. Validar el ID fiscal del comprador antes de emitir y reintentar un rechazo de la SEFAZ son la parte de tu agente.

AntesLote a fin de mes → perseguir los rechazos
DespuésEmitido a medida que se liquida cada venta
NF-e · CFDI · Factura
emitido por venta con codespar_invoice
Pruébalo en el Sandbox
NF-e · NFS-e
Brasil
Por NFe.io, solo en proyectos live: una clave de prueba se rechaza
CFDI
México
Por FacturAPI
Factura
Argentina
Por AFIP
status · amend
Después de emitir
action=status lee el estado fiscal; action=amend corrige, o cancela y reemite
Ejemplo ilustrativo · datos de demostración

Una venta liquidada, un documento fiscal.

Un ejemplo con datos de demostración: una NF-e emitida por NFe.io para la venta #883. En un proyecto live el documento tiene valor fiscal; no hay ambiente de prueba para él.

  • El documento sigue al país: NF-e o NFS-e, CFDI, Factura
  • La configuración fiscal vive en la empresa de NFe.io a la que apunta la conexión
  • Un rechazo vuelve como el error del proveedor: sin reintento automático ni contingencia

Emitir la NF-e de la venta #883.

La venta #883 está pagada: emitiendo la NF-e por NFe.io para la empresa a la que apunta la conexión.

NF-e · Nota Fiscal Eletrônica · ejemplo
Nº 00421 · série 1
Autorizada · ejemplo
EmisorLoja Aurora LTDA
DestinatarioCNPJ 12.345.678/0001-90
NaturalezaVenda · CFOP 5102
TotalR$ 240,00
Protocolo SEFAZ135240000842193
nfe-00421.xml
✓ autorizada · ejemplonfe_00421
El problema

La conversación es la parte fácil.

El cumplimiento fiscal es donde mueren los carritos: una NF-e olvidada frena un envío y un CFOP equivocado hace rechazar el documento. Cada país tiene su documento y sus rechazos.

Facturar en lote a fin de mes

El agente emite el documento a medida que se liquida cada venta

Aprender una API fiscal por país

Una meta-tool: NF-e o NFS-e, CFDI, Factura, por proveedor

Corregir un documento en el portal del proveedor

action=amend emite una carta de corrección, o cancela y reemite

Preguntarle al portal si un documento fue autorizado

action=status lee el estado fiscal del documento

Cómo lo hace el agente

Una meta-tool, un proveedor por país.

codespar_invoice enruta al proveedor fiscal que conectó el proyecto: NFe.io para NF-e y NFS-e en Brasil, FacturAPI para CFDI en México, AFIP para Factura en Argentina. NFe.io no tiene ambiente de prueba: en un proyecto live el documento es real, y una clave de prueba se rechaza. Validar el ID fiscal del comprador antes de emitir y reintentar un rechazo de la SEFAZ son la parte de tu agente.

01
Liquidar
Tu sistema

Tu sistema marca la venta como pagada

02
Emitir
codespar_invoice

NF-e · NFS-e · CFDI · Factura

Proveedor conectado
03
Estado
codespar_invoice

El estado fiscal

Proveedor
04
Corregir
codespar_invoice

Corrección, o cancela y reemite

Proveedor
05
Archivar
Tu sistema

En tu archivo

Arquitectura

Tu sistema le avisa al agente cuando se liquida una venta. codespar_invoice enruta la emisión al proveedor que conectó el proyecto: NFe.io (NF-e, NFS-e) emite para la empresa a la que apunta la conexión; FacturAPI emite CFDI; AFIP emite Factura. action=status lee el estado del documento y action=amend lo corrige en el lugar, o lo cancela y lo reemite. Los rechazos vuelven como el error del proveedor; no hay reintento automático ni contingencia.

En código

El código, y lo que supone.

fiscal-autopilot.ts
// Prerequisites: CODESPAR_API_KEY set to a LIVE key (csk_live_…) and an NFe.io
// connection whose company holds the fiscal setup. NFe.io has no test
// environment: a test key is refused, and a live key issues a real NF-e.
import { CodeSpar } from "@codespar/sdk";

const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });

// the agent fills codespar_invoice from the sale
const run = await session.send("Issue the NF-e for sale #883: 1 t-shirt, R$ 240.00, to CNPJ 12.345.678/0001-90.");
const issued = run.tool_calls.find((c) => c.tool_name === "codespar_invoice");
console.log(issued?.status, issued?.output);

// later: read the document's fiscal state by its id
const state = await session.execute("codespar_invoice", { action: "status", type: "nfe", invoice_id: "<id from the issue>" });
console.log(state.data);

Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.

Herramientas destacadas
codespar_invoice

Emite, consulta y corrige el documento fiscal por el proveedor que conectó el proyecto.

Ver la referencia de meta-tools

Empieza con una clave de prueba.

Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.

Piloto automático fiscal — CodeSpar | CodeSpar