API ejornada

WS Gestión de jornadas

Parámetros de entrada
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
private_key Varchar (255)
token Varchar (255) No
cif_desarrollador Varchar(255)
cif_cliente Varchar (255)
nombre_cliente Varchar (255)
email_cliente Varchar (255)
direccion_cliente Varchar (255)
provincia_cliente Varchar (255)
poblacion_cliente Varchar (255)
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)
cif Varchar (255)
domicilio_social Varchar (255)
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)
localidad Varchar (255) No
provincia Varchar (255)
lat Int (11) No
lng Int (11) No
tipo_via Varchar (255)
calle Varchar (255)
numero Varchar (255) No
codigo_postal Varchar (255) No
cif_sociedad Varchar (255)
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)
apellido1 Varchar (255)
apellido2 Varchar (255)
nif_usuario Varchar (255)
email_usuario Varchar (255)
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)
fecha_alta Date
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.
Importante: Si se le añade estructura de horarios de un trabajador, reemplazarán los horarios que coincidan en mismos rangos de fechas.
Nombre del campo Tipo de dato Obligatorio
nombre Varchar(255) Si
diario Indica si el horario es diario. 1 = Si, 0 = No No
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, 0 = Diario 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
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)
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)
nombre_centro Varchar(255)
Parámetros de salida
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
id_operacion Varchar(255) No
estado_operacion Varchar(255)
mensaje_operacion Varchar(255)
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.
0015 La suscripcion del cliente ha expirado
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
Datos de entrada
Respuesta

WS Gestión de trabajadores

Parámetros de entrada
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
private_key Varchar (255)
token Varchar (255) No
cif_desarrollador Varchar(255)
cif_cliente Varchar (255)
cif_sociedad Varchar (255)
nif_trabajador Varchar (255)
Parámetros de salida
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
id_operacion Varchar(255) No
estado_operacion Varchar(255)
mensaje_operacion Varchar(255)
respuesta Estructura JSON con los datos del trabajador
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 La sociedad indicada no existe
0006 El trabajador indicado no existe
0015 La suscripcion del cliente ha expirado
Ejemplos
Petición de envío

Se envía una petición POST a la URL (http://api.ejornada.es/datos_trabajador), 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",
								"nif_trabajador":"75244223N",
								"cif_sociedad":"V7323510J"
								}
							
Respuesta recibida
							{
								"id_operacion":"123456789999999",
								"estado_operacion":"0000",
								"mensaje_operacion":"El proceso se ha realizado con éxito.",
								"respuesta":"{"codigo":"3425345","nombre":"ANTONIO","apellido1":"DOBLAS","apellido2":"RODRIGUEZ"}"
								}
							
Zona de pruebas
Probar mediante petición JSON
Datos de entrada
Respuesta

WS Gestión de fichajes

Parámetros de entrada
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
private_key Varchar (255)
token Varchar (255) No
cif_desarrollador Varchar(255)
cif_cliente Varchar (255)
cif_sociedad Varchar (255)
nif_trabajador Varchar (255)
desde Date
hasta Date
Parámetros de salida
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
id_operacion Varchar(255) No
estado_operacion Varchar(255)
mensaje_operacion Varchar(255)
respuesta Estructura JSON con los fichajes
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 La sociedad indicada no existe
0006 El trabajador indicado no existe
0007 Falta el campo 'desde'
0008 Falta el campo 'hasta'
0015 La suscripcion del cliente ha expirado
Ejemplos
Petición de envío

Se envía una petición POST a la URL (http://api.ejornada.es/fichajes_trabajador), 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",
								"nif_trabajador":"75244223N",
								"cif_sociedad":"V7323510J",
								"desde":"01-01-2020",
								"hasta":"28-02-2020"
								}
							
