Actúan como un mecanismo complementario a los webhooks para mitigar la potencial pérdida de notificaciones o eventos.
- Polling de ventas
Se debe consultar las ventas de un rango de fechas cada M (Frecuencia de ejecución) horas, estableciendo lo siguiente:
- from = fecha y hora de la última vez que se ejecutó correctamente el polling (si no se ha ejecutado, desde que fecha y hora se deben consultar las ventas).
- to = la fecha y la hora actual.
- M = frecuencia de ejecución (recomendamos usar M = 1 -2 horas).
Debes utilizar el endpoint Get checkouts light whit scroll para realizar el sondeo de las órdenes desde Multivende.
En cada solicitud, se debe enviar el MerchantId. De manera opcional, puedes filtrar por MarketplaceConnectionId y obtener las ventas utilizando los campos de fecha:
- UpdatedAt: fecha de última actualización de la orden.
- SoldAt: fecha de venta en el canal de venta.
También debes definir el límite (limit) de resultados a consultar (valor permitido entre 50 y 1000). Este endpoint permite obtener las ventas del merchant paginadas mediante scroll.
Más información en el artículo Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema
- Polling de productos
Mediante el endpoint de Get products with scroll puedes traer un listado de productos nuevos o actualizados en una cuenta de merchant en un rango de tiempo determinado.
En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 5000.
El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.
El endpoint permite filtrar por fecha de creación (createdAt) o por fecha de actualización (updatedAt), devolviendo los items en el rango de fecha consultado (de from a to).
Podemos incluir las imágenes y los atributos customizados en la respuesta enviando estos filtros con el valor true.
La respuesta del endpoint nos dará un array con todos los productos incluidos en la consulta, donde podremos identificar además la información del producto padre y de las versiones.
- Polling de stock
Permite consultar el stock de productos por bodega que se haya registrado o actualizado en una rango de tiempo determinado.
En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.
El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.
El endpoint Get stocks with scroll permite filtrar por fecha de creación (createdAt) o por fecha de actualización (updatedAt), devolviendo los ítems en el rango de fecha consultado (de from a to).
La variable amount de cada registro devuelto en la solicitud nos dará el monto de stock disponible para el producto.
- Polling de precios
Puedes obtener los precios nuevos o actualizados en un rango de tiempo determinado por lista de precios mediante el endpoint de Get prices with scroll.
En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.
El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.
Por cada registro podemos validar los precios asociados a los product versions mediante los campos:
- net (precio neto)
- gross (precio de venta)
- tax (impuesto)
- pricewithdescount (precio con descuento)
- Polling de product links
Consultas los estados de sincronización de los productos que fueron vinculados hacia el canal de venta (sólo para administración de integraciones que son de tipo canal de venta) por fecha de creación o actualización.
Con Get product links with scroll obtienes un array de los registros devueltos en la solicitud, donde puedes validar el synchronizationStatus del producto hacia el canal y de acuerdo a este realizar las acciones necesarias para la vinculación.
En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 1000.
El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.
- Polling de clientes
Puedes obtener el registro de clientes nuevos o actualizados en un rango de tiempo determinado mediante el endpoint de Get clients with scroll.
En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.
El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.
Equipo Integraciones API Multivende
0 comentarios
Inicie sesión para dejar un comentario.