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

Troubleshooting Refund and Credit Memo Errors for Cancelled or Modified Orders via Webgility Desktop

This article helps Webgility Desktop users in troubleshooting issues where customer refunds or credit memos fail to post correctly to QuickBooks Desktop, particularly for cancelled or modified orders. It guides users through validating software configurations and investigating potential API or integration problems to ensure accurate refund processing and accounting records.

Overview

When customer refunds or credit memos are not posting correctly to QuickBooks—especially for orders that are cancelled or modified—it's important to validate the software setup and investigate possible API or integration issues.

Issue Identification

Symptoms:

  • Refunds erroneously appear in QuickBooks for cancelled/modified orders.
  • Credit memo entries do not match the expected order state.

Scope:

  • Orders processed through integration with QuickBooks.
  • Impact on financial accuracy and reporting.

Preliminary Steps

  1. Confirm Software Version

    • Ensure the integration platform (Webgility) is running the latest supported version.
    • Check the version under Help > Terms and Privacy.

  2. Replicate the Issue

    • Review logs for recent refund/credit memo transactions.
    • Attempt a test refund on a cancelled or modified order.
    • Document the discrepancies in QuickBooks.

  3. Data Validation

    • Verify that the source order status in the origin system is correctly updated to Cancelled or Modified before refund initiation.
    • Confirm order status propagation to QuickBooks via API calls (audit the request/response payloads if available).

Troubleshooting Workflow

  1. Log Analysis

    • Inspect Webgility logs for API requests/responses for refund events.
    • Note any failed, repeated, or misrouted transactions.

  2. Review Credit Memo Mapping

    • Audit the mapping between refund/credit memo events and QuickBooks targets.
    • Identify if refunds are being triggered despite cancellation/adjustment flags.

  3. Check QuickBooks Integration Settings

    • Go to Connection > Accounting/POS/ERP > Sync Settings.
    • Ensure that the posting settings are in sync with the expected workflow.
    • Validate API keys and user permissions.