{"openapi":"3.1.0","info":{"title":"Altagráfica: catálogo","version":"1.0.0","description":"API de solo lectura del catálogo de impresión digital y soportes publicitarios. Sin autenticación. Precios netos en pesos chilenos (CLP), más IVA.","contact":{"name":"Altagráfica","url":"https://altagrafica.cl/contacto/"}},"servers":[{"url":"https://altagrafica.cl"}],"paths":{"/api/v1/buscar":{"get":{"operationId":"buscarProductos","summary":"Busca productos por nombre, código o categoría","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Palabras a buscar, por ejemplo: roller 80x200"},{"name":"limite","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Resultados","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"productos":{"type":"array","items":{"type":"object","description":"Producto del catálogo. Precios netos en CLP, más IVA.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["integer","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["integer","null"],"description":"Precio unitario para público general"},"precio_a_consultar":{"type":"boolean","description":"true cuando el producto no publica precio: se cotiza"},"en_oferta":{"type":"boolean","description":"true cuando el producto tiene Precio Oferta vigente"},"precio_oferta":{"type":["integer","null"],"description":"Precio Oferta unitario, desde una unidad y sujeto a stock disponible"},"descuento_oferta_pct":{"type":["integer","null"],"description":"Descuento del Precio Oferta sobre el Precio Directo, en %"},"oferta_al":{"type":["string","null"],"description":"Fecha (AAAA-MM-DD) en que se leyó la lista de ofertas"},"precio_embalaje":{"type":["object","null"],"description":"Total de una caja completa: unidades, precio_unitario y total (netos, más IVA)"},"precio_pallet":{"type":["object","null"],"description":"Total de un pallet completo: unidades, precio_unitario y total (netos, más IVA)"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"integer"}}}},"disponibilidad":{"type":"string","enum":["en_stock","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"}}}}}}}}}}}},"/api/v1/productos/{codigo}":{"get":{"operationId":"verProducto","summary":"Un producto por su código","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string"},"description":"Código del producto, por ejemplo ROLEST080"}],"responses":{"200":{"description":"Producto","content":{"application/json":{"schema":{"type":"object","description":"Producto del catálogo. Precios netos en CLP, más IVA.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["integer","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["integer","null"],"description":"Precio unitario para público general"},"precio_a_consultar":{"type":"boolean","description":"true cuando el producto no publica precio: se cotiza"},"en_oferta":{"type":"boolean","description":"true cuando el producto tiene Precio Oferta vigente"},"precio_oferta":{"type":["integer","null"],"description":"Precio Oferta unitario, desde una unidad y sujeto a stock disponible"},"descuento_oferta_pct":{"type":["integer","null"],"description":"Descuento del Precio Oferta sobre el Precio Directo, en %"},"oferta_al":{"type":["string","null"],"description":"Fecha (AAAA-MM-DD) en que se leyó la lista de ofertas"},"precio_embalaje":{"type":["object","null"],"description":"Total de una caja completa: unidades, precio_unitario y total (netos, más IVA)"},"precio_pallet":{"type":["object","null"],"description":"Total de un pallet completo: unidades, precio_unitario y total (netos, más IVA)"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"integer"}}}},"disponibilidad":{"type":"string","enum":["en_stock","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"}}}}}},"404":{"description":"No existe"}}}},"/api/v1/ofertas":{"get":{"operationId":"listarOfertas","summary":"Productos con Precio Oferta vigente","responses":{"200":{"description":"Ofertas","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"lista_al":{"type":["string","null"]},"productos":{"type":"array","items":{"type":"object","description":"Producto del catálogo. Precios netos en CLP, más IVA.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["integer","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["integer","null"],"description":"Precio unitario para público general"},"precio_a_consultar":{"type":"boolean","description":"true cuando el producto no publica precio: se cotiza"},"en_oferta":{"type":"boolean","description":"true cuando el producto tiene Precio Oferta vigente"},"precio_oferta":{"type":["integer","null"],"description":"Precio Oferta unitario, desde una unidad y sujeto a stock disponible"},"descuento_oferta_pct":{"type":["integer","null"],"description":"Descuento del Precio Oferta sobre el Precio Directo, en %"},"oferta_al":{"type":["string","null"],"description":"Fecha (AAAA-MM-DD) en que se leyó la lista de ofertas"},"precio_embalaje":{"type":["object","null"],"description":"Total de una caja completa: unidades, precio_unitario y total (netos, más IVA)"},"precio_pallet":{"type":["object","null"],"description":"Total de un pallet completo: unidades, precio_unitario y total (netos, más IVA)"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"integer"}}}},"disponibilidad":{"type":"string","enum":["en_stock","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"}}}}}}}}}}}},"/api/v1/categorias":{"get":{"operationId":"listarCategorias","summary":"Árbol de categorías del catálogo","responses":{"200":{"description":"Categorías","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}