Notas fiscales

La emisión fiscal de una factura: emitir, cancelar, descargar PDF y XML, y seguir cada intento ante la municipalidad. Barueri tiene comandos propios.

Comando	HTTP	Descripción
nfes list	GET /v1/nfes	Listar NF-es
nfes create	POST /v1/nfes	Crear NF-e (borrador)
nfes get	GET /v1/nfes/{id}	Obtener NF-e
nfes update	PATCH /v1/nfes/{id}	Actualizar NF-e (borrador)
nfes delete	DELETE /v1/nfes/{id}	Eliminar NF-e
nfes cancel	POST /v1/nfes/{id}/cancel	Cancelar NF-e
nfes issue	POST /v1/nfes/{id}/issue	Emitir NF-e
nfes pdf	GET /v1/nfes/{id}/pdf	Descargar el PDF de la NF-e
nfes retry-cancel	POST /v1/nfes/{id}/retry-cancel	Reintentar la cancelación de la NF-e
nfes validate-barueri	POST /v1/nfes/{id}/validate-barueri	Validar NFS-e de Barueri
nfes xml	GET /v1/nfes/{id}/xml	Descargar el XML de la NF-e
nfes bulk create	POST /v1/nfes/bulk	Actualizar NF-es en lote
nfes bulk-delete create	POST /v1/nfes/bulk-delete	Eliminar NF-es en lote
nfes fetch-barueri create	POST /v1/nfes/fetch-barueri	Buscar NFS-e en Barueri
nfes fetch-from-sefaz create	POST /v1/nfes/fetch-from-sefaz	Buscar NFS-e en el ADN (SEFAZ)
nfes import-barueri create	POST /v1/nfes/import-barueri	Importar NFS-e de Barueri
nfes request-tries list	GET /v1/nfes/request-tries	Listar intentos de solicitud (organización)
nfes request-tries get	GET /v1/nfes/{id}/request-tries	Listar los intentos de solicitud de la NF-e
nfes requests get	GET /v1/nfes/{id}/requests/{requestId}	Obtener solicitud externa
nfes sync create	POST /v1/nfes/sync	Sincronizar las NF-es de la organización

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 NF-es
kobana billing nfes list \
  --fields "id,public_id,external_id,invoice_id,transaction_id"

# Obtener NF-e
kobana billing nfes get --params '{"id": "NFE_ID"}'

# Crear NF-e (borrador)
kobana billing nfes create \
  --json '{"billing_account_id": "BILLING_ACCOUNT_ID", "amount_cents": 100, "customer": {}}'

# Actualizar NF-e (borrador)
kobana billing nfes update \
  --params '{"id": "NFE_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "service_code": "SERVICE_CODE", "service_description": "SERVICE_DESCRIPTION"}'

# Cancelar NF-e
kobana billing nfes cancel \
  --params '{"id": "NFE_ID"}' \
  --json '{"reason": "REASON"}'

# Eliminar NF-e
kobana billing nfes delete --params '{"id": "NFE_ID"}' --dry-run

Próximos pasos

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