Facturas

El documento a cobrar, del borrador al pagado. finalize sella el borrador, pay registra la liquidación, void la anula, y las cuotas viven en installments.

Comando	HTTP	Descripción
invoices list	GET /v1/invoices	Listar facturas
invoices create	POST /v1/invoices	Crear factura
invoices get	GET /v1/invoices/{id}	Obtener factura
invoices update	PATCH /v1/invoices/{id}	Actualizar factura
invoices delete	DELETE /v1/invoices/{id}	Eliminar factura
invoices apply-credits	POST /v1/invoices/{id}/apply-credits	Aplicar créditos en la factura
invoices finalize	POST /v1/invoices/{id}/finalize	Finalizar factura
invoices issue-nfe	POST /v1/invoices/{id}/issue-nfe	Emitir NF-e para la factura
invoices pay	POST /v1/invoices/{id}/pay	Pagar factura
invoices payment-methods	GET /v1/invoices/{id}/payment-methods	Listar métodos de pago disponibles
invoices pdf	GET /v1/invoices/{id}/pdf	Descargar el PDF de la factura
invoices remove-credits	POST /v1/invoices/{id}/remove-credits	Quitar créditos aplicados
invoices send-reminder	POST /v1/invoices/{id}/send-reminder	Enviar recordatorio de cobro
invoices undo-payment	POST /v1/invoices/{id}/undo-payment	Deshacer el pago de la factura
invoices void	POST /v1/invoices/{id}/void	Anular (void) factura
invoices installments get	GET /v1/invoices/{id}/installments	Listar las cuotas de la factura
invoices installments create	POST /v1/invoices/{id}/installments	Crear/actualizar plan de cuotas
invoices installments mark-paid	POST /v1/invoices/{id}/installments/{installmentId}/mark-paid	Marcar cuota como pagada
invoices installments pay	POST /v1/invoices/{id}/installments/{installmentId}/pay	Pagar cuota
invoices pending-nfe list	GET /v1/invoices/pending-nfe	Listar facturas con NF-e pendiente
invoices pending-payment list	GET /v1/invoices/pending-payment	Listar facturas con pago pendiente

Ejemplos

--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar facturas
kobana billing invoices list \
  --fields "id,public_id,external_id,number,billing_account_id"

# Obtener factura
kobana billing invoices get --params '{"id": "INVOICE_ID"}'

# Crear factura
kobana billing invoices create \
  --json '{"billing_account_id": "BILLING_ACCOUNT_ID", "line_items": []}'

# Actualizar factura
kobana billing invoices update \
  --params '{"id": "INVOICE_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "company_id": "COMPANY_ID", "collection_method": "charge_automatically"}'

# Aplicar créditos en la factura
kobana billing invoices apply-credits \
  --params '{"id": "INVOICE_ID"}' \
  --json '{"credit_ids": []}'

# Eliminar factura
kobana billing invoices delete --params '{"id": "INVOICE_ID"}' --dry-run

Próximos pasos

• Pagos
• Introspección de schema — todos los parámetros que este recurso acepta.