developers
Buscar
K

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:
{
"id": 15111,
"codigo": "PRODUCTO DE EJEMPLO",
"medio_distribucion": 3,
"descripcion": "Lorem ipsum dolor...",
"descripcion_adicional": "",
"ce_fraccion_arancelaria": "",
"descripcion_ingles": "",
"descripcion_ecommerce": "",
"tipo": 0,
"tipo_producto_sistema_cardonal": null,
"composiciones": [],
"unidad_aduana": "",
"imagen_url": "",
"costo_ensamble": 0,
"costo": 0.0,
"precio": 160.0,
"unidad": {
"id": 13393,
"factor": "1.000000",
"seleccionado": true,
"seleccionado_compra": true,
"codigo_barras": null,
"base": "70.0000",
"altura": "35.0000",
"profundidad": "60.0000",
"peso": "200.0000",
"nombre": "PIEZA"
},
"unidades": [
{
"id": 13393,
"factor": "1.000000",
"seleccionado": true,
"seleccionado_compra": true,
"codigo_barras": null,
"base": "70.0000",
"altura": "35.0000",
"profundidad": "60.0000",
"peso": "200.0000",
"nombre": "PIEZA"
}
]
}

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:
[
{
"sku": "0001",
"precio": "99.00",
"costo": "0.00",
"stock": "10"
},
{
"sku": "0002",
"precio": "239.00",
"costo": "0.00",
"stock": "2"
},
...
]
Última actualización 3yr ago