Skip to main content
Todos los casos de uso
MarketplaceMarketplaces

Cada pedido: cobrado, facturado, enviado, avisado.

El agente toma cada pedido de tu flujo y hace cuatro llamadas: un cobro Pix con codespar_charge, la NF-e con codespar_invoice, la etiqueta de envío con codespar_ship y un texto por WhatsApp con codespar_notify. Cada una va al proveedor que conectó tu proyecto. NFe.io y Z-API no tienen ambiente de prueba: una clave de prueba se rechaza ahí, y en un proyecto live la NF-e se emite de verdad y el mensaje se envía de verdad.

AntesCinco herramientas, cinco pestañas, traspasos manuales
DespuésUn agente, cuatro llamadas por pedido
4
meta-tools por pedido
Pruébalo en el Sandbox
Pix
Cobrar
codespar_charge genera un cobro Pix en el proveedor conectado
NF-e
Facturar
codespar_invoice emite la NF-e por NFe.io, solo en proyectos live
Melhor Envio
Enviar
codespar_ship cotiza, compra la etiqueta y rastrea
WhatsApp
Avisar
codespar_notify envía un texto por WhatsApp por Z-API, solo en proyectos live
Ejemplo ilustrativo · datos de demostración

Un pedido, cuatro llamadas.

Un ejemplo con datos de demostración: el agente cobra el pedido #4821 por Pix, emite la NF-e, compra la etiqueta y le envía al comprador un texto por WhatsApp. La NF-e y el texto por WhatsApp solo corren en un proyecto live.

  • El cobro Pix va al proveedor que conectó el proyecto
  • NF-e por NFe.io: solo en proyectos live, sin ambiente de prueba
  • WhatsApp por Z-API: un texto, en cola; solo en proyectos live
Order #4821
charge · invoice · ship · notify
Agente
codespar_charge · Pix · R$ 219,80
via codespar_charge · Asaas
✓ Pix
codespar_invoice · NF-e
via codespar_invoice · NFe.io
codespar_ship · label
via codespar_ship · Melhor Envio
codespar_notify · WhatsApp · QUEUED
via codespar_notify · Z-API
✓ #4821 · Pix · NF-e · label · WhatsApporder_4821
El problema

La conversación es la parte fácil.

El fulfillment vive en herramientas que no se hablan: cobrar aquí, facturar allá, enviar en otro lado, avisar a mano.

Cobrar en una herramienta, facturar en otra

El agente cobra y factura con dos meta-tools

Comprar la etiqueta en una tercera pestaña

codespar_ship cotiza y compra la etiqueta en Melhor Envio

Avisarle al comprador a mano

codespar_notify envía un texto por WhatsApp por Z-API

Rastrear el paquete en el sitio de la transportadora

codespar_ship con action=track lee el rastreo

Cómo lo hace el agente

El fulfillment como cuatro llamadas.

El agente lee cada pedido de tu flujo y llama a codespar_charge (Pix), codespar_invoice (NF-e), codespar_ship (etiqueta) y codespar_notify (WhatsApp). Cada llamada va al proveedor que conectó el proyecto. La NF-e y el texto por WhatsApp solo corren en un proyecto live, donde son reales; la configuración fiscal vive en la empresa de NFe.io a la que apunta la conexión. Escribir el pedido de vuelta en tu ERP es tu integración.

01
Pedido
Tu sistema

Leído de tu flujo

02
Cobrar
codespar_charge

Cobro Pix

Proveedor conectado
03
Facturar
codespar_invoice

NF-e · solo en proyectos live

NFe.io
04
Enviar
codespar_ship

Etiqueta

Melhor Envio
05
Avisar
codespar_notify

Texto por WhatsApp · solo en proyectos live

Z-API
Arquitectura

Tu flujo de pedidos le entrega al agente cada pedido. codespar_charge genera el cobro Pix en el proveedor conectado (Asaas, Mercado Pago, EBANX, Celcoin, Iugu o Stone). codespar_invoice emite la NF-e por NFe.io para la empresa a la que apunta la conexión. codespar_ship cotiza, compra y rastrea la etiqueta en Melhor Envio. codespar_notify envía un texto por WhatsApp por Z-API, que responde que el mensaje está en cola. Escribir el resultado de vuelta en tu ERP es tu integración.

En código

El código, y lo que supone.

autonomous-fulfillment.ts
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a Pix
// provider (Asaas, for instance) and Melhor Envio connected to the project.
// NFe.io and Z-API have no test environment: codespar_invoice (NF-e) and
// codespar_notify (WhatsApp) need a live key, and then issue and send for real.
import { CodeSpar } from "@codespar/sdk";

const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });
const buyer = { name: "Ana Souza", email: "ana@example.com", document: "12345678909", phone: "+5511999990000" };

// 1 · charge the order by Pix (amount in reais)
const charge = await session.charge({ amount: 219.8, currency: "BRL", method: "pix", description: "Order #4821", buyer });
console.log(charge.status, charge.pix_copy_paste);

// 2 · buy the shipping label at Melhor Envio
const label = await session.ship({
  action: "label",
  origin: { postal_code: "01310-100" },
  destination: { postal_code: "20040-002" },
  items: [{ description: "Order #4821", weight_g: 800, width_cm: 15, height_cm: 10, length_cm: 20 }],
});
console.log(label.status, label.tracking_code);

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_charge

Genera un cobro Pix en el proveedor que conectó el proyecto.

codespar_invoice

Emite la NF-e por NFe.io; solo en proyectos live.

codespar_ship

Cotiza, compra y rastrea la etiqueta de envío en Melhor Envio.

codespar_notify

Envía un texto por WhatsApp por Z-API; solo en proyectos live.

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.

Agente de fulfillment autónomo — CodeSpar | CodeSpar