josenobile.github.io

agregar_al_carrito

[EN: Adds items to the page cart by free text or SKU, and is the gateway of the whole surface: the first item in the cart is what unlocks the tax, withdrawal, freight and payment tools.] Agrega referencias al carrito de la página — la puerta de entrada de toda la superficie: con el carrito vacío solo existen buscar_productos, validar_documento_dian y estas dos herramientas, y al entrar la primera referencia aparecen calcular_total_con_iva, consultar_derecho_retracto, cotizar_envio y metodos_de_pago —los rieles piden el destino si la página no lo tiene fijado—. Cada línea lleva `consulta` (texto libre tal como lo pidió el cliente: 'jabón', 'leche', resuelto con la misma búsqueda de buscar_productos, que tolera tildes y mayúsculas) o el `sku` exacto, más su `cantidad`. Si la consulta coincide con varias referencias, esta herramienta NO adivina: devuelve las candidatas y espera que elijas. Devuelve el carrito resultante, ya recalculado. ESTA HERRAMIENTA MODIFICA LA PÁGINA: pinta el carrito, crece la superficie de herramientas y recalcula lo que la página ya había pintado.

Page: /tendero/

Input schema

{
  "type": "object",
  "properties": {
    "lineas": {
      "type": "array",
      "description": "Líneas a agregar, en el orden pedido. Cada una lleva `consulta` o `sku` (uno solo) y su `cantidad`.",
      "items": {
        "type": "object",
        "properties": {
          "consulta": {
            "type": "string",
            "description": "Texto libre, p. ej. 'jabón' o 'leche'. Se resuelve contra el catálogo con la misma búsqueda de buscar_productos. Si cae en varias referencias, la herramienta no adivina: las devuelve como candidatas."
          },
          "sku": {
            "type": "string",
            "description": "SKU exacto, p. ej. 'ASE-JAB-X3'; si se envía, salta la búsqueda por texto. Se consigue con buscar_productos."
          },
          "cantidad": {
            "type": "integer",
            "minimum": 1,
            "description": "Unidades a agregar a esa referencia. Por defecto 1."
          }
        },
        "required": [
          "cantidad"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "lineas"
  ],
  "additionalProperties": false
}