En esta guía se explica el proceso para construir la Integración Estándar vía SFTP con Payflow en Colombia.

1. Contexto inicial: ¿Qué es Payflow?

Payflow es una plataforma de bienestar financiero que tiene como principal servicio el salario bajo demanda.

Esto significa que las compañías que contratan la plataforma pueden permitir a sus empleados cobrar parte del salario que ya llevan devengado cuando ellos quieran o lo necesiten.

El objetivo de Payflow no es adelantar todo el salario, sino ofrecer liquidez responsable, esto quiere decir que Payflow solo adelantará la parte que el colaborador ya haya trabajado, bajo los límites establecidos por la empresa contratante.

No es una solución que adelante todo el salario del mes, ni es una solución de préstamos. Payflow permite que el empleado pueda obtener liquidez sobre lo trabajado, pero evitando que se quede sin ingresos a final de mes.

Ejemplo práctico:

Un colaborador con un salario básico neto de $3,000,000:

Devenga diariamente $100,000 (3,000,000 / 30)

En el día 10 del mes ha completado 9 días de trabajo (el 10 no ha terminado) y por lo tanto ha devengado $900,000 (100,000 * 9)

RRHH define que puede retirar el 60%

Entonces tendrá un disponible de: $540,000

De esta forma:

El trabajador cubre necesidades puntuales

No se queda sin salario a fin de mes

No se genera una nómina negativa

Se mantiene un uso responsable del beneficio

💡 El objetivo es que el empleado tenga un porcentaje de su salario disponible, no el 100% del mismo.

⚠️ En este orden de ideas, para que una compañía que contrató la plataforma de Payflow pueda prestar correctamente el servicio de salario bajo demanda a sus empleados, es necesario que:
1.
Mantenga actualizada de manera diaria la información básica necesaria a nivel empleados: altas, bajas y modificaciones
2.
Consuma la información de pagos (también de manera diaria) para que la compañía pueda reportarla en su sistema de nómina y realizar los pagos.

2. Payflow: El Producto

Payflow ofrece 2 componentes principales:

📱 Aplicación móvil para empleados:

Disponible en App Store y Google Play Store:

App Store: https://apps.apple.com/es/app/payflow/id1503530690

Google Play: https://play.google.com/store/apps/details?id=es.payflow.app&hl=en

Permite al usuario:

Registrarse

Ver su salario disponible

Hacer transacciones (retiros de dinero)

Consultar historial

Otros: funcionalidades extra de la aplicación

Funciona como el trigger de las solicitudes de retiro de salario devengado.

🖥️ Panel web para administradores

URL: https://admin.payflow.es/auth/login

Versión web utilizada por los administradores de Payflow en el día a día (generalmente RRHH) para gestionar aspectos relevantes como:

Revisar las Altas/Ediciones/Bajas de empleados ejecutadas por la integración

Configurar límites de uso

Ver transacciones

Monitorear uso

Detalle panel de control 🖥️

Página principal - Estadísticas de proyecto

Número de empleados registrados: total y por producto

Total de dinero transaccionado

Cantidad media de transacción

Número total de transacciones

Evolución mensual del total de transacciones

Evolución mensual del total transaccionado

3. Introducción al SFTP de Payflow

En empresas de un número considerable de colaboradores, suele suceder que la gestión de Payflow busca realizarse de manera desatendida, es decir, mediante una integración entre sistemas.

Con la integración:

Payflow se convierte en un espejo del software de nómina, siendo el software la fuente de verdad.

Esto reduce:

Errores humanos

Retrasos

Incidencias en producción

Carga operativa

El objetivo es mantener sincronizados dos flujos de información mediante el intercambio de ficheros en un servidor SFTP:

Empleados → mantener en Payflow a los empleados actualizados con base en el software de nómina.

Transacciones → recoger las transacciones de salario bajo demanda que realizan los empleados para descontarlas en la nómina.

Payflow pone a disposición del cliente un único servidor SFTP con dos carpetas:

Carpeta	Quién escribe	Permisos del cliente	Contenido
`employees`	El cliente	Depósito, escritura, renombrado y borrado	El cliente deposita aquí el archivo de actualización de empleados.
`transactions`	Payflow	Lectura, escritura, renombrado y borrado	Payflow deposita aquí, a diario, el archivo con las novedades de nómina a descontar. El cliente lo recoge.

