Documentos tributarios electrónicos

Esta página explica qué documentos tributarios electrónicos devuelve el producto invoices, cómo clasificar cada documento y cómo Fintoc los mantiene actualizados. Para el detalle de cada atributo, revisa el objeto Invoice.

Qué documentos obtienes

En Chile, el Servicio de Impuestos Internos (SII) publica los documentos tributarios electrónicos (DTE) en el Registro de Compras y Ventas del contribuyente. El registro incluye los documentos que el contribuyente emite o recibe. Las boletas de honorarios viven en un registro separado. Un Link creado con el producto invoices devuelve todos los documentos del Registro de Compras y Ventas: facturas, notas de crédito y débito, guías de despacho, liquidaciones, documentos de exportación y resúmenes de boletas. Devuelve tanto los documentos emitidos como los recibidos. También devuelve las boletas de honorarios que el contribuyente emitió y recibió. List invoices y Get an invoice devuelven cada documento como un objeto Invoice, venga de cualquiera de los dos registros.

Documentos emitidos y recibidos

El atributo issue_type indica la dirección del documento desde el punto de vista del contribuyente dueño del Link.

`issue_type`	Significado	Contraparte
`issued`	El contribuyente emitió el documento. Es una venta.	`receiver` contiene el identificador tributario y el nombre del cliente. `issuer` es `null`.
`received`	El contribuyente recibió el documento. Es una compra.	`issuer` contiene el identificador tributario y el nombre del proveedor. `receiver` es `null`.

Filtra por dirección con el parámetro issue_type de List invoices.

Clasifica un documento

El objeto Invoice contiene los atributos comunes a todos los documentos. El campo institution_invoice contiene el detalle que entrega el SII para ese tipo de documento: tipo, estados, desglose del impuesto al valor agregado (IVA) y datos de la boleta de honorarios. Usa los siguientes atributos para distinguir los documentos.

Tipo de documento

institution_invoice.document_type es el código del SII para el documento. Por ejemplo, 33 es una factura electrónica, 61 es una nota de crédito electrónica y 39 es una boleta electrónica. Revisa la lista completa en Tipos de documento. document_type es null para las boletas de honorarios, que el SII no codifica como documento tributario electrónico (DTE). Identifícalas con institution_invoice.is_services_invoice.

Boletas de honorarios

Cuando institution_invoice.is_services_invoice es true, el documento es una boleta de honorarios. institution_invoice.services_invoice contiene entonces los datos propios de la boleta: el monto retenido, si la emitió un tercero y su status en el SII. Los valores de status son VIG (vigente), ANUL (anulada), ObR (observada) y VCA (vigente con solicitud de anulación). Para cualquier otro documento, is_services_invoice es false y services_invoice es null.

Documentos resumen

El SII informa algunos documentos como un resumen diario en vez de una fila por documento. Son las boletas (35, 38, 39 y 41), el comprobante especial mensual (47) y los pagos electrónicos (48). Fintoc devuelve un Invoice por día y tipo de documento para ellos, con el total del día. Para un documento resumen, institution_invoice.total_documents contiene la cantidad de documentos agrupados. Los atributos number, issuer y receiver son null, porque el resumen no tiene folio ni una contraparte única.

Estado en el registro

institution_invoice.invoice_status indica en qué pestaña del Registro de Compras y Ventas el SII informa el documento.

`invoice_status`	Significado
`registered`	El documento forma parte del registro oficial (la pestaña Registro del SII).
`pending`	El documento fue recibido pero espera el acuse de recibo del receptor (la pestaña Pendientes del SII).

Filtra por estado en el registro con el parámetro invoice_status de List invoices.

Estado del acuse de recibo

institution_invoice.confirmation_status muestra el resultado del proceso de acuse de recibo o reclamo del SII para una factura recibida. El receptor tiene 8 días corridos para dar acuse de recibo o reclamar la factura. Si el receptor no hace nada, el SII la acepta automáticamente.

`confirmation_status`	Significado
`C`	Aceptada por el receptor dentro del plazo.
`A`	Aceptada automáticamente al vencer el plazo sin reclamo.
`P`	Pagada al contado, por lo que no necesita acuse de recibo.
`G`	Aceptada a través de las guías de despacho del mes anterior.
`R`	Reclamada por el receptor.
`null`	El SII aún no registra un evento.

null no es un rechazo y no invalida el documento. El SII informa null en tres casos: el documento sigue dentro del plazo de 8 días, el tipo de documento no pasa por el proceso de acuse de recibo (boletas, notas de crédito y débito, y guías de despacho), o el documento es issued y la contraparte no ha actuado. Para saber en qué estado está el documento, usa invoice_status, accepted_at y rejected_at.

