Skip to main content
Version: Latest

Consultar inventario

Devuelve el saldo de inventario por bodega. Permite conciliar desde un sistema externo sin entrar a AveCRM.

Request 🚀​

url​

https://app.aveonline.co/avestock/api/inventoryStock.php

Method​

POST

Content-Type: application/json
Authorization: {data.token}

El data.token se obtiene en la Autenticación.

Params JSON​

  • tipo* String Enrutador de la API, "authave"
  • empresa* Number Identificador de la empresa dentro de AVEONLINE
  • references Array Referencias a consultar. Si se omite, devuelve todo el inventario paginado
  • warehouse_id Number Bodega. Si se omite, devuelve todas las bodegas de la empresa
  • page Number Página. Por defecto 1
  • per_page Number Resultados por página. Por defecto 100, máximo 500

Ejemplo​

{
  "tipo": "authave",
  "empresa": 6077,
  "references": ["REF-0001", "REF-0002"],
  "warehouse_id": 1203
}

Response 📄​

Success​

  • page Number Página actual
  • total Number Total de registros
  • items[].reference String Referencia del producto
  • items[].available Number Saldo disponible, el que descuentan los pedidos
  • items[].physical Number Saldo físico, lo que hay en el estante
  • items[].report_copy Number La copia del saldo que muestran los informes de AveCRM
  • items[].in_sync Bool false cuando report_copy no coincide con available
  • items[].min_stock Number Stock mínimo configurado
  • items[].allows_negative Bool El producto permite inventario negativo

Ejemplo​

{
  "success": true,
  "messages": "Inventario consultado",
  "status": 200,
  "data": {
    "page": 1,
    "per_page": 100,
    "total": 2,
    "total_pages": 1,
    "items": [
      {
        "reference": "REF-0001",
        "product_id": 225321,
        "name": "Camiseta negra talla M",
        "warehouse_id": 1203,
        "warehouse_name": "Bodega principal",
        "available": 120,
        "physical": 120,
        "report_copy": 120,
        "in_sync": true,
        "min_stock": 5,
        "allows_negative": false
      }
    ]
  }
}
Por qué se devuelven tres saldos

available y physical se calculan sumando los movimientos reales de inventario. report_copy es una copia que AveCRM mantiene aparte para que los informes respondan rápido.

Cuando in_sync es false, el informe está mostrando un número que los movimientos no respaldan. Conviene revisarlo antes de tomar un conteo físico como referencia: de lo contrario se "corrige" un saldo que en realidad estaba bien.

Referencias vacías​

{
  "success": false,
  "messages": "Errores de validacion",
  "status": 422,
  "errors": [
    { "attribute": "references", "detail": "Las referencias enviadas estan vacias." }
  ]
}

Credenciales incorrectas​

{
  "success": false,
  "message": "No tienes permisos para acceder a este recurso.",
  "status": 401
}