Gestión — Conexión con Nubefact
Configura las credenciales (URL + token + código único) para emitir boletas y facturas a través de Nubefact como OSE.
La pantalla Conexión con Nubefact es donde configuras (o actualizas) tus credenciales de Nubefact para que MYPES.pe pueda emitir tus boletas y facturas electrónicas a través de ese OSE (Operador de Servicios Electrónicos). Es la alternativa a usar Greenter directo: en lugar de firmar tú con tu propio certificado, Nubefact firma por ti y se encarga del envío a SUNAT — tú solo pagas el servicio mensual.
⚠️ Esta pantalla solo aplica si tu proveedor electrónico es Nubefact. Si elegiste Greenter directo en el onboarding, esta pantalla no está disponible — usa Certificado digital en su lugar.
Los 3 datos que necesitas son los que Nubefact te entrega al crear tu cuenta en su plataforma:
- URL del API: la dirección donde el sistema envía las requests (típicamente
https://api.nubefact.com/api/v1/invoicepara producción). - Token de autenticación: una cadena larga que identifica tu cuenta. Es secreto — Nubefact te lo da una sola vez, guárdalo seguro.
- Código único de cuenta: identificador adicional vinculado a tu RUC dentro de Nubefact.
El sistema NO te muestra el token actual una vez guardado (se encripta en BD por seguridad). Si necesitas verificar el token, copia uno nuevo desde el panel de Nubefact y reemplázalo aquí.
Manual completo
¿Por qué usar Nubefact en lugar de Greenter directo?
| Aspecto | Nubefact (OSE) | Greenter directo |
|---|---|---|
| Certificado digital | NO necesitas | SÍ — compras un PFX anual (S/30-80) |
| Costo mensual | S/30-50 según volumen | S/0 (pero compras cert anual) |
| Mantenimiento | Nubefact se encarga de updates SUNAT | Tu MYPE tiene que actualizar el cert anualmente |
| Configuración inicial | URL + token + código (5 min) | Cert PFX + validar con SUNAT (más complejo) |
| Velocidad emisión | ~3-5 segundos (extra hop) | ~1-2 segundos (directo) |
| Recuperación de PDFs | Cloud de Nubefact (links permanentes) | Storage local del server |
Recomendación: para la mayoría de MYPEs pequeños, Nubefact es más simple y vale la pena los S/30-50/mes. Greenter directo conviene cuando tu volumen es alto (cientos de comprobantes/día) y los costos mensuales superan al PFX anual.
Campos del form
| Campo | Validación | Notas |
|---|---|---|
| URL del API | Requerido, URL válida, máx 500 chars | Ej: https://api.nubefact.com/api/v1/invoice |
| Token | Opcional (en update), máx 500 chars | Si lo dejas vacío al guardar, conserva el token anterior. |
| Código único de cuenta | Opcional, máx 100 chars | Identificador interno de Nubefact. |
Acción «Guardar»
Al hacer submit:
- Validación local: URL con formato correcto.
- Actualización parcial: solo se actualizan los campos que enviaste. El token vacío NO sobreescribe.
- Encriptación: el token se guarda encriptado.
- Prueba de conexión opcional: el sistema NO verifica la conexión con Nubefact automáticamente. Para confirmar que funciona, emite tu primera boleta de prueba después de guardar.
Casos comunes
«¿Dónde consigo el token de Nubefact?»
Inicia sesión en https://www.nubefact.com/ con tu cuenta → ve a Configuración → API → genera o copia tu token. El token tiene un formato como abc123... con ~40-60 caracteres. Cópialo completo sin espacios.
«Cambié de cuenta Nubefact y mi token nuevo no funciona» Verifica:
- URL correcta: producción es
api.nubefact.com/api/v1/invoice. Si pegaste otra URL (homologación, dev), no va a funcionar. - Token completo: a veces al copiar quedan caracteres invisibles al final. Vuelve a copiar.
- Código único correcto: si tu cuenta Nubefact maneja múltiples RUCs, asegúrate de copiar el código del RUC correcto.
«Quiero rotar el token por seguridad» Genera un nuevo token desde Nubefact → invalida el anterior → ven aquí y pega el nuevo. El sistema lo encripta y reemplaza inmediatamente.
«¿Qué pasa si Nubefact se cae?» SUNAT recibe los comprobantes a través de Nubefact. Si Nubefact tiene una caída, los comprobantes quedan pendientes de envío. Cuando Nubefact se recupera, el sistema reintenta automáticamente. No pierdes nada — solo demora.
«Quiero pasar de Nubefact a Greenter directo» Cambia el provider desde el wizard de onboarding (link «Editar empresa» en Dashboard). Después tienes que cargar un certificado PFX desde Certificado digital. Los comprobantes ya emitidos por Nubefact siguen en su cloud — los nuevos van por Greenter.
«Mi banner dice "Nubefact NO configurado" pero sí ingresé los datos» Probablemente el guardado falló (validación, conexión). Verifica el banner rojo de error abajo del form. Si todo se ve OK pero sigue diciendo no configurado, refresca la página y verifica que los campos se hayan poblado (URL debe verse, token no se muestra por seguridad).
Cosas que NO puedes hacer
- Ver el token actual en el form (por seguridad solo se muestra placeholder).
- Validar el token sin emitir un comprobante. No hay botón de «test connection» — el primer emit confirma.
- Tener 2 cuentas Nubefact simultáneas para el mismo RUC. Si necesitas migrar, cambia los datos aquí y los comprobantes nuevos van por la cuenta nueva.
- Recuperar tu token si lo perdiste. Genera uno nuevo desde Nubefact (el anterior queda inválido).
- Configurar Nubefact si tu proveedor electrónico es Greenter directo. La pantalla no está disponible en ese caso. Cambia primero el proveedor.
- Emitir contra el ambiente de homologación de Nubefact desde aquí. Solo producción. Para testing usa el sandbox de Nubefact directamente.