3.1 Conexión

Entorno	URL	Puerto	Autenticación
Pruebas (staging)	sftp.v2-staging.payflow-dev.net	22	Usuario + contraseña (generados desde el panel)
Producción	sftp.v2.payflow.es	22	Usuario + contraseña (generados desde el panel)

La autenticación puede hacerse mediante usuario y contraseña (generados desde el panel de Payflow) o mediante llave SSH.

4. Formatos soportados: Excel y CSV

Los ficheros pueden intercambiarse en dos formatos, y se acuerda con Payflow cuál se usará durante la implementación:

Formato	Característica clave
Excel (.xlsx)	Admite varias hojas en un mismo archivo. • Solo aplica para el archivo de transacciones: una hoja de resumen y otra de detalle.
CSV	Archivo plano de una sola tabla, delimitado por punto y coma (;).

5. Flujo de sincronización de empleados

Alta / Baja / Modificación de empleados

Para que un colaborador pueda usar la plataforma de Payflow, tiene que ser en primer lugar dado de alta: es decir, debe de ser creado como un potencial usuario por su empresa en su panel de control de Payflow.

El objetivo de este flujo es garantizar que solo los empleados correctos puedan usar Payflow y que sus datos estén actualizados.

Es importante recordar que Payflow es una plataforma provista por el empleador y el colaborador no puede modificar ningún dato allí. En caso de querer cambiar algo tiene que ir a su empleador y que este haga la modificación en el software de nómina; luego esta integración sincronizará los cambios en Payflow. Esto evita fraudes y garantiza la correcta prestación del servicio.

En este flujo, el cliente genera a diario un archivo con todos sus empleados desde el software de nómina y lo deposita en la carpeta employees del SFTP. Payflow lo procesa y crea, actualiza o inactiva a los empleados en el panel de control según la información recibida.

Evita errores comunes:
Envía todos los datos obligatorios.
No uses salario = 0 para inactivar, usa siempre el campo estado.
No dejes de enviar empleados para inactivarlos, usa siempre el campo estado.
Envía nombres y apellidos completos.

5.1 Requisitos del archivo: foto completa

Enviar la foto completa: todos los empleados en cada ejecución. El archivo es un snapshot de la nómina completa.

Una sola fila por empleado, reflejando su información y estado actuales. No se envía histórico:

Si cambió de filial, enviar solo la fila con la filial actual.

Si su información cambió varias veces, enviar solo la fila con la información vigente.

Si estuvo de licencia y ahora está activo, enviar solo la información actual.

Inactivación definitiva: para dar de baja a un empleado, inclúyelo con estado inactivo. No basta con dejar de enviarlo: si se deja de enviar, se mantiene el estado anterior. Tampoco se debe usar salario = 0 para inactivar; usar siempre el campo estado.

Recomendación: incluir a todas las personas que salieron en los últimos 30 días con estado inactivo, para evitar inconsistencias si un fichero puntual no se procesa.

Inactivación temporal: si el empleado no debe tener acceso a la app de forma temporal, su estado debe ser baja (ausencia temporal). Al reincorporarse, actualizar a activo.

5.2 Reglas generales del archivo

Codificación: UTF-8 (imprescindible para tildes, ñ y caracteres especiales).

Sin cifrado ni contraseña: los ficheros no se pueden enviar encriptados ni protegidos por contraseña. Si lo están, no se procesan.

Salario: debe enviarse uno entre sueldoNeto o sueldoBruto. Si se envía sueldoBruto, Payflow calcula el sueldoNeto según reglas tributarias.

Nombres completos: enviar nombres y apellidos completos del empleado.

5.3 Campos del archivo de empleados

Estos son los campos del archivo de empleados y sus reglas. Aplican tanto si se entrega en Excel (como columnas de la hoja) como en CSV (como campos de la cabecera). El nombre de cada campo debe coincidir exactamente, respetando mayúsculas y minúsculas, y se recomienda mantener el orden indicado.

