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 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 Colombia",
    "payrollId": "C02",
    "personalId": "1023879513",
    "documentType": "C_CIUDADANIA",
    "paymentFrequency": "monthly",
    "email": "test_user_colombia2@payflow.co",
    "phone": "+573209355775",
    "bankAccountNumber": "17469294854",
    "bankAccountType": "checking",
    "bankEntity": "BANCOLOMBIA",
    "address": "Edificio Lievano, Calle 11",
    "grossSalary": 920000,
    "startDate": "2022-01-01",
    "contractEnd": "2050-01-01",
    "subsidiary": "900123456-7",
    "status": "active"
}'
Response Response Example
{
    "id": 2
}
Modified at 2026-08-12 07:25:21
Previous
Obtener todos los Empleados (V1.1)
Next
Crear Empleados en Lote
Built with