Skip to content
  • There are no suggestions because the search field is empty.

Common Causes and Fixes for Amazon Settlement Posting Errors in Webgility Desktop

This article helps Webgility Desktop users troubleshoot and resolve errors encountered when posting Amazon Settlement Reports in Webgility Desktop. It guides users through identifying common causes such as account mismatches, outdated report files, or formatting errors, and provides clear, step-by-step instructions to fix these issues and successfully complete settlement postings.

Overview

Settlement posting errors often occur due to mismatched account details, using an outdated report version, or formatting issues in the report itself. Fixing these issues will allow your reconciliation process to continue smoothly.

Common Causes of Posting Errors

  • Account mismatch: Your uploaded report doesn’t match the account credentials in Webgility Desktop.

  • Outdated report: You’re using an old or incorrect version of the settlement file.

  • Data entry/formatting issues: The file includes typos, special characters, unsupported formats, or missing required fields.

Step-by-Step Resolution Guide

1. Check the Error Message

  • When you attempt to post the report, carefully read the error message that appears.

  • Identify if the issue happened during the upload, account matching, or posting phase.

  • Take note of any error codes or message text—they can help pinpoint the issue faster.

2. Verify Your Amazon Account Information

  • In Webgility Desktop, go to Orders > Amazon > Settlement Reports.

  • Confirm that the account number in your report matches the account connected in Webgility Desktop.

  • Double-check your integration settings to ensure everything is up-to-date.

3. Use the Latest Settlement Report

  • Download the most recent settlement report directly from your Amazon seller account or accounting platform.

  • Make sure the report version and date are current.

  • Avoid reusing files you've already submitted or processed before.

4. Check Report Formatting

  • Open the file and review the data:

    • Look for extra spaces, strange symbols, or unsupported characters.

    • Make sure all required fields are filled in correctly.

  • Save the file in a Webgility Desktop-supported format—preferably .csv or .xlsx.

5. Re-upload the Corrected Report

  • In Webgility Desktop, go to:
    Orders > Amazon > Settlement Reports > Get Reports > Manual Import

  • Select the corrected and up-to-date file from your system.

  • Upload the file and wait for confirmation that the posting is complete and successful.