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

# Documentos tributarios electrónicos

> Entiende qué documentos tributarios electrónicos devuelve el producto `invoices`, cómo distinguir documentos emitidos de recibidos y cómo leer los estados de registro y acuse de recibo del Servicio de Impuestos Internos (SII).

Esta página explica qué documentos tributarios electrónicos devuelve el producto `invoices`, cómo clasificar cada documento y cómo Fintoc los mantiene actualizados. Para el detalle de cada atributo, revisa el [objeto Invoice](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-object).

## Qué documentos obtienes

En Chile, el Servicio de Impuestos Internos (SII) publica los documentos tributarios electrónicos (DTE) en el Registro de Compras y Ventas del contribuyente. El registro incluye los documentos que el contribuyente emite o recibe. Las boletas de honorarios viven en un registro separado.

Un `Link` creado con el producto `invoices` devuelve todos los documentos del Registro de Compras y Ventas: facturas, notas de crédito y débito, guías de despacho, liquidaciones, documentos de exportación y resúmenes de boletas. Devuelve tanto los documentos emitidos como los recibidos. También devuelve las boletas de honorarios que el contribuyente emitió y recibió. [List invoices](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-list) y [Get an invoice](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-get) devuelven cada documento como un objeto `Invoice`, venga de cualquiera de los dos registros.

## Documentos emitidos y recibidos

El atributo `issue_type` indica la dirección del documento desde el punto de vista del contribuyente dueño del `Link`.

| `issue_type` | Significado                                           | Contraparte                                                                                    |
| :----------- | :---------------------------------------------------- | :--------------------------------------------------------------------------------------------- |
| `issued`     | El contribuyente emitió el documento. Es una venta.   | `receiver` contiene el identificador tributario y el nombre del cliente. `issuer` es `null`.   |
| `received`   | El contribuyente recibió el documento. Es una compra. | `issuer` contiene el identificador tributario y el nombre del proveedor. `receiver` es `null`. |

Filtra por dirección con el parámetro `issue_type` de [List invoices](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-list).

## Clasifica un documento

El objeto `Invoice` contiene los atributos comunes a todos los documentos. El campo `institution_invoice` contiene el detalle que entrega el SII para ese tipo de documento: tipo, estados, desglose del impuesto al valor agregado (IVA) y datos de la boleta de honorarios. Usa los siguientes atributos para distinguir los documentos.

### Tipo de documento

`institution_invoice.document_type` es el código del SII para el documento. Por ejemplo, `33` es una factura electrónica, `61` es una nota de crédito electrónica y `39` es una boleta electrónica. Revisa la lista completa en [Tipos de documento](/es/guides/movements/fiscal-links/document-types).

`document_type` es `null` para las boletas de honorarios, que el SII no codifica como documento tributario electrónico (DTE). Identifícalas con `institution_invoice.is_services_invoice`.

### Boletas de honorarios

Cuando `institution_invoice.is_services_invoice` es `true`, el documento es una boleta de honorarios. `institution_invoice.services_invoice` contiene entonces los datos propios de la boleta: el monto retenido, si la emitió un tercero y su `status` en el SII. Los valores de `status` son `VIG` (vigente), `ANUL` (anulada), `ObR` (observada) y `VCA` (vigente con solicitud de anulación). Para cualquier otro documento, `is_services_invoice` es `false` y `services_invoice` es `null`.

### Documentos resumen

El SII informa algunos documentos como un resumen diario en vez de una fila por documento. Son las boletas (`35`, `38`, `39` y `41`), el comprobante especial mensual (`47`) y los pagos electrónicos (`48`). Fintoc devuelve un `Invoice` por día y tipo de documento para ellos, con el total del día.

Para un documento resumen, `institution_invoice.total_documents` contiene la cantidad de documentos agrupados. Los atributos `number`, `issuer` y `receiver` son `null`, porque el resumen no tiene folio ni una contraparte única.

### Estado en el registro

`institution_invoice.invoice_status` indica en qué pestaña del Registro de Compras y Ventas el SII informa el documento.

| `invoice_status` | Significado                                                                                                |
| :--------------- | :--------------------------------------------------------------------------------------------------------- |
| `registered`     | El documento forma parte del registro oficial (la pestaña **Registro** del SII).                           |
| `pending`        | El documento fue recibido pero espera el acuse de recibo del receptor (la pestaña **Pendientes** del SII). |

Filtra por estado en el registro con el parámetro `invoice_status` de [List invoices](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-list).

### Estado del acuse de recibo

`institution_invoice.confirmation_status` muestra el resultado del proceso de acuse de recibo o reclamo del SII para una factura recibida. El receptor tiene 8 días corridos para dar acuse de recibo o reclamar la factura. Si el receptor no hace nada, el SII la acepta automáticamente.

| `confirmation_status` | Significado                                                  |
| :-------------------- | :----------------------------------------------------------- |
| `C`                   | Aceptada por el receptor dentro del plazo.                   |
| `A`                   | Aceptada automáticamente al vencer el plazo sin reclamo.     |
| `P`                   | Pagada al contado, por lo que no necesita acuse de recibo.   |
| `G`                   | Aceptada a través de las guías de despacho del mes anterior. |
| `R`                   | Reclamada por el receptor.                                   |
| `null`                | El SII aún no registra un evento.                            |

