Sunat CLI

sunat-cli keychain set SUNAT_PASSWORD
sunat-cli login --ruc 10XXXXXXXXX --user MYUSER
sunat-cli login --nueva-plataforma --ruc 10XXXXXXXXX --user MYUSER
sunat-cli whoami

sunat-cli keychain set CPE_CERT_PASSWORD
sunat-cli keychain set CPE_SOL_PASSWORD
sunat-cli keychain set SUNAT_API_CLIENT_SECRET
sunat-cli keychain list
sunat-cli keychain clear CPE_CERT_PASSWORD

# Build and reconcile one RHE draft in SUNAT
sunat-cli rhe emit --params '{
  "empresa": "Cliente Ejemplo",
  "tipoDoc": "SIN DOCUMENTO",
  "descripcion": "Servicios de desarrollo de software",
  "monto": 6700,
  "moneda": "PEN",
  "medioPago": "TRANSFERENCIA"
}' --preview-only

# Validate locally without opening SUNAT
sunat-cli rhe emit --params '...' --dry-run

# Reach SUNAT's server preview by direct HTTP and render it for review
sunat-cli rhe emit --params '...' --preview-only

# Emit only after visually checking the preview; XML and PDF go to Downloads/sunat-rhe
sunat-cli rhe emit --params '...' --yes --live-sunat

# Choose another private artifact directory
sunat-cli rhe emit --params '...' --yes --live-sunat --artifacts-dir /absolute/path/rhe

# Validate a CSV batch locally
sunat-cli rhe emit --batch recibos.csv --dry-run

# Single month
sunat-cli f616 declare --params '{
  "periodo": "2026-03"
}'

# Preview
sunat-cli f616 declare --params '...' --dry-run

# Batch multiple months
sunat-cli f616 declare --batch --months "2025-03..2026-02"

# Check status
sunat-cli f616 status

# Driver introspection
sunat-cli cpe doctor              # Health check active driver (default: mock)
sunat-cli cpe info                # Driver info (name, mode, version)
sunat-cli cpe --driver mock doctor

# Schemas
sunat-cli schema cpe-factura
sunat-cli schema cpe-boleta
sunat-cli schema cpe-nota-credito
sunat-cli schema cpe-gre

# Preview a Factura (T0, no submit)
sunat-cli cpe factura preview --params '{
  "receptor": {"tipoDoc":"6","numDoc":"20123456789","rznSocial":"ACME SAC"},
  "items": [{"codigo":"P001","descripcion":"Consultoria","cantidad":1,"unidad":"NIU","valorUnitario":1000,"igvPct":18}],
  "totales": {"valorVenta":1000,"igv":180,"total":1180},
  "serie": "F001",
  "numero": 1234
}'

# Emit (T2, requires --yes)
sunat-cli cpe factura emit --params '...' --yes
sunat-cli cpe boleta emit --params '...' --yes
sunat-cli cpe nc emit --params '...' --yes

# Individual boleta (>= S/700) — same flow as factura
sunat-cli cpe boleta emit --params '{...}' --yes

# Boleta < S/700 — queue first
sunat-cli cpe boleta queue --params '{...}'
sunat-cli cpe boleta queue:list                   # list all pending dates
sunat-cli cpe boleta queue:list --fecha 2026-04-29 # entries for one date

# At end of day (or next day, plazo 7 days), send the resumen
sunat-cli cpe --driver sunat-direct resumen send --fecha 2026-04-29 --correlativo 1 --yes --wait
# Returns ticket; --wait polls getStatus until CDR (max 5min)

# Or fire-and-forget
sunat-cli cpe --driver sunat-direct resumen send --fecha 2026-04-29 --correlativo 1 --yes
sunat-cli cpe --driver sunat-direct resumen status --ticket 1234567890123 --wait

sunat-cli cpe --driver sunat-direct baja send --params '{
  "fechaEmisionDocs": "2026-04-29",
  "entries": [
    { "tipoDoc": "03", "serie": "B001", "numero": 100, "motivo": "Anulacion por error en datos" }
  ]
}' --yes --wait
# Returns ticket; --wait polls until CDR

# 1. Save a profile (replace with YOUR RUC + razon social)
sunat-cli cpe profile set --name beta --ruc 20131312955 --razon-social "ACME SAC" \
  --mode beta --cert-path /abs/path/to/cert.pfx --sol-usuario MODATOS1 --default

# 2. Set sensitive vars or keychain secrets (NEVER commit)
export CPE_PROFILE=beta
export CPE_CERT_PASSWORD='your-pfx-password'
export CPE_SOL_PASSWORD='your-clave-sol'

# Keychain alternative for local machines
sunat-cli keychain set CPE_CERT_PASSWORD
sunat-cli keychain set CPE_SOL_PASSWORD

# 3. Verify
sunat-cli cpe --driver sunat-direct doctor
# Checks: config_resolved, cert_file_exists, cert_loaded (validUntil),
#         cert_expiry_warning (if <30 days), sunat_reachable (WSDL ping),
#         stale_pendings (alerts if there are pending audit entries >1h old)

# 4. Emit a real Factura against SUNAT beta
sunat-cli cpe --driver sunat-direct factura emit --params '{...}' --yes
# Returns CDR responseCode=0 (Aceptado) on success.

# 5. Re-running with the same serie+numero returns cached CDR (idempotent)
#    No second SOAP call to SUNAT. The natural idempotency key is RUC-tipo-serie-numero.

