developers
Buscar…
Webhooks

Información general

La configuración de Webhooks nos ayuda a enviar notificaciones de diferentes eventos que ocurren en su cuenta de admintotal, estas notificaciones son enviadas mediante una petición POST a la URL que se especifica al momento de su configuración. Los eventos que pueden ser notificados son:
  • Creación de productos
  • Creación de clientes
  • Creación de cotización
  • Timbrar factura
  • Actualización de precios y existencias de productos

Configuración básica de un webhook

La configuración de webhooks podemos encontrarla entrando en su cuenta de admintotal a la ruta Configuración / Webhooks ó directamente https://{clave}.admintotal.com/admin/integraciones/configuracion_webhooks/
Todos los webhooks que se configuren tendrán las siguientes propiedades, dependiendo el tipo de evento que se notificará puede que se agreguen propiedades adicionales a su configuración.
  • URL: Admintotal tomará el valor especificado para enviar una petición POST con la información de la notificación.
  • La autenticación de las notificaciones enviadas es opcional pero recomendada, pueden ser de las siguientes maneras:
    • Token: Token de autenticación que será utilizado en cada petición enviada, se enviará en el header "Api-key"

Creación de productos

Ejemplo del body de la petición:
1
{
2
"id": 15111,
3
"codigo": "PRODUCTO DE EJEMPLO",
4
"medio_distribucion": 3,
5
"descripcion": "Lorem ipsum dolor...",
6
"descripcion_adicional": "",
7
"ce_fraccion_arancelaria": "",
8
"descripcion_ingles": "",
9
"descripcion_ecommerce": "",
10
"tipo": 0,
11
"tipo_producto_sistema_cardonal": null,
12
"composiciones": [],
13
"unidad_aduana": "",
14
"imagen_url": "",
15
"costo_ensamble": 0,
16
"costo": 0.0,
17
"precio": 160.0,
18
"unidad": {
19
"id": 13393,
20
"factor": "1.000000",
21
"seleccionado": true,
22
"seleccionado_compra": true,
23
"codigo_barras": null,
24
"base": "70.0000",
25
"altura": "35.0000",
26
"profundidad": "60.0000",
27
"peso": "200.0000",
28
"nombre": "PIEZA"
29
},
30
"unidades": [
31
{
32
"id": 13393,
33
"factor": "1.000000",
34
"seleccionado": true,
35
"seleccionado_compra": true,
36
"codigo_barras": null,
37
"base": "70.0000",
38
"altura": "35.0000",
39
"profundidad": "60.0000",
40
"peso": "200.0000",
41
"nombre": "PIEZA"
42
}
43
]
44
}
Copied!

Cambios de precios y existencias

El envío de los cambios de precios y existencias se realiza cada 4 minutos y no en tiempo real, se envían un máximo de 50 productos por petición.
Para recibir notificaciones sobre cambios de precios y existencias en su catálogo de productos será necesario especificar las siguientes configuraciones, esto podemos hacerlo entrando en su cuenta de admintotal a la ruta Configuración / Webhooks ó directamente https://{clave}.admintotal.com/admin/integraciones/configuracion_webhooks/
  • Almacén de precios: Almacén que será usado para calcular los precios notificados.
  • Almacén(es): Se especifica uno o varios almacenes de los cuales se tomarán en cuenta las existencias.
  • Cliente: Se puede seleccionar un cliente del catálogo para poder asignar listas de precios.
Ejemplo del body de la petición:
1
[
2
{
3
"sku": "0001",
4
"precio": "99.00",
5
"costo": "0.00",
6
"stock": "10"
7
},
8
{
9
"sku": "0002",
10
"precio": "239.00",
11
"costo": "0.00",
12
"stock": "2"
13
},
14
...
15
]
Copied!
Última actualización 1yr ago