`null` no es un rechazo y no invalida el documento. El SII informa `null` en tres casos: el documento sigue dentro del plazo de 8 días, el tipo de documento no pasa por el proceso de acuse de recibo (boletas, notas de crédito y débito, y guías de despacho), o el documento es `issued` y la contraparte no ha actuado. Para saber en qué estado está el documento, usa `invoice_status`, `accepted_at` y `rejected_at`.

### Otros atributos

* `institution_invoice.transaction_category` es la clasificación que el contribuyente da a un documento recibido en el registro de compras, como `Del Giro`, `Supermercado` o `Activo Fijo`. Es `null` cuando el SII no la informa.
* `institution_invoice.has_note` es `true` cuando una nota de crédito o débito referencia el documento.
* Los montos (`total_amount`, `net_amount`, `institution_invoice.exempt_amount`, `institution_invoice.vat_amount` e `institution_invoice.other_taxes`) son enteros en CLP, la unidad mínima de la moneda.

## Filtra la lista

[List invoices](/es/api/fiscal-api/fiscal-invoices/fiscal-invoices-list) devuelve los documentos ordenados por `date` descendente, paginados. Estos parámetros acotan el resultado.

| Parámetro        | Efecto                                                                                                                                                                                    |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `since`, `until` | Solo documentos con `date` dentro del rango. Ambos son fechas ISO 8601.                                                                                                                   |
| `updated_since`  | Solo documentos que Fintoc creó o actualizó en o después de esta fecha y hora ISO 8601 con zona horaria, por ejemplo `2024-01-01T00:00:00Z`. Úsalo para sincronizar de forma incremental. |
| `issue_type`     | Solo documentos `issued` o solo `received`.                                                                                                                                               |
| `invoice_status` | Solo documentos `registered` o solo `pending`.                                                                                                                                            |

## Cómo Fintoc mantiene las facturas actualizadas

Cuando tu usuario crea el `Link`, Fintoc obtiene los documentos de los últimos 12 meses. Los documentos quedan disponibles después de que tu usuario se conecta. Luego, Fintoc actualiza el `Link` periódicamente con el intervalo de actualización de tu plan. Cada actualización obtiene los documentos del mes en curso y del mes anterior, porque el SII todavía puede modificar un documento después del cierre del mes.

Fintoc envía el evento `link.refresh_intent.succeeded` cuando una actualización termina. Si la actualización no se completa, Fintoc envía `link.refresh_intent.failed`. Revisa la [referencia de eventos](/es/api/main-resources/events-reference/types-of-events) para ver el payload. Para actualizar a demanda un `Link` creado con el producto `invoices`, crea un [Refresh Intent](/es/guides/movements/refresh-intents-walkthrough/index).

## Ejemplo

Una factura electrónica recibida (`document_type` `33`), que ya forma parte del registro:

```json theme={null}
{
  "id": "inv_nMNejK7BT8oGbvO4",
  "object": "invoice",
  "currency": "CLP",
  "date": "2021-06-25T04:00:00.000Z",
  "institution_id": "cl_fiscal_sii",
  "institution_invoice": {
    "accepted_at": "2021-06-26T12:00:00.000Z",
    "common_use_vat": null,
    "confirmation_status": "A",
    "construction_company_credit": 0,
    "container_deposit_guarantee": 0,
    "document_type": 33,
    "domestic_ticket_sales": 0,
    "exempt_amount": 0,
    "exempt_commissions": 0,
    "fixed_assets_net_amount": null,
    "fixed_assets_vat_amount": null,
    "free_zone_tax": 0,
    "has_note": false,
    "international_ticket_sales": 0,
    "invoice_status": "registered",
    "is_services_invoice": false,
    "net_commissions": 0,
    "non_credit_tax_amount": null,
    "non_refundable_vat_amount": null,
    "non_refundable_vat_code": null,
    "non_withheld_vat": 0,
    "other_taxes": {
      "other_taxes_detail": [
        {
          "tax_amount": 400,
          "tax_code": 14,
          "tax_rate": "19"
        }
      ],
      "total_amount": 400
    },
    "out_of_time_vat": 0,
    "own_vat": 0,
    "partial_vat_withheld": 0,
    "receipt_reference_number": null,
    "received_at": "2021-06-25T19:27:04.000Z",
    "reference_number": null,
    "reference_type_code": null,
    "rejected_at": null,
    "services_invoice": null,
    "settlement_issuer_id": null,
    "third_party_vat": 0,
    "tobacco": {
      "cigarettes": 0,
      "cigars": 0,
      "processed_tobacco": 0
    },
    "total_documents": null,
    "total_vat_withheld": 0,
    "transaction_category": "Del Giro",
    "vat_amount": 1900,
    "vat_commissions": null
  },
  "issue_type": "received",
  "issuer": {
    "id": "111111111",
    "institution_tax_payer": null,
    "name": "Test Customer 1"
  },
  "net_amount": 10000,
  "number": "135",
  "receiver": null,
  "tax_period": "06/2021",
  "total_amount": 12300
}
```