Obtener mercadería por su ID

Obtiene información detallada de una mercadería específica usando su ID único. Permite consultar los datos de la mercadería.

---

Entorno

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

Endpoint

GET /mercaderias/{id}

Ejemplo de solicitud

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

Nota: Asegúrate de reemplazar {id} con el identificador único de la mercaderia 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	Requerido	Descripción
id	uuid	Sí	ID de la mercaderia para obtener sus datos. (ver mercaderias)

Encabezados de la Solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.
Accept	application/json	Indica que la respuesta debe devolverse en formato JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": {
    "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",
    "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"
      }
    },
    "marca": {
      "id": "00000000-0000-4000-8000-000000000000",
      "nombre": "Sin definir"
    },
    "clasificacion": {
      "id": "00000000-0000-4000-8000-000000000000",
      "codigo": "99",
      "nombre": "Sin definir"
    },
    "precios": [
      {
        "precio_unitario": {
          "0": 7000,
          "5": 0,
          "10": 3300
        },
        "moneda": "PYG",
        "establecimiento_id": "ejemplo-uuid-establecimiento-123"
      }
    ]
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único de la mercadería.
codigo_interno	string	Código interno de la mercadería.
codigo_original	string	Código original del proveedor o fabricante.
codigo_fabricante	string	Código asignado por el fabricante.
codigo_barra	string	Código de barras del producto.
descripcion	string	Descripción corta de la mercadería.
descripcion_larga	string	Descripción detallada de la mercadería.
observacion	string	Observaciones adicionales sobre la mercadería.
imagen_url	string	URL de la imagen del producto en Firebase Storage.
unidades	objeto	Información de unidades de medida y factor de conversión.
marca	objeto	Información de la marca de la mercadería.
clasificacion	objeto	Información de la clasificación de la mercadería.
precios	array	Lista de precios por establecimiento y moneda.

Campos de unidades

Campo	Tipo	Descripción
unidad_medida_compra	objeto	Unidad de medida para compras.
factor_conversion	number	Factor de conversión entre unidad de compra y venta.
unidad_medida_venta	objeto	Unidad de medida para ventas.

Campos de unidad de 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.

Campos de marca

Campo	Tipo	Descripción
id	uuid	Identificador único de la marca.
nombre	string	Nombre de la marca.

Campos de clasificacion

Campo	Tipo	Descripción
id	uuid	Identificador único de la clasificación.
codigo	string	Código de la clasificación.
nombre	string	Nombre de la clasificación.

Campos de precios

Campo	Tipo	Descripción
precio_unitario	objeto	Precios según tipo de IVA (0%, 5%, 10%).
moneda	string	Código de moneda (ej: “PYG”, “USD”).
establecimiento_id	uuid	ID del establecimiento donde aplica el precio.

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores.