Ir al contenido
Facturalo

Actualizar empresa

Actualiza los datos de una empresa existente. Todos los campos son opcionales — envía solo lo que deseas cambiar. Para `clientId` y `clientSecret` puedes enviar `null` explícitamente para limpiar el valor.

PATCHhttps://api.facturalo.pe/api/v3/empresas/{uuid}

Parámetros del request

Campo
Descripción
empresa
objectrequerido
Campos a actualizar. Todos son opcionales — envía solo lo que quieres cambiar.
nombre
stringopcional
Nueva razón social.Ej: NUEVO NOMBRE S.A.C.
direccion
stringopcional
Nueva dirección fiscal.Ej: Nueva dirección 123
departamento
stringopcional
Departamento según RENIEC.Ej: LIMA
provincia
stringopcional
Provincia según RENIEC.Ej: LIMA
distrito
stringopcional
Distrito según RENIEC.Ej: MIRAFLORES
codigoPostal
stringopcional
Código postal INEI (6 dígitos).Ej: 150048
logo
string | nullopcional
Logo en base64. Envía null para eliminarlo.
produccion
booleanopcional
Activa o desactiva el entorno de producción.Ej: true
sunat
objectopcional
Credenciales SUNAT a actualizar. Envía solo los campos que deseas cambiar.
solUsuario
stringopcional
Usuario SOL de la empresa.Ej: NUEVO_USER
solClave
stringopcional
Clave SOL de ese usuario. Se guarda sin probarla en SUNAT; para validarla antes de guardar usa Verificar Clave SOL.Ej: nueva_clave
clientId
string | nullopcional
Client ID de la API de SUNAT (guías y SIRE). Al guardarlo junto con el Client Secret se valida con SUNAT; si SUNAT lo rechaza responde 422 y no se guarda. null limpia el valor.
clientSecret
string | nullopcional
Client Secret de la API de SUNAT. null limpia el valor.
detraccion
objectopcional
Detracción por defecto de la empresa. Se aplica a las facturas que envíen documento.detraccion (aunque sea {}): cuenta, porcentaje y tipo salen de aquí y el monto se calcula.
cuenta
string | nullopcional
Cuenta de detracciones del Banco de la Nación.Ej: 00-000-000000
porcentaje
number | nullopcional
Porcentaje de detracción (0–100).Ej: 12
tipo
string | nullopcional
Código del bien o servicio (catálogo 54), p. ej. 037 Demás servicios gravados con el IGV. Lista en GET /catalogos → tiposDetraccion.Ej: 037

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.actualizar("6f1c2a10-6805-11f1-8869-aba1fc00c9df", {
  nombre: "NUEVO NOMBRE S.A.C.",
  direccion: "Nueva dirección 123",
  departamento: "LIMA",
  provincia: "LIMA",
  distrito: "MIRAFLORES",
  codigoPostal: "150048",
  logo: "base64...",
  produccion: true,
  sunat: {
    solUsuario: "NUEVO_USER",
    solClave: "nueva_clave",
    clientId: "client_id_api",
    clientSecret: "client_secret_api"
  }
});
console.log(result);
SDK oficial @facturalo-pe/node · guía en /sdks
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "message": "Empresa actualizada correctamente.",
  "data": {
    "empresa": {
      "id": "afcfac05-b5c2-45c4-90d9-7e6f03c9e863",
      "ruc": "20614694557",
      "nombre": "NUEVO NOMBRE S.A.C.",
      "direccion": "Nueva dirección 123",
      "departamento": "LIMA",
      "provincia": "LIMA",
      "distrito": "MIRAFLORES",
      "codigoPostal": "150048",
      "produccion": true,
      "sunat": {
        "solUsuario": "NUEVO_USER",
        "solConfigurado": true,
        "clientId": "client_id_api",
        "clientSecret": "client_secret_api"
      },
      "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"
    }
  }
}