ZIMRA FDMS Error Codes — RCPT, DEV and FSCD Explained
These are the ZIMRA validation codes, with their real meanings from the FDMS specification. Most are caught by our pre-flight check before anything is sent, so you see the message without a rejected receipt sitting on your record.
| Code | What It Means | How to Fix |
|---|---|---|
RCPT047 | A line has no HS code and you are a VAT payer. | What it means and how to fix it → |
RCPT048 | The HS code is not 4 or 8 digits (8 required for VAT payers). | What it means and how to fix it → |
RCPT043 | Buyer data is incomplete. If a buyer is declared at all, ZIMRA requires both the registered name and the TIN. | What it means and how to fix it → |
RCPT015 | A credit or debit note does not identify the invoice it reverses, or that invoice was never fiscalised on this device. | What it means and how to fix it → |
RCPT034 | A credit or debit note has no note. | What it means and how to fix it → |
RCPT025 | A tax rate or tax ID that your device is not registered for. | What it means and how to fix it → |
RCPT030 | The receipt date is earlier than a receipt already submitted in this fiscal day. | What it means and how to fix it → |
RCPT014 | The receipt date is earlier than the fiscal day opening. Yellow — accepted, but flagged. | What it means and how to fix it → |
RCPT039 | The invoice total does not equal the sum of the payments. | What it means and how to fix it → |
RCPT024 | Line total does not equal unit price × quantity. | What it means and how to fix it → |
RCPT013 | The invoice number is not unique. | What it means and how to fix it → |
RCPT021 | VAT is used on an invoice from a taxpayer who is not VAT-registered. | What it means and how to fix it → |
DEV01 | FDMS cannot process the request for this device — most often an expired or invalid certificate, or a device ZIMRA has switched to Offline mode. | What it means and how to fix it → |
FISCAL_DAY | The fiscal day could not be opened, or is in a state that blocks new receipts. | What it means and how to fix it → |
MAPPING | The payload could not be converted into a fiscal invoice — a field is the wrong shape or a value could not be read. | What it means and how to fix it → |
PAYMENT_REQUIRED | No payment is on file for the account, so fiscalisation is held. | What it means and how to fix it → |
PLAN_LIMIT | You have used this month's invoice allowance on your plan. | What it means and how to fix it → |
Every error in your portal comes with its fix written in plain English — open the invoice drawer to read it. Errors are not silently retried: fix the cause, then click Resend. If you're still stuck, email us with the invoice number.