Usar a CLI do Cord
A CLI do Cord (@flouviahq/cli) é a ferramenta de terminal para integrar o Cord ao seu projeto. Ela só funciona em modo de teste: nada do que você fizer com ela toca dados reais.
O jeito mais rápido: o assistente
npx @flouviahq/cliEle guia você passo a passo com menus: conecta seu terminal, configura sua conta com IA, integra seu projeto (instala o SDK, cria as rotas e salva as chaves no seu .env.local) e deixa os webhooks escutando. No final, mostra um resumo do que ficou pronto.
Instalar e entrar
npm install -g @flouviahq/cli
cord logincord login abre seu navegador com um código de confirmação. Confira se é o mesmo que você vê no terminal e clique em Autorizar. Você precisa da permissão de Configurações na empresa. O terminal recebe sozinho uma chave de teste restrita: ela pode usar os simuladores, ler eventos e propor configurações, e expira em 90 dias. Ela aparece na aba Chaves do Workbench de Desenvolvedores como CLI · <seu computador>, onde você pode revogá-la.
- Você trabalha por SSH sem navegador?
cord login --no-browserimprime o endereço para abri-lo em outro dispositivo. - Prefere colar uma chave sua?
cord login --api-key.
Os comandos principais
| Comando | Para quê |
|---|---|
cord setup |
Propõe a configuração da sua conta a partir do seu site e da sua tabela de preços. Você a aprova no navegador. |
cord init |
Detecta seu framework e cria a rota de webhooks com a assinatura verificada. |
cord listen --forward-to http://localhost:3000/api/webhooks/cord |
Reencaminha os webhooks de teste para o seu servidor local. |
cord trigger quote.approved |
Dispara um evento de teste. |
cord simulate fiscal pac_caido |
A próxima fatura de teste falha como se o PAC não respondesse. |
cord events tail |
Mostra os eventos à medida que acontecem. |
cord whoami / cord logout |
Mostra a empresa conectada / apaga a chave salva. |
Problemas comuns
- “O código expirou”: o código dura 10 minutos. Execute
cord loginnovamente. - “Essa é uma chave de produção”: a CLI recusa chaves
sk_live_de propósito. Use uma de teste. - Você não vê a tela de autorização: seu usuário precisa da permissão de Configurações na empresa. Peça-a ao administrador.
Mais detalhes no guia da CLI.