✔️ Paso 1 - Registra los datos de tu empresa

Registra los datos de tu empresa llamando al endpoint POST /companies de la API de Alanube.

Endpoint

POST /companies

Servidores

Ambiente	URL
Producción	`https://api.alanube.co/per/v1/`
Sandbox	`https://sandbox-api.alanube.co/per/v1/`

Autenticación: Bearer token (header Authorization: Bearer <token>).

Campos obligatorios

Campo	Tipo	Descripción
`name`	string	Nombre / Razón social de la empresa.
`ruc`	string	Registro Único de Contribuyentes (RUC).
`ose`	boolean	Indica si la empresa factura a través del OSE EFact (`true`) o directamente con SUNAT (`false`). Aplica a todos los comprobantes excepto guías de remisión, que siempre se emiten directamente con SUNAT.

Campos opcionales

Campo	Tipo	Descripción
`certificate`	object	Certificado digital de la empresa: `extension` (`p12`), `password` y `content` (archivo en base64).
`webhooks`	object	Webhooks de notificación: `emissionDocumentFinished` y `cancellationDocumentFinished` (cada uno con `url`, `headers` opcionales y `status`).
`logo`	string	Imagen del logo en base64 para los PDF (máx. 150 KB, formato recomendado PNG).
`emails`	object	Configuración de envío de correos: `active` (booleano) y `headers` (texto al final del correo).

Ejemplo de solicitud

{
  "name": "Mi compañía",
  "ruc": "20123456789",
  "ose": true
}

Respuesta exitosa (201)

{
  "id": "01GFHNFXCWAWA7KNKY6F2BX5EK",
  "name": "Mi compañía",
  "ruc": "20123456789",
  "ose": true,
  "isActive": true
}

🔗 Paso 2 - ¿Cómo configurar tu PSE?

Un PSE (Proveedor de Servicios Electrónicos) es un intermediario autorizado por la SUNAT que facilita la emisión de comprobantes electrónicos. En Alanube, la habilitación se realiza a través del proveedor Alanube, operador autorizado por la SUNAT.

📍 Ten a mano tu RUC o DNI y la Clave SOL para ingresar a la plataforma de SUNAT.

Ingresa a SUNAT > Operaciones en línea (SOL) > Ubica Mis trámites y consultas > Ingresar.
Elige la opción con la que deseas ingresar al sistema (DNI o RUC) > Coloca tus datos > Marca la casilla de seguridad > Iniciar sesión > Empresa.
Haz clic en Comprobantes de pago > Factura electrónica > Comunicación y tercerización con PSE > Altas/Bajas de PSE > Alta servicio.
Haz clic en los 3 puntos y elige a Alanube del listado > Ingresa una fecha de inicio > Aceptar.

✅ Paso 3 - ¿Cómo configurar tu OSE?

Un OSE (Operador de Servicios Electrónicos) es la entidad responsable de emitir comprobantes electrónicos validados ante la SUNAT. Al vincular EFAC a tu OSE podrás emitir, validar y enviar comprobantes a la SUNAT de forma automática.

Ingresa a SUNAT > Operaciones en línea (SOL) > Ubica Mis trámites y consultas > Ingresar.
Elige la opción con la que deseas ingresar al sistema (DNI o RUC) > Coloca tus datos > Marca la casilla de seguridad > Iniciar sesión > Empresa.
Haz clic en Comprobantes de pago > Sistema de emisión electrónica - OSE. A continuación, elige Afiliación y vinculación SEE OSE > Registrar vinculación.
En la ventana emergente haz clic en Aceptar > Agregar OSE > Haz clic en los 3 puntos > EFAC del listado.
Ingresa una fecha de inicio > Aceptar.

📢
Importante

Luego de vincular el OSE y PSE, debes esperar 24 horas para empezar a emitir facturas electrónicas.

El alta de tu PSE y OSE deben hacerse en la misma fecha.

Si realizas este proceso en días no hábiles (sábado o domingo), el cambio será procesado el lunes siguiente.