Scheduled Order Processing Errors

Processing Error Codes

When a Scheduled Order fails to complete processing, the status of the Scheduled Order is set to "Failed" and a notification is sent to your QPilot Site's Contact(s) explaining the error and suggested next steps to resolve the error.

The following are errors that can occur while processing a Scheduled Order:

Code Response Definition WooCommerce Order Status
1000   EmptyScheduledOrder No items were added to the Scheduled Order No Order created in WooCommerce
1001 NoItemsToShip No items are available to process for the Scheduled Order No Order created in WooCommerce
1002 ShippingRateNotFound One or more shipping rates could not be applied to the Scheduled Order No Order created in WooCommerce
1003 PaymentIntegrationNotFound No payment integration exists for the selected payment method on the Scheduled Order No Order created in WooCommerce
1004 PaymentMethodNull No payment method is selected for the Scheduled Order No Order created in WooCommerce
1005 PaymentMethodInvalid The selected payment method for the Scheduled Order is invalid No Order created in WooCommerce
2000 PaymentFailed The selected payment method for the Scheduled Order did not process successfully Failed
3000 ClientOrderCreationFailure The WooCommerce site did not respond successfully to QPilot's API request to Create the Order Unknown: if Order(s) exists, then Pending Payment, On Hold or Failed Status
3001 ClientOrderUpdateFailure The WooCommerce site did not respond successfully to QPilot's API request to Update the Order Unknown: either Processing, Pending Payment, On Hold or Failed Status

Understanding and Resolving Processing Errors

Error 1000: EmptyScheduledOrder

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

What this error means:

  • The Scheduled Order is empty of any items, so there is nothing to process.

Potential causes for this error:

  • Your customer removing all products from their Scheduled Order
  • A site administrator with access to edit Scheduled Orders removing items from the Scheduled Order but leaving the status of the Scheduled Order as "Active"

Suggested next steps:

In most cases, an empty Scheduled Order should be deleted because it contains no items at all.

If you believe the Scheduled Order is empty and should not be, you should check the History of the Scheduled Order to confirm if the items were removed.  If not, please contact our customer success team (customers@qpilot.cloud) and include the Scheduled Order ID and/or email address of the customer to whom the Scheduled Order belongs.


Error 1001: NoItemsToShip

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

What this error means:

  • No items are available to process for the Scheduled Order that can be used to create an order in WooCommerce.

Potential causes for this error:

  • The Scheduled Order contains Products that are not valid or enabled to process for Scheduled Orders (this setting is controlled within WP-Admin > Autoship Cloud > Products)
  • The Scheduled Order contains Products that have a Stock Status of "Out of Stock"

Suggested next steps:

If you can confirm which products should be contained in the Scheduled Order, you can visit WP-Admin > Autoship Cloud > Scheduled Orders and edit the Scheduled Order to add Products and update the Scheduled Order.

If products are invalid, not enabled for processing, or are out of stock, you will see them marked as "Disabled Items" when editing this Scheduled Order.

If unresolved, we recommend at least leaving the Scheduled Order as "Failed" or setting it to "Paused" until it is updated with Products that are back in stock or enabled for processing in the future.

After Resolving the Issue:

Activate and Retry processing the Failed Scheduled Order.


Error 1002: ShippingRateNotFound

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

What this error means:

One or more products within the Scheduled Order did not qualify for any shipping rate(s).

Potential causes for this error:

  • a "shipping class" is being used for one or more products within the Scheduled Order that doesn't match with any shipping rates
  • no shipping rate exists that meets the conditions for this Scheduled Order

Suggested next steps:

  • Review the products within the Scheduled Order to see if a shipping class should be applied to a new or existing shipping rate
  • Review the shipping address information for this Scheduled Order to ensure it qualifies for an existing shipping rate
  • If no shipping rate exists that would apply to this Scheduled Order, add a new shipping rate in WP-Admin > Autoship Cloud > Shipping Rates

After resolving the issue:

Activate and Retry processing the Failed Scheduled Order.


Error 1003: PaymentIntegrationNotFound

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

What this error means:

This means that the payment method for this Scheduled Order cannot be processed because the integration required for this payment method has not be setup successfully.

Suggested next steps: 

View your payment integration settings ( WP-Admin > Autoship Cloud > Payment Integrations) for this site to confirm which payment gateways are currently setup. You may want to test this gateway first using a sandbox account or "test mode" before using it in production (live) mode.

After resolving the issue:

Activate and Retry processing the Failed Scheduled Order.


Error 1004: PaymentMethodNull

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

What this error means:

No payment method is selected for the Scheduled Order.

Potential causes for this error:

  • A customer completed checkout on your site using a payment method that is not supported by Autoship Cloud (you can review which payment methods are enabled in WP-Admin > Autoship Cloud > Payment Integrations)
  • A customer removed or deleted their saved payment method
  • An admin removed the customer's payment method by editing their Scheduled Order

Suggested next steps:

  • Check the Scheduled Order to ensure that a saved payment method was not unselected from the Scheduled Order by editing the Scheduled Order.
  • If no saved payment method exists in WooCommerce, look up the customer in your payment gateway to see if you can locate the required billing info to copy and add a payment method manually to the Scheduled Order.
  • If no saved payment method exists in the payment gateway, you will need to request that the customer add a payment method by logging into your site (in My Account > Payment Methods)
    • Once the payment method is added, the customer can apply the payment method to their Scheduled Order(s) and resume their Scheduled Order which will update the status to "Active" so that it automatically processes on the Next Occurrence Date.

After resolving the issue:

Once the payment method is added to the Scheduled Order, the customer can resume their Scheduled Order which will update the status to "Active" so that it automatically processes on the Next Occurrence Date.

