Objeto Tax Statement

El objeto Tax Statement

El objeto TaxStatement representa una declaración de impuestos periódica que el titular de una cuenta fiscal presenta ante su autoridad tributaria. Para el Servicio de Impuestos Internos (SII), corresponde al formulario mensual F29 de un period determinado. Los montos específicos de la autoridad aparecen en institution_tax_statement. El siguiente ejemplo muestra un objeto TaxStatement:

Tax Statement Object

{
  "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": "test@example.com",
      "phone": "999999999"
    },
    "name": "Test Company 1"
  }
}

El objeto TaxStatement incluye los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Identificador único de la declaración de impuestos.
`object`	`string`	Tipo de objeto. Siempre es `tax_statement`.
`currency`	`string`	Código ISO 4217 de tres letras de la moneda.
`document_number`	`string`	Folio de la declaración para `cl_fiscal_sii` o número de operación para `mx_fiscal_sat`.
`fiscal_year`	`integer`	Año fiscal al que corresponden los impuestos.
`institution_id`	`string`	Identificador de la autoridad fiscal. Consulta las instituciones disponibles.
`institution_tax_statement`	`object`	Objeto `SIITaxStatement` o `SATTaxStatement` con los datos específicos de la autoridad fiscal.
`interval_unit`	`string`	Periodicidad de la declaración. Siempre es `monthly`.
`period`	`string`	Mes de `fiscal_year` al que corresponde la declaración, expresado con dos dígitos.
`status`	`string`	Estado de 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), los impuestos mensuales corresponden a lo declarado mediante el formulario F29. Los campos institution_tax_statement y taxpayer contienen los siguientes objetos, respectivamente:

El objeto SII Tax Statement

El objeto SIITaxStatement contiene los montos de crédito, débito y pago declarados en el formulario F29. Todos los montos están expresados en pesos chilenos, sin decimales, y pueden ser null. Este objeto aparece en institution_tax_statement cuando la autoridad fiscal es cl_fiscal_sii e incluye los siguientes atributos:

Atributo	Tipo	Descripción
`monthly_provisional_payments`	`integer`	Pagos provisionales mensuales.
`retention_fee`	`integer`	Retención por honorarios.
`salary_tax`	`integer`	Impuestos de segunda categoría.
`total_credit`	`integer`	Monto total de crédito.
`total_debit`	`integer`	Monto total de débito.
`total_payment`	`integer`	Monto total de impuestos que se deben pagar dentro del plazo legal.

El objeto Tax Payer dentro del objeto Tax Statement

El objeto TaxPayer describe al titular de la cuenta al que corresponde la declaración de impuestos. Este objeto aparece en taxpayer del objeto TaxStatement e incluye los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Rol Único Tributario (RUT) del contribuyente, sin puntos ni guion.
`activities`	`array`	Actividades, profesiones o negocios del contribuyente.
`addresses`	`array`	Direcciones del contribuyente.
`authorized_documents`	`array`	Documentos tributarios que el contribuyente está autorizado a 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 de addresses en el objeto TaxPayer corresponde a un objeto Address con los siguientes atributos:

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

El objeto Activity dentro del objeto Tax Payer

El objeto Activity describe una actividad económica, profesión o negocio que el contribuyente tiene registrado. Cada elemento de activities en el objeto TaxPayer corresponde a un objeto Activity con los siguientes atributos:

Atributo	Tipo	Descripción
`category`	`string`	Categoría tributaria de la actividad: `1` para rentas empresariales o `2` para rentas por servicios profesionales.
`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á afecta al impuesto al valor agregado (IVA).
`started_at`	`datetime`	Fecha y hora de inicio de la actividad en formato ISO 8601 y en UTC.

El objeto Authorized Document dentro del objeto Tax Payer

El objeto AuthorizedDocument describe un tipo de documento tributario que el contribuyente está autorizado a emitir. Cada elemento de authorized_documents en el objeto TaxPayer corresponde a un objeto AuthorizedDocument con los siguientes atributos:

Atributo	Tipo	Descripción
`authorized_at`	`datetime`	Fecha y hora de autorización del tipo de documento en formato ISO 8601 y en UTC.
`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.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Objeto Tax Statement

El objeto Tax Statement

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

El objeto SII Tax Statement

El objeto Tax Payer dentro del objeto Tax Statement

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 Tax Statement

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

​El objeto SII Tax Statement

​El objeto Tax Payer dentro del objeto Tax Statement

​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 Tax Statement

🇨🇱 Chile: Servicio de Impuestos Internos (SII)

El objeto SII Tax Statement

El objeto Tax Payer dentro del objeto Tax Statement

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