Crear Empleados en Lote
Production
https://api-public.payflow.es
Production
https://api-public.payflow.es
POST
https://api-public.payflow.es
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.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.Mejores prácticas
api-version header. Recomendamos usar api-version: 1.1 para mejorar la estabilidad y el rendimiento.Reglas obligatorias
subsidiary o subsidiaryCode.email o phone).Gestión del salario
grossSalary o netSalary.netSalary, se usa como fuente de verdad para los cálculos internos y se ignora grossSalary.grossSalary, el netSalary se calcula automáticamente.Más información
Comportamiento de validación
email, phone or IBAN se establecen automáticamente en null.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
null, "", o 0, incluidos los campos de salario, ya que pueden causar errores de validación.Entidades bancarias admitidas
bankEntitysolo acepta entidades bancarias reconocidas por Payflow. Consulta la lista de entidades bancarias admitidas y sus variaciones aceptadas.Request
Header Params
Body Params application/json
Responses
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 Peru",
"payrollId": "P38",
"cedula": "45678938",
"documentType": "DNI",
"paymentFrequency": "monthly",
"email": "test_user_peru38@payflow.com",
"phone": "+51987655538",
"bankAccountNumber": "00212345678901234538",
"bankAccountType": "checking",
"address": "Av. Arequipa 1234, Miraflores, Lima",
"netSalary": 2500,
"startDate": "2022-01-01",
"contractEnd": "2030-01-01",
"subsidiary": "20512345678",
"status": "active"
},
{
"firstName": "Test",
"lastName": "User Peru",
"payrollId": "P09",
"personalId": "45678919",
"documentType": "C_EXTRANJERIA",
"paymentFrequency": "monthly",
"email": "test_user_peru9@payflow.com",
"phone": "+51987655519",
"bankAccountNumber": "00212345678901234519",
"bankAccountType": "savings",
"address": "Calle Los Pinos 456, San Borja, Lima",
"grossSalary": 2500,
"startDate": "2022-01-01",
"contractEnd": "2030-01-01",
"subsidiary": "20512345678",
"status": "active"
},
{
"firstName": "Test",
"lastName": "User Peru",
"payrollId": "P28",
"personalId": "45678928",
"documentType": "PASSPORT",
"paymentFrequency": "monthly",
"email": "test_user_peru28@payflow.com",
"phone": "+51987655528",
"bankAccountNumber": "00212345678901234528",
"bankAccountType": "checking",
"address": "Av. Javier Prado Este 789, San Isidro, Lima",
"netSalary": 2500,
"startDate": "2022-01-01",
"contractEnd": "2030-01-01",
"subsidiary": "20512345678",
"status": "active"
},
{
"firstName": "Test",
"lastName": "User Peru",
"payrollId": "P49",
"personalId": "45678949",
"documentType": "C_EXTRANJERIA",
"paymentFrequency": "monthly",
"email": "test_user_peru49@payflow.com",
"phone": "+51987655549",
"bankAccountNumber": "00212345678901234549",
"bankAccountType": "savings",
"address": "Av. La Marina 321, San Miguel, Lima",
"netSalary": 2500,
"startDate": "2022-01-01",
"contractEnd": "2030-01-01",
"subsidiary": "20512345678",
"status": "active"
}
]'Response Response Example
{
"created": [
{
"id": 142574,
"personalId": "45678938"
},
{
"id": 142573,
"personalId": "45678949"
}
],
"updated": [
{
"id": 142571,
"personalId": "45678919"
}
],
"error": [
{
"personalId": "45678928"
}
]
}Modified at 2026-06-30 07:45:12