Otros atributos

institution_invoice.transaction_category es la clasificación que el contribuyente da a un documento recibido en el registro de compras, como Del Giro, Supermercado o Activo Fijo. Es null cuando el SII no la informa.
institution_invoice.has_note es true cuando una nota de crédito o débito referencia el documento.
Los montos (total_amount, net_amount, institution_invoice.exempt_amount, institution_invoice.vat_amount e institution_invoice.other_taxes) son enteros en CLP, la unidad mínima de la moneda.

Filtra la lista

List invoices devuelve los documentos ordenados por date descendente, paginados. Estos parámetros acotan el resultado.

Parámetro	Efecto
`since`, `until`	Solo documentos con `date` dentro del rango. Ambos son fechas ISO 8601.
`updated_since`	Solo documentos que Fintoc creó o actualizó en o después de esta fecha y hora ISO 8601 con zona horaria, por ejemplo `2024-01-01T00:00:00Z`. Úsalo para sincronizar de forma incremental.
`issue_type`	Solo documentos `issued` o solo `received`.
`invoice_status`	Solo documentos `registered` o solo `pending`.

Cómo Fintoc mantiene las facturas actualizadas

Cuando tu usuario crea el Link, Fintoc obtiene los documentos de los últimos 12 meses. Los documentos quedan disponibles después de que tu usuario se conecta. Luego, Fintoc actualiza el Link periódicamente con el intervalo de actualización de tu plan. Cada actualización obtiene los documentos del mes en curso y del mes anterior, porque el SII todavía puede modificar un documento después del cierre del mes. Fintoc envía el evento link.refresh_intent.succeeded cuando una actualización termina. Si la actualización no se completa, Fintoc envía link.refresh_intent.failed. Revisa la referencia de eventos para ver el payload. Para actualizar a demanda un Link creado con el producto invoices, crea un Refresh Intent.

Ejemplo

Una factura electrónica recibida (document_type 33), que ya forma parte del registro:

{
  "id": "inv_nMNejK7BT8oGbvO4",
  "object": "invoice",
  "currency": "CLP",
  "date": "2021-06-25T04:00:00.000Z",
  "institution_id": "cl_fiscal_sii",
  "institution_invoice": {
    "accepted_at": "2021-06-26T12:00:00.000Z",
    "common_use_vat": null,
    "confirmation_status": "A",
    "construction_company_credit": 0,
    "container_deposit_guarantee": 0,
    "document_type": 33,
    "domestic_ticket_sales": 0,
    "exempt_amount": 0,
    "exempt_commissions": 0,
    "fixed_assets_net_amount": null,
    "fixed_assets_vat_amount": null,
    "free_zone_tax": 0,
    "has_note": false,
    "international_ticket_sales": 0,
    "invoice_status": "registered",
    "is_services_invoice": false,
    "net_commissions": 0,
    "non_credit_tax_amount": null,
    "non_refundable_vat_amount": null,
    "non_refundable_vat_code": null,
    "non_withheld_vat": 0,
    "other_taxes": {
      "other_taxes_detail": [
        {
          "tax_amount": 400,
          "tax_code": 14,
          "tax_rate": "19"
        }
      ],
      "total_amount": 400
    },
    "out_of_time_vat": 0,
    "own_vat": 0,
    "partial_vat_withheld": 0,
    "receipt_reference_number": null,
    "received_at": "2021-06-25T19:27:04.000Z",
    "reference_number": null,
    "reference_type_code": null,
    "rejected_at": null,
    "services_invoice": null,
    "settlement_issuer_id": null,
    "third_party_vat": 0,
    "tobacco": {
      "cigarettes": 0,
      "cigars": 0,
      "processed_tobacco": 0
    },
    "total_documents": null,
    "total_vat_withheld": 0,
    "transaction_category": "Del Giro",
    "vat_amount": 1900,
    "vat_commissions": null
  },
  "issue_type": "received",
  "issuer": {
    "id": "111111111",
    "institution_tax_payer": null,
    "name": "Test Customer 1"
  },
  "net_amount": 10000,
  "number": "135",
  "receiver": null,
  "tax_period": "06/2021",
  "total_amount": 12300
}

​Qué documentos obtienes

​Documentos emitidos y recibidos

​Clasifica un documento

​Tipo de documento

​Boletas de honorarios

​Documentos resumen

​Estado en el registro

​Estado del acuse de recibo

​Otros atributos

​Filtra la lista

​Cómo Fintoc mantiene las facturas actualizadas

​Ejemplo