Campo	Requerido?	Descripción	Formato / Validación	Ejemplo
idInterno	No	Identificador interno del empleado en el sistema de nóminas	Alfanumérico, único por empresa (máx. 100 caracteres)	EMP001
cedula	Sí	Número del documento de identidad (aplica también para cédula de extranjería o pasaporte)	Texto. Conservar ceros a la izquierda	1032498782
tipoDeDocumento	Sí	Tipo de documento de identidad	`C_CIUDADANIA`, `C_EXTRANJERIA` o `PASAPORTE`	C_CIUDADANIA
nombre	Sí	Nombres completos del empleado	Texto no vacío	JOSE FRANCISCO
apellidos	Sí	Apellidos completos del empleado	Texto no vacío	VILLAFUERTE FERNANDEZ
email	Sí* si no se manda telefono	Correo electrónico	Formato de email válido. Único y no genérico	jf.villafuerte1998@hotmail.com
telefono	Sí* si no se manda email	Número de celular	Único y no genérico. Con o sin indicativo de país (57), sin el símbolo +	573124208834
direccion	Sí	Dirección del empleado	Texto (máx. 100 caracteres)	Calle 93
cuentaBancaria	Sí	Número de cuenta bancaria del empleado	Texto. Conservar ceros a la izquierda	987978987
tipoDeCuenta	Sí	Tipo de cuenta bancaria	`ahorro` o `corriente`	ahorro
entidadBancaria	Sí	Entidad financiera del empleado	Texto (ver entidades soportadas abajo)	BANCOLOMBIA
sueldoNeto	Opcional* si se manda Sueldo Bruto	Sueldo neto mensual	Entero positivo, sin símbolo de moneda ni separadores de miles	3758000
sueldoBruto	Opcional* si se manda Sueldo Neto	Sueldo bruto mensual	Entero positivo, sin símbolo de moneda ni separadores de miles	3000000
fechaInicioContrato	No	Fecha de inicio de contrato	YYYY-MM-DD	2024-01-15
fechaFinContrato	Opcional	Fecha de fin de contrato (vacío = indefinido)	YYYY-MM-DD	2026-12-31
estado	Sí	Estado del empleado	`activo` / `inactivo` / `baja`	activo
nitEmpresa	Sí	NIT de la empresa/filial a la que pertenece el empleado	Texto, sin dígito de verificación, sin puntos ni guiones	902030001

Disclaimers:

Solo enviar uno entre sueldoNeto y sueldoBruto.

Debe enviarse al menos uno entre email y telefono.

5.4 Notas de validación

Tipo de Documento (tipoDeDocumento): tipos admitidos C_CIUDADANIA (Cédula de Ciudadanía), C_EXTRANJERIA (Cédula de Extranjería) y PASAPORTE (Pasaporte vigente del empleado).

El número va en el campo cedula sea cual sea el tipo de documento, y debe tratarse como texto para no perder ceros a la izquierda.

Email y teléfono: no pueden ser genéricos y deben ser únicos por empleado. Los emails y números de teléfono inválidos serán anulados.

Cuenta bancaria (cuentaBancaria): almacenada como texto para conservar ceros a la izquierda. Para billeteras como Nequi o Daviplata, corresponde al número de celular asociado.

NIT (nitEmpresa): sin dígito de verificación, puntos ni guiones. Debe ser válido y estar creado en el panel de control.

Salario: entero positivo, sin símbolo de moneda ni separadores; cadena vacía = nulo.

Detalle de los posibles estados de los empleados

Esta es la explicación de los posibles valores a enviar en el campo estado:

activo → Puede usar Payflow, es un empleado activo en la empresa

inactivo → No puede usar Payflow, ya no trabaja en la empresa

baja → No puede usar Payflow temporalmente, baja temporal definida por las reglas de negocio

Detalle de las reglas de negocio para definir estado "baja"

Las reglas de negocio que se pueden aplicar en el código para que el empleado sea enviado a Payflow con estado = "baja" y así cumplir con los estándares de integración de Payflow son:

Antigüedad: Empleados que lleven menos de X meses en la empresa

Vacaciones: Empleados que estén disfrutando vacaciones en el día de la sincronización.

