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

Crea un Empleado

Production
https://api-public.payflow.es
Production
https://api-public.payflow.es
POST
https://api-public.payflow.es
/employee
Agrega un nuevo empleado a la empresa asociada con la clave de API.
MEJOR PRÁCTICA
Para la creación/actualización de empleados en lote usa el endpoint Crear Empleados en Lote en su lugar.
Es más eficiente, coherente y reduce errores de validación. Este endpoint debe ser utilizado solo para la creación de UN empleado o solo para casos puntuales.

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 Conceptos salariales para más información.

Comportamiento de validación#

Los valores inválidos de email, phone or IBAN se establecen automáticamente en null.
Los emails y los números de cédula deben ser únicos. Los datos duplicados devuelven un error 409 Conflict.
Sobre los campos opcionales
Omite los campos opcionales que no quieras establecer en lugar de enviar valores de relleno comonull, "", 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
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-public.payflow.es/employee' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstName": "Test",
    "lastName": "User Peru",
    "payrollId": "P02",
    "personalId": "45678912",
    "documentType": "DNI",
    "paymentFrequency": "monthly",
    "email": "test_user_peru2@payflow.com",
    "phone": "+51987654321",
    "bankAccountNumber": "00212345678901234567",
    "bankAccountType": "savings",
    "bankEntity": "CREDITO DEL PERU",
    "address": "Av. Arequipa 1234, Miraflores, Lima",
    "grossSalary": 2500,
    "startDate": "2022-01-01",
    "contractEnd": "2030-01-01",
    "subsidiary": "20512345678",
    "status": "active"
}'
Response Response Example
{
    "id": 2
}
Modified at 2026-06-30 07:41:55
Previous
Todos los Empleados (V1.1)
Next
Crear Empleados en Lote
Built with