Documentación API Sambil Retail

Sincronización de Stock y Precios

AUTHORIZATION

Para poder realizar consultas y actualizaciones debe pasar el TOKEN obtenido en LOGIN en la cabecera o authorization debe ser un --> Bearer Token -- el token expira 1 Hora luego de ser obtenido.

Token de ejemplo: poJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.poJzZWxsZXJfaWQiOjE0MCwasdTghTU1fQ.sZfiD19ibFaFx1l92bRJGfS-Lw5y4BWq9hNoWKUGx6g

Rutas

Método GET para obtener el listado de productos

Ruta para obtener todos los productos: /api/products/id

(el path "id" debe ser reemplazado por el vendor que se le otorgará en las credenciales)

Método POST para actualizar stock y precios

Ruta para actualizar registros: /api/products/id

(el path "id" debe ser reemplazado por el vendor que se le otorgará en las credenciales)

Método POST para hacer Login

Ruta para iniciar sesión y obtener Token: /api/auth/login

Estructura JSON para hacer login

Para que el formato sea válido debe enviar un JSON

     {
      "seller_id": 0001, || ID de Vendor
       "password_hash": "Usuario.123*" || Contraseña asignada
     }

Una vez obtenga el token cópielo y envíelo en la cabecera para peticiones GET y POST

ESTATUS 200 || Credenciales correctas
ESTATUS 500 || Credenciales Incorrectas

Respuesta JSON del GET con los productos obtenidos

      {  
          "error": false, || muestra el status de la conexión
          "status": 200, || status 200 conexión exitosa
          "body": [
      {
             "entity_id": 125, || ID de producto relacionado
             "sku": "3X4MPLE", || SKU Producto
             "nombre_producto": "Piano portátil", || Nombre del producto
             "value": 35, || Precio de producto
             "seller_id": 125, || Id del vendor
             "firstname": "Nombre vendor", || Nombre de Vendor
             "quantity": 3 || cantidad de Stock
      },
            ],
      }

ESTATUS 200 || CONEXIÓN EXITOSA
ESTATUS 401 || ERROR DE BASE DE DATOS
ESTATUS 404 || NO EXISTE
ESTATUS 500 || ERROR INTERNO
ESTATUS 304 || CONSULTA ÉXITOSA

Arma tu array con esta estructura para actualizar precios y stock

Para que el formato sea válido debe enviar un Array JSON con la siguiente estructura obligatoriamente, recuerde enviar en la cabecera el TOKEN obtenido en el LOGIN

    [  
         {
          "entity_id": 0001, || ID del producto que quieres actualizar
           "sku": "9663254", || SKU del producto que quieres actualizar
           "value": 10.99, || Precio del producto se puede agregar decimales
           "quantity": 20, || cantidad en stock sin decimales
           "seller_id": 001 || Vendor
         },
         {
          "entity_id": 0002,
          "sku": "9588785",
           "value": 60,
           "quantity": 200,
           "seller_id": 001
         }
    ]

ESTATUS 200 || Actualización del producto ID: 0001, SKU: 9663254, realizado exitosamente
ESTATUS 500 || No se encontró ningún registro (Entity O SKU no se encuentran)