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.
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
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
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.
Leído de tu flujo
codespar_chargeCobro Pix
Proveedor conectadocodespar_invoiceNF-e · solo en proyectos live
NFe.iocodespar_shipEtiqueta
Melhor Enviocodespar_notifyTexto por WhatsApp · solo en proyectos live
Z-APITu 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.
El código, y lo que supone.
// 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.
codespar_chargeGenera un cobro Pix en el proveedor que conectó el proyecto.
codespar_invoiceEmite la NF-e por NFe.io; solo en proyectos live.
codespar_shipCotiza, compra y rastrea la etiqueta de envío en Melhor Envio.
codespar_notifyEnvía un texto por WhatsApp por Z-API; solo en proyectos live.
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.