Reportes y conciliación

Los reportes de Fintoc te ayudan a comprender y conciliar la actividad de tu cuenta.

Seleccionar un reporte

Cuando usas la API de Payment Initiation de Fintoc, Fintoc tiene dos reportes que proporcionan información sobre tus transacciones. Comienza con la tarea que buscas realizar y usa la tabla a continuación para identificar el mejor reporte.

Tarea	Reporte sugerido
- Desglosar las transacciones individuales incluidas en cada payout a tu cuenta bancaria	Conciliación de payout
- Descargar el historial diario de transacciones - Ver los totales diarios de transacciones	Transacciones diarias

Reporte de conciliación de payoutEl reporte de conciliación de payout solo está disponible cuando Fintoc recauda los pagos.

El reporte de conciliación de payout

El reporte de conciliación de payout muestra qué transacciones están incluidas en un payout específico. Este reporte te ayuda a conciliar cada payout que recibiste en tu cuenta bancaria con las transacciones incluidas en ese lote. Fintoc te envía un correo electrónico con el reporte de conciliación del payout cada vez que realiza un payout a tu cuenta bancaria, salvo que el toggle Correo de liquidación esté apagado. Para prender o apagar este correo, consulta notificaciones de payouts. Para los otros canales de entrega, consulta entrega automática de reportes.

Estructura

El reporte de conciliación de payout es un archivo CSV delimitado por punto y coma en el que la primera fila son los encabezados de las columnas. El nombre del archivo es yyyy-mm-dd-fintoc-payout-<orgname>.csv. Por ejemplo, si tu orgname es “My Company”, el nombre del archivo será yyyy-mm-dd-fintoc-payout-mycompany.csv. El archivo contiene las siguientes columnas:

#	Columna	Tipo	Descripción
1	`id`	`string`	Identificador único de la transacción. Distingue entre mayúsculas y minúsculas.
2	`created_at`	`string`	La fecha de creación de la transacción, en formato ISO 8601.
3	`amount`	`integer`	Monto bruto de la transacción, en centavos. En el caso de reembolsos, este valor se mostrará como negativo, a menos que un reembolso falle, en cuyo caso se mostrará como positivo.
4	`fee`	`integer`	Comisiones (en centavos) pagadas por esta transacción. Si tu cuenta está configurada para recibir el monto total del payout, entonces `fee` siempre es `0`.
5	`net_amount`	`integer`	Monto neto de la transacción, en centavos.
6	`currency`	`string`	Código ISO de la moneda de la transacción
7	`payout_holder_id`	`string`	Identificador del titular de la cuenta bancaria a la que se envió el payout. En Chile es un RUT y en México es un RFC.
8	`payout_recipient_account`	`string`	El número de cuenta al que se envió el payout.
9	`payout_recipient_bank`	`string`	El banco al que se envió el payout.
10	`resource_type`	`string`	Indica si la transacción es un `payment_intent`, un `charge` o un `refund`.
11	`resource_subtype`	`string`	Medio de pago de la transacción. Está presente cuando tu organización cobra con algún medio distinto de la transferencia bancaria. Revisa los valores más abajo.
12	`metadata`	`string`	Una cadena JSON con la metadata de la transacción.
13	`payout_id`	`string`	Identificador del payout que incluye la transacción.

Un mismo payout cubre todos los medios de pago con los que Fintoc recauda para ti, así que resource_type es payment_intent para todos los medios de pago. Usa resource_subtype para separar un payout por medio de pago:

`resource_subtype`	Medio de pago
`bank_transfer`	Transferencia bancaria.
`credit_card`, `debit_card`, `prepaid_card`, `card`	Tarjeta. El valor es `card` cuando no se conoce el tipo.
`installment`, `installments`	Cuotas.
`pac`	Pago Automático de Cuentas (PAC).
`cash`	Efectivo.
`getnet`, `boton_banco_estado`	Botón de pago, según el proveedor.

Las filas de cobros recurrentes dejan resource_subtype vacío.

Ejemplo

Para ver un ejemplo de los datos incluidos y de la estructura, descarga una muestra del reporte de conciliación de payout.

Reporte de transacciones diarias

Calendarios de entrega

El reporte de transacciones diarias puede programarse para entrega bajo dos esquemas: hora de corte bancaria y hora de corte de día cronológico. Los calendarios configurados tienen dos efectos:

Cambian el día y la hora en que se entregan los reportes.
Cambian la ventana de tiempo de los datos que contiene cada archivo.

Calendario de entrega	País disponible	Descripción
día cronológico	Chile México	El reporte se entregará todos los días sin excepción. El archivo contendrá datos de un solo día, de 00:00 a 23:59. Los archivos se entregarán entre las 00:20 y las 01:20.
día bancario	Chile	El reporte se entregará según la hora de corte bancaria de Chile, que es en días hábiles a las 14:00. Por lo tanto, los datos para un día específico estarán entre las 14:00 y las 13:59 del siguiente día hábil. Los archivos se entregarán en días hábiles entre las 14:20 y las 15:20. Por ejemplo, salvo feriados, un reporte recibido un miércoles contendrá datos desde el martes a las 14:00 hasta el miércoles a las 13:59. Otro ejemplo es que un reporte recibido un lunes contendrá datos desde el viernes anterior a las 14:00 hasta el lunes a las 13:59. Si ese viernes fuera feriado, la ventana de datos sería aún mayor (comenzaría el jueves a las 14:00).

