Parámetros de entrada
Nombre del campo |
Tipo de dato |
Obligatorio |
json |
Estructura JSON formada por los campos mostrados a continuación |
Sí |
private_key |
Varchar (255) |
Sí |
token |
Varchar (255) |
No |
cif_desarrollador |
Varchar(255) |
Sí |
cif_cliente |
Varchar (255) |
Sí |
nombre_cliente |
Varchar (255) |
Sí |
email_cliente |
Varchar (255) |
Sí |
direccion_cliente |
Varchar (255) |
Sí |
provincia_cliente |
Varchar (255) |
Sí |
poblacion_cliente |
Varchar (255) |
Sí |
origen_cliente |
Varchar (255) |
No |
fecha_baja |
Date |
No |
avanzado |
Int (1) |
No |
vacaciones_dias |
Int (1) |
No |
vacaciones_tipo |
Enum ("N","L") N = Días Naturales; L = Días Laborables |
No |
sociedades |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con el número de sociedades, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
nombre |
Varchar (255) |
Sí |
cif |
Varchar (255) |
Sí |
domicilio_social |
Varchar (255) |
Sí |
guardar_localizacion |
Int (1) |
No |
guardar_hora |
Int (1) |
No |
modificar_hora |
Int (1) |
No |
aviso_fin_jornada |
Int (1) |
No |
terminal_corporativo |
Int (1) |
No |
proponer_hora_salida |
Int (1) |
No |
centros_trabajo |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con el número de centros de trabajo, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
nombre |
Varchar (255) |
Sí |
localidad |
Varchar (255) |
No |
provincia |
Varchar (255) |
Sí |
lat |
Int (11) |
No |
lng |
Int (11) |
No |
tipo_via |
Varchar (255) |
Sí |
calle |
Varchar (255) |
Sí |
numero |
Varchar (255) |
No |
codigo_postal |
Varchar (255) |
No |
cif_sociedad |
Varchar (255) |
Sí |
guardar_localizacion |
Int (1) |
No |
guardar_hora |
Int (1) |
No |
modificar_hora |
Int (1) |
No |
aviso_fin_jornada |
Int (1) |
No |
terminal_corporativo |
Int (1) |
No |
proponer_hora_salida |
Int (1) |
No |
trabajadores |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con el número de trabajadores, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
nombre_usuario |
Varchar (255) |
Sí |
apellido1 |
Varchar (255) |
Sí |
apellido2 |
Varchar (255) |
Sí |
nif_usuario |
Varchar (255) |
Sí |
email_usuario |
Varchar (255) |
Sí |
telefono_usuario |
Varchar (255) |
No |
direccion_usuario |
Varchar (255) |
No |
numero_usuario |
Varchar (255) |
No |
provincia_usuario |
Varchar (255) |
No |
municipio_usuario |
Varchar (255) |
No |
codigo_postal_usuario |
Varchar (255) |
No |
cif_sociedad |
Varchar (255) |
Sí |
fecha_alta |
Date |
Sí |
fecha_baja |
Date |
No |
horario |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con el número de horarios, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
nombre |
Varchar(255) |
Si |
fecha_inicio |
Date |
Si |
fecha_fin |
Date |
Si |
turnos |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con el número de turnos, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
intervalos |
Estructura JSON formada por los campos mostrados a continuación |
Si |
|
Array con el número de intervalos, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
dia_semana |
Int (1) Número del día de la semana: 1 = Lunes, 7 = Domingo |
Si |
centro_trabajo |
Varchar(255) |
No |
hora_entrada |
Varchar(5) |
Si |
hora_salida |
Varchar(5) |
Si |
tolerancia_entrada |
int(2) |
No |
tolerancia_salida |
int(2) |
No |
departamento |
Varchar (255) |
No |
centros_trabajo |
Array |
Sí |
guardar_localizacion |
Varchar (255) |
No |
guardar_hora |
Varchar (255) |
No |
modificar_hora |
Int (1) |
No |
aviso_fin_jornada |
Int (1) |
No |
terminal_corporativo |
Int (1) |
No |
proponer_hora_salida |
Int (1) |
No |
codigo |
Varchar (255) |
No |
vacaciones_dias |
Int (1) |
No |
vacaciones_tipo |
Enum ("N","L") N = Días Naturales; L = Días Laborables |
No |
gestores de jornada |
Estructura JSON formada por los campos mostrados a continuación |
No |
|
Array con los gestores de jornada, de los que se solicitarán los siguientes datos |
|
Nombre del campo |
Tipo de dato |
Obligatorio |
nombre |
Varchar (255) |
Sí |
email |
Varchar (255) |
si |
centros_trabajo |
Array con los centros de trabajo, de estos se solicitarán los siguientes datos |
No
|
Nombre del campo |
Tipo de datos |
Obligatorio |
cif_sociedad |
Varchar(255) |
Sí |
nombre_centro |
Varchar(255) |
Sí |
Parámetros de salida
Nombre del campo |
Tipo de dato |
Obligatorio |
json |
Estructura JSON formada por los campos mostrados a continuación |
Sí |
id_operacion |
Varchar(255) |
No |
estado_operacion |
Varchar(255) |
Sí |
mensaje_operacion |
Varchar(255) |
Sí |
Códigos de operación
Estado de operación |
Mensaje de la operación |
0000 |
El proceso se ha realizado con éxito. |
0001 |
No se ha podido descargar el JSON enviado. |
0002 |
El JSON recibido no es válido. |
0003 |
La private key no es válida |
0004 |
El cliente no existe |
0005 |
El valor de NOMBRE_DEL_CAMPO no es válido |
0006 |
El campo dirección de un centro de trabajo no ha sido encontrada. |
0007 |
Las siguientes sociedades referenciadas en centros de trabajo o trabajadores no existen ni se han incluido en la petición: A11223344, B11223344 |
0008 |
El valor de localidad del centro de trabajo no corresponde con la provincia. |
0009 |
Se ha asociado a un trabajado un centro de trabajo no pertenece a la sociedad indicada con CIF A11223344 o no existe. |
0010 |
El cliente indicado no corresponde con la private key insertada |
0011 |
Se han encontrado centros de trabajo con el mismo nombre en la misma sociedad. |
0012 |
La suma de las horas ordinarias y las horas complementarias no puede ser mayor de 40 (Trabajador: 11223344A, CIF Sociedad: A11223344) |
0013 |
El código de trabajador provisto está repetido. |
0014 |
Los horarios no existen o tienen un formato incorrecto. |
Ejemplos
Petición de envío
Se envía una petición POST a la URL (http://api.ejornada.es/gestionar_jornadas), donde el parámetro es una variable del tipo JSON (json) con la Private Key (private_key) y el CIF del cliente (cif_cliente), así como el total de sociedades, centros de trabajo y trabajadores a gestionar, tal y como se muestra a continuación:
{
"private_key":"g9tdg44gGrk81pz",
"cif_desarrollador":"38047186B",
"cif_cliente":"N2505294E",
"nombre_cliente":"Empresa S.L.",
"email_cliente":"email@cliente.com",
"direccion_cliente":"Violeta",
"provincia_cliente":"Almería",
"poblacion_cliente":"ALMERIA",
"origen_cliente":"API",
"fecha_baja":"24-01-2021",
"avanzado":"1",
"vacaciones_dias":"30",
"vacaciones_tipo":"N",
"sociedades":[
{
"nombre":"Empresa S.L.",
"CIF":"N2505294E",
"domicilio_social":"Jazmín",
"guardar_localizacion":1,
"guardar_hora":0,
"modificar_hora":1,
"aviso_fin_jornada":0,
"proponer_hora_salida":0
}
],
"centros_trabajo":[
{
"nombre":"Centro A",
"localidad":"Almería",
"provincia":"Almería",
"lat":"36.8425611",
"lng":"-2.4650892",
"tipo_via":"Calle",
"calle":"Gran Capitán",
"numero":"5",
"codigo_postal":"04003",
"cif_sociedad":"N2505294E",
"guardar_localizacion":"0",
"guardar_hora":"1",
"modificar_hora":"0",
"aviso_fin_jornada":"1",
"terminal_corporativo":"0",
"proponer_hora_salida":"1"
}
],
"trabajadores":[
{
"nombre_usuario":"Antonio Rodríguez Zapata",
"nif_usuario":"16365771Y",
"email_usuario":"trabajador@empresa.com",
"cif_sociedad":"N2505294E",
"fecha_alta":"24-01-2020",
"vacaciones_dias":"30",
"vacaciones_tipo":"N",
"centros_trabajo":[
"Centro A"
],
"departamento":"Departamento 1",
"horario":[
{
"nombre":"Horario de Invierno",
"fecha_inicio":"01-01-2020",
"fecha_fin":"30-06-2020",
"turnos":[
{
"intervalos":[
{
"dia_semana":1,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":2,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":3,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":4,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":5,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
}
]
},
{
"intervalos":[
{
"dia_semana":1,
"centro_trabajo":"Centro A",
"hora_entrada":"16:00",
"hora_salida":"19:30",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":2,
"centro_trabajo":"Centro A",
"hora_entrada":"16:00",
"hora_salida":"19:30",
"tolerancia_entrada":"15",
"tolerancia_salida":"15",
"minutos_libres":"30"
}
]
}
],
"configuracion":{
"intervalos":[
{
"dia_semana":1,
"minutos_libres":"15"
},
{
"dia_semana":2,
"minutos_libres":"15"
},
{
"dia_semana":3,
"minutos_libres":"15"
},
{
"dia_semana":4,
"minutos_libres":"15"
},
{
"dia_semana":5,
"minutos_libres":"15"
}
]
}
},
{
"nombre":"Horario de Verano",
"fecha_inicio":"01-07-2020",
"fecha_fin":"31-08-2020",
"turnos":[
{
"intervalos":[
{
"dia_semana":1,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":2,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":3,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":4,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
},
{
"dia_semana":5,
"centro_trabajo":"Centro A",
"hora_entrada":"08:00",
"hora_salida":"15:00",
"tolerancia_entrada":"15",
"tolerancia_salida":"15"
}
]
}
],
"configuracion":{
"intervalos":[
{
"dia_semana":1,
"minutos_libres":"15"
},
{
"dia_semana":2,
"minutos_libres":"15"
},
{
"dia_semana":3,
"minutos_libres":"15"
},
{
"dia_semana":4,
"minutos_libres":"15"
},
{
"dia_semana":5,
"minutos_libres":"15"
}
]
}
},
{
"nombre":"Horario de Invierno",
"fecha_inicio":"01-09-2020",
"fecha_fin":"31-12-2020"
}
]
}
]
}
Respuesta recibida
{
"id_operacion":"123456789999999",
"estado_operacion":"0000",
"mensaje_operacion":"El proceso se ha realizado con éxito."
}
Zona de pruebas
Probar mediante petición JSON