Listar establecimientos

Retorna todos los establecimientos (sucursales) de la empresa. Usa el `id` del establecimiento en el campo `establecimiento` al emitir documentos para identificar qué sucursal emite.

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

Query

Campo

Descripción

Authorization

header · stringrequerido

Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...

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.listar("6f1c2a10-6805-11f1-8869-aba1fc00c9df");
console.log(result.establecimientos);

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

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Establecimientos obtenidos correctamente.",
  "data": {
    "total": 2,
    "establecimientos": [
      {
        "id": "c1d2e3f4-0000-1111-2222-333344445555",
        "nombre": "SEDE PRINCIPAL",
        "direccion": "Av. Grau 123",
        "departamento": "LAMBAYEQUE",
        "provincia": "LAMBAYEQUE",
        "distrito": "LAMBAYEQUE",
        "codigoPostal": "140301",
        "celular": "979123456",
        "correo": "principal@empresa.com",
        "logo": "https://api.facturalo.pe/storage/images/establishments/c1d2e3f4-0000-1111-2222-333344445555.jpg",
        "esPrincipal": true,
        "creado": "2026-06-01"
      },
      {
        "id": "a9b8c7d6-eeee-ffff-0000-111122223333",
        "nombre": "SUCURSAL NORTE",
        "direccion": "AV. INDUSTRIAL 456",
        "departamento": "LA LIBERTAD",
        "provincia": "TRUJILLO",
        "distrito": "TRUJILLO",
        "codigoPostal": "13001",
        "celular": null,
        "correo": null,
        "logo": null,
        "esPrincipal": false,
        "creado": "2026-06-10"
      }
    ]
  }
}