Objeto Tax return

El objeto Tax Return

El objeto TaxReturn representa una declaración anual de impuestos que el titular de una cuenta fiscal presenta ante su autoridad tributaria. Para el Servicio de Impuestos Internos (SII), el objeto corresponde al formulario F22 de un fiscal_year determinado. Los montos específicos de la autoridad aparecen en institution_tax_return.

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": "111111111",
      "holder_name": "Test Customer 1",
      "institution": {
        "id": "cl_banco_de_chile",
        "country": "cl",
        "name": "Banco de Chile"
      },
      "number": "000000000"
    },
    "refund_amount": 1000
  },
  "interval_unit": "annual",
  "period": "2021",
  "taxpayer": {
    "id": "000000001",
    "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": "test@example.com",
      "phone": "999999999"
    },
    "name": "Test Company 1"
  }
}

Atributo	Tipo	Descripción
`id`	`string`	Identificador único de la declaración de impuestos.
`object`	`string`	Identificador del tipo de objeto. El valor siempre es `tax_return`.
`currency`	`string`	Código de moneda ISO 4217.
`document_number`	`string`	Folio de la declaración para `cl_fiscal_sii`, o número de operación para `mx_fiscal_sat`.
`fiscal_year`	`string`	Año fiscal al que corresponde la declaración de impuestos.
`institution_id`	`string`	Identificador de la autoridad fiscal. Consulta las instituciones disponibles.
`institution_tax_return`	`object`	Objeto `SIITaxReturn` o `SATTaxReturn` con los datos específicos de la autoridad.
`interval_unit`	`string`	Intervalo de la declaración. El valor siempre es `annual`.
`period`	`string`	Período al que corresponde la declaración de impuestos.
`taxpayer`	`object`	Contribuyente al que corresponde la declaración de impuestos.

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

Si la autoridad fiscal es el Servicio de Impuestos Internos (cl_fiscal_sii), la declaración de impuestos corresponde al formulario F22. Los campos taxpayer e institution_tax_return corresponden a los siguientes objetos, respectivamente.

El objeto Tax Payer (dentro del objeto Tax Return)

El objeto TaxPayer describe al titular de la cuenta al que corresponde la declaración de impuestos. Este objeto aparece en el campo taxpayer del objeto TaxReturn.

Atributo	Tipo	Descripción
`id`	`string`	Identificador tributario chileno (RUT) del contribuyente.
`activities`	`array`	Actividades económicas, profesiones o negocios del contribuyente.
`addresses`	`array`	Direcciones registradas del contribuyente.
`authorized_documents`	`array`	Documentos tributarios que el contribuyente puede emitir.
`email`	`string`	Correo electrónico del contribuyente.
`name`	`string`	Nombre del contribuyente.
`phone`	`string`	Número de teléfono del contribuyente.

El objeto Address (dentro del objeto Tax Payer)

El objeto Address describe una ubicación registrada del contribuyente. Cada elemento del arreglo addresses corresponde a un objeto Address.

Atributo	Tipo	Descripción
`apartment`	`string`	Número del departamento o de la oficina.
`city`	`string`	Ciudad de la dirección.
`code`	`string`	Código de la sucursal.
`commune`	`string`	Comuna de la dirección.
`number`	`string`	Número del edificio.
`region`	`string`	Región de la dirección.
`street`	`string`	Avenida, calle o pasaje de la dirección.

El objeto Activity (dentro del objeto Tax Payer)

El objeto Activity describe una actividad económica, profesión o negocio del contribuyente. Cada elemento del arreglo activities corresponde a un objeto Activity.

Atributo	Tipo	Descripción
`category`	`string`	Categoría tributaria del contribuyente.
`code`	`string`	Código de actividad económica del contribuyente.
`description`	`string`	Descripción de la actividad económica del contribuyente.
`iva`	`boolean`	Indica si la actividad económica está gravada con el impuesto al valor agregado (IVA).
`started_at`	`datetime`	Fecha y hora de inicio de las actividades tributarias en formato ISO 8601.

El objeto Authorized Document (dentro del objeto Tax Payer)

El objeto AuthorizedDocument describe un tipo de documento tributario que el contribuyente puede emitir. Cada elemento del arreglo authorized_documents corresponde a un objeto AuthorizedDocument.

Atributo	Tipo	Descripción
`authorized_at`	`datetime`	Fecha y hora de autorización de la emisión del documento en formato ISO 8601.
`code`	`string`	Código del tipo de documento.
`description`	`string`	Nombre del tipo de documento.
`max_documents`	`integer`	Cantidad máxima de folios autorizados para el tipo de documento.

