{"openapi":"3.1.0","info":{"title":"Soporte Publicitario: catálogo global","version":"1.0.0","description":"API de solo lectura del catálogo global de soportes publicitarios. Sin autenticación. Un solo catálogo; el parámetro pais elige la moneda.","contact":{"name":"Soporte Publicitario","url":"https://soportepublicitario.com/contacto/","email":"ventas@soportepublicitario.cl"}},"servers":[{"url":"https://soportepublicitario.com"}],"paths":{"/api/v1/paises":{"get":{"operationId":"listarPaises","summary":"Países del sitio: moneda, impuesto, tipo de cambio y dirección de cada uno","responses":{"200":{"description":"Países","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/buscar":{"get":{"operationId":"buscarProductos","summary":"Busca productos por nombre (en español), 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}},{"name":"pais","in":"query","schema":{"type":"string"},"description":"Código de carpeta del país (pe, nz, mx...). Sin él, precios en USD. Lista en /api/v1/paises"}],"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 y referenciales en la moneda del país pedido: la lista de Chile convertida. No incluyen impuestos, flete ni importación. El stock está en Santiago de Chile.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"pais":{"type":["string","null"]},"moneda":{"type":"string"},"impuesto_no_incluido":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["number","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["number","null"],"description":"Precio unitario de lista"},"precio_texto":{"type":["string","null"],"description":"El precio más bajo publicado por unidad, escrito en la moneda del país"},"precio_a_consultar":{"type":"boolean","description":"true cuando el producto no publica precio: se cotiza"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"number"}}}},"precio_embalaje":{"type":["object","null"]},"precio_pallet":{"type":["object","null"]},"disponibilidad":{"type":"string","enum":["en_stock_en_chile","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"},"en_chile":{"type":["string","null"],"description":"La misma ficha en el sitio de Chile"}}}}}}}}}}}},"/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"},{"name":"pais","in":"query","schema":{"type":"string"},"description":"Código de carpeta del país (pe, nz, mx...). Sin él, precios en USD. Lista en /api/v1/paises"}],"responses":{"200":{"description":"Producto","content":{"application/json":{"schema":{"type":"object","description":"Producto del catálogo. Precios netos y referenciales en la moneda del país pedido: la lista de Chile convertida. No incluyen impuestos, flete ni importación. El stock está en Santiago de Chile.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"pais":{"type":["string","null"]},"moneda":{"type":"string"},"impuesto_no_incluido":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["number","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["number","null"],"description":"Precio unitario de lista"},"precio_texto":{"type":["string","null"],"description":"El precio más bajo publicado por unidad, escrito en la moneda del país"},"precio_a_consultar":{"type":"boolean","description":"true cuando el producto no publica precio: se cotiza"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"number"}}}},"precio_embalaje":{"type":["object","null"]},"precio_pallet":{"type":["object","null"]},"disponibilidad":{"type":"string","enum":["en_stock_en_chile","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"},"en_chile":{"type":["string","null"],"description":"La misma ficha en el sitio de Chile"}}}}}},"404":{"description":"No existe"}}}},"/api/v1/categorias":{"get":{"operationId":"listarCategorias","summary":"Árbol de categorías del catálogo","parameters":[{"name":"pais","in":"query","schema":{"type":"string"},"description":"Código de carpeta del país (pe, nz, mx...). Sin él, precios en USD. Lista en /api/v1/paises"}],"responses":{"200":{"description":"Categorías","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}