Obtener mercaderías por establecimiento

Obtiene las mercaderías disponibles en un establecimiento específico. Permite consultar el catálogo de esa sucursal.

---

Entorno

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

Endpoint

GET /mercaderias/establecimiento/{id}

Ejemplo de solicitud

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

Nota: Asegúrate de reemplazar {id} con el ID del establecimiento al que deseas consultar y <access_token> con un token JWT válido proporcionado por el equipo Guarani. Importante:
Este endpoint requiere autenticación. Debes incluir un token de acceso válido en el encabezado x-api-key. Sin este token, la solicitud será rechazada con un error de autorización.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	uuid	Sí	ID del establecimiento para obtener mercaderías. (ver establecimientos)

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",
      "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"
      },
      "precio": {
        "precio_unitario": {
          "0": 7000,
          "5": 0,
          "10": 3300
        },
        "moneda": "PYG",
        "establecimiento_id": "ejemplo-uuid-establecimiento-123"
      }
    }
  ],
  "pagination": {
    "total_registros": 1,
    "pagina": 1,
    "total_paginas": 1
  }
}

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.
precio	objeto	Información del precio del producto.

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 precio

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.

Campos de paginación

Campo	Tipo	Descripción
total_registros	number	Cantidad total de mercaderías en el sistema.
pagina	number	Número de página actual.
total_paginas	number	Cantidad total de páginas disponibles.

Recursos adicionales

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