SOL Credentials

SOL (SUNAT Operaciones en Linea) credentials are required for SUIT to communicate with SUNAT’s SOAP web services. Each tenant must configure their own SOL user and password.

What are SOL credentials?

SOL credentials consist of:

• SOL User — A secondary user created in SUNAT’s portal for web service access
• SOL Password — The password for that user

These are different from the primary RUC login credentials used to access SUNAT’s website.

Configuring SOL credentials

Via API

curl -X PUT https://api.suit.pe/api/settings/sunat-credentials \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "solUser": "YOUR_SOL_USER",
    "solPassword": "YOUR_SOL_PASSWORD"
  }'

Obtaining SOL credentials

Creating a secondary user in SUNAT

1. Log in to SUNAT Operaciones en Linea with your RUC and primary credentials
2. Go to “Mis Tramites y Consultas”
3. Navigate to “Registro de Usuarios Secundarios”
4. Create a new secondary user with permissions for:
   • Facturacion electronica
   • Envio de comprobantes electronicos
5. Save the user and password

Required permissions

The SOL user must have the following SUNAT permissions:

• Factura electronica — Emit invoices and receipts
• Notas electronicas — Emit credit and debit notes
• Guias de remision — Emit despatch notes
• Retenciones y percepciones — Emit retentions and perceptions
• Comunicacion de baja — Void documents

Sandbox credentials

For the sandbox environment (api-staging.suit.pe), use SUNAT’s standard beta credentials:

Field	Value
SOL User	MODDATOS
SOL Password	MODDATOS

These credentials connect to SUNAT’s beta servers where no real tax documents are generated.

Security

• SOL credentials are stored encrypted in the SUIT database
• They are never exposed in API responses
• Only tenant administrators (JWT with admin role) can update SOL credentials
• API Key authentication cannot be used to read or modify SOL credentials

Troubleshooting

SUNAT_ERROR status

If documents return SUNAT_ERROR, common SOL-related causes include:

Issue	Solution
Invalid SOL credentials	Verify user and password in SUNAT portal
SOL user lacks permissions	Add required permissions in SUNAT
SOL user expired or deactivated	Reactivate or create a new user in SUNAT
SUNAT servers down	Retry later using POST /api/documents/:id/retry

Testing your credentials

After configuring SOL credentials, emit a test document in the sandbox environment to verify they work correctly. If the document reaches ACCEPTED status, your credentials are properly configured.