Obtener item de nota de crédito por ID

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

---

Entorno

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

Endpoint

GET /notas/credito/items/{id}

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/notas/credito/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 notas de crédito)

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": "ad6c3e77-cb75-4437-8fc6-eaa825499463",
    "mercaderia": {
      "id": "34698e09-da6c-4585-bee4-709030c9c9f0",
      "codigo_interno": "01-2504208",
      "codigo_original": "PROD001",
      "codigo_fabricante": "FAB123",
      "codigo_barra": "7891234567890",
      "descripcion": "Laptop HP Pavilion",
      "descripcion_larga": "Laptop HP Pavilion con procesador Intel i5, 8GB RAM y 256GB SSD",
      "observacion": "Garantía 2 años",
      "mercaderia_clasificacion_id": "00a1cb7f-c0ce-40ce-8785-5e4b7d15ecb4",
      "mercaderia_marca_id": "6311fca0-f309-4064-b4f6-22fef56647aa",
      "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": 100000,
            "5": 0,
            "10": 0
          },
          "moneda": "PYG",
          "establecimiento_id": "06dabe45-cbb5-425e-b1c3-13a67d7114e0"
        }
      ]
    },
    "servicio": null,
    "precio_unitario": 50000,
    "precio_unitario_original": 50000,
    "total": 50000,
    "cantidad": 1,
    "iva": {
      "iva_tipo": 10,
      "importe_gravado": 181818.18181818,
      "monto": 18181.81818182,
      "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_interno	string	Código interno de la empresa.
codigo_original	string	Código original del producto.
codigo_fabricante	string	Código asignado por el fabricante.
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.
factor_conversion	number	Factor de conversión entre unidades de compra y venta.
unidad_medida_compra	object	Objeto con información de la unidad de medida para compra.
unidad_medida_venta	object	Objeto con información de la unidad de medida para venta.
mercaderia_marca_id	string	ID de la marca de la mercadería.
mercaderia_clasificacion_id	string	ID de la clasificación de la mercadería.
imagen_url	string	URL de la imagen del producto (null si no tiene).

Estructura del objeto servicio

Campo	Tipo	Descripción
id	string	Identificador único del servicio (UUID).
codigo_interno	string	Código interno de la empresa para el servicio.
descripcion	string	Descripción breve del servicio.
descripcion_larga	string	Descripción detallada del servicio.
observacion	string	Observaciones adicionales sobre el servicio.
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).
importe_gravado	number	Importe gravado por el IVA.
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 notas de crédito, consulta las siguientes secciones: errores.