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

# Declaraciones de impuestos

> Obtén las declaraciones de impuestos (formulario F29) que un contribuyente presentó en el Servicio de Impuestos Internos (SII): débito y crédito fiscal, retenciones, pagos provisionales mensuales y el total a pagar de cada período.

Esta página explica qué es una declaración de impuestos y qué montos incluye. Para el detalle de cada atributo, revisa el [objeto Tax Statement](/es/api/fiscal-api/tax-statements/tax-statements-object).

## Qué es una declaración de impuestos

En Chile, los contribuyentes declaran y pagan sus impuestos mensuales al Servicio de Impuestos Internos (SII) con el formulario F29. El formulario incluye el impuesto al valor agregado (IVA) cobrado en las ventas, el IVA pagado en las compras, las retenciones sobre boletas de honorarios y sueldos, y los pagos provisionales mensuales del impuesto a la renta.

Un `TaxStatement` es un formulario F29 presentado. Los contribuyentes presentan el F29 cada mes, por lo que un `Link` creado con el producto `tax_statements` te entrega la actividad tributaria mensual del contribuyente.

Las declaraciones de impuestos están disponibles para `Links` conectados al SII (`cl_fiscal_sii`). Crea el `Link` con el producto `tax_statements`.

## Lee una declaración de impuestos

| Atributo                                                 | Significado                                                                                                                   |
| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
| `fiscal_year`, `period`                                  | Año y mes que cubre la declaración. `period` es el número del mes, por ejemplo `10` para octubre.                             |
| `document_number`                                        | Folio que el SII asignó al formulario presentado.                                                                             |
| `status`                                                 | Estado del formulario en el SII, por ejemplo `Vigente` para un formulario actualmente en vigor.                               |
| `institution_tax_statement.total_debit`                  | IVA cobrado en las ventas del mes (débito fiscal).                                                                            |
| `institution_tax_statement.total_credit`                 | IVA pagado en las compras del mes (crédito fiscal).                                                                           |
| `institution_tax_statement.retention_fee`                | Impuesto retenido sobre boletas de honorarios.                                                                                |
| `institution_tax_statement.salary_tax`                   | Impuesto único de segunda categoría retenido sobre sueldos.                                                                   |
| `institution_tax_statement.monthly_provisional_payments` | Pago provisional mensual del impuesto a la renta. `null` cuando el contribuyente no declaró uno.                              |
| `institution_tax_statement.total_payment`                | Monto total a pagar por el mes dentro del plazo legal.                                                                        |
| `taxpayer`                                               | El contribuyente que presentó el formulario, con las actividades, direcciones y documentos autorizados registrados en el SII. |

Los montos son enteros en CLP, la unidad mínima de la moneda.

## Endpoints

[List tax statements](/es/api/fiscal-api/tax-statements/tax-statements-list) devuelve las declaraciones del `Link`, paginadas. Fintoc las ordena por año y período, con la declaración más reciente primero. [Get a tax statement](/es/api/fiscal-api/tax-statements/tax-statements-get) devuelve una declaración por `id`.

## Cómo Fintoc mantiene las declaraciones de impuestos actualizadas

Fintoc obtiene las declaraciones presentadas cuando tu usuario crea el `Link`. Luego las actualiza periódicamente con el intervalo de actualización de tu plan, para que los meses recién declarados aparezcan en la lista.

## Ejemplo

```json theme={null}
{
  "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": "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"
  }
}
```