Maternidad/Paternidad: Empleados que estén con licencia de maternidad/paternidad en el día de la sincronización

Incapacidad: Empleados que estén con incapacidad en el día de la sincronización

Practicante/aprendiz: Empleados que sean practicantes o aprendices

Detalle de entidades bancarias soportadas

En la fila de la izquierda está como se debe enviar el banco en el campo entidadBancaria, en la fila de la derecha están las variaciones aceptadas en caso de no enviarla como en la fila izquierda.

Entidad Bancaria Normalizada	Variaciones Aceptadas
AGRARIO	AGRARIO DE COLOMBIA
ALIANZA FIDUCIARIA	ALIANZA
ALLIANCE ENTERPRISE	ALLIANCE
ALLIANZ SEGUROS DE VIDA	ALLIANZ SEGUROS
ALMACENES EXITO	ALMACENES
ALPINA PRODUCTOS ALIMENTICIOS	ALPINA
ANTIOQUIA	COOPERATIVA FINANCIERA DE ANTIOQUIA
BANCAMIA	BANCAMIA CR 9 66 25
BANCOLDEX	-
BANCOLOMBIA	BANCOLOMBIA CALLE 50 NO. 5176
BANCOOMEVA	-
BBVA	BBVA COLOMBIA, BILBAO VIZCAYA ARGENTARIA, BILBAO VIZCAYA ARGENTARIA COLOMBIA
BNP PARIBAS	BNP
BOGOTA	BOGOTA CL 50 51 37
CAJA SOCIAL	BCSC, COLMENA, CAJA SOCIAL BCSC, BCSC CAJA SOCIAL COLMENA
CAMARA DE COMPENSACION DE DIVISAS	CAMARA DE COMPENSACION
CARTONES AMERICA	CARTONES
CARVAJAL	-
CITIBANK COLOMBIA	CITIBANK
COLPATRIA	SCOTIABANK COLPATRIA, COLPATRIA RED MULTIBANCA COLPATRIA, SCOTIABANK, COLPATRIA SCOTIABANK, RED MULTIBANCA COLPATRIA, SCOTIABANK COLOMBIA CR 7 N° 11433 PISO 16, BANCO COLPATRIA MULTIBANCA COLPATRIA S.A.
COLSUBSIDIO	-
COLTEFINANCIERA	-
COMERCIO EXTERIOR DE COLOMBIA	COMERCIO EXTERIOR
COMPARTIR	-
CONFIAR	-
COOPCENTRAL	COOPERATIVO COOPCENTRAL
COTRAFA	COOTRAFA COOPERATIVA FINANCIERA, COOFINEP COOPERATIVA FINANCIERA
CREDICORP CAPITAL COLOMBIA	CREDICORP
DALE	-
DAVIVIENDA	-
DAVIPLATA	-
FALABELLA	CMR FALABELLA
FIDUCIARIA BANCOLOMBIA	-
FIDUCIARIA DAVIVIENDA	-
FIDUCIARIA DE OCCIDENTE	OCCIDENTE CALLE 51 NO. 4725
FINANDINA	-
GNB SUDAMERIS	GNB, SUDAMERIS, GNB COLOMBIA
HSBC	-
IRIS	-
ITAU	ITAU CORPBANCA COLOMBIA, CORPBANCA COLOMBIA, CORPBANCA
JPMORGAN	J.P. MORGAN COLOMBIA
JURISCOOP	FINANCIERA JURISCOOP COMPANIA DE FINANCIAMIENTO
LULO	LULO BANK
MULTIBANK	-
MUNDO MUJER	-
NEQUI	-
NU BANK	NU
OCCIDENTE	-
PICHINCHA	PICHINCHA CRA 11 92 09
POPULAR	-
PROCREDIT	-
SANTANDER	SANTANDER DE NEGOCIOS COLOMBIA
SERFINANZA	-
VILLAS	-
W	-

5.5 Formato Excel (.xlsx)

Una sola hoja (Empleados) con la cabecera en la primera fila, una columna por campo y una fila por empleado:

