Helpers
Los helpers son comandos con prefijo + que entregan flujos de varios pasos que los comandos dinámicos por sí solos no dan: interfaces simplificadas, operaciones en lote o llamadas compuestas por varios endpoints. No envuelven una única llamada de API ya disponible por los comandos dinámicos — cada flag de helper controla lógica de orquestación, no una versión remodelada de --params/--json.
Los helpers de hoy son del Gateway Bancario, y están disponibles desde el mismo binario uses el producto que uses:
| Helper | Descripción |
|---|---|
+emitir | Emisión simplificada de boleto, con flags con nombre |
+cancelar-lote | Cancelación en lote de varios boletos por id |
+cobrar | Creación simplificada de cobro Pix, con flags con nombre |
# Emitir un boleto
kobana +emitir --valor 150.50 --vencimento 2026-05-01 \
--nome "Maria Silva" --cpf-cnpj "012.345.678-90" --carteira 1
# Crear un cobro Pix
kobana +cobrar --valor 99.90 --conta-pix "UID" \
--nome "João" --cpf-cnpj "012.345.678-90"
# Cancelar boletos en lote
kobana +cancelar-lote --ids "123,456,789"
Próximos pasos
- Uso — los comandos dinámicos junto a los que viven estos helpers.
- Introspección de schema — inspecciona los endpoints que un helper llama por debajo.