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)
cif_cliente Varchar (255)
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_usuario Varchar (255) No
apellido2_usuario Varchar (255) No
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
horas_complementarias Int (11)
horario Array 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
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.
Ejemplos
Petición de envío

Se envía una petición POST a la URL (http://api.efirma.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": "ASDFQWERZXCVASD",
   "cif_cliente": "C18445916",
   "sociedades": [
      {
         "nombre": "Sociedad A",
         "CIF": "D49230816",
         "domicilio_social": "Avenida Manuel Azaña",
         "guardar_localizacion": "1",
         "guardar_hora": "0",
         "modificar_hora": "1",
         "aviso_fin_jornada": "0",
         "terminal_corporativo": "1",
         "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": "D49230816",
         "guardar_localizacion": "0",
         "guardar_hora": "1",
         "modificar_hora": "0",
         "aviso_fin_jornada": "1",
         "terminal_corporativo": "0",
         "proponer_hora_salida": "1"
      }
   ],
   "trabajadores": [
      {
         "nombre_usuario": "usuario",
         "apellido1_usuario": "ap1",
         "apellido2_usuario": "ap2",
         "nif_usuario": "68992271E",
         "email_usuario": "usuario@dominio.com",
         "telefono_usuario": "+34666112233",
         "direccion_usuario": "Plaza de la Victorio",
         "numero_usuario": "2",
         "codigo_postal_usuario": "01122",
         "provincia_usuario": "Almería",
         "municipio_usuario": "Almería",
         "cif_sociedad": "D49230816",
         "fecha_alta": "11-5-2016",
         "fecha_baja": "12-5-2016",
         "horas_complementarias": "2",
         "horario": ["8","8","8","8","8","0","0"],
         "centros_trabajo": ["Centro A"],
         "guardar_localizacion": "0",
         "guardar_hora": "1",
         "modificar_hora": "0",
         "aviso_fin_jornada": "1",
         "terminal_corporativo": "0",
         "proponer_hora_salida": "1",
         "codigo": "1234"
      }
   ],
   "gestores_jornada": [
      {
         "nombre": "gestor",
         "email": "gestor@gestor.com",
         "centros_trabajo": [
         	{
         		"cif_sociedad":"D49230816",
         		"nombre_centro":"Centro A"
         	}
         ]
      }
   ]
}

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