ShipStation Connector FAQs

These frequently asked questions cover the most common setup, sync, label, and troubleshooting topics for the TeqStars ShipStation Connector. For a full feature list, see ShipStation Connector Features.

Getting Started

Is the connector compatible with Odoo Enterprise and Community editions?

Yes. Fully compatible with Odoo Enterprise (On-premise and Odoo.SH) and Odoo Community on version 20.0. Not compatible with Odoo Online (SaaS) as it does not support third-party apps.

Which ShipStation API versions are supported?

Both API v1 (ssapi.shipstation.com, API Key + Secret) and API v2 (api.shipstation.com/v2, API v2 Key). You choose the version per account. v1 rates a single carrier; v2 adds multi-carrier rate shipping and a live tracking URL. Store sync always runs on the v1 API, so a v2 account also needs v1 credentials for store flows.

Should I use API v1 or v2?

Use v2 to compare rates across multiple carriers in one quote and to get live tracking URLs. Use v1 for the classic single-carrier workflow. You can also run different accounts on each version in the same database.

How do I connect my ShipStation account to Odoo?

Go to ShipStation ‣ Settings ‣ Accounts, click New, set the API Version, paste the matching credentials (V1: API Key V1 + API Secret V1; V2: API Key V2, plus V1 keys for store sync), then click Confirm. Confirming auto-imports your stores, carriers, services, packages, warehouses, and products.

Details: Create a ShipStation Instance in Odoo.

Where do I generate the API credentials?

In ShipStation, open Account Settings ‣ Account ‣ API Settings. For V1, generate the API Key and API Secret (the secret is shown only once, so copy it before navigating away). For V2, generate the API v2 Key. Step-by-step: Generate ShipStation API Credentials.

Can I run more than one ShipStation account on the same Odoo database?

Yes. Create one ShipStation account record per ShipStation account. Each one has its own credentials, stores, carriers, services, warehouses, products, and scheduled actions. The same key and secret pair cannot be added twice on the same database.

How do I automate order import, order export, or shipment-details sync?

Open the account at ShipStation ‣ Settings ‣ Accounts, switch to the Automated Actions tab, and check Auto Import Orders?, Auto Export Orders?, or Auto Import Shipment Details?. Then click the Scheduled Actions link next to the checkbox to activate the matching scheduled action and pick a run interval (default 1 day).

Stores, Carriers & Services

Why are stores marked "Inactive" also imported?

The connector imports inactive stores so historical orders that reference a now-deactivated store still resolve. You can hide inactive stores in the list view with the search filter.

How do I refresh a single carrier's balance?

Go to ShipStation ‣ Settings ‣ Carriers, open the carrier, and click Refresh. The connector re-fetches that carrier from ShipStation, so the balance, account number, and primary flag are refreshed without re-importing everything.

What is "Requires Funded Account" on a carrier?

It is the ShipStation flag for carriers that need a positive prepaid balance to issue labels (Stamps.com, Endicia). Top them up with the Top Up Carrier Account Balance wizard.

How do I limit which services appear when creating a delivery method?

The Service field on the delivery method is filtered by the chosen Carrier. Only services that belong to that carrier (and were imported via Import Carriers and Services) show up.

Why are some packages flagged "Is Your Packaging"?

ShipStation distinguishes between carrier-provided packaging (e.g. FedEx Envelope) and your own packaging. When Is Your Packaging is checked, the connector reads dimensions from the linked Odoo package type and sends them to ShipStation during rate and label requests. Carrier-provided packages do not need dimensions.

Orders

Why are only "Awaiting Shipment" orders imported?

The connector imports only orders that are waiting to be shipped. Orders that are already shipped, on hold, or cancelled in ShipStation are intentionally out of scope; they are managed entirely in ShipStation. Details: Import Orders from ShipStation.

An imported order is missing a product. What happened?

Every order line must resolve to an Odoo product. The connector matches by ShipStation product identifier and then by internal reference. If neither matches and Create Product if not found? is unchecked on the account, the order is skipped for that run. Check the box (or pre-import the catalogue) and re-run the import.

Where does the shipping charge on the imported sales order come from?

When the ShipStation order carries a shipping amount, the connector creates a sales-order line using the account’s Shipping Product with the corresponding price. If the field is empty, the shipping line is not created, so configure the field before going live.

How does incremental import work?

The account stores Last Order Import Date. On the next import, the connector looks at orders from 3 days before the saved date onward. The overlap catches late-modified orders without re-importing the full back-catalogue.

Can I re-import a single order from ShipStation?

Not from the standard UI. The wizard fetches every awaiting-shipment order since the saved date. For a one-off recovery, clear the Last Order Import Date on the account and run the import. Only orders still in Awaiting Shipment status will be re-imported.

Shipments & Labels

What is the difference between exporting an order and generating a label?

