Comercios
Obtener Comercio
Obtener un comercio con sus relaciones.
GET /api/commerces/:id
Devuelve un único comercio con sus direcciones, usuarios, contactos y roles.
Auth: Requerida — permiso MANAGE_COMMERCES
Parámetros de Ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
id | UUID | ID del comercio |
Ejemplo
curl https://api.reten.ai/api/commerces/880e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"const commerceId = "880e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/commerces/${commerceId}`, {
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
});
const commerce = await response.json();import requests
commerce_id = "880e8400-e29b-41d4-a716-446655440000"
response = requests.get(
f"https://api.reten.ai/api/commerces/{commerce_id}",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
)
commerce = response.json()Respuesta 200 OK
{
"id": "880e8400-e29b-41d4-a716-446655440000",
"name": "Main Street Store",
"externalId": "store-001",
"taxId": "12345678-9",
"isActive": true,
"metadata": {},
"addresses": [
{
"id": "990e8400-e29b-41d4-a716-446655440000",
"street": "123 Main St",
"city": "Santiago",
"latitude": -33.4489,
"longitude": -70.6693,
"isPrimary": true,
"isActive": true
}
],
"users": [
{
"id": "aa0e8400-e29b-41d4-a716-446655440000",
"firstName": "Maria",
"lastName": "Garcia",
"isActive": true,
"roles": [{ "role": "OWNER" }],
"contacts": [
{
"id": "bb0e8400-e29b-41d4-a716-446655440000",
"type": "PHONE",
"value": "+56912345678",
"isPrimary": true,
"isActive": true
}
]
}
]
}Respuestas de Error
| Estado | Descripción |
|---|---|
404 | Comercio no encontrado |