Obtener una lista de los servicios

Lista todos los servicios registrados en el sistema de forma paginada. Permite gestionar y visualizar los servicios.

Entorno

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

Endpoint

GET /servicios?page=1&limit=100

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/servicios?page=1&limit=100" \
  -H "x-api-key: Bearer <access_token>" \
  -H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar <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 consulta

Parámetro	Tipo	Requerido	Descripción
page	integer	No	Página actual (por defecto: 1).
limit	integer	No	Cantidad de registros por página (100).

Encabezados de la solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token JWT válido.
Accept	application/json	Indica que se espera una respuesta en JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": [
    {
      "id": "ejemplo-uuid-servicio-123",
      "descripcion": "DESCRIPCION DE EJEMPLO",
      "descripcion_larga": "DESCRIPCION LARGA DE EJEMPLO",
      "observacion": "OBSERVACION DE EJEMPLO",
      "imagen_url": null,
      "codigo_interno": "02-1234567",
      "unidad_medida": {
        "id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
        "representacion": "UNI",
        "descripcion": "Unidad"
      },
      "servicio_clasificacion": {
        "id": "00000000-0000-4000-8000-000000000000",
        "codigo": "99",
        "nombre": "Sin definir"
      },
      "precio_unitario": {
        "0": 7000,
        "5": 0,
        "10": 0
      },
      "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 del servicio.
codigo_interno	string	Código interno del servicio.
descripcion	string	Descripción corta del servicio.
descripcion_larga	string	Descripción detallada del servicio.
observacion	string	Observaciones adicionales sobre el servicio.
imagen_url	string	URL de la imagen del servicio en Firebase Storage.
unidad_medida	objeto	Información de la unidad de medida del servicio.
servicio_clasificacion	objeto	Información de la clasificación del servicio (null si no aplica).
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 se ofrece el servicio.

Campos de unidad_medida

Campo	Tipo	Descripción
id	uuid	Identificador único de la unidad de medida.
representacion	string	Representación corta de la unidad (ej: “UNI”).
descripcion	string	Descripción de la unidad de medida.

Campos de servicio_clasificacion

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

Campos de precio_unitario

Campo	Tipo	Descripción
0	number	Precio con IVA 0% (exento)
5	number	Precio con IVA 5%
10	number	Precio con IVA 10%

Campos de paginación

Campo	Tipo	Descripción
total_registros	number	Cantidad total de servicios 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.