Servicio web: Empresa

Modificado el Mie, 24 Jul a 2:54 P. M.

Introducción

Este servicio web sirve para consultar y crear registros de tipo empresa.

Proceso de consumo

Se utiliza el protocolo de comunicación HTTP más el token API configurado para tu cuenta.

Los pasos serían:

Autenticarte: autenticación HTTP mediante los datos de acceso proporcionados más Token de la cuenta.
Consumir el servicio en la URL proporcionada (ponte en contacto con soporte para conocerla)
Solicitud: se envía en formato JSON
Respuesta: se recibe en formato JSON.

Consulta

Si solo envías el CIF de la empresa:

Si existe en Gesforma, devuelve 200 seguido de un JSON con varios niveles de información.
Si No existe en Gesforma, devuelve un 401.

Estructura del json de respuesta a la consulta

ID id interno empresa
CRM [
1. Tipo_de_empresa (string)
2. Actividad (string)
3. Relacion (string)
4. Procedencia (string)
  ]
GENERAL [
1. Etiquetas (array) [Etiquetas asociadas (strings)]
2. Codigo (string)
3. NIF(string)
4. Nombre_fiscal (string)
5. Nombre_comercial (string)
6. Administrador (string)
7. NIF_administrador (string)
8. E_mail_administrador (string)
9. Telefono_administrador (string)
10. En_calidad_de (string)
11. Direccion (string)
12. Resto_de_la_direccion (string)
13. CP (string)
14. Pais (string)
15. Provincia (string)
16. Poblacion (string)
17. Telefono (string)
18. Pagina_web (string)
19. URL_Logo (string)
  ]
FACTURACION [
1. IBAN1 (string)
2. SWIFT_1 (string)
3. IBAN2 (string)
4. SWIFT_2 (string)
5. Responsable_facturacion (string)
6. E_mail_responsable (string)
7. Telefono_responsable (string)
8. Metodo_envio_factura (string)
9. Forma_de_pago (string)
10. Dia_de_pago_1 (string)
11. Dia_de_pago_2 (string)
12. Cuenta_contable (string)
13. Cuenta_balance (string)
14. Cuenta_resultados (string)
15. IRPF (double)
16. Recordatorio_de_pago (boolean)
  ]
FUNDAE [
1. N_Convenio_ACE (string)
2. Cuenta_cotizacion (string)
3. Expediente (string)
4. Sector (string)
5. CNAEs (array) son lso CNAEs asociados a la empresa
6. CNAE [
  1. Codigo código CNAE
  2. Denominacion (strings)
    ]
    …
    ]
7. Fecha_adhesion (string)
8. Convenio (string)
9. Codigo_convenio (string)
10. Plantilla_media_ (long)
11. Tamano_de_la_empresa (long)
12. Coste_medio_hora (double)
13. PYME (boolean)
14. Nueva_creacion (boolean)
15. Franquicia (boolean)
16. Existe_RLT (boolean)
17. P_Col_Prio_Exigido (double)
18. P_Col_Prio_Cumplido (double)
19. P_Cof_Priv_Exigido (double)
20. Pe_Cof_Priv_Cumplido (double)
  ]
CREDITOS [
1. P_Bonificacion (double)
2. Fecha_comprobacion (string)
3. Cuota_FP (double)
4. Asignado (double)
5. Dispuesto (double)
6. Disponible (double)
7. TGSS (double)
  ]
8. acumulado [
  1. Reserva (boolean)
  2. Reserva_acumulada (array) de los 4valores de la ficha
    [
    (double), (double)…
    ]
    ]
9. Perfil_Grupo_Empresas_Disponible (double)
10. PIF [
  1. Dispuesto (boolean)
  2. Dispuesto_Adicional (boolean)
    ]
RRHH [
1. Responsable_formacion (string)
2. Telefono_de_contacto (string)
3. E_mail_RRHH (string)
  ]
GESTORIA [
1. Nombre (string)
2. CIF (string)
3. Nombre_gestor (string)
4. Apellidos_gestor (string)
5. Telefono (string)
6. E_mail (string)
7. E_mail_alternativos (string)
  ]
CONEXION [
1. Activa (string) La url indicada en ficha
2. Usuario (string)
3. Clave (string)
4. Multiempresa (string)
  ]
OTROS [
1. Comentarios (string)
2. Acepto_comunicaciones_comerciales (boolean)
  ]
CONTACTOS (array de N contactos) [
1. CONTACTO [
  1. ID (string)
  2. Nombre (string)
  3. Apellido1 (string)
  4. Apellido2 (string)
  5. Domicilio (string)
  6. CP (string)
  7. Pais (string)
  8. Provincia (string)
  9. Poblacion (string)
  10. Fecha_de_nacimiento (string)
  11. Telefono_1 (string)
  12. Telefono_2 (string)
  13. E_mail (string)
  14. Cargo (string)
  15. Departamento (string)
  16. Secretaria (string)
  17. Telefono_secretaria (string)
  18. Informar (string)
  19. Procedencia (string)
  20. Comentarios (string)
    ]
    .....
    ]
GRUPOS (array de N de grupos asociados con esta empresa a través de un trabajador) [
1. GRUPO [
  ID (string)
2. Fecha_Inicio (string)
3. Fecha_Fin (string)
  ...
  ]
  ]
INFORMACION_DEL_REGISTRO (string) fecha ultima actualizacion dd/mm/yy hh:mm:ss

En el array se entiende que el primer valor indicado para el CANE es el que está indicado en Gesforma como CNAE principal, y el resto de valores, en el caso de existir, como CNAEs secundarios.

Ejemplo

$GF_TOKEN='XXX';

$data = ['cif'=>'B07733884'];
$query = http_build_query($data, '', '&');

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL,'https://fv.campusdeformacion.com/api/empresa_ws.php');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, "loginname:password"); // cuenta de gesforma
curl_setopt($curl, CURLOPT_HTTPHEADER,['Token: '.$GF_TOKEN]);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($curl, CURLOPT_POSTFIELDS,$query);

// Ejecutar la solicitud y obtener la respuesta
$response = curl_exec($curl);

Escritura

Si se envía un CIF seguido de un JSON, se actualiza la ficha de empresa con los datos existentes en el JSON, tanto si hay datos en el elemento como si no.

Es decir, si se envía el elemento IBAN1 vacío, el objetivo es que elimine el valor existente, en caso de que hubiese, y deje ese campo vacío en G.

Ejemplo

$GF_TOKEN='XXX'; 

$empresa = new stdClass();
$empresa->cif = 'B07733884';
$empresa->nombre_comercial = 'TEST 0001';
$empresa->nombre_fiscal = 'TEST 0001 S.L';
$empresa->administrador = 'Juan Palomo';
$empresa->telefono_administrador = '666 66 66 66';

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL,'http://campusdeformacion.local/api/empresa_ws.php');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, "tecnico:Jfs5960?");
curl_setopt($curl, CURLOPT_HTTPHEADER,[
'Token: '.$GF_TOKEN,
'Content-Type: application/json'
]);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode(array("empresa" => $empresa)));

// Ejecutar la solicitud y obtener la respuesta
$response = curl_exec($curl);