> ## 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.
# El objeto Invoice
## El objeto Invoice
El objeto `Invoice` representa un documento tributario, como una factura electrónica o una boleta de honorarios, registrado para una cuenta fiscal ante su autoridad tributaria. Cada documento que emite o recibe el titular de la cuenta genera un objeto `Invoice`.
```json Invoice Object 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": null,
"common_use_vat": null,
"confirmation_status": null,
"construction_company_credit": 0,
"container_deposit_guarantee": 0,
"document_type": 34,
"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": 123,
"vat_commisions": null
},
"issue_type": "received",
"issuer": {
"id": "111111111",
"institution_tax_payer": null,
"name": "Hooli SpA"
},
"net_amount": 12000,
"number": "135",
"receiver": null,
"tax_period": "06/2021",
"total_amount": 12123
}
```
| Atributo | Tipo | Descripción |
| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `string` | Identificador único del objeto `Invoice`. |
| `object` | `string` | Identificador del tipo de objeto. Su valor siempre es `invoice`. |
| `currency` | `string` | [Código ISO de la moneda](https://www.iso.org/iso-4217-currency-codes.html). |
| `date` | `string` | Fecha del documento en formato ISO 8601. Para los documentos con código 39 o 41, corresponde al último día del período tributario. |
| `institution_id` | `string` | Identificador de la autoridad fiscal. Consulta las [instituciones disponibles](/es/guides/movements/overview-data-aggregation/products-and-institutions-movements). |
| `institution_invoice` | `object` | Datos tributarios del documento proporcionados por la autoridad fiscal. Consulta la sección Objeto Institution Invoice más abajo. |
| `issue_type` | `string` | Relación del documento con el titular de la cuenta. Sus valores posibles son `issued` y `received`. |
| `issuer` | `object` | Emisor de una compra. Su valor es `null` para una venta y para los documentos resumidos con código 35, 38, 39, 41, 47 o 48. Consulta el objeto `Taxpayer` más abajo. |
| `net_amount` | `integer` | Monto neto del documento [representado como un entero](/es/guides/home/currencies). |
| `number` | `string` | Folio de la factura para `cl_fiscal_sii`. |
| `receiver` | `object` | Receptor de una venta. Su valor es `null` para una compra y para los documentos resumidos con código 35, 38, 39, 41, 47 o 48. Consulta el objeto `Taxpayer` más abajo. |
| `tax_period` | `string` | Período tributario en formato `mm/yyyy`. |
| `total_amount` | `integer` | Monto total del documento [representado como un entero](/es/guides/home/currencies). |
### Objeto Taxpayer (dentro del objeto Invoice)
El objeto `Taxpayer` identifica a la contraparte del documento. Aparece en `issuer` para las facturas con `issue_type` igual a `received` y en `receiver` para las facturas con `issue_type` igual a `issued`.
| Atributo | Tipo | Descripción |
| :---------------------- | :------- | :-------------------------------------------------------------------------- |
| `id` | `string` | Rol Único Tributario (RUT) del emisor o receptor del documento para el SII. |
| `institution_tax_payer` | `object` | Datos fiscales del emisor o receptor del documento. Puede ser `null`. |
| `name` | `string` | Nombre del emisor o receptor del documento. |
## 🇨🇱 Chile: Servicio de Impuestos Internos (SII)
### Objeto Institution Invoice (dentro del objeto Invoice)
Si la autoridad fiscal es el Servicio de Impuestos Internos (`cl_fiscal_sii`), el campo `institution_invoice` corresponde al siguiente objeto.
#### Objeto SII Invoice (como objeto Institution Invoice)
El objeto `SIIInvoice` contiene los datos tributarios del documento proporcionados por el SII, incluido el desglose del impuesto al valor agregado (IVA), el estado de aceptación y el tipo de documento. Este objeto aparece en `institution_invoice` cuando la autoridad fiscal es `cl_fiscal_sii`.
| Atributo | Tipo | Descripción |
| ----------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accepted_at` | `string` | Fecha de aceptación del documento en formato ISO 8601. Puede ser `null` si la factura no está `registered`. |
| `common_use_vat` | `integer` | IVA de uso común. |
| `confirmation_status` | `string` | Resultado del proceso de aceptación o reclamo del SII para los documentos recibidos. El contribuyente tiene 8 días corridos para aceptar o reclamar una factura electrónica. Si no registra una acción, el SII la acepta automáticamente. Sus valores posibles son:
- `C`: conforme, aceptada por el receptor dentro del plazo.
- `A`: automática, aceptada al vencer el plazo sin reclamo.
- `P`: pago al contado, que no requiere aceptación.
- `G`: guía de despacho, aceptada mediante las guías del mes anterior.
- `R`: reclamada por el receptor.
- `null`: sin un evento registrado. Esto puede ocurrir dentro del plazo de 8 días, para un documento que no usa este flujo o para un documento `issued` que espera a la contraparte. |
| `construction_company_credit` | `integer` | Crédito de empresa constructora. |
| `container_deposit_guarantee` | `integer` | Garantía de depósito de envases. |
| `document_type` | `integer` | Código del tipo de documento. Su valor es `null` para una boleta de honorarios. Consulta los códigos de tipos de documento del SII más abajo. |
| `domestic_ticket_sales` | `integer` | Venta de pasajes nacionales. |
| `exempt_amount` | `integer` | Monto exento de impuestos [representado como un entero](/es/guides/home/currencies). |
| `exempt_commissions` | `integer` | Valor exento de comisiones. |
| `fixed_assets_net_amount` | `integer` | Monto neto de activos fijos [representado como un entero](/es/guides/home/currencies). |
| `fixed_assets_vat_amount` | `integer` | Monto de IVA recuperable de activos fijos [representado como un entero](/es/guides/home/currencies). |
| `free_zone_tax` | `integer` | Impuesto de zona franca según la Ley 18.211 de Chile. |
| `has_note` | `boolean` | Indica si el documento tiene una nota de crédito o débito asociada. |
| `international_ticket_sales` | `integer` | Venta de pasajes internacionales. |
| `invoice_status` | `string` | Pestaña del SII desde la que se obtuvo la factura. Sus valores posibles son `registered` (*REGISTRO*), `pending` (*PENDIENTES*), `cancelled` (*RECLAMADOS*) y `rejected` (*NO INCLUIR*). |
| `is_services_invoice` | `boolean` | Indica si el documento corresponde a una boleta de honorarios. |
| `net_commissions` | `integer` | Valor neto de las comisiones. |
| `non_credit_tax_amount` | `integer` | Impuestos sin derecho a crédito [representado como un entero](/es/guides/home/currencies). |
| `non_refundable_vat_amount` | `integer` | Monto de IVA no recuperable de activos fijos [representado como un entero](/es/guides/home/currencies). |
| `non_refundable_vat_code` | `integer` | Código de IVA no recuperable. |
| `non_withheld_vat` | `integer` | IVA no retenido. |
| `other_taxes` | `object` | Desglose de otros impuestos. Consulta el objeto `OtherTaxes` más abajo. |
| `out_of_time_vat` | `integer` | IVA fuera de plazo. |
| `own_vat` | `integer` | IVA propio. |
| `partial_vat_withheld` | `integer` | IVA retenido parcial. |
| `receipt_reference_number` | `integer` | Número de referencia interno del recibo. |
| `received_at` | `string` | Fecha de recepción del documento proporcionada por el SII, en formato ISO 8601. |
| `reference_number` | `string` | Número de folio del documento de referencia. |
| `reference_type_code` | `integer` | Código del tipo de documento de referencia. |
| `rejected_at` | `string` | Fecha de rechazo del documento en formato ISO 8601. Puede ser `null` si la factura no está `rejected`. |
| `services_invoice` | `object` | Datos específicos de una boleta de honorarios. Su valor es `null` para otros tipos de documento. Consulta el objeto `ServicesInvoice` más abajo. |
| `settlement_issuer_id` | `string` | RUT del emisor de la liquidación. |
| `third_party_vat` | `integer` | IVA de terceros. |
| `tobacco` | `object` | Desglose de impuestos del tabaco. Consulta el objeto `TobaccoTaxes` más abajo. |
| `total_documents` | `integer` | Número de documentos agrupados. Este campo corresponde a los documentos resumidos con código 35, 38, 39, 41, 47 o 48. Su valor es `null` para los demás documentos. |
| `total_vat_withheld` | `integer` | Total de IVA retenido. |
| `transaction_category` | `string` | Clasificación de la transacción. Sus valores posibles son `Money order`, `Supermarket`, `Real estate`, `Fixed asset`, `Common use VAT`, `Non-refundable VAT` y `Do not include`. |
| `vat_amount` | `integer` | Monto de IVA recuperable [representado como un entero](/es/guides/home/currencies). |
| `vat_commissions` | `integer` | Valor del IVA para las comisiones. |
#### Objeto Other Taxes (dentro del objeto Institution Invoice)
El objeto `OtherTaxes` desglosa los impuestos del documento distintos del IVA. Aparece en el campo `other_taxes` del objeto `SIIInvoice`.
| Atributo | Tipo | Descripción |
| :-------------------- | :-------- | :---------------------------------------------------------------------------------------- |
| `other_taxes_details` | `array` | Objetos con `tax_amount`, `tax_code` y `tax_rate`. |
| `total_amount` | `integer` | Monto total de otros impuestos [representado como un entero](/es/guides/home/currencies). |
#### Objeto Tobacco Taxes (dentro del objeto Institution Invoice)
El objeto `TobaccoTaxes` desglosa los impuestos sobre los productos de tabaco del documento. Aparece en el campo `tobacco` del objeto `SIIInvoice`.
| Atributo | Tipo | Descripción |
| :------------------ | :-------- | :------------------------ |
| `cigarettes` | `integer` | Cigarrillos de tabaco. |
| `cigars` | `integer` | Cigarros puros de tabaco. |
| `processed_tobacco` | `integer` | Tabaco procesado. |
#### Objeto Services Invoice (dentro del objeto Institution Invoice)
El objeto `ServicesInvoice` contiene los datos específicos de una boleta de honorarios. Aparece en el campo `services_invoice` del objeto `SIIInvoice` cuando `is_services_invoice` es `true`.
| Atributo | Tipo | Descripción |
| -------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `is_professional_society` | `boolean` | Indica si el contribuyente emisor es una sociedad de profesionales. |
| `is_third_party` | `boolean` | Indica si la factura se generó para un tercero. |
| `issued_at` | `datetime` | Fecha de emisión del documento en el sitio oficial del SII. |
| `issuer_withheld_amount` | `integer` | Monto retenido cuando el contribuyente emisor gestiona el pago provisional de los impuestos. |
| `receiver_withheld_amount` | `integer` | Monto retenido cuando el contribuyente receptor gestiona el pago provisional de los impuestos. |
| `status` | `string` | Estado de la factura. Sus valores posibles son `VIG` (vigente), `ANUL` (anulada), `ObR` (observada) y `VCA` (vigente con solicitud de anulación). |
### Códigos para tipos de documento del SII
El atributo `document_type` corresponde a uno de los códigos definidos por el SII en la guía [Formato Documentos Tributarios Electrónicos](https://www.sii.cl/factura_electronica/formato_dte.pdf). Los códigos más usados son:
| Tipo de documento | Descripción |
| :---------------- | :------------------------------------------------- |
| 30 | Factura |
| 32 | Factura de ventas y servicios exenta de IVA |
| 33 | Factura electrónica |
| 34 | Factura electrónica exenta de IVA |
| 35 | Boleta |
| 38 | Boleta exenta |
| 39 | Boleta electrónica |
| 40 | Liquidación factura |
| 41 | Boleta exenta electrónica |
| 43 | Liquidación factura electrónica |
| 45 | Factura de compra |
| 46 | Factura de compra electrónica |
| 47 | Comprobante electrónico especial del total del mes |
| 48 | Pago electrónico |
| 50 | Guía de despacho |
| 52 | Guía de despacho electrónica |
| 55 | Nota de débito |
| 56 | Nota de débito electrónica |
| 60 | Nota de crédito |
| 61 | Nota de crédito electrónica |
| 103 | Liquidación |
| 110 | Factura de exportación electrónica |
| 111 | Nota de débito de exportación electrónica |
| 112 | Nota de crédito de exportación electrónica |