Ir al contenido
Facturalo

Crear establecimiento

Crea un nuevo establecimiento (sucursal) para la empresa. El `id` retornado se usa en el campo `establecimiento` al emitir documentos para identificar qué sucursal emite.

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

Parámetros del request

Campo
Descripción
establecimiento
objectrequerido
Datos del establecimiento a crear.
nombre
stringrequerido
Nombre del establecimiento. Debe ser único dentro de la empresa.Ej: SUCURSAL NORTE
direccion
stringrequerido
Dirección del establecimiento.Ej: AV. INDUSTRIAL 456
departamento
stringrequerido
Departamento según RENIEC.Ej: LA LIBERTAD
provincia
stringrequerido
Provincia según RENIEC.Ej: TRUJILLO
distrito
stringrequerido
Distrito según RENIEC.Ej: TRUJILLO
codigoPostal
stringrequerido
Código postal INEI (6 dígitos).Ej: 13001
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 del establecimiento (9 dígitos).Ej: 987654321
correo
string | nullopcional
Correo electrónico del establecimiento.Ej: sucursal@empresa.com
logo
string | nullopcional
Logo en base64 (PNG, WEBP, BMP, etc.). Se convierte automáticamente a JPEG con calidad 90 eliminando metadatos EXIF. Sobreescribe el logo de la empresa en el PDF. Envía null para no incluir logo.Ej: data:image/png;base64,iVBORw0KGgo...

Parámetros del response

CampoTipoRequeridoDescripción
dataobjectSí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.crear("6f1c2a10-6805-11f1-8869-aba1fc00c9df", {
  nombre: "SUCURSAL NORTE",
  direccion: "AV. INDUSTRIAL 456",
  departamento: "LA LIBERTAD",
  provincia: "TRUJILLO",
  distrito: "TRUJILLO",
  codigoPostal: "13001",
  celular: "987654321",
  correo: "sucursal@empresa.com",
  logo: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAABmJLR0QA/wD/AP+gvaeTAAAA..."
});
console.log(result.id);
SDK oficial @facturalo-pe/node · guía en /sdks
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "message": "Establecimiento creado exitosamente.",
  "data": {
    "establecimiento": {
      "id": "a9b8c7d6-eeee-ffff-0000-111122223333",
      "nombre": "SUCURSAL NORTE",
      "direccion": "AV. INDUSTRIAL 456",
      "departamento": "LA LIBERTAD",
      "provincia": "TRUJILLO",
      "distrito": "TRUJILLO",
      "codigoPostal": "13001",
      "celular": "987654321",
      "correo": "sucursal@empresa.com",
      "logo": "https://api.facturalo.pe/storage/images/establishments/a9b8c7d6-eeee-ffff-0000-111122223333.jpg",
      "esPrincipal": false,
      "creado": "2026-06-14"
    }
  }
}