1. Empleados
Payflow API
Colombia
  • Spain
  • Colombia
  • Peru
  • Guías
    • Guía de integración vía API
    • Guía de integración vía SFTP
  • Guías y definiciones
    • Empleados
      • Estados del empleado
      • Conceptos salariales
    • Pagos
      • Ciclo de vida de un pago
  • Explora nuestra API publica
    • Autenticación y Estado del Sistema
      • Verificación de Estado
      • Prueba de API Key
    • Empresa
      • Obtener Detalles de la Compañía
    • Empleados
      • Obtener un Empleado
        GET
      • Obtener todos los Empleados
        GET
      • Obtener todos los Empleados (V1.1)
        GET
      • Crear un Empleado
        POST
      • Crear Empleados en Lote
        POST
      • Actualizar un Empleado por Personal ID
        PUT
      • Actualizar un Empleado por Payflow ID
        PUT
      • Actualizar un Empleado por Payroll ID
        PUT
    • Licencias
      • Empleados con Licencia
      • Licencia de Empleado
      • Remover Licencia a Empleado
    • Pagos
      • Obtener un Pago
      • Obtener todos los Pagos
      • Obtener Pagos del Empleado
      • Obtener monto disponible
      • Solicitar pago
      • Suscribirse a las Actualizaciones de Pago
      • Marcar un Pago como Informado
  • Estructura de Notificación
    • Actualizaciones de pago
  • Lista de bancos soportados
    • Entidades bancarias admitidas
  • Schemas
    • Empresa
      • Respuesta de la Empresa
    • Empleado
      • CO | Solicitud para crear Empleado
      • CO | Solicitud de actualización de empleado
      • CO | Respuesta del empleado
      • Licencia de Empleado
    • Pagos
      • Respuesta del pago
      • Respuesta de pago Convoluted
      • Actualización de pago
    • Error
      • Generic Error Response
  1. Empleados

Crear Empleados en Lote

Production
https://api-public.payflow.es
Production
https://api-public.payflow.es
POST
https://api-public.payflow.es
/employees
Crea o actualiza empleados en lotes.
Cada empleado se identifica por personalId. Si ya existe un empleado con el mismo personalId en la empresa, ese empleado se actualiza. Si el personalId no existe, se crea un nuevo empleado.
Como se trata de una operación en lote, los registros de empleados inválidos no hacen que toda la petición falle con un error 4xx. En su lugar, los errores de validación se devuelven por empleado en el cuerpo de la respuesta. Un array de respuesta vacío significa que todos los empleados se procesaron correctamente.
Todas las reglas del endpoint Create an Employee aplican a cada empleado del payload.
Mejores prácticas
Este endpoint admite la cabecera api-version header. Recomendamos usar api-version: 1.1 para mejorar la estabilidad y el rendimiento.
El tamaño máximo de la petición es de 500 empleados, pero recomendamos sincronizar empleados en lotes de 50 para un rendimiento óptimo y evitar la saturación.

Reglas obligatorias#

Cada empleado debe pertenecer a una filial. Proporciona subsidiary o subsidiaryCode.
Debe proporcionarse al menos un método de contacto válido (email o phone).

Gestión del salario#

Los empleados necesitan un salario para acceder al beneficio EWA.
Puedes proporcionar grossSalary o netSalary.
Si se proporciona netSalary, se usa como fuente de verdad para los cálculos internos y se ignora grossSalary.
Si solo se proporciona grossSalary, el netSalary se calcula automáticamente.
Más información
Consulta la guía Salary Concepts para más información.

Comportamiento de validación#

Los valores inválidos de email, phone or IBAN se establecen automáticamente en null.
Todos los empleados del cuerpo de la petición deben tener valores únicos de personalId y email. Si se envían valores duplicados en la misma petición, solo se procesa el último registro repetido.

Sobre los campos opcionales
Omite los campos opcionales que no quieras establecer en lugar de enviar valores de relleno como null, "", o 0, incluidos los campos de salario, ya que pueden causar errores de validación.
Entidades bancarias admitidas
El campobankEntitysolo acepta entidades bancarias reconocidas por Payflow. Consulta la lista de entidades bancarias admitidas y sus variaciones aceptadas.
Ver lista completa de entidades bancarias admitidas

Request

Authorization
API Key
Add parameter in header
authorization
Example:
authorization: ********************
or
Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-public.payflow.es/employees' \
--header 'api-version: 1.1' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "firstName": "Test",
        "lastName": "User Colombia",
        "payrollId": "C38",
        "personalId": "1023879538",
        "documentType": "C_CIUDADANIA",
        "paymentFrequency": "monthly",
        "email": "test_user_colombia38@payflow.co",
        "phone": "+573209355775",
        "bankAccountNumber": "17469294838",
        "bankAccountType": "checking",
        "address": "Edificio Lievano, Calle 11",
        "netSalary": 920000,
        "startDate": "2022-01-01",
        "contractEnd": "2050-01-01",
        "subsidiary": "15867674022",
        "status": "active"
    },
    {
        "firstName": "Test",
        "lastName": "User Colombia",
        "payrollId": "C09",
        "personalId": "1023879519",
        "documentType": "C_EXTRANJERIA",
        "paymentFrequency": "monthly",
        "email": "test_user_colombia9_modified@payflow.co",
        "phone": "+573209355776",
        "bankAccountNumber": "17469294859",
        "bankAccountType": "savings",
        "address": "Edificio Lievano, Calle 11",
        "grossSalary": 920000,
        "startDate": "2022-01-01",
        "contractEnd": "2050-01-01",
        "subsidiary": "15867674022",
        "status": "active"
    },
    {
        "firstName": "Test",
        "lastName": "User Colombia",
        "payrollId": "C28",
        "personalId": "1023879528",
        "documentType": "cedula",
        "paymentFrequency": "monthly",
        "email": "test_user_colombia_error8@payflow.co",
        "phone": "+573209355775",
        "bankAccountNumber": "17469294858",
        "bankAccountType": "checking",
        "address": "Edificio Lievano, Calle 11",
        "netSalary": 920000,
        "startDate": "2022-01-01",
        "contractEnd": "2050-01-01",
        "subsidiary": "15867674022",
        "status": "active"
    },
    {
        "firstName": "Test",
        "lastName": "User Colombia",
        "payrollId": "C09",
        "personalId": "1023879549",
        "documentType": "C_EXTRANJERIA",
        "paymentFrequency": "monthly",
        "email": "test_user_colombia9_modified@payflow.co",
        "phone": "+573209355775",
        "bankAccountNumber": "17469294859",
        "bankAccountType": "savings",
        "address": "Edificio Lievano, Calle 11",
        "netSalary": 920000,
        "startDate": "2022-01-01",
        "contractEnd": "2050-01-01",
        "subsidiary": "15867674022",
        "status": "active"
    }
]'
Response Response Example
{
    "created": [
        {
            "id": 142574,
            "personalId": "1023879538"
        },
        {
            "id": 142573,
            "personalId": "1023879549"
        }
    ],
    "updated": [
        {
            "id": 142571,
            "personalId": "1023879519"
        }
    ],
    "error": [
        {
            "personalId": "1023879528"
        }
    ]
}
Modified at 2026-06-29 14:36:23
Previous
Crear un Empleado
Next
Actualizar un Empleado por Personal ID
Built with