This document will provide names, codes, descriptions and possible resolution methods to all known and mapped error codes that a user may encounter interacting with Rebillia’s interfaces and actionable items.
External Order Creation
Listed below are all the known and mapped errors for external order creation
| Error Message | Error Code | Service | Description | Resolution |
|---|---|---|---|---|
| The options of one or more products are invalid. | – | BigCommerce | When a subscription is purchased, Rebillia stores all selections of options present in the product. For example, an option would be “Size” or “Color” and a selection would be “Large” or “Red” (respectively). When this error appears, it means that either one of the selections is no longer valid, or that the live version of the product now has new required options that did not exist when this subscription was purchased. For example, “Large” was removed, or a new option “Thread Count” was added to the product. | To resolve this issue, go to the “rate plans” page of the subscription, edit the plan’s linked product(s) and identify which option(s) is(are) missing (a) valid selection(s). Make the selection(s) and save the linked product(s). |
| The field ‘billing_address’ is invalid. | – | BigCommerce | One or more of the elements of the billing address is/are invalid. | Go to the customer’s subscription bag and into the “billing” section. There, edit the billing address and either select another address or fix the current address. |
| The field ‘shipping_address’ is invalid. | – | BigCommerce | One or more of the elements of the shipping address is/are invalid. | Go to the customer’s subscription bag and into the “shipping” section. There, edit the shipping address and either select another address or fix the current address. |
| The field ‘state’ does not allow null values. | – | BigCommerce | The shipping address assigned to the subscription is missing the field “state” in it, and it is deemed required to place the order. | Go to the customer’s subscription bag and into the “shipping” section. There, edit the shipping address and either select another address or fix the current address. |
| Quantities of one or more products are out of stock or did not meet quantity requirements. | – | BigCommerce | This error can mean one of two things: 1. The product’s current stock level can not support an order with the quantity of items that the subscription holds. 2. The product has a minimum/maximum quantity restriction that the quantity in the subscription does not follow. | Verify stock level and min/max quantity restrictions on the product in BigCommerce, and then check which of the two is causing the issue by checking the quantity assigned to the subscription’s invoice in Rebillia. |
| The field ‘customer_id’ is invalid. | – | BigCommerce | The customer Rebillia is trying to create the order to does not exist. This normally happens when a customer deletes their BigCommerce account without first cancelling their subscription. | At this point, you will need to contact the customer to understand what they want to do: 1. Cancel the subscription. 2. Create a new account and link the customer account in Rebillia to the new customer account in BigCommerce. |
| The store is suspended. This may be due to an administrative action, or due to a billing issue. Please contact BigCommerce support for more information. | – | BigCommerce | BigCommerce has restricted any external API calls, so when Rebillia tries to create an order, it is blocked by BigCommerce. As the error message describes, this is normally happening due to overdue payment status on the BigCommerce account. | N/A |
| The field ‘products.0.product_id’ is invalid. | – | BigCommerce | The product Rebillia is trying to create the order with does not exist. The most common reason for this to happen is if the company decided it wants to rebuild the product, so they made a copy of the original product, made all changes on the copy, then published the copy and deleted the original. Even though the subscription options were copied as well, Rebillia is linked to the original product, so it does not recognize the new product as a subscription product. | Sadly, in order to keep all of the selections the customers have made safe, there is no way for a user to make this fix in the app interfaces. Please contact your account manager, or our support team, to handle this issue. |