This guide explains how to request an e-seal (electronic plomb) and upload Excel/CSV journal entries to the Electronic Commercial Books module on my.tax.gov.ir. It also highlights file rules, practical checks, and common errors so your submission is accepted.
Quick links
Upload is accepted only when the sealed period and the file structure match.
- Request the e-seal for the correct fiscal period first.
- Export using the required columns and date/number formats.
- Validate totals (debit/credit) and account mapping before upload.
- Submit within the permitted time window shown in your taxpayer profile.
What you need
- Access to your taxpayer account on my.tax.gov.ir.
- An e-seal tracking code issued for your tax file and fiscal period.
- Your accounting export in the official template (Excel) or CSV (for large uploads).
- Clear mapping for GL accounts and any subsidiary/auxiliary accounts.
Tip: Keep a copy of the exported file and upload confirmation for your audit trail.
Step 1 — Request the e-seal (electronic plomb)
- Open the Company Registration portal and locate the option for electronic sealing of commercial books.
- Select your tax file and the fiscal period (time range) you want to seal.
- After approval, copy the issued tracking code (e-seal code).
Important
- The tracking code is tied to a specific tax file and fiscal period.
- If the period is wrong, the upload step will fail or be rejected.
Step 2 — Sign in to my.tax.gov.ir
- Go to my.tax.gov.ir and sign in.
- Open Electronic Commercial Books from the services list.
- Choose the relevant tax file (if you manage more than one).
If you do not see the service, confirm your taxpayer profile permissions and the fiscal period eligibility.
Step 3 — Upload your file
- Enter the e-seal tracking code.
- Select the file type (Excel or CSV) and upload your journal entries.
- Run validation (if available) and review any errors.
- Submit and keep the receipt / reference number.
Before you press Submit
- Confirm the file period matches the sealed period.
- Confirm debit totals equal credit totals for the period.
- Check that all mandatory fields are filled (no blank dates, account codes, or amounts).
Time-window rules
The system enforces time windows based on your fiscal year and reporting period. Uploads are accepted only for periods that are open in your profile and tied to a valid e-seal.
- Seal and upload the same fiscal period (no mixing months/quarters).
- Use the date format and period boundaries required by the portal.
- If you need corrections, submit an updated file following the portal’s update/correction workflow.
Upload deadlines
Deadlines depend on your fiscal year start and the period type (monthly/quarterly/annual) shown in the portal. Always verify the latest official announcements for your taxpayer profile.
Practical rule of thumb
- Plan your upload early—do not wait until the final week.
- Allow time for validation errors and re-uploads.
- Keep evidence of submission and system receipts.
Excel/CSV template & rules
Typical required fields
- Voucher / document number
- Transaction date
- Account code and account title
- Debit amount and credit amount
- Description (if required by the template)
Formatting checks
- Use a consistent date format (as required by the template/portal).
- Do not mix text and numbers in amount columns.
- Keep account codes consistent across lines (no leading/trailing spaces).
Common errors & fixes
Rejected file / invalid format
- Download the latest template again and re-export using the same column order.
- Remove extra columns, merged cells, and special formatting.
- For large files, export as CSV and ensure UTF-8 encoding.
Unbalanced totals
- Confirm debit totals equal credit totals for the uploaded period.
- Check rounding, separators, and negative signs.
Account code/title mismatch
- Keep a single source of truth for account mapping and naming.
- Ensure subsidiary/auxiliary accounts (if used) are consistent with your GL structure.
Legal notes
- This guide is practical and informational; your portal profile and official notices are the source of truth.
- Keep your accounting system documentation and exports available for audit and system-based reviews.
Contact us if you want help mapping accounts, validating exports, or preparing uploads.
FAQ
Do I have to upload Excel, or is CSV acceptable?
Excel is commonly accepted via the official template. CSV is often better for large datasets, as long as it follows the required structure and formatting rules.
Why does the system say my period is not allowed?
Usually the e-seal period does not match your file, or the period is closed in your taxpayer profile. Re-check the sealed period and the allowed windows shown inside the service.
What should I keep as evidence of compliance?
Keep the exported file, the e-seal tracking code, upload receipts/reference numbers, and any confirmation screens or messages.
Can I re-upload if I find an error after submission?
Many profiles allow correction workflows. Follow the portal’s correction method and keep records of the updated submission.
References & sources
Useful official portals related to the workflow: