Saltar al contenido
Facturador

Editar establecimiento

PUT /api/establishments/{establishment_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Edita un establecimiento. Acepta PUT o PATCH; en ambos casos la edición es parcial: los campos que no envíes conservan su valor actual.

Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.

Campos: los mismos de Crear establecimiento. code no se puede cambiar (si se envía, se ignora). Si cambias description, el almacén del establecimiento se renombra. addresses, si se envía, reemplaza todas las direcciones de partida.

Errores: 404 si no existe; 422 si el nuevo nombre ya existe.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
establishment_id ruta sí 1

Cuerpo

Content-Type: application/json

{
  "description": "SUCURSAL MIRAFLORES 2",
  "telephone": "014445599",
  "trade_address": "AV. LARCO 460 - MIRAFLORES"
}

Respuestas

200 — Editado

{
  "success": true,
  "data": {
    "id": 2,
    "description": "SUCURSAL MIRAFLORES 2",
    "country_id": "PE",
    "department_id": "15",
    "province_id": "1501",
    "district_id": "150122",
    "address": "AV. LARCO 456",
    "addresses": [],
    "telephone": "014445599",
    "email": "miraflores@empresa.com",
    "code": "0001",
    "trade_address": "AV. LARCO 460 - 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": null,
    "has_igv_31556": false,
    "template_pdf": "default",
    "template_ticket_pdf": "default",
    "department": "LIMA",
    "province": "LIMA",
    "district": "MIRAFLORES",
    "warehouse_id": 2
  },
  "message": "Establecimiento actualizado"
}

422 — Nombre repetido

{
  "success": false,
  "message": {
    "description": [
      "description ya ha sido registrado."
    ]
  }
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

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.