Every time LedgerPort syncs a record, it creates a log entry. These logs are your main tool for understanding what synced, what failed, and why. This guide walks you through where to find them, what each column means, and how to narrow things down when you are looking for a specific issue.
Find Your Audit Log
Through LedgerPort Dashboard
- Log in to app.ledgerport.com.
- From the left sidebar, click Audit Log.
You will see a list of all sync activity for your current Business, sorted with the most recent entries at the top.
Within Shopify App
- Go to Installed LedgerPort App.
- You can now click on Audit Logs. This way you can go ahead and check for their sync status of each product.
Understanding the Log Columns
Each row in your audit log represents one sync attempt for one record. Here is what each column tells you:
Entity Type : what kind of record was synced. Common types include Order, Product, Customer, Payout, and Daily Summary.
Status : the outcome of the sync attempt:
- Synced – the record was successfully sent to QuickBooks.
- Error – the sync failed. The row will include an error reason.
- Pending – the record is queued and has not been processed yet.
- On Hold – the record is waiting for a sync trigger condition to be met (such as a specific payment or fulfillment status).
Date : when the sync attempt was made.
Reference : the Shopify order number, product name, or customer name associated with the record.
Error Details : visible on Error rows. This column shows the reason the sync failed. Click the row to expand it and see the full error message.
Filtering Your Logs
When you have a large number of log entries, filtering helps you find what you are looking for quickly.
Filter by Status
Use the Status filter to show only errors, only successful syncs, or only records on hold.
- At the top of the Audit Log page, click the Status dropdown.
- Select Error to see only failed records.
- The list will update immediately.
This is the fastest way to do a daily error check – filter to Error and you see everything that needs attention.
Filter by Entity Type
Use the Entity Type filter to narrow logs to a specific type of record, such as orders only or products only.
- Click the Entity Type dropdown.
- Select the type you want to review (Order, Product, Customer, Payout, Daily Summary, etc.).
This is useful when troubleshooting a specific category. For example, if a customer reports that their order is not in QuickBooks, filter to Orders and search for their order number.
Filter by Date Range
Use the Date filter to focus on a specific time window.
- Click the Date filter.
- Set a start date and end date.
- The logs will show only entries within that range.
This is especially useful after a connection interruption — set the date range to cover the period when the connection was down to find all records that need to be re-synced.
Searching Logs
If you are looking for a specific order or customer, use the search bar at the top of the Audit Log page.
- Click the Search bar.
- Type the Shopify order number, product name, or customer name.
- Matching entries will appear as you type.
Reading an Error Message
When a sync fails, the error message in the log tells you specifically what went wrong. To read it:
- Find the row with an Error status.
- Click anywhere on the row to expand it.
- Read the Error Details field. This will describe the cause, such as “Customer not found in QuickBooks” or “Product not mapped.”
Most error messages map directly to a fix. See Common Sync Errors and How to Fix Them for a full list of errors and their solutions.
Re-Syncing Failed Records
After fixing an error, you can push the affected records through again without waiting for the next auto-sync.
- From the left sidebar, click Manual Sync.
- Select the entity type (Orders, Products, Customers, etc.).
- Filter or search to find the records that failed.
- Select them and click Sync Selected.
Log Retention by Plan
How far back your logs are available depends on your plan.
| Plan | Log Retention |
|---|---|
| Free | 7 days |
| Growth | 30 days |
| Scale | 90 days |
| Enterprise | Unlimited |
| Agency | 90 days |
If you need to investigate an issue that falls outside your retention window, you will not be able to find those log entries in LedgerPort. To retain logs longer, upgrade your plan from Billing.
Tip: If you are on the Growth plan and frequently need to look back more than 30 days, Scale ($79/mo) extends log retention to 90 days and also unlocks faster sync frequency (every 15 minutes vs every 60 minutes).
If you run into any issues, contact us and our support team will be happy to help.
