Invoice object

The Invoice object represents fiscal documents within the Fintoc API. It captures comprehensive invoice data including issuer and receiver information, amounts, VAT details, and fiscal authority-specific fields for the Chilean tax authority (cl_fiscal_sii).

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,
    "received_at": "2021-06-25T19:27:04.000Z",
    "receipt_reference_number": null,
    "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": "117056856",
    "institution_tax_payer": null,
    "name": "Hooli SpA"
  },
  "net_amount": 12000,
  "number": "135",
  "receiver": null,
  "tax_period": "06/2021",
  "total_amount": 12123
}

Attribute	Type	Description
`id`	`string`	Unique identifier for the Invoice
`object`	`string`	Identifier for the type of object. Its value for `Invoices` will always correspond to `invoice`
`currency`	`string`	Currency ISO code
`date`	`string`	Date of the document, using ISO 8601. For documents with code 39 and 41, corresponds to the last day of the tax period to which they correspond
`institution_id`	`string`	Fiscal authority’s `id`. You can read more about the available institutions here
`institution_invoice`	`object`	`InvoiceSII` object
`issue_type`	`string`	Indicates whether the document was issued or received by the account’s owner. Its possible values are `issued` or `received`
`issuer`	`object`	If the Invoice corresponds to a buy, this field indicates who issued the Invoice. Otherwise, this field is `null`. See the `Taxpayer` object to learn more. For documents that come in summary this field is `null` (codes 35, 38, 39, 41, 47 and 48)
`net_amount`	`integer`	Net amount of the document represented as an integer
`number`	`string`	For `cl_fiscal_sii`, it corresponds to the invoice folio
`receiver`	`object`	If the Invoice corresponds to a sell, this field indicates who received the Invoice. Otherwise, this field is `null`. See the `Taxpayer` object to learn more. For documents that come in summary this field is `null` (codes 35, 38, 39, 41, 47 and 48)
`tax_period`	`string`	Tax period, with the format `mm/yyyy`
`total_amount`	`integer`	Total amount of the document represented as an integer

Taxpayer Object

Attribute	Type	Description
`id`	`string`	The document issuer/receptor’s RUT (for the SII)
`institution_tax_payer`	`object`	The document issuer/receptor’s fiscal data. Can be `null`
`name`	`string`	The document issuer/receptor’s name

Servicio de Impuestos Internos (Chile)

If the fiscal authority is Servicio de Impuestos Internos (cl_fiscal_sii), the institution_invoice field corresponds to the following object:

InvoiceSII Object

Attribute	Type	Description
`accepted_at`	`string`	Document’s acceptance date, using ISO 8601. Can be `null` if the invoice is not `registered`
`common_use_vat`	`integer`	Common use VAT
`confirmation_status`	`string`	Document’s confirmation status. Can be: `P` = Cash payment method, `A` = Not claimed in term, `C` = Receipt granted by the recipient, `R` = Receipt claimed by the recipient, `G` = Acknowledgment of receipt for office guides of the previous month
`construction_company_credit`	`integer`	Construction company credit
`container_deposit_guarantee`	`integer`	Container deposit guarantee
`document_type`	`integer`	Code for the type of document. Its value is `null` if the document corresponds to a receipt for professional fees
`domestic_ticket_sales`	`integer`	Domestic ticket sales
`exempt_amount`	`integer`	Tax exempt amount represented as an integer
`exempt_commissions`	`integer`	Value exempt from commissions
`fixed_assets_net_amount`	`integer`	Fixed assets net amount represented as an integer
`fixed_assets_vat_amount`	`integer`	Fixed assets VAT-refundable amount represented as an integer
`free_zone_tax`	`integer`	Free zone tax (Chilean Law 18211)
`has_note`	`boolean`	Indicates whether the document has a credit or debit note associated
`international_ticket_sales`	`integer`	International ticket sales
`invoice_status`	`string`	Whether the invoice was obtained from the REGISTRO, PENDIENTES, RECLAMADOS or NO INCLUIR tab: `registered`, `pending`, `cancelled`, `rejected`
`is_services_invoice`	`boolean`	Indicates whether the document corresponds to a receipt for professional fees
`net_commissions`	`integer`	Net value for the commissions
`non_credit_tax_amount`	`integer`	Taxes without right to credit represented as an integer
`non_refundable_vat_amount`	`integer`	Fixed assets non VAT-refundable amount represented as an integer
`non_refundable_vat_code`	`integer`	Non VAT-refundable code
`non_withheld_vat`	`integer`	Non withheld VAT
`other_taxes`	`object`	Other taxes breakdown. See the `OtherTaxes` table below
`out_of_time_vat`	`integer`	Out of time VAT
`own_vat`	`integer`	Own VAT
`partial_vat_withheld`	`integer`	Partial VAT withheld
`received_at`	`string`	Document’s reception date given by the SII, using ISO 8601
`receipt_reference_number`	`integer`	Internal number: receipt reference number
`reference_number`	`string`	Folio number for the reference document
`reference_type_code`	`integer`	Code for the type of the reference document
`rejected_at`	`string`	Document’s rejectance date, using ISO 8601. Can be `null` if the invoice is not `rejected`
`services_invoice`	`object`	Contains specific information about the receipts for professional fees. Its value is `null` when the document doesn’t correspond to a receipt for professional fees
`settlement_issuer_id`	`string`	Settlement issuer RUT
`third_party_vat`	`integer`	Third party VAT
`tobacco`	`object`	Tobacco taxes breakdown. See the `TobaccoTaxes` table below
`total_documents`	`integer`	Number of grouped documents. This field is valid for the documents that come in summary (codes 35, 38, 39, 41, 47 and 48). For every other document, corresponds to `null`
`total_vat_withheld`	`integer`	Total VAT withheld
`transaction_category`	`string`	Classification of the transaction category: Money order, Supermarket, Real estate, Fixed asset, Common use VAT, Non-refundable VAT, Do not include
`vat_amount`	`integer`	VAT-refundable amount represented as an integer
`vat_commissions`	`integer`	Value of the VAT for the commissions

