BRIDGE API - REST - Consulta stock disponible por tienda por SKU, tienda, depósito



REVISIONES
FechaVersiónDescripciónAutor

 

1.0Creación del documento



Este servicio, permite consultar el stock disponible en cada tienda, de todo depósito en cualquiera de los estados. A diferencia del stock/status, este permitirá utilizar filtros para obtener la información más acotada (por tienda/depósito/item)

  1. Se invoca de la siguiente manera: https://[direccion_ip]:[puerto]/stock/status - Ejemplo: https://200.100.100.100:8090/stockReport/status
  2. Se invoca vía POST


Tener en cuenta:

  1. Primero se debe invocar al servicio de autenticación para obtener un token.
  2. Cuando se llama a cualquier servicio este token se envía como un parámetro más de la llamada en el header (x-access-token).
  3.  Si al llamar al servicio el token expiró, se recibirá respuesta de token inválido y se deberá volver a pedir uno nuevo.

Ver BRIDGE API - REST – Autenticación: token


Ejemplo del JSON a enviar en el body:  

{
  "storeCode": [  
     "T01", "T02"
  ],

  "locationCode": [  
     "DEP1"
  ],

  "internalCode": [  
     "ART_IVA21", "ART_PRUEBA"
  ]}


Descripción de los campos: 

Importante: los campos que poseen este ícono , son valores tipificados que deben respetar los valores expuestos por BRIDGE en sus servicios.

Campo

Tipo

Descripción

Requerido

Ejemplos

internalCodelista []Un listado con códigos únicos que identifican a los productos.Opcional, sino se informa considera todos000001
storeCodelista []Un listado con códigos de tiendaOpcional, sino se informa considera todosT001
locationCodelista []Un listado de códigos de depósitosOpcional, sino se informa considera todosDEP1

Respuesta del servicio: 

{
    "ack": 0,
    "detail": [
        {
            "internalCode": "GUS01",
            "detail": [
                {
                    "storeCode": "1",
                    "stock": 42,
                    "reserved": 0,
                    "locationCode": "DEP1",
                    "locationName": "Disponible Para La Venta", 
					"inventoryState": "Items a la venta"
                 },
                {
                    "storeCode": "2",
                    "stock": 3,
                    "reserved": 0,
                    "locationCode": "DEP1",
                    "locationName": "Disponible Para La Venta",
 					"inventoryState": "Items a la venta"
                  },
                {
                    "storeCode": "2",
                    "stock": 2,
                    "reserved": 0,
                    "locationCode": "CONSIG",
                    "locationName": "Consignación",
 					"inventoryState": "Items en tránsito de entrada"
                  },
                {
                    "storeCode": "2",
                    "stock": 1,
                    "reserved": 0,
                    "locationCode": "DEV",
                    "locationName": "Devoluciones",
 					"inventoryState": "Items a la venta"
                  }
            ]
        }
    ]
}


  1. ack es el código de respuesta, en caso de ser un error, mirar tabla a continuación.
  2. message: descripción del error en caso de existir.
  3. colección llamada detail, que contiene el detalle por código interno del producto y tienda, depósito (código y nombre), del stock disponible en el depósito configurado para ello.


CampoDescripción
internalCodecódigo del ítem
detail [ ] Lista de detalle por cada ítem 
storeCodeCódigo de tienda
stockCantidad de unidades en stock 
reservedCantidad de unidades reservadas del stock
locationCodeCódigo del depósito
locationNameNombre del depósito
inventoryStateEstado del depósito


Códigos de error generales: 

Código de Error

Descripción

0La operación es exitosa.
9999Error desconocido
  • Sem rótulos