Set Up E-Invoicing on ZoboLedger
Complete these steps so you can issue FIRS-compliant receipts and invoices from WhatsApp.
1. Set PASCA as your NRS provider
Before activating your business in ZoboLedger, your TIN must have PASCA selected as the e-invoicing provider on the FIRS Centralised Billing Portal. Without this, FIRS will not assign your business ID or IRN template.
- Log in to the FIRS e-invoice portal.
- Open the Centralised Billing Portal and find your NRS service provider settings.
- Select PASCA as your NRS provider and save.
- Wait a few minutes for FIRS to sync, then continue with Activate business below.
If you already tried Activate and saw a pending or incomplete message, set the provider first, then use Refresh setup in WhatsApp (see section 3).
2. Activate your business in WhatsApp
Once PASCA is your NRS provider, register your business with ZoboLedger:
- Open your ZoboLedger WhatsApp chat.
- Tap Invoice → Manage business → Activate business.
- Confirm the NRS provider checklist — tap Continue when PASCA is set on FIRS.
- Review your TIN, business name, email, and address, then tap Add Business.
- When activation succeeds, you will see a confirmation and can start issuing receipts and invoices.
Make sure your Profile TIN and business name match what FIRS has on file before you activate.
3. Pending or missing IRN template
If activation finds your business on FIRS but returns a pending status or no IRN template, your NRS provider is likely not set to PASCA yet. ZoboLedger cannot generate compliant invoice reference numbers until both your business ID and IRN template are available.
To recover:
- Set PASCA as your NRS provider on the FIRS portal (section 1).
- In WhatsApp, tap Refresh setup on the incomplete-setup message.
- Wait for confirmation that your business is ready for invoicing.
If you try to issue a receipt before setup is complete, ZoboLedger may attempt a one-time refresh automatically. If setup is still incomplete, follow the steps above and try again.
4. Cryptographic key upload (QR receipts)
FIRS requires cryptographic keys to embed verification QR codes on receipts and invoices. B2B and B2G invoices always need keys; B2C receipts can be issued without QR, but compliant QR embedding requires your public key and certificate.
When keys are missing, ZoboLedger prompts you in WhatsApp with Upload Crypto Keys. Tap it to receive a secure, time-limited upload link — do not share that link with anyone else.
- Generate keys in the FIRS e-invoice portal under My Account → API Credentials → Manage Cryptographic Keys.
- Upload the JSON bundle or separate public key and certificate files via the secure link from WhatsApp.
- After upload, return to WhatsApp — your receipts will include FIRS-compliant QR codes when keys are active.
Continue without QR is available for B2C flows when you want to issue a receipt immediately without waiting for key setup. Your receipt will still be recorded, but it will not include a verification QR code until keys are uploaded.
Use the upload page only from the link ZoboLedger sends you in WhatsApp. Learn about the key upload page.