Tax Return Object

{
  "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": 13123,
      "fees_with_retention": 234212,
      "fees_without_retention": 512334,
      "salary": 2313123,
      "withheld_fees": 42341,
    },
    "refund_account": {
      "holder_id": "117056856",
      "holder_name": "Erlich Bachman",
      "institution": {
        "id": "cl_banco_de_chile",
        "country": "cl",
        "name": "Banco de Chile"
      },
      "number": "123123123"
  	},
    "refund_amount": 1000,
  },
  "interval_unit": "annual",
  "period": "2021",
  "taxpayer": {
    "id": "777777777",
    "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": "84345463",
          "commune": "PROVIDENCIA",
          "number": "2461",
          "region": "REGION METROPOLITANA",
          "street": "LOS CONQUISTADORES",
          "type": "DOMICILIO"
        }
      ],
      "authorized_documents": [
        {
          "authorized_at": "2021-11-30T15:57:38.584Z",
          "code": "33",
          "description": "FACTURA ELECTRONICA",
          "max_documents": 414
        }
      ],
      "email": "[email protected]",
      "phone": "999999999"
    },
    "name": "Fintoc SpA"
  }
}
AttributeTypeDescription
idstringUnique identifier for the Tax Return
objectstringIdentifier for the type of object. Its value for Tax Returns will always correspond to tax_return
currencystringCurrency ISO code
document_numberstringFor cl_fiscal_sii, it corresponds to the declaration folio. For mx_fiscal_sat, it corresponds to the operation number
fiscal_yearstringYear to which the tax return corresponds
institution_idstringFiscal authority's id. You can read more about the available institutions here
institution_tax_returnobjectEither a SIITaxReturn or a SATTaxReturn object
interval_unitstringIts value corresponds to annual
periodstringPeriod to which the tax return corresponds
taxpayerobjectAn object representing the taxpayer to whom the taxe return corresponds

Servicio de Impuestos Internos (Chile)

If the fiscal authority is Servicio de Impuestos Internos (cl_fiscal_sii), the tax return correspond to what's declared using the F22 form. The taxpayer and institution_tax_return fields corresponds to the following objects, respectively:

Taxpayer Object

AttributeTypeDescription
idstringThe taxpayer's RUT
activitiesarrayArray with the taxpayer's activities, profession or business
addressesarrayArray with the taxpayer's addresses
authorized_documentsarrayArray with the taxpayer's authorized documents for emitting
emailstringThe taxpayer's email
namestringThe taxpayer's name
phonestringThe taxpayer's phone number

Address Object

AttributeTypeDescription
apartmentstringApartment or office number
citystringCity
codestringBranch code
communestringCommune
numberstringBuilding number
regionstringRegion
streetstringAvenue, street, passage

Activity Object

AttributeTypeDescription
categorystringTaxpayer's tributary category
codestringThe taxpayer's code of economic activity
descriptionstringTaxpayer's economic activity description
ivabooleanIndicates whether the economic activity is affected by IVA
started_atdatetimeThe taxpayer's start date of tax activities, using ISO 8601

Authorized Documents Object

AttributeTypeDescription
authorized_atdatetimeDate in which the emision of the document was authorized
codestringCode for the type of document
descriptionstringName for the type of document
max_documentsintegerMax number of folios to authorize for the type of document

SIITaxReturn Object

AttributeTypeDescription
due_amountintegerThe taxpayer's tax to be paid
incomeobjectThe taxpayer's income, according to the F22 form
refund_accountobjectThe taxpayer's account in which to deposit the tax returns. Corresponds to a Transfer Account object
refund_amountintegerThe taxpayer's requested tax returns

Income Object

AttributeTypeDescription
feesintegerTotal amount of income from receipts for professional fees. It corresponds to the addition of fees_with_retention and fees_without_retention. Code 547 of the F22 form
fees_with_retentionintegerTotal amount from receipts for professional fees with retention. Code 461 of the F22 form
fees_without_retentionintegerTotal amount from receipts for professional fees without retention. Code 545 of the F22 form
salaryintegerSalaries, pensions and other similar incomes. Code 1098 of the F22 form
withheld_feesintegerTotal taxes withheld from receipts for professional fees. Code 492 of the F22 form