Fiscalisation options for Manager users in Zimbabwe

I don’t know much more than what is in the API documentation linked above. My understanding is that the process should work something like this:

  1. At the beginning of a trading day, the user opens a “fiscal day” by sending a request to ZIMRA’s server. ZIMRA’s server responds with an approval and the user’s business details. There are several counters, relating to the fiscal day sequence, the global invoice sequence, and the daily invoice sequence. Some of these can be reset daily, while others cannot. I’m not sure if these are saved locally or on ZIMRA’s server, or both.
  2. Assuming the request to open a fiscal day was approved, the user submits all sales invoices and credit notes to ZIMRA through the API. Ideally this should happen as they are issued, in the correct sequence. However, there is some provision to submit them out of order, as long as any missing transactions are submitted before the end of the fiscal day. For each transaction that is submitted to ZIMRA’s API, some of the details such as the customer information is verified against their records. If all the required information is present and the transaction data is accepted by ZIMRA, a response is sent to the user. This includes the data needed for a QR code which should be printed on the invoice that is given to the customer. The customer can use the QR code to verify that the transaction is valid and was recorded successfully by ZIMRA.
  3. At the end of the day, the user submits a “Z-report” to ZIMRA. This contains a summary of the transactions for the day. If it matches what ZIMRA has recorded during the day and there are no missing transactions from the sequences, ZIMRA sends a response to the user acknowledging the successful submission of the Z-report and closes the fiscal day.

So, it looks to me like Manager could probably handle the submission of transaction data (step 2) to ZIMRA’s server through the relay service, but I don’t see how it could handle the opening and closing of the fiscal day, the Z-report, etc.

I did also read a few other things in the API documentation that I am not sure of, such as:

  1. The method of payment and amount paid are listed as required information, but this was never brought up in our attempted setup with Axis Solutions.
  2. I saw mention of a periodic “ping” that ZIMRA’s server would send to the user at a set interval during a fiscal day to check that the user’s device is online.

The Excel methods would vary depending on the third-party supplier. For example, Axis Solutions I think just has a simple Excel template that has the wording and column structure that they have trained their device to read when it is saved as a PDF. Fiscal Harmony has an Excel plugin and a template. You can read some more about their method on their support page.

1 Like