Recording returns filed on Rev360 or iTax
Why Nigerian and Kenyan returns are filed on Rev360 or iTax by a person, how Achekam records the filing for a second person to verify, and who may do it.
By Achekam · · 4 min read · For Accountants & audit firms in Nigeria, Kenya
Launching soon. Some of the screens this article describes for Nigerian and Kenyan businesses are not reachable in Achekam yet. They are coming soon.
A return is not finished when it is approved. It is finished when the authority has it, and when the firm can prove that it does. For Nigerian and Kenyan clients that proof comes from the authority's own portal, because the filing itself happens there and not in the firm's software.
Achekam is built around that reality. It does not file Nigerian or Kenyan returns. A person files on Rev360 or iTax, uploads the receipt or acknowledgement, and a different person verifies it before the return counts as filed. This article explains why the filing happens on the portals, how the record is made, and a permission problem to check before you rely on the recording step.
No public filing API for most returns
In Nigeria, the research behind Achekam's pack found no public NRS system-to-system API for filing returns. Returns are filed on Rev360 by Excel upload or web form. The NRS launched Rev360 at selfservice.nrs.gov.ng on 30 April 2026 to replace TaxPro Max for registration, filing, payments, refunds and tax clearance certificates, and is rolling it out in phases. TaxPro Max profiles, history and balances were migrated automatically, and tax advisers get role-based access without sharing their clients' credentials.
In Kenya, returns are filed on iTax. KRA's developer platform, GavaConnect, offers approved developers PIN and tax compliance certificate checkers and NIL return filing, but no API for filing VAT, corporation tax, PAYE or withholding tax returns.
So for the returns a practice spends most of its time on, the filing is done by a person on the authority's portal. Software that claimed otherwise would be claiming a connection the authorities do not offer.
Filing on Rev360 or iTax yourself
Inside Achekam, a Nigerian or Kenyan return is prepared by one person, reviewed by a second and approved by a third, after which its figures are frozen. What leaves Achekam is an approved return ready to be entered or uploaded on the portal.
The person who files then does three things:
- files the return on Rev360 or iTax, from the approved figures;
- downloads the portal's receipt (Nigeria) or acknowledgement (Kenya);
- uploads it against the return in Achekam.
Using the role-based adviser access on Rev360, rather than a client's own password, keeps the filing traceable to the person who did it. Because Rev360 is being rolled out in phases, note on the return which portal and which route was used, so that anyone reading the record later knows where to look for the original.
A second person verifies the receipt
The upload is not the end. A different person verifies the receipt or acknowledgement before the return counts as filed in Achekam. The verifier should check that the document belongs to this client and this period, that the figures on it match the approved return, and that it is a genuine portal document rather than a draft or a screenshot of an unsubmitted form.
Payroll returns follow the same idea. Achekam does not file or pay Nigerian or Kenyan payroll returns; a person records the filing on the authority's portal with the reference it gave, and a second person confirms each payment.
The filing permission no role gets by default
Recording a filing needs a specific permission: NG_NRS_FILE for Nigeria and KE_KRA_FILE for Kenya. No role receives either by default, not even Partner. Partners get every other permission in the country packs by default; this one is meant to be granted to named people only.
The intent is sound. The person who records that a return reached the authority is making a statement on which deadlines, penalties and client advice depend, so the firm should choose deliberately who may make it.
Check before relying on it
There is a catch. The permission needed to record a filing is given to no role when the pack is activated, and no screen was found that grants it. Recording a filing may therefore be unreachable in your workspace.
Find out before a deadline, not on it. Ask a firm administrator to try granting the filing permission to one named person, then test the step on a return that has already been filed. If it cannot be granted, keep the filing evidence on the client's file outside the return record, note on the return that it was filed and where the receipt is kept, and raise the gap with Achekam.
| Step | Who | Where |
|---|---|---|
| Prepare, review, approve | Three different people | Achekam |
| File the return | A person with portal access | Rev360 or iTax |
| Upload receipt or acknowledgement | Holder of the filing permission | Achekam |
| Verify the receipt | A different person | Achekam |
| If the permission cannot be granted | Keep evidence on file and raise it | Outside the return record |
A filing-day checklist
- Confirm the return is approved and frozen in Achekam.
- File on Rev360 or iTax from the approved figures.
- Download the portal's receipt or acknowledgement straight away.
- Upload it against the return, or file it as above if recording is blocked.
- Have a second person verify it against the return.
- Check the client's deadline calendar now shows the return as filed.
Settling who files before the season
Decide now which named people in the firm will file on Rev360 and iTax and record the filings, and test the permission with one of them this month. The dates that follow a filed return, if an assessment comes, are in objecting to a tax assessment in Nigeria or Kenya. For the main tax of small Kenyan clients, see turnover tax for small Kenyan clients.
General guidance only, not advice on your own circumstances. Tax and payroll rules change: check the current position with the authority or your adviser.
