Saltar la navegación

tgAPI

Comunica tgProfesional 11 con aplicaciones web

tgAPI funcionamiento

tgAPI server es una api de comunicación y sincronizacion REST de entidades de tgProfesional. Estas entidades describen tablas como clientes, proveedores, direcciones, agenda, agentes, etc. y documentos como albaranes, facturas, presupuestos,etc.

La api va acompañada de un middleware, Swagger , para mostrar la documentación en HTML por navegador. Para cada entidad existe un conjunto de operaciones de comunicación de tipo GET (lectura), POST (inserción), PUT (actualización) y DELETE (borrado). De este modo, el servidor ofrece la posibilidad de comunicar con cualquier otra aplicación y sincronizar datos de tgProfesional 11 con estas apps.

tgAPI entidades

Si quieres ver ejemplos de cómo funciona, haz clic en cada opción para desplegar el contenido.

Autorización para acceder a los datos

Para poder acceder a la sincronización, deberás tener usuario y contraseña y obtener un Token.

Consultar datos de un artículo

Veamos en el ERP la ficha de un Artículo concreto:

Para obtener de la API un fichero con los datos de un artículo concreto, la operación de lectura es GET:

Buscamos de la empresa 01 el Código de artículo 100304:

Obtenemos un fichero Json con los datos del Artículo:

Fíjate que nos devuelve campos que normalmente visualizaremos en la app web que queramos vincular así como campos de "control" para saber un identificador de cambio (change_id),  fecha de actualización (updated_at) o quien actualiza (updated_by).

tgAPI nos da acceso a sincronizar los ficheros maestros, en este caso el de artículos y las tablas auxiliares :

que nos permitirá que nuestra app controle, por ejemplo, los stocks o los lotes de un artículo.

Consultar clientes fijando parámetros

Puedes seleccionar los campos a incluir o excluir en una consulta, establecer orden de los campos, acotar por empresa, indicar si quieres un recuento de registros y aplicar una condición para filtrar (where) en formato sql:

Añadir una firma (imagen) en un albarán de venta

Vamos incorporando en tgAPI diferentes operaciones en base a las propuestas de nuestros distribuidores y clientes, por ejemplo, poder registrar y adjuntar una imagen con la firma del cliente en un albarán de venta usando POST:

Licencia: licencia propietaria

Creado con eXeLearning (Ventana nueva)