Fiscalization can be followed by various errors that prevent payments from being processed. Errors can arise from incorrect settings in the program or from your sECR.

Let's take a look at the most common errors, their causes, and solutions to ensure that your cash register operations run smoothly.

Difficulties due to incorrect settings in the CRM account

Even before performing the fiscalization process, you may see errors:

• Activate at least one cash register to fiscalize the order: make sure you have active cash registers. And the source of this order is added to them in the cash register settings (field: «Sources»);

• Activate the cash register to cancel fiscalization: a notification appears when you try to cancel a receipt with a cash register in which the license key has been changed. In this case, it will not be possible to cancel fiscalization with the old key from KeyCRM. You need to cancel it in the CheckBox account.

During automatic fiscalization, errors may occur if the trigger or fiscalization conditions are not met. These errors are stored in the order history:

• No payments ready to fiscalize: appears if the order does not have a payment specified in the trigger, it has a different status, or a payment method is used that is not available in the cash register settings. If the payment method is deactivated, you must first activate it and add it to the cash register settings and trigger;

• No sources registered in a cash register: means that the order source has not been added to the cash register so that it can be fiscalized. Therefore, add the source of this order in the cash register settings (field: «Sources»);

• No payments to cancel: occurs when fiscalization is canceled, when there are no fiscalized payments in the order where fiscalization could be canceled.

• Payment status still in progress after 3 tries: indicates that there were 3 attempts to connect to the cash register service, but it did not respond. Therefore, you need to try to check the fiscalization status by pressing the corresponding button in the fiscalization menu next to this payment.

Errors received from the sECR

With manual fiscalization, you will immediately see an error from your cash register in the right corner of the program.

With automatic fiscalization, errors are saved in the order history with the text «Fiscalization failed». The error code received from the sECR can be viewed by clicking on the arrow next to «Content»:

The most common errors:

• The shift is not open: we recommend contacting KeyCRM support for verification;

• The shift was opened more than 24 hours ago. To continue working, close the current shift and open a new one: we also recommend setting up automatic shift closure in your cash register;

• Error when applying a signature: there is a problem with your signature on the cash register side, we recommend checking the cash register settings and, if necessary, contacting your cash register support service;

• Invalid access token: if the license key is valid and the key itself is the same in CRM and CheckBox, you need to re-authorize in the existing cash register in CRM;

• 504 Gateway Time-out: there may have been a temporary difficulty in connecting the two services or an overload. We recommend trying to fiscalize this payment again.

• 429 Too Many Requests: the limit of requests to the API sECR for a certain period of time has been exceeded. It seems that you have launched many fiscalizations at the same time.

• 503 Service Unavailable: at the time of fiscalization, repair work was being carried out on the cash register side. Perform fiscalization when they are complete. Usually, you can see information about the time of maintenance work in the cash register account;

• error code 520: this is a non-standard error code, which usually means that the sECR server sent an incorrect or unexpected response. This may be a temporary glitch.

• 402 Payment Required: The cash register is blocked; you must pay for services on the web portal https://my.checkbox.ua.

• The change cannot be used for cashless payments: check your order, it may contain items priced at less than 10 cents. Or the amounts are specified in fields that are not transferred to the receipt, for example, “Sales tax.”
  In rare cases, this may occur if the order contains fractional quantities of items and discounts on them, due to differences in rounding methods between the order and fiscalization. In this case, we recommend performing fiscalization manually through the Checkbox account.

• There is not enough cash to issue a return receipt. The balance in the cash register is $0.00: if the receipt is fiscalized in cash, then when it is canceled, there must be enough cash in the cash register for the amount of this receipt.

• Parallel requests cannot be processed for this operation. Wait for the previous request to complete: this occurs as a result of simultaneous fiscalization of orders by triggers that are launched after a mass change of statuses. The error is returned by Vchasno, so we cannot influence it at this time. The information has been forwarded to the relevant department to find a solution. For now, we recommend not initiating mass status changes so that each order is fiscalized separately.

• The cashier is already working with this cash register: the error occurs when trying to open the cash register, but it is already open in the application or another integration. CheckBox does not allow one cashier to work in parallel in different integrations.