Retrieve information from a Batch Gateway Reconciliation job
Learn how to view and retrieve information from a Batch Gateway Reconciliation job, and understand common errors and recovery steps.
Use the instructions in this article to view a Batch Gateway Reconciliation job and retrieve information for your needs.
Zuora strongly recommends that you enable the Gateway Reconciliation Job Completion | Reconciliation Completed notification when you are using the Gateway Reconciliation feature. You will get notified when a Gateway Reconciliation job is completed or encounters an error. See Edit a Notification for more information.
Recover from a failed Gateway Reconciliation job
If the initial attempt to retrieve a gateway reconciliation report fails, the job's Status will say Error. Jobs can fail for a variety of reasons. The following is a list of common errors:
-
Zuora could not connect to the gateway to retrieve the source information. This can happen, if for example, the credentials were incorrect.
-
Zuora was able to connect, but could not find the source settlement report, perhaps because the automatically generated source file name was wrong for some reason.
-
Zuora connected and retrieved the file, but could not parse it. This can happen when the source file is created manually for testing, rather than by a well defined automatic process.
Zuora incorporates a retry mechanism to fetch the Gateway Reconciliation file from the gateway server. If the file is not available on the gateway server at the time of the retry, the "Source Not Present" message is displayed. This message indicates that the file has not yet been uploaded to the gateway server and is an expected behavior to handle cases where gateways upload files at varying times. Once the file is available on the gateway server, Zuora fetches and processes it. Note that processing the file may take time, so "Source Not Present" may still appear in Zuora temporarily, even if the file is already available on the gateway server.