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

Troubleshooting Repeated Amazon Settlement Report posting Failures in Webgility Desktop

This article helps Webgility Desktop users in systematically diagnosing and resolving persistent errors encountered when posting Amazon settlement reports, even after unposting and re-uploading. It outlines a recommended process to address common causes such as data format inconsistencies, duplicate uploads, network interruptions, account-level restrictions, and issues with report generation tools like file encoding ensuring accurate and successful Amazon settlement posting.

Overview

When a marketplace user encounters errors while posting settlement reports—even after unposting and re-uploading—you need to systematically diagnose and resolve the issue. This guide outlines the recommended process.

Common Causes for Posting Errors

  • Data format inconsistencies in the report.
  • Duplicate report uploads.
  • Network interruptions during upload.
  • Account-level restrictions or permissions issues.
  • Issues with report generation tools (e.g., encoding).

Step-by-Step Troubleshooting

1. Gather Required Information

  • Error message(s) displayed (exact wording).
  • Type and format of the settlement report.
  • Steps you performed prior to the error.

2. Review the Upload and Posting History

  • Check report status in the Settlement Reports section.
  • Confirm if the report was previously posted, unposted, or marked as errored.

3. Verify Report Format Compliance

  • Ensure the report file matches marketplace requirements (e.g., CSV structure, encoding).
  • Validate date ranges and mandatory fields.

4. Advise Customer to Retry Upload

  • Delete the errored instance if necessary.
  • Recommend a report regeneration in the source system, then re-upload using the correct workflow.

5. Check for System or Network Issues

  • Review logs for failed uploads or connectivity errors during the reported time window.

6. Permissions and Account Review

  • Confirm the user's account has permission to post/unpost settlements.
  • Rectify any detected restrictions or refer to the account admin for changes