Obtener establecimiento por su ID

Obtiene información detallada de un establecimiento específico usando su ID único. Incluye datos de ubicación, contacto y ciudad asociada.

---

Entorno

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

Endpoint

GET /establecimientos/{id}

Ejemplo de solicitud

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

Nota: Asegúrate de reemplazar {id} con el identificador único del establecimiento 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í	Identificador único del establecimiento. (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": "077abfe5-45a5-41c6-a82c-88ef8e8a2679",
    "numero_establecimiento": "001",
    "nombre": "Matriz",
    "direccion": "Avda. Principal esq. 1ra",
    "barrio": "Centro",
    "numero_casa": "101",
    "whatsapp": "+595981234567",
    "ciudad": {
      "id": "67ef2e9f-0fa7-43e7-ad5e-87a694e56341",
      "codigo_sifen": "3556",
      "nombre": "SANTA RITA"
    }
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único del establecimiento.
numero_establecimiento	string	Número que identifica al establecimiento.
nombre	string	Nombre del establecimiento.
direccion	string	Dirección física del establecimiento.
barrio	string	Nombre del barrio donde se encuentra el establecimiento.
numero_casa	string	Número de casa o edificio.
whatsapp	string	Número de WhatsApp del establecimiento en formato internacional.
ciudad	objeto	Información de la ciudad donde se ubica el establecimiento.

Campos de ciudad

Campo	Tipo	Descripción
id	uuid	Identificador único de la ciudad.
codigo_sifen	string	Código de la ciudad según el catálogo SIFEN.
nombre	string	Nombre de la ciudad.

Recursos adicionales

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