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.

Invoice Object

{
    "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.
`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.
`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.
`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.

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.
`exempt_commissions`	`integer`	Valor exento de comisiones.
`fixed_assets_net_amount`	`integer`	Monto neto de activos fijos representado como un entero.
`fixed_assets_vat_amount`	`integer`	Monto de IVA recuperable de activos fijos representado como un entero.
`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.
`non_refundable_vat_amount`	`integer`	Monto de IVA no recuperable de activos fijos representado como un entero.
`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.
`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.

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. 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

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

El objeto Invoice