Conectar con Nubefact
Para qué sirve
MDSYS Grifos no envía los comprobantes directamente a SUNAT: los envía a Nubefact, tu PSE (Proveedor de Servicios Electrónicos), que los firma, los envía a SUNAT y devuelve la respuesta (aceptado, rechazado), el XML, el CDR y el PDF. Para que el sistema pueda emitir boletas, facturas y notas necesitas registrar una sola vez, por empresa, los datos de tu cuenta de Nubefact.
Mientras la empresa no tenga esta conexión configurada, el POS solo ofrece Ticket (documento interno que no va a SUNAT).
Dónde está
/mi-empresaQuién puede
- Ver y editar la conexión: Permiso
empresa.editar_facturacion. Sin este permiso la pestaña Facturación electrónica no aparece.
Conceptos
- PSE (Nubefact): empresa autorizada por SUNAT que recibe tus comprobantes y los informa a SUNAT. Cada empresa del sistema usa su propia cuenta de Nubefact.
- URL: dirección de tu cuenta en Nubefact (la que te da Nubefact, del tipo
https://api.nubefact.com/…). Solo se aceptan direcciones https denubefact.com. - Token: clave secreta de tu cuenta. Se guarda cifrada; nunca se vuelve a mostrar completa,
solo una máscara con sus últimos 4 caracteres (por ejemplo
••••a9F2). - Modo Demo: los comprobantes van al ambiente de pruebas de Nubefact. No tienen valor tributario y en el listado de comprobantes aparecen con la etiqueta DEMO.
- Modo Producción: los comprobantes van a SUNAT y tienen valor legal.
:::info Numeración demo y producción Los comprobantes emitidos en demo y en producción llevan numeraciones separadas. Al pasar a producción puedes reiniciar el correlativo de cada serie para que el primer comprobante real sea el número 1 (ver Series y correlativos). :::
Paso a paso
Configurar la conexión por primera vez
- Entra a Mi empresaAbre el menú Configuración y pulsa Mi empresa.
- Abre la pestaña «Facturación electrónica»Su descripción dice Conexión con Nubefact (URL, token y modo).
- Escribe la URL de NubefactCopia la URL exacta que te entregó Nubefact para tu cuenta.
- Escribe el tokenPega el token de tu cuenta (entre 20 y 200 caracteres).
- Elige el modoEmpieza en Demo para hacer pruebas. Cuando todo esté correcto, vuelve y cámbialo a Producción.
- Pulsa «Guardar»El cambio queda registrado en la auditoría (el token nunca se registra, solo que cambió).
Cambiar solo el modo o la URL (sin volver a escribir el token)
- Deja el token vacíoDebajo del campo verás Configurado (••••XXXX). Déjalo vacío para conservarlo.
- Cambia lo que necesites y guardaEl token guardado se conserva.
Pasar de demo a producción
- Verifica que la URL y el token son los de producciónNubefact suele dar datos distintos para pruebas y producción.
- Cambia el modo a «Producción» y guardaSi falta la URL o el token, el sistema no te deja: Para pasar a producción configura primero la URL y el token de Nubefact.
- Reinicia la numeración de tus series (opcional)En Series de comprobantes, usa Reiniciar correlativo en cada serie para que la numeración real empiece en 1.
Campos
| Campo | ¿Obligatorio? | Descripción |
|---|---|---|
| URL de NubefactTexto | No | Dirección https de tu cuenta en Nubefact (*.nubefact.com). Solo la ven quienes tienen el permiso de facturación. |
| TokenContraseña | No | Clave secreta de Nubefact, de 20 a 200 caracteres. Vacío = conservar el token ya guardado. |
| ModoLista | No | Demo o Producción. Por defecto, Demo. |
Qué documentos se habilitan
El POS ofrece cada documento solo si se cumplen todas estas condiciones:
| Documento | Requisitos |
|---|---|
| Ticket | Siempre disponible (documento interno, no va a SUNAT). |
| Boleta | Plan con el módulo de comprobantes + Nubefact configurado + una serie de boleta predeterminada y activa para el terminal o la estación. |
| Factura | Igual que la boleta, con una serie de factura predeterminada y activa. |
Ajustes relacionados
En
/ajustes| Ajuste (nombre visible) | Por defecto | Para qué sirve |
|---|---|---|
| Espera máxima del envío inmediato al PSE desde el POS (s) | 4 | Cuánto espera el POS la respuesta de Nubefact antes de imprimir el ticket como "pendiente" (1 a 10 s). |
| Días de crédito por defecto de la cuota única | 30 | Vencimiento de la cuota única de una factura a crédito cuando no se indican cuotas. |
| Exoneración de IGV por Amazonía aprobada por el contador | No | Permite emitir ítems exonerados (afectación 20) en estaciones ubicadas en zona Amazonía. |
| Plazo para comunicar la baja de un comprobante (días) | 7 | Hasta cuántos días después de la emisión se anula por comunicación de baja; después, por nota de crédito. |
| Espera máxima de la aceptación del comprobante de referencia de una nota (h) | 72 | Cuánto espera una nota a que su boleta/factura sea aceptada antes de pasar a error. |
| Emisión del comprobante de percepción en ventas a crédito | Al facturar | Ver Percepciones del IGV. |
| Estrategia ante caída del PSE | Emisión diferida | Qué hacer cuando Nubefact no responde por un tiempo largo (emisión diferida o comprobante físico). |
Mensajes de error frecuentes y qué hacer
| Mensaje | Por qué pasa | Qué hacer |
|---|---|---|
| "La URL debe ser https de Nubefact (*.nubefact.com)." | La dirección no es de Nubefact o no empieza por https://. | Copia la URL exacta de tu panel de Nubefact. |
| "El token debe tener entre 20 y 200 caracteres." | El token está incompleto o pegado con espacios de más. | Vuelve a copiarlo desde Nubefact. |
| "Para pasar a producción configura primero la URL y el token de Nubefact." | Intentas elegir Producción sin datos completos. | Guarda primero la URL y el token. |
:::warning Atención Un comprobante emitido en Demo no existe para SUNAT. No entregues a tus clientes boletas o facturas con la marca DEMO como si fueran reales. :::
Relación con otros módulos
- Series y correlativos: sin series predeterminadas el POS no ofrece boleta ni factura.
- Comprobantes electrónicos: cómo se emite y qué estados recorre cada comprobante.
- Configuración de la empresa: resto de pestañas de Mi empresa y Ajustes avanzados.