Appearance
VEFD settings (EFD receipts)
In Tanzania, every sale must produce a TRA-registered EFD receipt. Amaniq uses Simplify VEFD (Virtual EFD) — a software-based system that connects directly to TRA and issues receipts without a physical device.
Go to Settings → VEFD Settings to configure your EFD credentials.
What you need before you start
You need an account with Simplify (simplify.co.tz). Simplify is a TRA-approved VEFD provider. To register:
- Visit simplify.co.tz and apply for a VEFD account
- Provide your company TIN, VRN, and business details
- Simplify will review your application and issue credentials
- You receive a username and password for the Simplify API
This is a separate registration from your Amaniq account. Simplify charges their own fees — check their current pricing on their website.
Entering your credentials
Once you have your Simplify credentials:
- Go to Settings → VEFD Settings
- Enter your Simplify username
- Enter your Simplify password
- Set the environment to Production (not Sandbox)
- Click Save
Amaniq will test the credentials immediately and show you whether the connection is working.
Sandbox vs Production
| Environment | What it does |
|---|---|
| Sandbox | Issues test receipts on Simplify's staging server — NOT registered with TRA |
| Production | Issues real receipts registered with TRA |
Always use Production for real business receipts. Sandbox receipts do not count as official TRA EFD receipts and will not protect you in a TRA audit. Only use Sandbox when testing a new setup.
What happens if VEFD fails
If an EFD issuance fails:
- Amaniq shows you the specific error from Simplify
- Common issues: wrong credentials, TIN format errors, network timeout
- The VEFD settings page shows the last error and whether your credentials are currently valid
If issuance keeps failing, check that:
- Your Simplify credentials are correct and the account is active
- Your company TIN in Amaniq matches the TIN registered with Simplify
- The environment is set to Production (not Sandbox)
For persistent issues, contact support — we can check the Simplify API logs.
EFD receipts on invoices
Once an EFD receipt is issued, the invoice PDF is updated automatically to include:
- The EFD verification code
- The TRA receipt number
- A QR code linking to TRA's verification portal
- The date and time the receipt was issued
This enriched PDF is what you send to your client as their official receipt.