Synchronization ledger entries

Tinx Connector saves all data exchanges between Business Central and your webshop on the Synchronisation Ledger Entries page. Use this page to check whether a message was sent successfully, investigate errors, or resend a specific entry to your webshop.

To check the status of the message

Select Search (Alt+Q) in the upper-right corner, enter Synchronisation Ledger Entries, and then choose the related link.
On the Synchronisation Ledger Entries page, check the status to determine if you need to troubleshoot. The Status field shows whether a message was processed successfully.

Only messages with the status Processed have been successfully exchanged between Business Central and your webshop. To troubleshoot entries with all other statuses, see Check the synchronisation ledger entries.
Select the message definition code in the Document No. field to see what operation the entry performed, such as Update WooCommerce orders for WOO-086-1.

The following image shows the Synchronisation Ledger Entries page.

Actions on the Synchronisation Ledger Entries page

The Synchronisation Ledger Entries page has several actions you can use to investigate and manage your data exchanges.

Home

To resend a previously sent entry, for example, after updating a mapping, use the Publish to Webshop action. The selected entry is added back to the Record Queue for reprocessing. This is useful during testing when you are adjusting the mapping in the message definition.

Entry

View Record: Opens the source record that was sent so that you can review the data.
Message Definition: Opens the Message Definition used for this entry, so you can adjust the data mapping if needed.

View and Download

Web Request shows the data that was sent to the webshop from Business Central.
Web Response shows the response received from the webshop, including any success or error messages.

Choose View to open it directly in Business Central, or choose Download to save the file.

The web request or response shows the actual JSON data exchanged with your webshop. The fields in the JSON correspond to the fields defined in the mapping on the Message Definition page:

For outbound messages, the JSON shows the data that was sent to your webshop. The fields correspond to the values that Tinx Connector reads from Business Central and formats into the request. For example, sku, name, price, and stock_quantity for WooCommerce, or title, sku, and id for Shopify.
For inbound messages, the JSON shows the response that your webshop sent back. Tinx Connector reads these fields from the webshop and writes them to the corresponding fields in Business Central, as defined in the mapping. For example, id, status, total, and line_items for WooCommerce, or id, name, and lineItems for Shopify.

To manage the number of entries on the Synchronisation Ledger Entries page

To avoid unnecessary database growth, Tinx Connector can automatically delete entries from the Synchronisation Ledger Entries page after a certain number of days. The following procedure describes how to set up the automatic deletion.

Select Search (Alt+Q) in the upper-right corner, enter E-Commerce Integration Setup, and then choose the related link.

If you don’t find E-Commerce Integration Setup in Search, change your role in Business Central to TINX E-Com Admin. Then on the Role Center, select Setup, and then choose E-Commerce Integration Setup.
On the E-commerce Setup page, on the General FastTab, find the No. Of Days To Remove Log Data field. Set how many days of log data you want to keep in the system.
Select Search (Alt+Q) in the upper-right corner, enter Job Queue Entries, and then choose the related link.
On the Job Queue Entries page, select the TINX Remove Web Log Entries job, and choose the Set On Hold action if the job queue status is Ready.
Select TINX Remove Web Log Entries to open the job queue entry card page.
On the Job Queue Entry Card page, in the Earliest Start Date/Time field, enter a date and time when the job should start running. Make sure to set it to a time outside your working hours to avoid any performance impact. To learn more, see The earliest start date.
In the No. of Minutes between Runs field, enter 1440 to make sure the job runs once per day.
Select Set Status to Ready to activate the job queue.

Related information

Record queue
Job queues
Synchronization dashboards
Error messages
Troubleshooting checklist
E-commerce Setup and Sales Channel: Where to set up the webshop
Key concepts in Tinx Connector