Zoho books logo Help Docs
/

eTIMS Troubleshooting Guide

We’ve outlined some of the common issues you may encounter while using eTIMS in Zoho Books, along with steps to help you resolve them. If the issue persists after following the recommended solutions, kindly reach out to Zoho Support at support.africa@zohobooks.com for further assistance.

ErrorDescriptionSolution
The credentials you've entered are invalid. Kindly check and enter the valid credentials. If you need assistance, please write to support.africa@zohobooks.com and we'll assist you.This error occurs during the initial setup between Zoho Books and eTIMS when the provided credentials are incorrect.If you encounter the error, try the solutions mentioned below:
  • Log in to the eTims Taxpayer Portal.
  • Navigate to the Device Management section.
  • Ensure that the eTims Type selected for the service request you created is OSCU.
  • Ensure that the Branch ID and Serial No in the service request match the Location Code and Device Serial Number in Zoho Books, respectively.
The solution service is already approvedThis error occurs when eTIMS fails to initiate a new service request.If you encounter the error, try the solutions mentioned below:
  • Log in to the eTims Taxpayer Portal.
  • Navigate to the Device Management section.
  • Check if a service request already exists under the eTIMS – OSCU tab.
  • If a request is present, click Add in the lower right corner of the tab and register Zoho Books as a branch using the correct location details.
We are unable to process your request at the moment. Kindly contact our support team at support.africa@zohobooks.com for further assistance.This error occurs when you try to push items, users, or customers from Zoho Books to the eTIMS Taxpayer Portal after the initial setup is complete.Ensure that the location you initially used to create a service request in the eTIMS Taxpayer Portal is marked as your primary location in Zoho Books.
Case 1:
This invoice could not be pushed to the eTIMS due to the following reasons: You must push the item to eTIMS before pushing the transaction.
This error occurs when you try to push an invoice to the eTIMS Taxpayer Portal before pushing the related items, users, or customers from your Zoho Books organization.Ensure that all items, users, and customers linked to the invoice are pushed from Zoho Books to the eTIMS Taxpayer Portal.
Case 2:
This invoice could not be pushed to the eTIMS due to the following reasons: Push the users to eTIMS before pushing the transaction.
This invoice could not be pushed to the eTIMS due to the following reasons: The following data in the line items contains invalid values:
Kindly contact our support team at support.africa@zohobooks.com for further assistance.
This indicates that one or more line items in the invoice pushed to the eTIMS Taxpayer Portal have invalid or missing data.If you encounter the error, try the solutions mentioned below:
  • Ensure that all items linked to the invoice are pushed from Zoho Books to the eTIMS Taxpayer Portal.
  • Check if a UQC (Unique Quantity Code) is entered for the unit selected for the item you're trying to push from Zoho Books to the eTIMS portal. If not, enter the UQC, save the item, clone the invoice, and try pushing it again.
  • Ensure that the item SKU does not exceed 20 characters.
This invoice could not be pushed to the eTIMS due to the following reasons: Invoice number already exists.The invoice number already exists in the eTIMS portal.
  • Log in to the eTIMS Taxpayer Portal.
  • Navigate to eTIMS Menu > Transaction Management > Sales by Invoice.
  • Identify the most recent Receipt Number used.
  • In Zoho Books, go to Settings > e-Invoicing. Click the dropdown next to the relevant location, and select View Details.
  • Update the next Receipt Number under the E-Invoice Number Series.
This Bill could not be pushed to the eTIMS due to the following reasons: There is no request full textThis error typically occurs due to unsupported characters in the bill number.If you encounter the error, try the solutions mentioned below:
  • Use only numeric characters in the Bill#.
  • Avoid letters or special characters.
  • Ensure the Bill# does not exceed 20 characters.

Case 1:
This credit note could not be pushed to the eTIMS due to the following reasons: Some values are invalid. Kindly contact our support team at support.africa@zohobooks.com for further assistance.
Occurs when pushing credit notes or vendor credits with invalid or missing data.
  • Ensure that the invoice related to the credit note or the bill linked to the vendor credit is pushed to the eTIMS portal.
  • Verify that the UQC (Unique Quantity Code) is entered for the unit you've selected for the item related to the credit note or credit note.
Case 2:
This vendor credit could not be pushed to the eTIMS due to the following reasons: Some values are invalid. Kindly contact our support team at support.africa@zohobooks.com for further assistance.
Pushing stock update to eTIMS has failed.This error appears during inventory adjustments when the item data is invalid.
  • Ensure the item's SKU does not exceed 20 characters.
  • Verify that a UQC (Unique Quantity Code) is entered for the unit selected for the item in the invoice that you are trying to mark as sent.
Was this document helpful?
Yes
No

Thank you for your feedback!