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.
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
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
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.
Lido do seu fluxo
codespar_chargeCobrança Pix
Provedor conectadocodespar_invoiceNF-e · só em projetos live
NFe.iocodespar_shipEtiqueta
Melhor Enviocodespar_notifyTexto no WhatsApp · só em projetos live
Z-APIO 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.
O código, e o que ele pressupõe.
// 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.
codespar_chargeGera uma cobrança Pix no provedor que o projeto conectou.
codespar_invoiceEmite a NF-e pela NFe.io; só em projetos live.
codespar_shipCota, compra e rastreia a etiqueta de envio na Melhor Envio.
codespar_notifyManda um texto no WhatsApp pela Z-API; só em projetos live.
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.