El objeto Institution Tax Return (dentro del objeto Tax Return)

Cuando la autoridad fiscal es el Servicio de Impuestos Internos (cl_fiscal_sii), el campo institution_tax_return corresponde al siguiente objeto.

El objeto SII Tax Return

El objeto SIITaxReturn contiene los ingresos y los montos de devolución declarados en el formulario F22. Este objeto aparece en institution_tax_return cuando la autoridad fiscal es cl_fiscal_sii.

Atributo	Tipo	Descripción
`due_amount`	`integer`	Impuesto por pagar del contribuyente, en pesos chilenos (CLP).
`income`	`object`	Ingresos del contribuyente declarados en el formulario F22.
`refund_account`	`object`	Cuenta bancaria en la que se deposita la devolución de impuestos. Corresponde a un objeto `RefundAccount`.
`refund_amount`	`integer`	Devolución de impuestos solicitada por el contribuyente, en CLP.

El objeto Income (dentro del objeto Institution Tax Return)

El objeto Income desglosa los ingresos declarados por el contribuyente según su origen. Este objeto aparece en el campo income del objeto SIITaxReturn.

Atributo	Tipo	Descripción
`fees`	`integer`	Ingresos totales en CLP por boletas de honorarios. Corresponde a la suma de `fees_with_retention` y `fees_without_retention`, informada en el código 547 del formulario F22.
`fees_with_retention`	`integer`	Ingresos totales en CLP por boletas de honorarios con retención, informados en el código 461 del formulario F22.
`fees_without_retention`	`integer`	Ingresos totales en CLP por boletas de honorarios sin retención, informados en el código 545 del formulario F22.
`salary`	`integer`	Sueldos, pensiones y otros ingresos similares en CLP, informados en el código 1098 del formulario F22.
`withheld_fees`	`integer`	Impuestos totales en CLP retenidos por boletas de honorarios, informados en el código 492 del formulario F22.

El objeto Refund Account (dentro del objeto Institution Tax Return)

El objeto RefundAccount describe la cuenta bancaria en la que se deposita la devolución del contribuyente. Este objeto aparece en el campo refund_account del objeto SIITaxReturn.

Atributo	Tipo	Descripción
`holder_id`	`string`	RUT del contribuyente.
`holder_name`	`string`	Nombre del contribuyente.
`institution`	`object`	Institución financiera del contribuyente. Corresponde a un objeto `Institution`.
`number`	`string`	Número de cuenta del contribuyente.

El objeto Institution (dentro del objeto Refund Account)

El objeto Institution identifica el banco que mantiene la cuenta de devolución. Este objeto aparece en el campo institution del objeto RefundAccount.

Atributo	Tipo	Descripción
`id`	`string`	Identificador de la institución.
`country`	`string`	País de la institución.
`name`	`string`	Nombre de la institución.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Objeto Tax return

El objeto Tax Return

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

El objeto Tax Payer (dentro del objeto Tax Return)

El objeto Address (dentro del objeto Tax Payer)

El objeto Activity (dentro del objeto Tax Payer)

El objeto Authorized Document (dentro del objeto Tax Payer)

El objeto Institution Tax Return (dentro del objeto Tax Return)

El objeto SII Tax Return

El objeto Income (dentro del objeto Institution Tax Return)

El objeto Refund Account (dentro del objeto Institution Tax Return)

El objeto Institution (dentro del objeto Refund Account)

​El objeto Tax Return

​🇨🇱 Chile: Servicio de Impuestos Internos (SII)

​El objeto Tax Payer (dentro del objeto Tax Return)

​El objeto Address (dentro del objeto Tax Payer)

​El objeto Activity (dentro del objeto Tax Payer)

​El objeto Authorized Document (dentro del objeto Tax Payer)

​El objeto Institution Tax Return (dentro del objeto Tax Return)

​El objeto SII Tax Return

​El objeto Income (dentro del objeto Institution Tax Return)

​El objeto Refund Account (dentro del objeto Institution Tax Return)

​El objeto Institution (dentro del objeto Refund Account)

El objeto Tax Return

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

El objeto Tax Payer (dentro del objeto Tax Return)

El objeto Address (dentro del objeto Tax Payer)

El objeto Activity (dentro del objeto Tax Payer)

El objeto Authorized Document (dentro del objeto Tax Payer)

El objeto Institution Tax Return (dentro del objeto Tax Return)

El objeto SII Tax Return

El objeto Income (dentro del objeto Institution Tax Return)

El objeto Refund Account (dentro del objeto Institution Tax Return)

El objeto Institution (dentro del objeto Refund Account)