Obtener lista de items del carrito libre

Obtiene lista de items del carrito libre. Muestra detalles como cantidades, precios, IVA calculados.

---

Entorno

URL base: https://api.guarani.app

Endpoint

GET /carritos/libre/{id}/items

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/carritos/libre/{id}/items" \
  -H "x-api-key: Bearer <access_token>" \
  -H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar {id} con el ID del carrito libre y <access_token> con un token JWT válido proporcionado por el equipo Guarani. Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
id	uuid	Sí	Identificador único del carrito libre del cual se desea obtener los ítems. (ver carritos-libre)

Encabezados de la solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token JWT necesario para autenticar al usuario que realiza la consulta.
Accept	application/json	Define que la respuesta debe devolverse en formato JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": [
    {
      "id": "ejemplo-uuid-item-carrito-libre-123",
      "codigo_interno": "01-ABC1247",
      "descripcion": "DESCRIPCION DE EJEMPLO",
      "cantidad": 1,
      "precio_unitario": 95000,
      "precio_unitario_detalle": {
        "0": 0,
        "5": 0,
        "10": 95000
      },
      "total": 95000,
      "unidad_medida": {
        "id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
        "codigo_sifen": "77",
        "representacion": "UNI",
        "descripcion": "Unidad"
      },
      "iva": {
        "iva_tipo": 10,
        "monto": 8636.36363636,
        "afectacion": 100
      }
    }
  ]
}

Descripción de Campos de Respuesta

El campo data es un array de ítems del carrito libre. Cada elemento tiene la siguiente estructura:

Campos de cada ítem

Campo	Tipo	Descripción
id	uuid	Identificador único del item.
codigo_interno	string	Código interno del item.
descripcion	string	Descripción del item.
cantidad	number	Cantidad de unidades.
precio_unitario	number	Precio unitario del item.
precio_unitario_detalle	object	Precios discriminados por tipo de IVA (0, 5, 10).
total	number	Monto total del item (precio_unitario × cantidad).
unidad_medida	object	Unidad de medida del item.
iva	object	Información del IVA aplicado al item.

Estructura del objeto unidad_medida

Campo	Tipo	Descripción
id	uuid	Identificador único de la unidad de medida.
codigo_sifen	string	Código de la unidad según el catálogo SIFEN.
representacion	string	Representación corta de la unidad (ej: “UNI”).
descripcion	string	Descripción de la unidad de medida.

Estructura del objeto iva

Campo	Tipo	Descripción
iva_tipo	number	Tipo de IVA aplicado (0: exento, 5: 5%, 10: 10%).
monto	number	Monto de IVA calculado para el item.
afectacion	number	Porcentaje de afectación del IVA sobre el precio total.

Recursos adicionales

Para más información sobre posibles errores de carritos, consulta las siguientes secciones: errores.