Subir logo del establecimiento
POST /api/establishments/{establishment_id}/logo
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Sube o reemplaza el logo del establecimiento (se imprime en sus comprobantes en lugar del logo de la empresa).
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Se envía como multipart/form-data (no JSON) con el campo:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
file |
archivo | Sí | Imagen jpeg, jpg, png o webp, máximo 1 MB. Se redimensiona a 450 px de ancho y se guarda como JPG. |
No envíes Content-Type manualmente (lo arma el cliente con el boundary).
Errores: 422 si falta el archivo, no es una imagen permitida o supera 1 MB; 404 si el establecimiento no existe.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
establishment_id |
ruta | sí | 1 |
Cuerpo
Content-Type: multipart/form-data
| Campo | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
file |
archivo | sí | Imagen jpeg/jpg/png/webp, máx. 1 MB |
Respuestas
200 — Logo actualizado
{
"success": true,
"data": {
"id": 2,
"description": "SUCURSAL MIRAFLORES",
"country_id": "PE",
"department_id": "15",
"province_id": "1501",
"district_id": "150122",
"address": "AV. LARCO 456",
"addresses": [],
"telephone": "014445566",
"email": "miraflores@empresa.com",
"code": "0001",
"trade_address": "AV. LARCO 456 - MIRAFLORES",
"web_address": "https://empresa.com",
"aditional_information": "Horario: lunes a sábado de 9 a 18 h",
"customer_id": null,
"customer_number": null,
"logo": "https://empresa.dominio/storage/uploads/logos/1762531200.jpg",
"has_igv_31556": false,
"template_pdf": "default",
"template_ticket_pdf": "default",
"department": "LIMA",
"province": "LIMA",
"district": "MIRAFLORES",
"warehouse_id": 2
},
"message": "Logo actualizado"
}
422 — Archivo inválido
{
"success": false,
"message": {
"file": [
"file debe ser un archivo con formato: jpeg, png, jpg, webp."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.