Estructura

El reporte de transacciones diarias es un archivo CSV delimitado por punto y coma en el que la primera fila son los encabezados de las columnas. El nombre del archivo es yyyy-mm-dd-daily-summary-fintoc-<orgname>.csv. Por ejemplo, si tu orgname es “My Company”, el nombre del archivo será yyyy-mm-dd-daily-summary-fintoc-mycompany.csv. El archivo contiene las siguientes columnas:

#	Columna	Tipo	Descripción
1	`created_at`	`string`	La fecha de creación del pago, en formato ISO 8601.
2	`payment_id`	`string`	Identificador único del pago. Distingue entre mayúsculas y minúsculas.
3	`id_given_by_sender_institution`	`string`	Número de operación del banco de la cuenta del remitente.
4	`updated_at`	`string`	La fecha de actualización del pago, en formato ISO 8601.
5	`amount`	`integer`	Monto del pago, en centavos.
6	`currency`	`string`	El código ISO de la moneda del pago
7	`sender_institution_id`	`string`	El banco que inició el pago.
8	`sender_institution_cmf_code`	`string`	El código CMF del banco que inició el pago. En México está vacío.
9	`sender_account_number`	`string`	El número de cuenta que inició el pago.
10	`sender_account_type`	`string`	El tipo de cuenta del remitente.
11	`sender_holder_id`	`string`	Identificador del titular de la cuenta bancaria que inició el pago. En Chile es un RUT y en México es un RFC.
12	`sender_name`	`string`	El nombre del titular de la cuenta bancaria que inició el pago. Puede estar vacío.
13	`recipient_holder_id`	`string`	Identificador del titular de la cuenta bancaria que recibió el pago. En Chile es un RUT y en México es un RFC.
14	`recipient_account_number`	`string`	El número de cuenta que recibió el pago.
15	`recipient_institution_id`	`string`	El banco que recibió el pago.
16	`organization_name`	`string`	El nombre de tu organización en el sistema de Fintoc.
17	`metadata`	`string`	Una cadena JSON con la metadata de la transacción.

Ejemplo

Para ver un ejemplo de los datos incluidos, descarga una muestra del reporte de transacciones diarias.

Canales de entrega disponibles

En lugar de descargar manualmente los archivos desde el Dashboard, los reportes pueden programarse para entrega automática a través de distintos canales. Si están configurados, los reportes se entregarán periódicamente de modo que cada archivo contenga datos de un intervalo de tiempo específico.

Correo electrónico

Los archivos pueden entregarse automáticamente a un correo electrónico de tu elección. El asunto de los correos enviados también es configurable. Por ejemplo, es común incluir la fecha de un reporte en el asunto para facilitar su identificación. Usa el correo operativo de la pestaña Comunicación en Configuración para definir el destinatario. Prende o apaga el correo de payout con el toggle Correo de liquidación. Consulta notificaciones de payouts. Para configurar el asunto, contacta a nuestro equipo de ventas.

SFTP

La forma recomendada de recibir los reportes es a través del SFTP de Fintoc. Esto permite automatizar la extracción de archivos de manera fácil y segura.

Conectarse al servidor SFTP

Usa la siguiente información para conectarte al servidor SFTP de Fintoc:

Host: sftp.fintoc.com
Puerto: 80
Usuario: el ID de tu organización. Comienza con org_
Contraseña: la contraseña proporcionada por tu Account Executive.

Para las credenciales de acceso, comunícate con nuestro equipo de ventas.

Ruta de los reportes

Fintoc sube cada reporte a las siguientes rutas:

Reporte	Ruta del archivo
Conciliación de payout	`OUT/payout/<mode>/yyyy-mm-dd-fintoc-payout-<orgname>.csv`
Transacciones diarias	`OUT/daily_summary/<mode>/yyyy-mm-dd-daily-summary-fintoc-<orgname>.csv`

Donde <mode> puede ser live o test.

​Seleccionar un reporte

​El reporte de conciliación de payout

​Estructura

​Ejemplo

​Reporte de transacciones diarias

​Calendarios de entrega

​Estructura

​Ejemplo

​Canales de entrega disponibles

​Correo electrónico

​SFTP

​Conectarse al servidor SFTP

​Ruta de los reportes

Seleccionar un reporte

El reporte de conciliación de payout

Estructura

Ejemplo

Reporte de transacciones diarias

Calendarios de entrega

Estructura

Ejemplo

Canales de entrega disponibles

Correo electrónico

SFTP

Conectarse al servidor SFTP

Ruta de los reportes