> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Finanzas

> Facturacion moderna y legacy, DTE, cuentas por pagar, grupos de billing y medios de pago

## Alcance

El menu **Finanzas** agrupa billing y operaciones financieras administrativas.

Incluye:

* facturas legacy
* billing moderno
* facturacion 2.0
* DTE y documentos tributarios
* ejecucion de facturacion
* cuentas por pagar
* descuentos y grupos de billing

## Submenus principales

* Facturas
* Billing moderno
* Facturacion 2.0
* DTE
* Ejecucion de facturacion
* Cuentas por pagar
* Descuentos y grupos

## Billing legacy

Endpoints relevantes:

* `GET /api/v1/factura/sum`
* `GET /api/v1/factura/client/{clientId}`
* `GET /api/v1/factura/period`
* `DELETE /api/v1/factura/{id}`
* `GET /api/v1/boleta`
* `POST /api/v1/boleta`
* `PUT /api/v1/boleta/{id}/status`

Este bloque convive con el billing moderno de `billing/invoices`.

## Billing moderno

Endpoints relevantes:

* `GET /api/v1/billing/invoices`
* `POST /api/v1/billing/invoices`
* `GET /api/v1/billing/invoices/{id}`
* `PATCH /api/v1/billing/invoices/{id}`
* `DELETE /api/v1/billing/invoices/{id}`
* `GET /api/v1/billing/invoices/{id}/detail-xlsx`
* `GET /api/v1/billing/invoices/{id}/pdf`
* `POST /api/v1/billing/invoices/{id}/publish`
* `POST /api/v1/billing/invoices/{id}/emit-dte`
* `POST /api/v1/billing/invoices/{id}/register-payment`
* `POST /api/v1/billing/invoices/batch/generate-monthly`
* `POST /api/v1/billing/invoices/batch/publish-dtes`
* `POST /api/v1/billing/invoices/batch/send-emails`

Usalo para:

* crear borradores y publicar facturas comerciales; `publish` intenta emitir el DTE
* consultar el estado comercial antes de reintentar una emisión
* generar anexos PDF/XLSX
* automatizar procesos batch mensuales

El [mapa de endpoints](/invoices-endpoints) indica qué rutas son canónicas y cuáles siguen por compatibilidad. La [guía de facturas y DTE](/invoices-guide) explica el ciclo completo, el payload de creación y los estados del SII.

## Facturacion 2.0

Endpoints relevantes:

* `GET /api/v1/facturacion-2/summary`
* `GET /api/v1/facturacion-2/uf`
* `GET /api/v1/facturacion-2/executions`
* `POST /api/v1/facturacion-2/create-all`
* `GET /api/v1/facturacion-2/progress/{executionId}`
* `POST /api/v1/facturacion-2/resume/{executionId}`
* `POST /api/v1/facturacion-2/check-and-resume`
* `GET /api/v1/facturacion-2/invoice/general/download`
* `GET /api/v1/facturacion-2/invoice/all/zip`
* `POST /api/v1/facturacion-2/invoices/batch/validate-dtes`

Usalo para:

* ejecutar cierres o reanudaciones masivas
* revisar progreso de ejecuciones largas
* validar DTE antes de publicar o reenviar

## Ejecucion de facturacion

Endpoints relevantes:

* `POST /api/billing/ejecucion`
* `GET /api/billing/ejecucion/recent`
* `GET /api/billing/ejecucion/{id}`
* `GET /api/billing/ejecucion/{id}/error-summary`
* `PUT /api/billing/ejecucion/errors/{errorId}/status`

## DTE y documentos tributarios

Endpoints relevantes:

* `POST /api/v1/dte/documents`
* `GET /api/v1/dte/documents`
* `GET /api/v1/dte/documents/{id}`
* `GET /api/v1/dte/documents/{id}/pdf`
* `GET /api/v1/dte/documents/{id}/cedible`
* `POST /api/v1/dte/documents/{id}/generate-pdf`
* `POST /api/v1/dte/documents/{id}/credit-note`
* `POST /api/v1/dte/documents/{id}/sync`
* `POST /api/v1/dte/documents/{id}/send-email`
* `GET /api/v1/payments/{dteId}`

Usalo para:

* revisar documentos tributarios emitidos
* generar versiones PDF o cedibles
* disparar credit notes y sincronizaciones
* consultar pagos asociados a un DTE

## Cuentas por pagar

Endpoints relevantes:

* `GET /api/v1/expense/paginated`
* `POST /api/v1/expense/create`
* `PUT /api/v1/expense/{id}`
* `PATCH /api/v1/expense/{id}/mark-paid`
* `POST /api/v1/expense/{id}/payments`
* `GET /api/v1/supplier/all`
* `POST /api/v1/supplier/create`
* `GET /api/v1/credits/all`
* `POST /api/v1/credits/create`
* `GET /api/v1/bank-account/all`
* `GET /api/v1/payment-method/all`
* `GET /api/v1/credit-card/all`
* `GET /api/v1/recurring/rules`
* `POST /api/v1/recurring/rules`

Usalo para:

* registrar gastos y pagos parciales
* administrar proveedores y creditos
* operar reglas recurrentes
* vincular cuentas bancarias, tarjetas y medios de pago

## Grupos y descuentos

Endpoints relevantes:

* `GET /api/v1/billing/clients/{clientId}/groups`
* `POST /api/v1/billing/clients/{clientId}/groups`
* `PUT /api/v1/billing/groups/{id}`
* `DELETE /api/v1/billing/groups/{id}`
* `GET /api/v1/billing/clients/{clientId}/unassigned-subscriptions`
* `POST /api/v1/billing/clients/{clientId}/groups/regenerate-drafts`
* `GET /api/v1/descuentos/client/{clientId}`
* `GET /api/v1/descuentos/motivos`
* `POST /api/v1/descuentos`
* `PUT /api/v1/descuentos/{id}`
* `DELETE /api/v1/descuentos/{id}`

Usalo para:

* agrupar suscripciones a nivel de facturacion
* regenerar drafts por cliente
* aplicar o mantener descuentos administrados

## Recomendaciones

* Trata billing operativo y cuentas por pagar como dominios distintos.
* Usa ejecuciones o `facturacion-2` para procesos batch, no para mutaciones puntuales.
* Prioriza `billing/invoices` para facturas comerciales nuevas; usa `facturacion-2` para la generación masiva existente.
* Usa la pestaña **API** para revisar estados, referencias y acciones batch menos frecuentes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.