idInterno	cedula	tipoDeDocumento	nombre	apellidos	email	telefono	direccion	cuentaBancaria	tipoDeCuenta	entidadBancaria	sueldoNeto	sueldoBruto	fechaInicioContrato	estado	nitEmpresa
EMP001	1032498782	C_CIUDADANIA	JOSE FRANCISCO	VILLAFUERTE FERNANDEZ	jf.villafuerte1998@hotmail.com	573124208834	Calle 93	987978987	ahorro	BANCOLOMBIA		3000000		activo	902030001
EMP002	413990002	C_CIUDADANIA	ENIO MOISES	LOPEZ GUERRERO	em.lopez1976@hotmail.com	573001112233	Calle 100	123456789	corriente	DAVIVIENDA		2000000		activo	902030001
EMP003	1239873677	C_CIUDADANIA	RUTH STEFANIE	HINOSTROZA COCA	rs.hinostroza2001@hotmail.com	3102359994	calle 12	20093904481	ahorro	NU	3758000		2024-01-15	inactivo	902030001
EMP004	42033983	C_CIUDADANIA	SANTOS	ANCALLE ENRIQUEZ	ss.ancalle1950@hotmail.com	3103244593	calle 2	29918204439	ahorro	BANCOLOMBIA		3000000		baja	902030001
EMP005	1032490002	C_CIUDADANIA	SIDERVY ESTHER	ESPINOZA PEÑA	se.espinoza2008@hotmail.com	3175879980	calle 30	12203948839	ahorro	LULO		1500000		activo	902030001

Ejemplo:

ejemplo_employees_XLSX_SFTP_CO

5.6 Formato CSV

Codificación UTF-8, delimitador punto y coma (;). Cabecera + una fila por empleado, con los campos de §5.3:

idInterno;cedula;tipoDeDocumento;nombre;apellidos;email;telefono;direccion;cuentaBancaria;tipoDeCuenta;entidadBancaria;sueldoNeto;sueldoBruto;fechaInicioContrato;fechaFinContrato;estado;nitEmpresa
38600003;654879000;C_CIUDADANIA;Nombre;Apellido;prueba@empresa.co;573124208834;Calle 93;987978987;ahorro;BANCOLOMBIA;;10000000;2023-08-01;;activo;902030000
38600004;1021104050;C_CIUDADANIA;Ana;Gomez;ana.prueba@empresa.co;573001112233;Calle 100;123456789;corriente;DAVIVIENDA;;3500000;2024-01-15;;activo;902030000

Los campos opcionales sin valor se dejan vacíos entre delimitadores (ej. ;;).

Ejemplo:

ejemplo_employees_CSV_SFTP_CO

6. Flujo de sincronización de transacciones

Sincronización de transacciones para ser descontadas de la nómina de los empleados

Para la preparación de la nómina de los colaboradores, es necesario que los pagos realizados en la plataforma de Payflow sean registrados en el software de nómina correctamente para su deducción de la nómina del periodo.

El objetivo de este flujo es garantizar que las transacciones realizadas en Payflow sean descontadas de la nómina de los empleados.

Hay que tener en cuenta que aunque la nómina se pague a final de mes o de la quincena, puede suceder que se paguen liquidaciones durante los periodos a colaboradores que se retiran. En estos casos se necesitará considerar y descontar las transacciones hechas en la plataforma de Payflow.

En este flujo, Payflow genera a diario un archivo con las transacciones de los empleados y lo deposita en la carpeta transactions del SFTP. El cliente lo descarga y registra los montos como novedad en su software de nómina.

Evita errores comunes:
Antes de construir este flujo, asegúrate de que existe un concepto en la nómina de tu empresa a donde deban llegar las transacciones de Payflow para ser descontadas (usualmente lo llaman "Anticipo Payflow").
Usa el "Identificador de transacción" para no registrar dos veces la misma transacción en nómina.

6.1 Contenido y alcance del archivo

Alcance: el archivo contiene las transacciones del mes en curso (desde el inicio del mes hasta el día de generación) y se regenera todos los días.

Moneda: pesos colombianos (COP), con el símbolo $ como prefijo y punto como separador de miles. Los montos llegan como texto, por lo que hay que limpiarlos antes de cargarlos como número en nómina.

Los datos necesarios van a variar dependiendo del software de nómina y sus requerimientos para crear una novedad, pero usualmente se toman por lo menos:

