En este artículo te explicamos cómo usar la API de SimplyGest Desktop. Ten en cuenta que se trata de un artículo complejo, que requiere de conocimientos de programación, por lo que está orientado a personal específico.
El acceso o consumo de la API puede realizarse casi con cualquier lenguaje de programación. En este artículos usaremos ejemplos en PHP.
Lo primero que necesitaremos es habilitar nuestro Servidor para la API y obtener nuestra Clave de API (APIKey), en el Módulo Servidor:
Una vez habilitada la API y obtenida nuestra APIKey, ya podremos empezar.
Cómo obtener la IP Pública de nuestro Servidor
Para poder usar la API y acceder a los datos de tu Empresa, necesitarás saber la IP Pública de tu Servidor de SimplyGest.
La mejor forma de saber la IP Pública de tu Servidor es consultándola manualmente en el propio Módulo Servidor. No obstante, también es posible conocer la IP Pública de tu Servidor usando la API de SimplyGest.
NOTA: Si tienes contratada una IP Pública fija, puedes omitir este paso, ya que la IP siempre será la misma.
El siguiente código en PHP permite obtener la última IP Pública conocida de tu Servidor de SimplyGest, para que puedas utilizarla en las consultas posteriores a la API.
NOTA: Si dispones de varios Servidores, por defecto se muestra el primero de todos los disponibles. Por el momento no es posible especificar un servidor concreto.
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://simplygest.es:56983/getserverip?user=XXXXX&passwd=XXXXXX',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;Recuerda cambiar XXXX por tu Identificativo de Cliente de SimplyGest (el mismo que utilizas para acceder a la Zona de Clientes de nuestra web) y la contraseña, que deberá estar cifrada con MD5.
Ejemplo en PHP + cURL para obtener todos los Artículos
El siguiente código en PHP permite obtener todos los productos de nuestra base de datos. La consulta devolverá un JSON con todos los campos y valores de nuestros productos.
Recuerda sustituir los valores XXXXX por la IP Pública de tu Servidor de SimplyGest y tu APIKey:
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'XXX.XXX.XXX.XXX:56985/api/productos',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_POSTFIELDS =>'{}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'APIKey: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
El resultado obtenido será un JSON similar a este:
{
"articulos": [
{
"CODIGO": "001",
"DESCR": "Tarjeta Gráfica Radeon X6000 RTTUA",
"PRECIO_P": "33277",
"PRECIO_E": "300",
.....
.....
.....
"ALTO": "",
"ANCHO": "",
"FONDO": "",
"LONGITUD": "",
"AGENTE": "",
"DTOMAX": "",
"SUBFAMILIA2": "",
"URL": "",
"MODIFICADO": "07/09/2023 13:11:56"
},
.....
.....Recuerda que tienes disponible la documentación de la API aquí.
¿Te ha resultado útil??
0 / 1