1. Empleados
Payflow API
Peru
  • 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
      • Detalles de Empresa
    • Empleados
      • Empleado
        GET
      • Todos los Empleados
        GET
      • Todos los Empleados (V1.1)
        GET
      • Crea 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 payrollId
        PUT
    • Licencias
      • Empleados con Licencia
      • Licencia de Empleado
      • Remover Licencia a Empleado
    • Pagos
      • Pagos de la Empresa
      • Pagos del Empleado
      • Pago individual por ID
      • Solicitar pago
      • Suscribirse a las actualizaciones de pago
      • Confirmar Pagos
      • Obtener monto disponible
  • Estructura de Notificación
    • Actualizaciones de pago
  • Lista de bancos soportados
    • Entidades bancarias admitidas
  • Schemas
    • Empresa
      • Respuesta de la Empresa
    • Empleado
      • PE | Solicitud para crear Empleado
      • PE | Solicitud de actualización de empleado
      • PE | Respuesta del empleado
      • Licencia de Empleado
    • Pagos
      • Respuesta del pago
      • Respuesta de pago Convoluted
      • Actualización de pago
    • Error
      • Generic Error Response
  1. Empleados

Actualizar un empleado por payrollId

Production
https://api-public.payflow.es
Production
https://api-public.payflow.es
PUT
https://api-public.payflow.es
/employee/payroll/{payrollId}
Actualiza un empleado identificado por su payrollId. Incluye en el cuerpo de la petición solo los campos que quieras actualizar.
Mejor práctica
Para actualizaciones de empleados en lote, usa el endpoint POST Empleados en su lugar.

Gestión del salario#

Si se actualizan los campos de salario, aplican las mismas reglas descritas en los endpoints anteriores:
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 Conceptos salariales para más información.

Comportamiento de validación#

Todos los campos son opcionales.
Los valores inválidos de email, phone o IBAN se establecen automáticamente ennull en lugar de causar errores de validación.
Sobre los campos opcionales
Omite los campos opcionales que no quieras establecer en lugar de enviar valores de relleno como null, "", or 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
Path Params

Body Params application/json

Examples

Responses

🟢200
This response does not have a body.
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api-public.payflow.es/employee/payroll/' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "payrollId": "E02",
    "firstName": "Jane",
    "lastName": "Doe",
    "bankAccountNumber": "00212345678901234567",
    "bankEntity": "CREDITO DEL PERU",
    "bankAccountType": "savings",
    "grossSalary": 1450,
    "contractEnd": "2030-06-01",
    "status": "on_leave",
    "leaveEnd": "2025-06-15"
}'
Response Response Example
{
    "statusCode": 404,
    "error": "Not Found",
    "message": "Employee not found"
}
Modified at 2026-06-30 07:46:45
Previous
Actualizar un empleado por Payflow ID
Next
Empleados con Licencia
Built with