Identificador de transacción, para identificar la transacción y evitar duplicados

Cedula y/o Id de empleado, para identificar al empleado al que se le hará el descuento

Monto adelantado a deducir, para poner en el concepto el monto a descontar

6.2 Formato Excel (.xlsx)

Payflow genera este archivo con dos hojas. En ambas, la primera fila y la primera columna están reservadas (vacías) para uso futuro; la cabecera empieza en la celda B2.

Hoja Payflow - Resumen — total a deducir agregado por empleado:

Columna	Descripción	Ejemplo
NIT empresa	NIT de la empresa	902030001
Nombre empresa	Razón social	nico test excel
Id de empleado	idInterno del empleado	EMP001
Cedula	Número de documento del empleado	1032498782
Nombre	Nombres	Jose Francisco
Apellidos	Apellidos	Villafuerte Fernandez
Monto total a deducir $	Suma total a descontar de la nómina del empleado	$273.000

Hoja Payflow - Detalles — una fila por transacción:

Columna	Descripción	Ejemplo
Identificador de transacción	Identificador único alfanumérico (para conciliación)	7mFODg1
Fecha	Fecha de la transacción (DD/MM/YYYY)	02/09/2026
NIT empresa	NIT de la empresa	902030001
Nombre empresa	Razón social	nico test excel
Cedula	Número de documento del empleado	1032498782
Nombre	Nombres	Jose Francisco
Apellidos	Apellidos	Villafuerte Fernandez
Monto retirado $	Monto retirado por el empleado	$1.000
Comisión aplicable $	Comisión cobrada por la transacción	$0
Monto adelantado a deducir $	Monto a descontar de la nómina	$1.000

Ejemplo:

ejemplo_transactions_XLSX_SFTP_CO

6.3 Formato CSV

Codificación UTF-8, delimitador punto y coma (;). Al ser un archivo plano, el CSV corresponde al detalle de transacciones (equivalente a la hoja Payflow - Detalles), con dos columnas adicionales al final: Id de empleado y Estado. La primera columna está reservada (vacía) para uso futuro.

;Identificador de transacción;Fecha;NIT empresa;Nombre empresa;Cedula;Nombre;Apellidos;Monto retirado $;Comisión aplicable $;Monto adelantado a deducir $;Id de empleado;Estado
;7mFODg1;02/9/2026;902030000;nico test csv;654879000;Nombre;Apellido;$ 1.000;$ 0;$ 1.000;38600003;procesado
;Niygutfvgu7;03/9/2026;902030000;nico test csv;1021104050;Ana;Gomez;$ 10.000;$ 0;$ 10.000;38600004;procesado

Diferencias de formato respecto al Excel:

Dato	Formato en CSV	Ejemplo
Fecha	DD/M/YYYY (el mes va sin cero a la izquierda)	02/9/2026
Montos	Símbolo $, un espacio y punto como separador de miles	$ 10.000

Columna adicional	Descripción	Ejemplo
Id de empleado	idInterno del empleado	38600003
Estado	Estado de la transacción	procesado

Ejemplo:

ejemplo_transactions_CSV_SFTP_CO

7. Integración (script diario)

La integración consiste en un script/proceso automático que se ejecuta todos los días y que:

(a) deposita el archivo de empleados en employees

(b) recoge el archivo de transacciones de transactions.

El cliente es responsable de este transporte, que debe ejecutarse al menos una vez al día.

7.1 ¿Cuándo correrlo?

Payflow deja disponible el archivo de transacciones a partir de la 01:00 (zona horaria del servidor de Payflow, Europa Occidental). Conviene programar la descarga después de esa hora:

Periodo	Disponible desde	Equivalente en hora de Colombia (COT, UTC−5)
Horario de invierno	01:00 UTC+00:00	~20:00 del día anterior
Horario de verano	01:00 UTC+01:00	~19:00 del día anterior

En la práctica, el archivo del día ya está disponible la noche anterior en hora de Colombia, antes del inicio de la jornada laboral.

7.2 Flujo del proceso diario

Conectar al SFTP de Payflow (producción):
host = sftp.v2.payflow.es · puerto = 22 · usuario/contraseña del panel

