Saltar al contenido
Facturador

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.