developers
  • Introducción
  • API
    • v1
    • v2
      • Introducción
      • Autenticación
      • Almacenes
      • Clientes
      • Productos
      • Mensualidades
      • Lista negra
      • Contacto
      • Líneas
      • Sublíneas
      • Subsublíneas
      • Usuarios
      • Notas de venta
      • Pedidos
      • Facturas
      • Prospectos
      • Notas de crédito
      • Vehículos Entrega
      • Repartidores
      • Cotizaciones
      • Empleado
  • Webhooks
Con tecnología de GitBook
En esta página
  • Información general
  • Configuración básica de un webhook
  • Creación de productos
  • Cambios de precios y existencias

¿Te fue útil?

Webhooks

AnteriorEmpleado

Última actualización hace 4 años

¿Te fue útil?

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"

    • :

      • Username

      • Password

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"
    },
    ...
]
Autenticación de acceso básica