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.
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.
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
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.
Tu sistema marca la venta como pagada
codespar_invoiceNF-e · NFS-e · CFDI · Factura
Proveedor conectadocodespar_invoiceEl estado fiscal
Proveedorcodespar_invoiceCorrección, o cancela y reemite
ProveedorEn tu archivo
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.
El código, y lo que supone.
// 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.
codespar_invoiceEmite, consulta y corrige el documento fiscal por el proveedor que conectó el proyecto.
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.