Exporting (Export Delivery Orders to ShipStation) creates the ShipStation order so it appears in the ShipStation dashboard alongside orders from your stores. Generating a label (Generate Shipping Labels) actually purchases the label, returns the tracking number, and attaches the PDF to the delivery order. You can do one without the other.

Are international shipments supported?

Yes. When the destination country differs from the warehouse country, the connector adds international options to the label request: customs items are auto-built from delivery lines, and the Content Type plus Non-Delivery Option come from the delivery method.

How are dimensions sent to ShipStation?

Only when the chosen package is Your Packaging. In that case the connector reads height, width, and length from the linked Odoo package type, converts them to inches, and sends them with the request.

Where does the label PDF end up?

It is attached to the chatter on the delivery order with a message that includes the tracking number. Reprint by downloading the attachment from the chatter.

Can I switch between "test" and "production" labels?

The Test Environment toggle on the delivery method controls whether labels are issued in test mode. Test labels are not billed and cannot be scanned by carriers, so switch to production once setup is validated.

Tracking & Sync

When is the carrier tracking number written on the delivery order?

Whenever the connector pulls a shipped status from ShipStation, either via the Import Shipment Details operation in the Operations wizard, automatically when an internal transfer linked to an exported delivery is validated in multi-step warehouses, or via the Auto Import Shipment Details scheduled action. Tracking numbers from all non-voided shipments are joined with commas. Details: Sync Shipment Details and Tracking.

What happens to my Odoo delivery order when the ShipStation order is cancelled?

On the next sync the connector sees that the order is Cancelled and cancels the related delivery order in Odoo.

Are voided shipments included in the tracking sync?

No. The connector reads each shipment’s status and skips any that were voided.

How long are activity logs retained?

10 days. A daily cleanup removes older log entries automatically. Export to an external system if you need long-term audit.

Pricing & Rates

How does the rate displayed at checkout match the final billed cost?

The rate displayed at checkout is requested in real time with the same carrier, service, package, and dimensions that the label request will use. ShipStation guarantees that the rate is the price for that exact combination, so the final billed cost is normally identical, unless the carrier later applies a dimensional-weight or address-correction surcharge.

Why is the rate lookup returning zero?

The validator usually surfaces the exact problem (missing weight, missing address fields, missing store). If validation passes but ShipStation still returns zero, check that the carrier has a positive balance (when Requires Funded Account is checked) and that the carrier-service-package combination is supported for the destination.

Can I use ShipStation rates without exporting the order?

Yes. Rate lookup is independent of order export: the connector requests a rate from the sales-order delivery line regardless of whether the delivery order has been pushed to ShipStation yet.

Does the connector store the exact billed cost?

Yes. After a label is generated, the connector writes ShipStation Shipping Cost on the delivery order with the value reported by ShipStation.

Which currency does ShipStation return prices in?

ShipStation returns prices in the currency of the carrier account configured in ShipStation. The connector forwards that value to Odoo’s standard delivery flow without conversion.

Troubleshooting

I get "Please define ShipStation Store in delivery method": what does it mean?

The delivery method must have a ShipStation Store selected for rate, export, or label requests to be valid. Edit the delivery method and pick a store. Details: Configure a ShipStation Delivery Method.

Rate lookup fails with "Please define Weight in products": how do I fix it?

ShipStation requires a weight for every line item. Set a non-zero weight on each product in the order. Re-running the rate lookup afterwards should succeed.

Where do I see the exact request and response of a failing action?

Go to ShipStation ‣ Accounts, click the Logs link on the account’s kanban card, and pick the latest entry. It contains the full request URL, request data, and response. Details: Activity Logs & Troubleshooting.

A label was issued in ShipStation but Odoo does not show the tracking number. What now?

Run the Import Shipment Details operation: ShipStation ‣ Accounts, click Operations on the account card, set Shipstation Operation to Import, pick Import Shipment Details, and click Process. The action pulls the latest status from ShipStation and writes the tracking number and shipping cost on the delivery order. If the order is still in Awaiting Shipment status, ShipStation has not yet processed the label; wait a minute and retry.

My delivery order won't validate / no label is generated. What's wrong?

The connector validates inputs before sending anything to ShipStation. The error message on the picking will tell you exactly what is missing. Common causes: weight not set on every line product, incomplete shipping or warehouse address (city / state / ZIP / country), missing ShipStation Store on the delivery method, or a prepaid carrier (Stamps.com / Endicia) with a zero balance. Fix the field shown in the error and try again.

Support

Is a free setup session really included?

Yes. Every purchase includes a free 60 to 90 minute screen-share session with our team. We walk through credentials, configuration, first import, and go-live with you: not a PDF, not a chatbot, real developer support.

Will I receive complimentary support and upgrades upon buying the application?

We offer free support for the initial 60 days after the purchase date. Beginning from version 13, each app version will be sold separately as per Odoo Policy.