What is SUIT
SUIT Billing is a REST API multi-tenant platform for electronic invoicing in Peru (SUNAT). It allows you to emit invoices, receipts, credit notes, debit notes, retentions, perceptions, and despatch notes — all digitally signed, sent to SUNAT, and with automatic PDF generation.
What SUIT handles for you
Section titled “What SUIT handles for you”- XML UBL 2.1 generation — Standard required by SUNAT
- Digital signature with your SUNAT certificate (.pfx)
- SOAP communication with SUNAT servers
- CDR (Constancia de Recepcion) parsing — Automatic interpretation of SUNAT responses
- PDF generation — Printable documents for your customers
- Automatic email delivery — Send PDFs to your customers automatically
- Accounts receivable (CxC) — Auto-generated when invoices are accepted
- Payment tracking and reminders — Keep track of who owes what
- Financial dashboards and Excel exports — Reporting tools
Architecture
Section titled “Architecture”Your App --> SUIT API --> SUNAT | Signs XML --> Sends SOAP --> Parses CDR | Stores document, generates PDF, sends email | Auto-creates receivable (CxC)Supported document types
Section titled “Supported document types”| Code | Type | Endpoint | SUNAT Method |
|---|---|---|---|
| 01 | Factura | POST /api/invoices | sendBill (sync) |
| 03 | Boleta de Venta | POST /api/receipts | sendBill (sync) |
| 07 | Nota de Credito | POST /api/credit-notes | sendBill (sync) |
| 08 | Nota de Debito | POST /api/debit-notes | sendBill (sync) |
| 09 | Guia de Remision | POST /api/despatch-advices | sendBill (sync) |
| 20 | Retencion | POST /api/retentions | sendBill (sync) |
| 40 | Percepcion | POST /api/perceptions | sendBill (sync) |
| RA | Comunicacion de Baja | POST /api/voided-documents | sendSummary (async) |
Environments
Section titled “Environments”| Environment | Base URL | Purpose |
|---|---|---|
| Production | https://api.suit.pe | Live documents sent to SUNAT |
| Sandbox | https://api-staging.suit.pe | Testing with SUNAT beta servers |
The sandbox environment uses SUNAT beta credentials (MODDATOS / MODDATOS) and does not generate real tax documents.