Links fiscales

Esta página explica qué es un Link fiscal, qué productos fiscales ofrece Fintoc y qué documentos de la autoridad tributaria devuelve cada uno. Para el detalle de cada campo, revisa los objetos Invoice, TaxStatement y TaxReturn.

​

Qué es un Link fiscal

Un Link fiscal conecta la cuenta de un contribuyente en el Servicio de Impuestos Internos (SII), la autoridad tributaria de Chile, con Fintoc, de la misma forma en que un Link bancario conecta una cuenta bancaria. Tu usuario crea el Link fiscal a través del Widget con las credenciales que usa en la autoridad tributaria. Después de crear el Link, Fintoc envía el evento link.created a la webhookUrl que configuraste en el Widget. Ese evento incluye el link_token, que autentica cada request a la API Fiscal para ese Link. Guarda el link_token cuando lo recibas, porque Fintoc no lo almacena. El flujo de conexión sigue la guía Flujo de integración para Links bancarios. Un Link fiscal pertenece a un contribuyente, identificado por su identificador tributario chileno (RUT). El holder_type del Link es individual para una persona natural y business para una empresa.

​

Productos fiscales

Crea un Link fiscal para cada producto que quieras obtener. El producto determina qué documentos obtiene Fintoc desde la autoridad tributaria y qué endpoint los devuelve. Para obtener dos tipos de documentos del mismo contribuyente, por ejemplo facturas y declaraciones de impuestos, crea dos Links. Usa invoices cuando concilies compras y ventas, verifiques los ingresos de un trabajador independiente a través de sus boletas de honorarios o necesites la actividad completa de una empresa. Usa tax_statements para el IVA declarado mes a mes y tax_returns para la declaración de renta.

​

Instituciones

​

Mantener los datos actualizados

Los documentos fiscales cambian después de que el contribuyente conecta el Link: aparecen documentos nuevos, una factura recibida recibe acuse de recibo y se presenta una nueva declaración de impuestos. Fintoc mantiene cada producto al día de una forma distinta.

• Facturas y boletas de honorarios. Al crear 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. Cuando una actualización termina, Fintoc envía el evento link.refresh_intent.succeeded. Si la actualización no se completa, Fintoc envía link.refresh_intent.failed. También puedes actualizar a demanda un Link creado con el producto invoices con un Refresh Intent.
• Declaraciones de impuestos. Fintoc obtiene las declaraciones presentadas al crear el Link y las actualiza periódicamente con el intervalo de actualización de tu plan.
• Declaraciones de renta. Fintoc obtiene las declaraciones presentadas al crear el Link. Las declaraciones de renta no se actualizan periódicamente.

Usa el parámetro updated_since de List invoices para obtener solo los documentos que cambiaron desde tu última sincronización.

​

Próximos pasos