PCK ZRA Middleware Wiki
The complete documentation for the Taxint–Chrilan Middleware — the bridge that lets every Pedro's Chicken point-of-sale terminal issue fiscally compliant invoices through the Zambia Revenue Authority (ZRA) Smart Invoice system. From your first store registration to deep technical integration.
Multi-Store Operations
Every Pedro's Chicken location is registered with its own TPIN and Chrilan API key. One deployment routes every invoice to the correct ZRA fiscal device.
Managing stores →Fiscal Invoice Pipeline
POS terminals send Taxint invoices; the middleware translates, submits to ZRA via Chrilan, and returns the receipt number, QR code and digital signature for printing.
How invoices flow →Automatic Menu Sync
Oracle Simphony menu items and tax definitions are pushed to the Chrilan product catalog every 60 seconds — including correct VAT categories.
Menu sync explained →POS Integration
A single endpoint, one JSON payload format. Full field reference, credit note rules, VAT codes and working examples for Micros integrators.
Integration guide →Reports & Auditing
Every request, response and data conversion is logged with full payloads and timing. Track success rates, failures and volume per store.
Using reports →Enterprise Security
Oracle IDM JWT validation, per-store API keys with no fallbacks, WhatsApp OTP for the admin portal, and a complete audit trail.
Security details →Where to go next
| I am a… | Start here |
|---|---|
| Store administrator | Signing in, then Managing stores |
| Operations / support engineer | Troubleshooting and Monitoring |
| Micros / POS integrator | Micros POS Integration Guide |
| Developer | System architecture and Field mappings |
| DevOps / release manager | Deployment and Configuration reference |