Saltar al contenido principal

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:

HelperDescripción
+emitirEmisión simplificada de boleto, con flags con nombre
+cancelar-loteCancelación en lote de varios boletos por id
+cobrarCreació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.