> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`.

```json Tax Return Object theme={null}
{
  "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](https://www.iso.org/iso-4217-currency-codes.html).                                     |
| `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](/es/guides/movements/fiscal-links). |
| `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](https://www.sii.cl/ayudas/ayudas_por_servicios/1956-codigos-1959.html) 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.        |
