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

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
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

data
objectrequerido
Contenedor principal del resultado.
establecimiento
objectrequerido
Datos del establecimiento creado.
id
stringrequerido
ID del establecimiento. Úsalo en el campo 'establecimiento' al emitir documentos.
nombre
stringrequerido
Nombre del establecimiento.
direccion
stringrequerido
Dirección del establecimiento.
departamento
stringrequerido
Departamento.
provincia
stringrequerido
Provincia.
distrito
stringrequerido
Distrito.
codigoPostal
stringrequerido
Código postal.
celular
string | nullopcional
Número de celular del establecimiento.
correo
string | nullopcional
Correo electrónico del establecimiento.
logo
string | nullopcional
URL pública del logo en JPEG. null si no se envió logo al crear.
esPrincipal
booleanrequerido
Siempre false para establecimientos recién creados (el principal se asigna automáticamente).
creado
stringrequerido
Fecha de creación en formato YYYY-MM-DD.
Request bodyjson
{
  "establecimiento": {
    "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..."
  }
}
200 — Establecimiento creadojson
{
  "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"
    }
  }
}