Tax returns - Fintoc

This page explains what a tax return is and which amounts it includes. For every attribute, see the Tax return object.

What a tax return is

In Chile, taxpayers declare their income tax once a year to the Servicio de Impuestos Internos (SII) with the F22 form (Operación Renta). The form sums up the income of the previous calendar year and the taxes already withheld. The resulting balance is either a refund the SII pays into the taxpayer’s bank account, or an amount the taxpayer owes. A TaxReturn is one filed F22 form. Fintoc returns one TaxReturn per fiscal year. Tax returns are available for Links connected to the SII (cl_fiscal_sii). Create the Link with the tax_returns product.

Read a tax return

These attributes help you read a tax return:

Attribute	Meaning
`fiscal_year`, `period`	Year the return was filed. The declared income corresponds to the previous calendar year.
`document_number`	Folio the SII assigned to the filed form.
`institution_tax_return.income.salary`	Salaries, pensions, and similar income (code 1098 of the F22 form).
`institution_tax_return.income.fees`	Income from fee receipts for professional services (code 547). It is the sum of `fees_with_retention` (code 461) and `fees_without_retention` (code 545).
`institution_tax_return.income.withheld_fees`	Taxes withheld from fee receipts (code 492).
`institution_tax_return.refund_amount`	Refund the taxpayer requested.
`institution_tax_return.due_amount`	Tax the taxpayer still has to pay.
`institution_tax_return.refund_account`	Bank account where the SII deposits the refund, as a transfer account with the holder’s tax ID, account number, and institution.
`taxpayer`	The taxpayer who filed the form, with the activities, addresses, and authorized documents registered at the SII.

Amounts are integers in CLP, the smallest unit of the currency.

Endpoints

List tax returns returns the tax returns of the Link, paginated. Get a tax return returns one tax return by id.

How Fintoc fetches tax returns

Fintoc fetches the filed returns when your user creates the Link. Tax returns aren’t refreshed periodically, so to get a return filed after the connection, create a new Link.

Example

{
  "id": "taxret_nMNejK7BT8oGbvO4",
  "object": "tax_return",
  "currency": "CLP",
  "document_number": "12345",
  "fiscal_year": "2021",
  "institution_id": "cl_fiscal_sii",
  "institution_tax_return": {
    "due_amount": 0,
    "income": {
      "fees": 746546,
      "fees_with_retention": 234212,
      "fees_without_retention": 512334,
      "salary": 2313123,
      "withheld_fees": 42341
    },
    "refund_account": {
      "holder_id": "000000000",
      "holder_name": "Test Customer 1",
      "institution": {
        "country": "cl",
        "id": "cl_banco_de_chile",
        "name": "Banco de Chile"
      },
      "number": "0000000000"
    },
    "refund_amount": 1000
  },
  "interval_unit": "annual",
  "period": "2021",
  "taxpayer": {
    "id": "000000000",
    "institution_tax_payer": {
      "activities": [
        {
          "category": "1",
          "code": "0123",
          "description": "Servicios de tecnología",
          "iva": false,
          "started_at": "2020-04-16T04:00:00.000Z"
        }
      ],
      "addresses": [
        {
          "apartment": null,
          "city": "Santiago",
          "code": "0000000",
          "commune": "PROVIDENCIA",
          "number": "123",
          "region": "REGION METROPOLITANA",
          "street": "CALLE FALSA",
          "type": "DOMICILIO"
        }
      ],
      "authorized_documents": [
        {
          "authorized_at": "2021-11-30T15:57:38.584Z",
          "code": "33",
          "description": "FACTURA ELECTRONICA",
          "max_documents": 414
        }
      ],
      "email": "test@example.com",
      "phone": "000000000"
    },
    "name": "Test Customer 1"
  }
}

​What a tax return is

​Read a tax return

​Endpoints

​How Fintoc fetches tax returns

​Example

What a tax return is

Read a tax return

Endpoints

How Fintoc fetches tax returns

Example