Alta PSE

Registra en SUNAT al PSE de Facturalo para una empresa, con su Usuario SOL y Clave SOL principal. Es el paso previo a emitir en producción. Usa el token de cuenta (user_sk_…).

POSThttps://api.facturalo.pe/api/v3/empresas/{uuid}/alta-pse

Parámetros del request

Campo

Descripción

uuid

stringrequerido

En la URL. El id de la empresa que devuelve Crear empresa.Ej: afcfac05-b5c2-45c4-90d9-7e6f03c9e863

solUsuario

stringrequerido

Usuario SOL principal de la empresa (no un usuario secundario). Máx. 50 caracteres.Ej: USUARIO1

solClave

stringrequerido

Clave SOL de ese usuario. Se guarda cifrada solo si SUNAT acepta el login, y se usa después para consultar el estado y el CDR de los comprobantes. Nunca se devuelve.Ej: ********

fechaInicio

stringopcional

Fecha de inicio de la autorización, YYYY-MM-DD o DD-MM-YYYY. Mínimo el día siguiente (hora de Lima). Si no la envías, se usa mañana.Ej: 2026-11-06

Timeout

Facturalo automatiza el registro del PSE en SUNAT y responde cuando el trámite termina: la respuesta puede tardar hasta 3 minutos. Configura tu cliente HTTP con un timeout de al menos 210 segundos y no reintentes mientras la primera llamada siga abierta.

Estados

estado	HTTP	Significado
`vinculado`	200	El PSE quedó registrado en SUNAT desde `fechaInicio`.
`ya_vigente`	200	El PSE ya estaba registrado para ese RUC. Es seguro repetir la llamada: si ya está vinculado con la misma fecha, Facturalo no vuelve a entrar a SUNAT.
`credenciales_invalidas`	422	SUNAT rechazó el Usuario SOL o la Clave SOL. Pide al cliente que los revise.
`error_sunat`	502	SUNAT no respondió o el portal falló. Reintenta más tarde o pide al cliente el alta manual.
`captcha_requerido`	502	SUNAT pidió captcha. Pide al cliente el alta manual en SUNAT.

Un 422 sin estado significa datos inválidos (por ejemplo, una fechaInicio de hoy o pasada); el detalle viene en errors.

Si eres un SaaS que factura por tus clientes

Crea la empresa con Crear empresa y guarda el id y los tokens.
Pide a tu cliente su Usuario SOL, su Clave SOL principal y la fecha de inicio en tu propia pantalla, con un texto de consentimiento: está autorizando el uso de su Clave SOL para el alta PSE y para consultar sus comprobantes en SUNAT.
Llama a este endpoint con tu token de cuenta user_sk_….
Si el cliente no quiere compartir su Clave SOL, mándale la guía de Alta PSE (opción C, a mano en SUNAT) y luego contacta a soporte para confirmar la empresa.
No guardes la Clave SOL en tu sistema: Facturalo ya la guarda cifrada.

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/empresas/afcfac05-b5c2-45c4-90d9-7e6f03c9e863/alta-pse", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "solUsuario": "USUARIO1",
    "solClave": "********",
    "fechaInicio": "2026-11-06"
  })
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "estado": "vinculado",
  "message": "PSE vinculado correctamente.",
  "data": {
    "fechaInicio": "06-11-2026",
    "empresa": {
      "id": "afcfac05-b5c2-45c4-90d9-7e6f03c9e863",
      "ruc": "20614694557",
      "nombre": "CONSULTIA DIGITAL S.A.C.",
      "produccion": false,
      "firma": {
        "provider": "qpse",
        "pse": {
          "estado": "vinculado",
          "fechaInicio": "06-11-2026",
          "altaAt": "2026-11-05T15:42:10-05:00",
          "confirmado": true
        }
      },
      "sunat": {
        "solUsuario": "USUARIO1",
        "solConfigurado": true
      }
    }
  }
}