Obtener items del carrito

Obtiene item por su id. Muestra detalles como cantidades, precios, IVA calculados.

---

Entorno

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

Endpoint

GET /carritos/items/{id}

Ejemplo de solicitud

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

Nota: Asegúrate de reemplazar {id} con el ID del item 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 item del cual deseas obtener. (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).
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	string	Descripción breve de la mercadería.
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 (null si no tiene).
unidades	object	Objeto con información de las unidades de medida de compra y venta.
precios	array	Array de objetos con información de precios por establecimiento.

Estructura del objeto unidades (mercadería)

Campo	Tipo	Descripción
unidad_medida_compra	object	Objeto con información de la unidad de medida para compras (ver unidades-medidas).
factor_conversion	number	Factor de conversión entre unidad de compra y venta.
unidad_medida_venta	object	Objeto con información de la unidad de medida para ventas (ver unidades-medidas).

Estructura del objeto precios (mercadería)

Campo	Tipo	Descripción
precio_unitario	object	Objeto con precios por tipo de IVA. Las claves son “0”, “5”, “10” representando el porcentaje de IVA.
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 de la empresa para el servicio. Ver tabla de código interno
servicio_clasificacion_id	string	ID de la clasificación del servicio.
imagen_url	string	URL de la imagen del servicio (null si no tiene).
unidad_medida	object	Objeto con información de la unidad de medida del servicio (ver unidades-medidas).
precio_unitario	object	Objeto con precios por tipo de IVA. Las claves son “0”, “5”, “10” representando el porcentaje de IVA.
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 unidad_medida

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

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.