If the merchant is helping the customer retry processing immediately, the merchant can Activate and Retry processing the Failed Scheduled Order.


Error 1005: PaymentMethodInvalid

  • WooCommerce Order Status: No Order created in WooCommerce
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Pre-Processing error so the Scheduled Order status is set to Failed before a request to create the Order in WooCommerce is initiated.

Detailed documentation for this error code is coming soon.


Error 2000: PaymentFailed

  • WooCommerce Order Status: Failed
    • The WooCommerce Order Status is updated to Failed after QPilot receives an error from the payment gateway.
  • Payment Processing Status: Error
  • Scheduled Order Status: Failed
    • This is a Processing error so the Scheduled Order status is set to Failed after the payment gateway has responded with an error.

What this error means:

  • The selected payment method for the Scheduled Order did not process successfully.  The payment gateway's full response is recorded with the Failed Scheduled Order's history and processing cycle log.

Potential causes for this error:

  • Payment processing declines due to expiration, insufficient funds, fraud detection

Suggested next steps:

  • Please see the Scheduled Order's history and processing cycle log for the payment gateway's response.  Further detail can be provided by looking up the payment gateway's response in your payment gateway's documentation or by contacting your payment gateway's support.
    • If the issue can be resolved without having to update the payment method (for example: by simply contacting your payment gateway or by your customer contacting their card-issuing bank in the case of fraud detection), then the merchant can Activate and Retry processing the Failed Scheduled Order.
    • If the issue cannot be resolved until the payment method is updated, you will need to request that the customer add a new payment method by logging into your site (in My Account > Payment Methods)
      • Once the payment method is added, the customer can apply the payment method to their Scheduled Order(s) and resume their Scheduled Order which will update the status to "Active" so that it automatically processes on the Next Occurrence Date.

After resolving the issue:

Once the payment method is added to the Scheduled Order, the customer can resume their Scheduled Order which will update the status to "Active" so that it automatically processes on the Next Occurrence Date.

If the merchant is helping the customer retry processing immediately, the merchant can Activate and Retry processing the Failed Scheduled Order.


Error 3000: ClientOrderCreationFailure

  • WooCommerce Order Status: Unknown
    • if Order(s) exists, then the Order status is "Pending Payment", "On Hold" or "Failed"
  • Payment Processing Status: No request to the payment gateway has been made
  • Scheduled Order Status: Failed
    • This is a Processing error so the Scheduled Order status is set to Failed after the WooCommerce site fails to successfully respond to QPilot's request to create the Order.

What this error means:

WooCommerce failed to respond to QPilot's request to create the WooCommerce Order.

Potential causes for this error:

  • WooCommerce REST API Permissions: Your site is restricting or blocking POST requests to create WooCommerce Orders
  • Interference by custom code or plugins: Your site contains custom code that corrupts your site's response to POST requests to create WooCommerce Orders
  • Site Performance / Timeout: Your site is not responding to the POST request to create the WooCommerce Order within the 15 seconds allowed for a response

Suggested next steps:

  • Before attempting to retry processing this Scheduled Order, first test & verify your WooCommerce REST API and its ability to respond to POST requests to create WooCommerce Orders
    • This test can be performed using the Autoship Cloud powered by QPilot plugin using the "Test Integration" action within WP-Admin > Autoship Cloud > Settings
    • This test can also be performed without the Autoship Cloud powered by QPilot plugin by testing a POST request to create a WooCommerce Order by making a basic request as documented by WooCommerce.

After resolving the issue:

Activate and Retry processing the Failed Scheduled Order.


Error 3001: ClientOrderUpdateFailure

  • WooCommerce Order Status: Unknown
    • the Order status is "Pending Payment", "On Hold" or "Failed"
  • Payment Processing Status: the payment has attempted to process with the payment gateway
    • if the payment succeeded, then no payment error is recorded for the Failed Scheduled Order
    • if the payment gateway returned an error, the payment gateway's full response is recorded with the Failed Scheduled Order's history and processing cycle log
  • Scheduled Order Status: Failed
    • This is a Processing error so the Scheduled Order status is set to Failed after the WooCommerce site fails to successfully respond to QPilot's request to create the Order regardless if the payment gateway responded with a success or error.

What this error means:

WooCommerce failed to respond to QPilot's request to update the WooCommerce Order.

Potential causes for this error:

  • WooCommerce REST API Permissions: Your site is restricting or blocking PUT requests to update WooCommerce Orders
  • Interference by custom code or plugins: Your site contains custom code that corrupts your site's response to PUT requests to update WooCommerce Orders
  • Site Performance / Timeout: Your site is not responding to the PUT request to update the WooCommerce Order within the 15 seconds allowed for a response.

Suggested next steps:

  • Before attempting to retry processing this Scheduled Order, first test & verify your WooCommerce REST API and its ability to respond to PUT requests to update WooCommerce Orders
    • This test can be performed using the Autoship Cloud powered by QPilot plugin using the "Test Integration" action within WP-Admin > Autoship Cloud > Settings
    • This test can also be performed without the Autoship Cloud powered by QPilot plugin by testing a PUT request to update a WooCommerce Order by making a basic request as documented by WooCommerce.

After resolving this issue:

  • Use the action to "Retry Update Order" on the Failed Scheduled Order
    • This action will attempt to complete the final step of processing the Scheduled Order by updating the WooCommerce Order
      • If the payment was processed successfully by the payment gateway, the update will result in a completed WooCommerce Order with status "Processing".  The Scheduled Order will also display an "Active" status and an updated Next Occurrence date.
      • If the payment was not processed successfully by the payment gateway, the update will result in a completed WooCommerce Order with status "Failed".  The Scheduled Order will also display a "Failed" status and include details from the payment gateway's response regarding the payment error.

Still need help? Contact Us Contact Us