Tax statement object

The Tax Statement object

The TaxStatement object represents a periodic tax statement that a fiscal account's owner files with their tax authority. For the Servicio de Impuestos Internos (SII), it corresponds to the monthly F29 form for a given period, with the authority-specific amounts nested in institution_tax_statement.

{
  "id": "taxstmt_000000000",
  "object": "tax_statement",
  "currency": "CLP",
  "document_number": "123456",
  "fiscal_year": 2021,
  "institution_id": "cl_fiscal_sii",
  "institution_tax_statement": {
    "monthly_provisional_payments": null,
    "retention_fee": 6497,
    "salary_tax": 1870153,
    "total_credit": 403497,
    "total_debit": 1173692,
    "total_payment": 2646845
  },
  "interval_unit": "monthly",
  "period": "10",
  "status": "Vigente",
  "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 Statement
objectstringIdentifier for the type of object. Its value for Tax Statements will always correspond to tax_statement
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 taxes correspond
institution_idstringFiscal authority's id. You can read more about the available institutions here
institution_tax_statementobjectEither an SIITaxStatement or an SATTaxStatement object
interval_unitstringIts value corresponds to monthly
periodstringMonth of the year to which the taxes correspond
statusstringStatus of the Tax Statement
taxpayerobjectTaxpayer to whom the tax statement corresponds.

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

If the fiscal authority is Servicio de Impuestos Internos (cl_fiscal_sii), monthly taxes correspond to what's declared using the F29 form. The taxpayer and institution_tax_statement fields corresponds to the following objects, respectively:

The SII Tax Statement object

The SIITaxStatement object holds the credit, debit, and payment amounts declared on the F29 form, and it populates the institution_tax_statement field when the fiscal authority is cl_fiscal_sii.

AttributeTypeDescription
monthly_provisional_paymentsintegerMonthly provisional payments
retention_feeintegerRetention fee over honoraria
salary_taxintegerSecond category taxes
total_creditintegerTotal amount of credit
total_debitintegerTotal amount of debit
total_paymentintegerTotal amount of taxes to pay within the legal term

The Tax Payer object (within the Tax Statement object)

The TaxPayer object describes the account's owner to whom the tax statement corresponds, and it appears in the taxpayer field of the TaxStatement 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

The Address object (within the Tax Payer object)

The Address object describes a registered location of the taxpayer, and entries appear in the addresses array of the TaxPayer object.

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

The Activity object (within the Tax Payer object)

The Activity object describes an economic activity, profession, or business that the taxpayer is registered for. Entries appear in the activities array of the TaxPayer 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

The Authorized Document object (within the Tax Payer object)

The AuthorizedDocument object describes a type of tax document the taxpayer is authorized to issue. Entries appear in the authorized_documents array of the TaxPayer object.

AttributeTypeDescription
authorized_atdatetimeDate when the document issuance 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