OtherTaxes Object

Attribute	Type	Description
`other_taxes_details`	`array`	Array of objects with `tax_amount`, `tax_code` and `tax_rate`
`total_amount`	`integer`	Total amount of other taxes represented as an integer

TobaccoTaxes Object

Attribute	Type	Description
`cigarettes`	`integer`	Tobacco cigarettes
`cigars`	`integer`	Pure tobacco cigars
`processed_tobacco`	`integer`	Processed tobacco

ServicesInvoice Object

Attribute	Type	Description
`is_professional_society`	`boolean`	Indicates whether the issuer taxpayer corresponds to a society of professionals or not
`is_third_party`	`boolean`	Indicates whether the invoice was generated for a third party or not
`issued_at`	`datetime`	Corresponds to the date in which the document was issued on the official SII website
`issuer_withheld_amount`	`integer`	Corresponds to the withheld amount in case the issuer taxpayer handles the provisional payment of the taxes
`receiver_withheld_amount`	`integer`	Corresponds to the withheld amount in case the recipient taxpayer handles the provisional payment of the taxes
`status`	`string`	Corresponds to the invoice. Its possible values are: `VIG` (Valid), `ANUL` (Annulled), `ObR` (Observed), `VCA` (Valid with annulment request)

Codes for SII document types

Document Type	Description
30	Invoice
32	Sales and services invoice exempt from VAT
33	Electronic invoice
34	Electronic invoice exempt from VAT
35	Ballot
38	Exempt ballot
39	Electronic ballot
40	Invoice settlement
41	Electronic exempt ballot
43	Electronic invoice settlement
45	Purchase invoice
46	Electronic purchase invoice
47	Total of the month special electronic voucher
48	Electronic payment
50	Office guide
52	Electronic office guide
55	Debit note
56	Electronic debit note
60	Credit note
61	Electronic credit note
103	Settlement
110	Electronic export invoice
111	Electronic export debit note
112	Electronic export credit note

Fintoc API

Main Resources

Payment Initiation API

Transfers API

Movements API

Direct Debit and Subscriptions

Fiscal API

Billing API

Invoice object

Taxpayer Object

Servicio de Impuestos Internos (Chile)

InvoiceSII Object

OtherTaxes Object

TobaccoTaxes Object

ServicesInvoice Object

Codes for SII document types

​Taxpayer Object

​Servicio de Impuestos Internos (Chile)

​InvoiceSII Object

​OtherTaxes Object

​TobaccoTaxes Object

​ServicesInvoice Object

​Codes for SII document types

Taxpayer Object

Servicio de Impuestos Internos (Chile)

InvoiceSII Object

OtherTaxes Object

TobaccoTaxes Object

ServicesInvoice Object

Codes for SII document types