API v2.0 - Go Version

Retail Inventory API

Sincronización de alta velocidad para aliados comerciales de Sambil Online.

Descripción

La API Retail es la herramienta centralizada para que los aliados comerciales de Sambil Online gestionen su inventario de forma automatizada. Permite la sincronización en tiempo real de precios y stock, garantizando que los productos en el marketplace estén siempre actualizados con su sistema local.

¿Quieres integrar tu inventario?

Para empezar a utilizar esta API, debes solicitar tus credenciales de acceso al departamento comercial.

Escríbenos a: [email protected]

Autenticación

Todas las peticiones deben incluir un token JWT en la cabecera Authorization.

POST /api/auth

Obtén tu token de acceso usando tu ID de vendedor y contraseña.

Request Body:

{
  "seller_id": 140,
  "password_hash": "tu_contraseña"
}

Response:

{
  "error": false,
  "body": {
    "token": {
      "token": "eyJhbGciOiJIUzI1..."
    }
  }
}

Endpoints Disponibles

GET /api/products/{seller_id}

Consulta la lista actual de tus productos registrados en Sambil Online.

POST /api/products/{seller_id}

Actualización masiva de inventario y precios.

Límite: 1000 productos por petición. Sincronización automática con Zoho CRM y Algolia.

Request Body (Array):

[
  {
    "sku": "SKU001",
    "value": 25.50,
    "quantity": 10
  },
  {
    "sku": "SKU002",
    "value": 40.00,
    "quantity": 0
  }
]