Actualizar establecimiento

Actualiza los datos de un establecimiento existente. Todos los campos son opcionales — envía solo lo que deseas cambiar. El logo acepta cualquier formato de imagen (PNG, WEBP, BMP, etc.) y se convierte automáticamente a JPEG con calidad 90 eliminando los metadatos EXIF. Para eliminar el logo envía `"logo": null`.

PATCHhttps://api.facturalo.pe/api/v3/empresas/{empresaUuid}/establecimientos/{uuid}

Parámetros del request

Campo

Descripción

establecimiento

objectrequerido

Campos a actualizar. Todos son opcionales — envía solo lo que quieres cambiar.

nombre

stringopcional

Nuevo nombre del establecimiento.Ej: SUCURSAL NORTE

direccion

stringopcional

Nueva dirección.Ej: Av. Los Pinos 123

departamento

stringopcional

Departamento según RENIEC.Ej: LIMA

provincia

stringopcional

Provincia según RENIEC.Ej: LIMA

distrito

stringopcional

Distrito según RENIEC.Ej: SAN ISIDRO

codigoPostal

stringopcional

Código postal INEI (6 dígitos).Ej: 150027

codigoSunat

string | nullopcional

Código de establecimiento anexo SUNAT de la ficha RUC (4 dígitos). 0000 es el domicilio fiscal y solo lo usa el establecimiento principal. Único dentro de la empresa. Lo usa el PLE de inventarios.Ej: 0001

celular

string | nullopcional

Número de celular (9 dígitos).Ej: 987654321

correo

string | nullopcional

Correo electrónico del establecimiento.Ej: sucursal@empresa.com

logo

string | nullopcional

Logo en base64. Acepta PNG, WEBP, BMP y otros formatos — se convierte automáticamente a JPEG con calidad 90 y sin metadatos EXIF. Envía null para eliminarlo.Ej: data:image/png;base64,iVBORw0KGgo...

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Contenedor principal del resultado.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloCuentaClient } from "@facturalo-pe/node";

const cuenta = new FacturaloCuentaClient({ token: process.env.FACTURALO_USER_TOKEN! });

const result = await cuenta.establecimientos.actualizar("6f1c2a10-6805-11f1-8869-aba1fc00c9df", "6f1c2a10-6805-11f1-8869-aba1fc00c9df", {
  nombre: "SUCURSAL NORTE",
  direccion: "Av. Los Pinos 123",
  departamento: "LIMA",
  provincia: "LIMA",
  distrito: "SAN ISIDRO",
  codigoPostal: "150027",
  celular: "987654321",
  correo: "sucursal@empresa.com",
  logo: "data:image/png;base64,iVBORw0KGgo..."
});
console.log(result);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Establecimiento actualizado correctamente.",
  "data": {
    "establecimiento": {
      "id": "a9b8c7d6-eeee-ffff-0000-111122223333",
      "nombre": "SUCURSAL NORTE",
      "direccion": "Av. Los Pinos 123",
      "departamento": "LIMA",
      "provincia": "LIMA",
      "distrito": "SAN ISIDRO",
      "codigoPostal": "150027",
      "celular": "987654321",
      "correo": "sucursal@empresa.com",
      "logo": "https://api.facturalo.pe/images/establishments/a9b8c7d6-eeee-ffff-0000-111122223333.jpg",
      "esPrincipal": false,
      "creado": "2026-06-14"
    }
  }
}