Helpers
Helpers são comandos prefixados com + que entregam fluxos de vários passos que os comandos dinâmicos sozinhos não dão: interfaces simplificadas, operações em lote ou chamadas compostas por vários endpoints. Eles não embrulham uma única chamada de API já disponível pelos comandos dinâmicos — cada flag de helper controla lógica de orquestração, não uma versão remodelada de --params/--json.
Os helpers de hoje são todos do Gateway Bancário: vêm no mesmo binário, mas chamam a API do Gateway Bancário, com a credencial dele. O Dashboard Mágico ainda não tem helper próprio — tudo o que ele faz está nos comandos dinâmicos.
| Helper | Descrição |
|---|---|
+emitir | Emissão simplificada de boleto, com flags nomeadas |
+cancelar-lote | Cancelamento em lote de vários boletos por id |
+cobrar | Criação simplificada de cobrança Pix, com flags nomeadas |
# Emitir um boleto
kobana +emitir --valor 150.50 --vencimento 2026-05-01 \
--nome "Maria Silva" --cpf-cnpj "012.345.678-90" --carteira 1
# Criar uma cobrança Pix
kobana +cobrar --valor 99.90 --conta-pix "UID" \
--nome "João" --cpf-cnpj "012.345.678-90"
# Cancelar boletos em lote
kobana +cancelar-lote --ids "123,456,789"
Próximos passos
- Uso — os comandos dinâmicos ao lado dos quais estes helpers vivem.
- Introspecção de schema — inspecione os endpoints que um helper chama por baixo.