Skip to main content
Todos os casos de uso
MarketplaceMarketplaces

Cada pedido: cobrado, faturado, enviado, avisado.

O agente pega cada pedido do seu fluxo e faz quatro chamadas: uma cobrança Pix com o codespar_charge, a NF-e com o codespar_invoice, a etiqueta de envio com o codespar_ship e um texto no WhatsApp com o codespar_notify. Cada uma vai para o provedor que o seu projeto conectou. NFe.io e Z-API não têm ambiente de teste: uma chave de teste é recusada nelas, e num projeto live a NF-e é emitida de verdade e a mensagem é enviada de verdade.

AntesCinco ferramentas, cinco abas, repasses manuais
DepoisUm agente, quatro chamadas por pedido
4
meta-tools por pedido
Teste no Sandbox
Pix
Cobrar
O codespar_charge gera uma cobrança Pix no provedor conectado
NF-e
Faturar
O codespar_invoice emite a NF-e pela NFe.io, só em projetos live
Melhor Envio
Enviar
O codespar_ship cota, compra a etiqueta e rastreia
WhatsApp
Avisar
O codespar_notify manda um texto no WhatsApp pela Z-API, só em projetos live
Exemplo ilustrativo · dados de demonstração

Um pedido, quatro chamadas.

Um exemplo com dados de demonstração: o agente cobra o pedido #4821 por Pix, emite a NF-e, compra a etiqueta e manda um texto no WhatsApp para o comprador. A NF-e e o texto no WhatsApp só rodam num projeto live.

  • A cobrança Pix vai para o provedor que o projeto conectou
  • NF-e pela NFe.io: só em projetos live, sem ambiente de teste
  • WhatsApp pela Z-API: um texto, enfileirado; só em projetos 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
A dor

A conversa é a parte fácil.

O fulfillment mora em ferramentas que não conversam: cobra aqui, fatura ali, envia em outro lugar, avisa à mão.

Cobrar numa ferramenta, faturar em outra

O agente cobra e fatura com duas meta-tools

Comprar a etiqueta numa terceira aba

O codespar_ship cota e compra a etiqueta na Melhor Envio

Avisar o comprador à mão

O codespar_notify manda um texto no WhatsApp pela Z-API

Rastrear o pacote no site da transportadora

O codespar_ship com action=track lê o rastreio

Como o agente faz isso

Fulfillment como quatro chamadas.

O agente lê cada pedido do seu fluxo e chama o codespar_charge (Pix), o codespar_invoice (NF-e), o codespar_ship (etiqueta) e o codespar_notify (WhatsApp). Cada chamada vai para o provedor que o projeto conectou. A NF-e e o texto no WhatsApp só rodam num projeto live, onde são reais; a configuração fiscal mora na empresa NFe.io para a qual a conexão aponta. Escrever o pedido de volta no seu ERP é a sua integração.

01
Pedido
Seu sistema

Lido do seu fluxo

02
Cobrar
codespar_charge

Cobrança Pix

Provedor conectado
03
Faturar
codespar_invoice

NF-e · só em projetos live

NFe.io
04
Enviar
codespar_ship

Etiqueta

Melhor Envio
05
Avisar
codespar_notify

Texto no WhatsApp · só em projetos live

Z-API
Arquitetura

O seu fluxo de pedidos entrega ao agente cada pedido. O codespar_charge gera a cobrança Pix no provedor conectado (Asaas, Mercado Pago, EBANX, Celcoin, Iugu ou Stone). O codespar_invoice emite a NF-e pela NFe.io para a empresa à qual a conexão aponta. O codespar_ship cota, compra e rastreia a etiqueta na Melhor Envio. O codespar_notify manda um texto no WhatsApp pela Z-API, que responde que a mensagem está na fila. Escrever o resultado de volta no seu ERP é a sua integração.

Em código

O código, e o que ele pressupõe.

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);

Exemplo com o SDK publicado (@codespar/sdk 0.16.11). Os pré-requisitos estão nos comentários. Compilar não prova a integração: rode primeiro em modo de teste.

Ferramentas em destaque
codespar_charge

Gera uma cobrança Pix no provedor que o projeto conectou.

codespar_invoice

Emite a NF-e pela NFe.io; só em projetos live.

codespar_ship

Cota, compra e rastreia a etiqueta de envio na Melhor Envio.

codespar_notify

Manda um texto no WhatsApp pela Z-API; só em projetos live.

Ver a referência das meta-tools

Comece com uma chave de teste.

Chaves de teste são gratuitas. Abra o sandbox, conecte os provedores que o seu projeto usa e veja quais ferramentas ele pode chamar antes de construir.

Agente de fulfillment autônomo — CodeSpar | CodeSpar