Ajustes de la tienda

Consultar los ajustes

GET /api/v1/ecommerce/settings

No pide token. Conviene pedirlo al arrancar la tienda y guardarlo en caché.

Respuesta

{
  "success": true,
  "message": "Configuraciones del sitio obtenidas de forma correcta.",
  "data": {
    "shipping_types": [],
    "ecommerce_show_only_stock": false,
    "ecommerce_shippings_apply_igv": true,
    "ecommerce_order_type": "ALFABETICO",
    "ecommerce_business_models": [ { "code": "Minorista", "status": true }, { "code": "Mayorista", "status": false } ],
    "ecommerce_status": true,
    "store": {
      "site_name": "Mi Empresa",
      "site_description": "Ropa urbana",
      "whatsapp": "51987654321",
      "address": "Av. Lima 123",
      "social": { "facebook": "", "instagram": "https://instagram.com/miempresa", "tiktok": "", "youtube": "", "linkedin": "", "twitter": "" },
      "banner_style": "columnas",
      "theme": { "primary": "#282828" },
      "state": "publicada",
      "logo": "https://miempresa.ejemplo.com/storage/logo.png",
      "favicon": "https://miempresa.ejemplo.com/storage/uploads/logos/favicon-logo.png",
      "url": "https://miempresa.geor.store"
    }
  }
}

Campo	Qué es
shipping_types	Tipos de envío que ofrece la tienda, en el orden en que la empresa los activó. Cada elemento trae code (DOMICILIO, AGENCIA o TIENDA) y description, por ejemplo { "code": "DOMICILIO", "description": "Envío a domicilio" }. El de AGENCIA puede traer además shipping_cost, el coste fijo de envío por agencia; puede llegar como número o como texto, así que conviértelo antes de usarlo. Si la empresa no activó ninguno, llega []
ecommerce_show_only_stock	Si la tienda solo muestra productos con stock
ecommerce_shippings_apply_igv	Si al coste de envío se le suma el IGV
ecommerce_order_type	Orden por defecto del catálogo: ALFABETICO (por nombre), DEFAULT (de más antiguo a más reciente), DEFAULTDESC (de más reciente a más antiguo), STOCKASC (de menos a más stock), STOCKDESC (de más a menos stock), SKUALFABETICO (por código interno) o ALEATORIO. Llega "" si la empresa nunca lo configuró
ecommerce_business_models	Modelos de venta activos: minorista o mayorista (precios por volumen)
ecommerce_status	Si la tienda está abierta al público
store.site_name	Nombre comercial de la empresa
store.state	Estado de la tienda: borrador, publicada o pausada
store.banner_style	Cómo mostrar los banners: columnas o completo
store.theme.primary	Color principal, en formato #RRGGBB
store.url	Dirección pública de la tienda, o null

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
429	RATE_LIMITED	Se superó el límite de peticiones	Guarda los ajustes en caché y espera lo que indica Retry-After
500	INTERNAL_ERROR	Fallo del servidor	Reporta la reference