# Facturador SUNAT — pasos para dejarlo listo

> Guía operativa para activar la facturación electrónica del **Sistema de Gestión**
> reusando el **motor SUNAT que ya tiene PimPam** (microservicio PHP: firma `.pfx`
> + SOAP + CDR). Caso de uso de Ozado: **facturar servicios (publicidad) con
> detracción del 12%**, + notas de crédito/débito. Fecha: 2026-07-25.

---

## La idea (no duplicar, reusar)

El motor de emisión ya existe en PimPam (correlativo atómico, firma, envío a
SUNAT, CDR, modo local/beta/producción, detracción 12%). **El Sistema NO
reimplementa nada** — arma el documento (ya sabe, con su detracción) y **llama al
mismo microservicio PHP**. Un solo motor, los dos sistemas lo usan.

**Modo de emisión (un switch):**
`local` (sin certificado, solo documento interno) → `beta` (pruebas SUNAT) →
`produccion` (real). Se arranca en local y se sube cuando esté la firma.

---

## PASO 0 — Modo local (ya funciona, sin certificado)

El facturador emite el documento interno: numera serie/correlativo, calcula IGV
(18%) + detracción (12%), y **sincroniza** con `receivables` (CxC) → cliente-hub →
proyecto → cierre mensual / IGV. **Esto se puede usar hoy**, sin nada de SUNAT.

- [ ] Confirmar que "emitir" queda enganchado al flujo del cliente-hub.
- [ ] Series internas definidas (ej. F001).

## PASO 1 — Certificado digital (.pfx) · la FIRMA

Es lo único que bloquea el envío real. Necesitas un **certificado digital `.pfx`**
+ su **clave**.

**Sobre el gratuito (CONFIRMADO 2026-07-25):** el **Certificado Digital Tributario
(CDT) gratuito de SUNAT SÍ sigue vigente.** SUNAT está autorizada **hasta el
31/12/2027** a entregarlo → en 2026 está activo.
- **Es GRATIS, vigencia 3 años**, solo para firmar comprobantes electrónicos.
- **Requisitos:** renta de 3ra categoría · RUC activo/habido (sin suspensión, sin
  domicilio "no habido") · capacidad de ejercicio. (Es para **MYPE** — Ozado
  califica.)
- **Cómo sacarlo (no presencial):** SOL → **Empresas → Comprobantes de Pago →
  Certificado Digital Tributario** → Solicitar (aceptar términos).
- **Para PROBAR (beta):** además, SUNAT tiene un certificado de prueba gratis en su
  documentación SEE — con eso emites en beta desde ya.

**→ Conclusión: Ozado NO gasta en certificado (lo saca gratis por SOL).** Los
facturadores de **~S/18/MES** (recurrente, ~S/216/año por RUC) incluyen el
certificado, pero **ya no hacen falta** teniendo el CDT gratuito + motor propio.
Fuentes: cpe.sunat.gob.pe/certificado-digital · Gestión (ampliación de plazo).

- [ ] Conseguir `.pfx` de prueba (beta) — gratis, hoy.
- [ ] Decidir el de producción: gratuito MYPE (si sigue) vs comprado.

## PASO 2 — Usuario SOL secundario + clave

Para que el microservicio envíe, necesita un **usuario SOL secundario** con permiso
de emisión + su clave (en beta: el usuario de prueba `MODDATOS`).

- [ ] Crear usuario SOL secundario en el portal SUNAT (o usar MODDATOS en beta).

## PASO 3 — Registrar el certificado en SUNAT

En el portal SOL, **registrar/dar de alta el certificado** para emisión electrónica
(esto lo hace el contador o tú). Sin este registro, SUNAT rechaza los comprobantes.

- [ ] Registrar el `.pfx` en SUNAT (solo producción).

## PASO 4 — Cargar la configuración en el facturador

Con los datos anteriores, configurar en el facturador (mismo esquema que PimPam):
- [ ] **Emisor:** RUC + razón social + dirección/ubigeo de Ozado.
- [ ] **Certificado:** subir el `.pfx` + su clave (se guarda cifrada).
- [ ] **SOL:** usuario secundario + clave (cifrada).
- [ ] **Series:** F001 (factura), FC01 (nota crédito), FD01 (nota débito).
- [ ] **Modo:** `beta`.

## PASO 5 — Detracción de publicidad (12%)

- [ ] Código de servicio de detracción: **037 "demás servicios gravados"** (12%)
      — confirmar con el contador que aplica a tu servicio de publicidad.
- [ ] Cuenta de detracciones del **Banco de la Nación** (el Sistema ya trackea
      `detraction_deposit/use`).
- [ ] Verificar el importe mínimo (la detracción aplica sobre operaciones > S/700).

## PASO 6 — Probar en BETA

- [ ] Emitir una **factura de prueba** a SUNAT beta.
- [ ] Verificar que vuelve el **CDR "aceptado"**.
- [ ] Emitir una **nota de crédito** de prueba (anular/corregir).
- [ ] Revisar el XML firmado y el PDF.

## PASO 7 — Pasar a PRODUCCIÓN

- [ ] Cambiar `.pfx` y SOL a los de producción.
- [ ] Cambiar **modo `beta` → `produccion`**.
- [ ] Emitir la primera factura real (monto chico) y verificar CDR.

## PASO 8 — Notas de crédito / débito

El mismo motor las emite (Greenter). Solo faltan las series (FC01/FD01) y el motivo
(anulación, descuento, etc.). Ya cubierto si se hizo el Paso 4.

---

## Requisito técnico pendiente (para el cableado)

- [ ] **Ubicar el microservicio SUNAT** (el `facturador-sunat/index.php` que usa
      PimPam) — no está dentro de `web/`; parece un servicio aparte. Necesito su
      **ruta/URL** para que el Sistema lo llame. Con eso queda el cableado listo.

## Resumen del orden

1. **Hoy:** modo local + sync (sin certificado). ✅ usable ya.
2. **Beta:** cert de prueba (gratis) + MODDATOS → probar emisión + CDR.
3. **Producción:** cert real (verificar gratuito MYPE o comprar) + SOL + registrar
   en SUNAT → switch a producción.

**Costo del certificado: S/0** — el CDT gratuito de SUNAT (vigente hasta 2027) lo
cubre. No gastas nada en la firma.

## El ángulo económico (por qué conviene el propio)

Un facturador SaaS cuesta **~S/18/mes = ~S/216/año por RUC**, recurrente y para
siempre. Con el motor propio (reusando el de PimPam) **+ el certificado gratuito de
SUNAT**, el costo de emitir es **~S/0** — sin mensualidad y sin depender de nadie.

Y hay upside: como Ozado ya tendría el motor, **puede ofrecer facturación a sus
clientes** (los que hoy pagan S/18/mes a terceros) como parte del servicio o un
add-on — otra puerta de ingreso, igual que el llenado. Es el mismo patrón "una
cosa, muchas puertas".
