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

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.

Issue a Peru electronic CPE (comprobante de pago electrónico) — FACTURA (B2B, buyer RUC) or BOLETA (B2C consumer) — declared to SUNAT. Two backends (auto-selected from your credential header, or force with "provider"): NUBEFACT (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; free DEMO at www.nubefact.com) or APISUNAT (PSE cloud; headers x-apisunat-persona-id + x-apisunat-persona-token + x-apisunat-ruc = your 11-digit issuer RUC; free self-signup at apisunat.com with a DEV persona for testing). Both keep your SUNAT credentials in your own provider account; this server forwards them per-request and stores nothing. The same credentials switch to production at the account level, so this server reports mode "nubefact-account"/"apisunat-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.

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).