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

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
objectrequerido
Credenciales de acceso al servicio SUNAT.
solUsuario
stringrequerido
Usuario secundario SOL de SUNAT (no el RUC principal).Ej: MODDATOS
solClave
stringrequerido
Clave del usuario secundario SOL de SUNAT.Ej: moddatos
clientId
string | nullopcional
Client ID OAuth2 SUNAT (PASSWRD opcional).
clientSecret
string | nullopcional
Client Secret OAuth2 SUNAT.
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

data
objectrequerido
Contenedor principal del resultado.
empresa
objectrequerido
Datos de la empresa creada.
id
stringrequerido
ID de la empresa.
ruc
stringrequerido
RUC de 11 dígitos.
nombre
stringrequerido
Razón social.
direccion
stringrequerido
Dirección fiscal.
departamento
stringrequerido
Departamento.
provincia
stringrequerido
Provincia.
distrito
stringrequerido
Distrito.
codigoPostal
stringrequerido
Código postal.
produccion
booleanrequerido
true si el entorno de producción está habilitado.
sunat
objectrequerido
Credenciales SOL registradas.
solUsuario
stringrequerido
Usuario secundario SOL de SUNAT registrado.
solClave
stringrequerido
Clave del usuario secundario SOL registrada.
clientId
string | nullopcional
Client ID OAuth2 SUNAT.
clientSecret
string | nullopcional
Client Secret OAuth2 SUNAT.
claves
objectrequerido
Tokens y webhooks por entorno. Guárdalos — no se pueden recuperar, solo regenerar.
demo
objectrequerido
Credenciales del entorno de pruebas.
token
stringrequerido
Token de autenticación demo. Prefijo: "sk_test_".
webhookUrl
string | nullopcional
URL del webhook demo. null si no está configurada.
webhookSecret
stringrequerido
Secreto para verificar la firma del webhook demo. Prefijo: "whsec_test_".
prod
objectrequerido
Credenciales del entorno de producción.
token
stringrequerido
Token de autenticación producción. Prefijo: "sk_live_".
webhookUrl
string | nullopcional
URL del webhook producción. null si no está configurada.
webhookSecret
stringrequerido
Secreto para verificar la firma del webhook producción. Prefijo: "whsec_live_".
creada
stringrequerido
Fecha de creación en formato YYYY-MM-DD.
Request bodyjson
{
  "empresa": {
    "ruc": "20614694557",
    "nombre": "CONSULTIA DIGITAL S.A.C.",
    "direccion": "AV. PRINCIPAL 123, PISO 4",
    "departamento": "LAMBAYEQUE",
    "provincia": "LAMBAYEQUE",
    "distrito": "LAMBAYEQUE",
    "codigoPostal": "140301",
    "sunat": {
      "solUsuario": "MODDATOS",
      "solClave": "moddatos",
      "clientId": null,
      "clientSecret": null
    }
  }
}
200 — Empresa creadajson
{
  "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": "MODDATOS",
        "solClave": "moddatos",
        "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"
    }
  }
}