Ir al contenido
Facturalo

Crear empresa

Registra una nueva empresa. Retorna los tokens de demo y producción junto con los webhookSecret. Guárdalos — no se pueden recuperar, solo regenerar.

POSThttps://api.facturalo.pe/api/v3/empresas

Parámetros del request

Campo
Descripción
empresa
objectrequerido
Datos de la empresa a registrar.
ruc
stringrequerido
RUC de 11 dígitos. Debe ser único en el sistema.Ej: 20614694557
nombre
stringrequerido
Razón social de la empresa tal como figura en SUNAT.Ej: CONSULTIA DIGITAL S.A.C.
direccion
stringrequerido
Dirección fiscal completa.Ej: AV. PRINCIPAL 123
departamento
stringrequerido
Departamento según RENIEC.Ej: LAMBAYEQUE
provincia
stringrequerido
Provincia según RENIEC.Ej: LAMBAYEQUE
distrito
stringrequerido
Distrito según RENIEC.Ej: LAMBAYEQUE
codigoPostal
stringrequerido
Código postal INEI (6 dígitos).Ej: 140301
sunat
objectopcional
Opcional. Con firma PSE no necesitas usuario secundario: la Clave SOL primaria se registra después, en el Alta PSE de la consola.
solUsuario
stringopcional
Usuario SOL de la empresa (opcional al crear).Ej: MODDATOS
solClave
stringopcional
Clave SOL de ese usuario (opcional al crear).Ej: moddatos
clientId
string | nullopcional
Client ID de la API de SUNAT. Solo para guías de remisión y SIRE.
clientSecret
string | nullopcional
Client Secret de la API de SUNAT. Solo para guías de remisión y SIRE.
logo
string | nullopcional
Imagen del logo en base64. Aparece en el PDF del comprobante.
produccion
booleanopcional
Si es true, el token de producción queda activo al crear la empresa. Default: false.Ej: false

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.empresas.crear({
  ruc: "20614694557",
  nombre: "CONSULTIA DIGITAL S.A.C.",
  direccion: "AV. PRINCIPAL 123, PISO 4",
  departamento: "LAMBAYEQUE",
  provincia: "LAMBAYEQUE",
  distrito: "LAMBAYEQUE",
  codigoPostal: "140301"
});
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": "Empresa creada exitosamente.",
  "data": {
    "empresa": {
      "id": "afcfac05-b5c2-45c4-90d9-7e6f03c9e863",
      "ruc": "20614694557",
      "nombre": "CONSULTIA DIGITAL S.A.C.",
      "direccion": "AV. PRINCIPAL 123, PISO 4",
      "departamento": "LAMBAYEQUE",
      "provincia": "LAMBAYEQUE",
      "distrito": "LAMBAYEQUE",
      "codigoPostal": "140301",
      "produccion": false,
      "sunat": {
        "solUsuario": null,
        "solConfigurado": false,
        "clientId": "client-id-sunat-oauth2",
        "clientSecret": "client-secret-sunat-oauth2"
      },
      "claves": {
        "demo": {
          "token": "sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "webhookUrl": "https://mi-sistema.com/webhooks/facturalo/demo",
          "webhookSecret": "whsec_test_xxxxxxxxxxxxxxxxxxx"
        },
        "prod": {
          "token": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "webhookUrl": "https://mi-sistema.com/webhooks/facturalo/prod",
          "webhookSecret": "whsec_live_xxxxxxxxxxxxxxxxxxx"
        }
      },
      "creada": "2026-06-14"
    }
  }
}