Respuesta recibida
							[
								{"fecha":"2020-02-03 08:08:00","creado":"2020-02-20 12:47:52","es_salida":"0","lat":"36.83","lng":"-2.40741","gps_activo":"0","origen":"web","fecha_modificacion":null,"fecha_firma":null,"requiere_firma":"1","requiere_validacion":"0","validado":"1"},
								{"fecha":"2020-02-03 15:00:00","creado":"2020-02-20 12:48:11","es_salida":"1","lat":"36.83","lng":"-2.40741","gps_activo":"0","origen":"web","fecha_modificacion":"2020-03-26 00:06:00","fecha_firma":null,"requiere_firma":"1","requiere_validacion":"0","validado":"1"},
								{"fecha":"2020-02-27 08:01:30","creado":"2020-02-27 11:19:31","es_salida":"0","lat":"36.83","lng":"-2.40741","gps_activo":"1","origen":"app","fecha_modificacion":"2020-03-26 00:07:32","fecha_firma":null,"requiere_firma":"1","requiere_validacion":"0","validado":"1"}
							]
							
Zona de pruebas
Probar mediante petición JSON
Datos de entrada
Respuesta

WS Marcar cliente facturado

Parámetros de entrada
Nombre del campo Tipo de dato Obligatorio
private_key varchar(255)
cif_cliente varchar(255)
cif_desarrollador varchar(255) No
facturado Int (1) No
Parámetros de salida
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
id_operacion Varchar(255) No
estado_operacion Varchar(255)
mensaje_operacion Varchar(255)
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
0005 Usted no tiene acceso a este recurso
0006 El valor de facturado debe ser 1 o 0
0007 Ha fallado la actualización. Consulte con el programador.
0008 Ha fallado la recepción del json. Consulte con el programador.
0010 El cliente indicado no corresponde con la private key insertada
0015 La suscripcion del cliente ha expirado
Ejemplos
Petición de envío

Se envía una petición POST a la URL (http://api.ejornada.es/api_set_cliente_facturado), 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 campo facturado para marcar al cliente como tal, vease ejemplo:

								{
									"private_key":"g9tdg42gGrk81pz",
									"cif_desarrollador":"38047186B",									
									"cif_cliente":"V7323559J",									
									"facturado":1
								}
							
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
Datos de entrada
Respuesta

WS Clientes TPV

Datos de cliente y de licencia que no estén facturados

Parámetros de entrada
Nombre del campo Tipo de dato Obligatorio
private_key varchar(255)
cif_cliente varchar(255) No
cif_desarrollador varchar(255) No
Parámetros de salida
Nombre del campo Tipo de dato Obligatorio
json Estructura JSON formada por los campos mostrados a continuación
id_operacion Varchar(255) No
estado_operacion Varchar(255)
mensaje_operacion Varchar(255)
datos Text
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 Usted no tiene acceso a este recurso
0007 Ha fallado la actualización. Consulte con el programador.
0008 Ha fallado la recepción del json. Consulte con el programador.
0010 El cliente indicado no corresponde con la private key insertada
0015 La suscripcion del cliente ha expirado
Ejemplos
Petición de envío

Se envía una petición POST a la URL (http://api.ejornada.es/api_get_info_facturacion_clientes_tpv), donde el parámetro es una variable del tipo JSON (json) con la Private Key (private_key), el CIF del cliente (cif_cliente) y el CIF del desarrollador (cif_desarrollador):

								{
									"private_key":"g9tdg42gGrk81pz",
									"cif_desarrollador":"38047186B"
								}
							
Respuesta recibida
								{
									"id_operacion":"123456789999999",
									"estado_operacion":"0000",
									"mensaje_operacion":"El proceso se ha realizado con éxito."
									"datos": [
										{
											nombre:"Antonio",
											email:"antonio@gmail.com",
											direccion:"CL Alegria 22",
											municipio:"Huercal-Overa",
											provincia:"Almería",
											nif:"33599867M",
											fecha_inicio:'2020-07-28',
											fecha_fin:'2020-07-28',
											facturado:0,										
										},
										{
											nombre:"Mariano Gomez",
											email:"mgomez@gmail.com",
											direccion:"CL Ferrocarril 345 A",
											municipio:"Pulpi",
											provincia:"Almería",
											nif:"45789632J",
											fecha_inicio:'2020-05-01',
											fecha_fin:'2020-09-29',
											facturado:0,										
										}
									]
								}
							
Zona de pruebas
Probar mediante petición JSON
Datos de entrada
Respuesta