Peru Invoices (CPE factura/boleta electrónica via Nubefact) MCP server

Issue a Peru electronic CPE (comprobante de pago electrónico) — FACTURA (B2B, buyer RUC) or BOLETA (B2C consumer) — declared to SUNAT via Nubefact. Bring your own Nubefact credentials as headers: x-nubefact-ruta (your unique full RUTA URL, e.g. https://api.nubefact.com/api/v1/<hash>) AND x-nubefact-token (your account TOKEN). A free DEMO account at www.nubefact.com gives both; the SAME credentials switch to production at the account level (numbering resets on go-live), so this server reports mode "nubefact-account" honestly rather than guessing demo vs production. ⚠️ NUMBERING IS MERCHANT-MANAGED: this server is stateless and does NOT track sequences — YOU must supply "serie" (e.g. F001 for facturas, B001 for boletas) and the next sequential "numero" yourself; reusing a numero is rejected by SUNAT, skipping one leaves a gap. Give item prices WITH IGV included (precio_unitario) — this server computes valor_unitario, subtotal, IGV (18%) and totals for you.

Check a Peru CPE previously issued (consultar_comprobante) by its identity: comprobante_type + serie + numero (Nubefact/SUNAT identify documents by these, not by an opaque id). Status values: ACCEPTED (aceptada_por_sunat=true), PENDING (not yet sent/processing), REJECTED (SUNAT returned an error — see sunat_description). Also returns anulado (true if voided) and the PDF/XML/CDR links. Safe to call anytime.

Void a Peru CPE at SUNAT (generar_anulacion — a comunicación de baja). Identified by comprobante_type + serie + numero, plus a free-text motivo (reason, e.g. "ERROR DEL SISTEMA"). SUNAT processes voids asynchronously via a ticket, so status is usually PENDING right after — call query_invoice later to confirm the document shows anulado=true. Note: for value corrections you normally issue a nota de crédito instead of a full void (notas not yet exposed by this server).