API : Productos

https://www.obuma.cl/ayuda/api-integracion/productos

Productos:

  •  GET  /productos.list.json    

Devuelve lista con todos los productos.

--- Parametros : 

Filtros opcionales : puedes pasar los siguientes filtros opcionales como parametro GET, ejemplo /productos.list,json/?tipo=2&proveedor=1

id :  es el id del producto

tipo : se refiere al tipo producto ( 0=estandar, 1=Servicio 2=Kit-Combo 3=Fabricado  )

codigo_sku :  es el codigo comercial o codigo sku del producto

codigo_barra :  es el codigo de barra del producto

categoria : es el id de la categoria

subcategoria : es el id de la subcategoria

fabricante :  es el id del fabricante

inventariable : indica si el producto es inventariable ( 1=si, 0=no )

para_venta : indica si el producto es para venta ( 1=si, 0=no )

para_compra : indica si el producto es para compra ( 1=si, 0=no )

activo : indica si el producto esta activo ( 1=si, 0=no )

proveedor : es el id del proveedor

 

 

  •  GET  /productos.findById.json/100    

Devuelve un producto en especifico.

--- Parametros :

El ID del producto.

 

 

 


Consulta precios de productos por Lista Precio:

 

  •  GET  /productosConsultaPrecios.list.json 

Devuelve el precio de un producto según la lista precio dada.

 

--- Parametros :

lista_precio : id de la lista precio. si no pasa ninguno, devuelve el precio de la ficha del producto, que es el precio base.

opcionales para filtrar :  

categoria : id de la categoria

subcategoria : id de la subcategoria

fabricante : id del fabricante / marca

 

 

 

 

 


Categorias de productos:

 

  •  GET  /productosCategorias.list.json    

Devuelve lista con todas las categorias de productos.

--- Parametros :

 

 

  •  GET  /productosCategorias.findById.json/100    

Devuelve una categoria en especifico.

--- Parametros :

ID : id de la categoria en la URL.

 


SubCategorias de productos:

 

  •  GET  /productosSubCategorias.list.json    

Devuelve lista con todas las subcategorias de productos.

--- Parametros :

 

 

  •  GET  /productosSubCategorias.findById.json/100    

Devuelve una subcategoria en especifico.

--- Parametros :

El ID de la subcategoria.

 


Fabricantes de productos:

 

  •  GET  /productosFabricantes.list.json    

Devuelve lista con todos los fabricantes de productos.

--- Parametros :  

 

 

  •  GET  /productosFabricantes.findById.json/ID    

Devuelve un fabricante en especifico.

--- Parametros :

ID : id del fabricante en la URL.

 


Imagenes de productos:

 

  •  GET  /productosImagenes.list.json/ID   

Devuelve lista con todas las imagenes de un producto.

--- Parametros :

ID : id del producto en la URL.

 

 

  •  GET  /productosImagenes.findById.json/ID 

Devuelve una imagen en especifico.

--- Parametros :

ID : id de la imagen en la URL.

 


Stock de productos :

 

  •  GET  /productosStock.list.json/ID    

Devuelve lista de todos los productos con stock.

--- Parametros :

id de la bodega (obligatorio) se puede pasar como se indica en el ejemplo en la url

o se puede pasar por GET

?id_bodega=100

?categoria = ID Categoria

?subacateria = ID Sub Categoria

?fabricante =  = ID fabricante

 ?fecha_desde=2023-01-01T00:00:00 la cual devuelve los movimientos desde una fecha dada en adelante

 

  •  GET  /productosStock.list-DetalleBodegas.json/   

Devuelve lista de todos los productos detallado por bodegas con su respectivo saldo

--- Parametros :

?id_bodega=100 

?fecha_desde=2023-01-01T00:00:00 la cual devuelve los movimientos desde una fecha dada en adelante

 

  •  GET  /productosStock.list-DetalleBodegas2.json/   

Devuelve lista de todos los productos con el detalle de saldo de cada bodega en un sola row

--- Parametros :

?formato_stock=json (devuelve el stock agrupado en un json)

Ej.: 

"saldos": "{\"290\":10,\"1511\":73,\"2007\":0}"
 
Por default lo devuelve como un string
 
Ej.: 
 
"saldos": "290:10,1511:73,2007:0" indicado id_bodega : saldo, id_bodega : saldo

 

 

 

 

  •  GET  /productosStock.findById.json/ID

Devuelve el stock de un producto en especifico.

--- Parametros : 

ID : id del producto en la URL

id de la bodega. 0 = todas las bodegas

?id_bodega=100

 OJO : Se recomienda su uso para casos especificos, teniendo en cuenta la cantidad de items y limite de consultas diarias establecido.

 

  •  GET  /productosStock.findById-DetalleBodegas.json/ID

Devuelve el stock de un producto en especifico detallado por cada bodega

--- Parametros : 

ID : id del producto en la URL

 

 

 

  •  GET  /productosStock.findByCodigoSku.json/SKU100    

Devuelve el stock de un producto en especifico.

--- Parametros : 

codigo producto : El codigo sku del producto en la URL  

id de la bodega : 0 = todas las bodegas

?id_bodega=100

 

  •  GET  /productosStock.findByCodigoBarra.json/CODIGO-BARRA-PRODUCTO 

Devuelve el stock de un producto en especifico.

--- Parametros : 

codigo producto : El codigo de barra del producto en la URL

id de la bodega : 0 = todas las bodegas

?id_bodega=100

 

 

  •  POST  /productosStock.create.json   

Envia un movimiento de stock nuevo hacia OBUMA.

--- Parametros : 

bodega : indicar el id de la bodega en obuma (Si usa esta variable no es necesario usar $codigo_bodega)

codigo_bodega : indicar el codigo de la bodega en obuma (Si usa esta variable no es necesario usar $bodega)

tipo_movimiento : ENTRADA / SALIDA

metodo_movimiento : salida / entrada

referencia_movimiento : es una referencia u observacion

--- Ejemplo : 

{
"fecha": "",
"bodega": "290",
"tipo_movimiento": "ENTRADA",
"metodo_movimiento": "entrada",
"referencia_movimiento":"prueba",

"items": [
{
"producto_id" : 238962,
"cantidad" : 50
}
]
}

 

Aclaraciones : 

No se pueden generar comprobantes de toma de inventario por esta via.

No se pueden generar traspasos automaticos como en el ERP por esta via.

Para traspasos entre bodegas, repetir el mismo movimiento como entrada y como salida en las respectivas bodegas involucradas.

 

 

  •  GET  /empresaBodegas.list.json 

Devuelve lista de bodegas en obuma

--- Parametros : 

 

 


LdM Lista Materiales / Recetas productos :

 

  •  GET  /productosLdM.list.json 

Devuelve lista de todas las LdM

--- Parametros : 

 

 

  •  GET  /productosLdM.findById.json/ID

Devuelve LdM de un producto por el id del producto

--- Parametros : 

ID : id del producto en la URL

 

 

  •  GET  /productosLdM.findByCodigoSku.json/SKU

Devuelve LdM de un producto por el codigo sku

--- Parametros : 

SKU : sku del producto en la URL