Subida — archivo de empleados:
a. Generar la foto completa de empleados desde el sistema de nóminas
(todos los empleados · 1 fila por empleado · estado actual).
b. Validar los campos (cédula, cuenta bancaria, NIT, fechas, salario)
y la codificación UTF-8. No cifrar ni proteger con contraseña.
c. Depositar el archivo en la carpeta /employees.

Descarga — archivo de transacciones:
a. Listar /transactions y localizar el archivo del día.
b. Descargarlo.
c. Procesar el detalle y aplicar los descuentos en nómina,
conciliando por "Identificador de transacción" / cédula.

Registrar el resultado (logs) y alertar ante errores o si el archivo
esperado no aparece.

Puede implementarse con cualquier cliente SFTP (una librería en Python, Node, Java, etc., o una utilidad de línea de comandos).

7.3 Recomendaciones para una integración robusta

Foto completa siempre: envía el padrón completo en cada ejecución; así, si un archivo no se procesa, el siguiente snapshot corrige el estado automáticamente.

Ceros a la izquierda: trata cedula, cuentaBancaria y nitEmpresa como texto, nunca como número.

UTF-8 de extremo a extremo para preservar tildes y ñ.

Nombres de campo exactos: cualquier variación en la cabecera (incluidas mayúsculas/minúsculas) puede romper el procesamiento.

Montos como texto: los importes del archivo de transacciones llegan con símbolo 1.000 en Excel, $ 1.000 en CSV); límpialos antes de cargarlos como número en nómina.

Fechas según el formato: en Excel llegan como DD/MM/YYYY y en CSV como DD/M/YYYY; ajusta el parseo al formato acordado.

Sin duplicados: usa el "Identificador de transacción" para no registrar dos veces la misma transacción en nómina.

Liquidaciones: si se paga una liquidación durante el periodo a un colaborador que se retira, considera y descuenta también sus transacciones de Payflow.

Monitoreo: levanta una alerta si el archivo de transacciones no aparece a la hora esperada.

Empieza en pruebas: valida un ciclo completo (subida de empleados + descarga de transacciones) en staging antes de pasar a producción.

8. Soporte

Para dudas de implementación, credenciales o incidencias de procesamiento, contacta con tu Technical Account Manager de Payflow.

Guía de integración vía SFTP

1. Contexto inicial: ¿Qué es Payflow?#

Ejemplo práctico:#

2. Payflow: El Producto#

📱 Aplicación móvil para empleados:#

🖥️ Panel web para administradores#

3. Introducción al SFTP de Payflow#

3.1 Conexión#

4. Formatos soportados: Excel y CSV#

5. Flujo de sincronización de empleados#

5.1 Requisitos del archivo: foto completa#

5.2 Reglas generales del archivo#

5.3 Campos del archivo de empleados#

5.4 Notas de validación#

5.5 Formato Excel (.xlsx)#

5.6 Formato CSV#

6. Flujo de sincronización de transacciones#

6.1 Contenido y alcance del archivo#

6.2 Formato Excel (.xlsx)#

6.3 Formato CSV#

7. Integración (script diario)#

7.1 ¿Cuándo correrlo?#

7.2 Flujo del proceso diario#

7.3 Recomendaciones para una integración robusta#

8. Soporte#

1. Contexto inicial: ¿Qué es Payflow?

Ejemplo práctico:

2. Payflow: El Producto

📱 Aplicación móvil para empleados:

🖥️ Panel web para administradores

3. Introducción al SFTP de Payflow

3.1 Conexión

4. Formatos soportados: Excel y CSV

5. Flujo de sincronización de empleados

5.1 Requisitos del archivo: foto completa

5.2 Reglas generales del archivo

5.3 Campos del archivo de empleados

5.4 Notas de validación

5.5 Formato Excel (.xlsx)

5.6 Formato CSV

6. Flujo de sincronización de transacciones

6.1 Contenido y alcance del archivo

6.2 Formato Excel (.xlsx)

6.3 Formato CSV

7. Integración (script diario)

7.1 ¿Cuándo correrlo?

7.2 Flujo del proceso diario

7.3 Recomendaciones para una integración robusta

8. Soporte