Obtener lista de items del carrito

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

---

Entorno

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

Endpoint

GET /carritos/{id}/items

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/carritos/{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 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 del cual se desea obtener los ítems. (ver carritos)

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-123",
      "mercaderia": {
        "id": "ejemplo-uuid-mercaderia-123",
        "codigo_original": "CODIGO ORIGINAL DE EJEMPLO",
        "codigo_fabricante": "CODIGO FABRICANTE DE EJEMPLO",
        "codigo_interno": "01-1234567",
        "codigo_barra": "CODIGO DE BARRAS DE EJEMPLO",
        "descripcion": "DESCRIPCION DE EJEMPLO",
        "descripcion_larga": "DESCRIPCION LARGA DE EJEMPLO",
        "observacion": "OBSERVACION DE EJEMPLO",
        "mercaderia_clasificacion_id": "ejemplo-uuid-clasificacion-mercaderia-123",
        "mercaderia_marca_id": "ejemplo-uuid-marca-123",
        "imagen_url": null,
        "unidades": {
          "unidad_medida_compra": {
            "id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
            "codigo_sifen": "77",
            "representacion": "UNI",
            "descripcion": "Unidad"
          },
          "factor_conversion": 1,
          "unidad_medida_venta": {
            "id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
            "codigo_sifen": "77",
            "representacion": "UNI",
            "descripcion": "Unidad"
          }
        },
        "precios": [
          {
            "precio_unitario": {
              "0": 0,
              "5": 0,
              "10": 30000
            },
            "moneda": "PYG",
            "establecimiento_id": "ejemplo-uuid-establecimiento-123"
          }
        ]
      },
      "servicio": null,
      "precio_unitario": 30000,
      "precio_unitario_original": 30000,
      "total": 30000,
      "cantidad": 1,
      "iva": {
        "iva_tipo": 10,
        "monto": 2727.27272727,
        "afectacion": 100
      }
    }
  ]
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	string	Identificador único del item (UUID).
mercaderia	object	Datos de la mercadería (null si es un servicio).
servicio	object	Datos del servicio (null si es una mercadería).
precio_unitario	number	Precio unitario actual del item.
precio_unitario_original	number	Precio unitario original sin descuentos aplicados.
total	number	Monto total del item (precio_unitario × cantidad).
cantidad	number	Cantidad de unidades del item.
iva	object	Información del IVA aplicado al item.

Estructura del objeto mercadería

Campo	Tipo	Descripción
id	string	Identificador único de la mercadería (UUID).
descripcion	string	Descripción breve de la mercadería.
codigo_original	string	Código original del producto.
codigo_fabricante	string	Código asignado por el fabricante.
codigo_interno	string	Código interno de la mercadería. Ver tabla de código interno
codigo_barra	string	Código de barras del producto.
descripcion_larga	string	Descripción detallada de la mercadería.
observacion	string	Observaciones adicionales sobre la mercadería.
mercaderia_clasificacion_id	string	ID de la clasificación de la mercadería.
mercaderia_marca_id	string	ID de la marca de la mercadería.
imagen_url	string	URL de la imagen del producto (puede ser null si no tiene).
unidades	object	Objeto con información de unidades de compra/venta y factor de conversión.
precios	array	Lista de precios por establecimiento, incluye valores por tipo de IVA y moneda correspondiente

Campos de unidades (mercadería)

Campo	Tipo	Descripción
unidad_medida_compra	object	Datos de la unidad de medida utilizada para comprar la mercadería. (ver unidades-medidas)
factor_conversion	number	Factor de conversión entre la unidad de compra y la de venta (ej.: 1 caja = 12 unidades).
unidad_medida_venta	object	Datos de la unidad de medida utilizada para vender la mercadería. (ver unidades-medidas)

Campos de precios (mercadería)

Cada elemento del arreglo precios posee la siguiente estructura:

Campo	Tipo	Descripción
precio_unitario	object	Objeto con precios por tipo de IVA. Las claves son "0", "5" y "10" representando el porcentaje.
moneda	string	Código de moneda en formato ISO 4217 (ej.: PYG, USD).
establecimiento_id	string	ID del establecimiento al que pertenece este precio.

Estructura del objeto servicio

Campo	Tipo	Descripción
id	string	Identificador único del servicio (UUID).
descripcion	string	Descripción breve del servicio.
descripcion_larga	string	Descripción detallada del servicio.
observacion	string	Observaciones adicionales sobre el servicio.
codigo_interno	string	Código interno del servicio. Ver tabla de código interno
unidad_medida_id	string	ID de la unidad de medida del servicio.
servicio_clasificacion_id	string	ID de la clasificación del servicio.
imagen_url	string	URL de la imagen del servicio (null si no tiene).

Estructura del objeto IVA

Campo	Tipo	Descripción
iva_tipo	number	Tipo de IVA aplicado (5: 5%, 10: 10%, 0: exento).
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.