# One-line verification — no your own cert needed
bun smoke:sunat

# GRE-specific OAuth (separate from CPE consulta credentials)
export SUNAT_GRE_CLIENT_ID=...
export SUNAT_GRE_CLIENT_SECRET=...
# Plus the same SOL creds used by sunat-direct
export CPE_SOL_USUARIO=MODDATOS
export CPE_SOL_PASSWORD='clave-sol'

# Submit (sign + zip + base64 + POST + optional polling)
sunat-cli cpe gre emit --params '{
  "tipoDoc": "09",
  "serie": "T001",
  "numero": 1,
  "fechaEmision": "2026-04-29",
  "destinatario": {"tipoDoc":"6","numDoc":"20100070970","rznSocial":"CLIENTE SAC"},
  "envio": {
    "codTraslado": "01",
    "modTraslado": "02",
    "fecTraslado": "2026-04-29",
    "pesoTotal": 100, "undPesoTotal": "KGM", "numBultos": 2,
    "chofer": {"tipoDoc":"1","nroDoc":"12345678","nombres":"JUAN","apellidos":"PEREZ","licencia":"Q12345678"},
    "vehiculo": {"placa": "ABC-123"},
    "partida": {"ubigeo":"150101","direccion":"AV LIMA 123"},
    "llegada": {"ubigeo":"150114","direccion":"AV ALIVERTI 456"}
  },
  "items": [{"codigo":"P001","descripcion":"Caja cervezas","cantidad":10,"unidad":"NIU"}]
}' --yes --wait

# Independent status check
sunat-cli cpe gre status --ticket 20240100000001 --wait

# Get client_id + client_secret from SOL → Mi RUC → Credenciales API
export SUNAT_API_CLIENT_ID=...
export SUNAT_API_CLIENT_SECRET=...

sunat-cli cpe consulta \
  --ruc-emisor 20131312955 --tipo 01 --serie F001 --numero 1234 \
  --fecha 2026-04-29 --monto 118
# Returns: estadoCp (Aceptado/Anulado), estadoRuc (Activo/Baja), condDomiRuc (Habido/No Habido)

# Get credenciales API SUNAT from SOL → Mi RUC → Credenciales API SUNAT
# When registering, select URI: "MIGE RCE y RVIE - SIRE"
export SUNAT_API_CLIENT_ID=...
export SUNAT_API_CLIENT_SECRET=...
# SIRE also needs SOL credentials (different OAuth flow vs CPE consulta)
export SUNAT_RUC=20131312955
export SUNAT_USER=MODDATOS
export SUNAT_PASSWORD='clave-sol'

# 1. See available periodos
sunat-cli sire ventas periodos

# 2. Download SUNAT's pre-built proposal for the period (async — returns ticket)
sunat-cli sire ventas propuesta --periodo 202404 --wait --out propuesta-202404.zip

# 3. Review the .zip contents (TXT con todos tus comprobantes)

# 4a. Accept as-is
sunat-cli sire ventas aceptar --periodo 202404 --yes

# 4b. Or replace SUNAT's proposal with your own .zip (T2, TUS.IO upload)
sunat-cli sire ventas reemplazar --periodo 202404 --file mi-propuesta.zip --yes --wait

# 4c. Or import additional comprobantes not in the proposal
sunat-cli sire ventas importar --periodo 202404 --file extra.zip --tipo propuesta --yes --wait
# --tipo: propuesta | preliminar | ajustes | ajustes-anteriores

# 5. Download the final RVIE PDF/TXT once accepted
sunat-cli sire ventas descargar --periodo 202404 --wait --out rvie-202404.zip

sunat-cli sire compras periodos
sunat-cli sire compras propuesta --periodo 202404 --wait --out compras-202404.zip
sunat-cli sire compras ticket --num 20240100000123 --periodo 202404 --wait

sunat-cli tipo-cambio                       # today's USD/PEN
sunat-cli tipo-cambio --fecha 2026-04-15    # historical (immutable)
sunat-cli tipo-cambio --force               # bypass cache
sunat-cli tipo-cambio cached --fecha 2026-04-15  # cache-only, no scrape

sunat-cli padron ruc-online 20131312955   # ~5-10s, drives SUNAT portal via browser

sunat-cli padron status                 # see if synced + how stale
sunat-cli padron sync                   # downloads if missing or >24h old; --force to override
sunat-cli padron ruc 20131312955        # lookup razon social, estado, condicion, dirección
echo "20131312955
20100070970
20536557858" | sunat-cli padron batch   # batch lookup via stdin
sunat-cli padron batch --file rucs.csv  # or from CSV (RUC in first column)

sunat-cli api token              # Validate OAuth2 credentials without printing the token
sunat-cli schema rhe             # JSON schema for RHE fields
sunat-cli schema f616            # JSON schema for F616 fields
sunat-cli schema buzon           # Metadata-only Buzón SOL contract
sunat-cli schema cpe-factura     # JSON schema for Factura Electronica
sunat-cli schema cpe-boleta      # JSON schema for Boleta de Venta
sunat-cli schema cpe-nota-credito
sunat-cli schema cpe-gre         # JSON schema for Guía de Remisión Electrónica

sunat-cli login
sunat-cli buzon list --max-pages 25
sunat-cli buzon status
sunat-cli schema buzon