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¶
Yes. Fully compatible with Odoo Enterprise (On-premise and Odoo.SH) and Odoo Community on version 19.0. Not compatible with Odoo Online (SaaS) as it does not support third-party apps.
Any ShipStation account on which you can generate API Keys (most paid plans). The connector signs in with the API Key + API Secret you generate from your ShipStation account settings.
Go to , click New, paste your API Key and API Secret, then click Confirm. Confirming auto-imports your stores, carriers, services, packages, warehouses, and products.
Details: Create a ShipStation Instance in Odoo.
In ShipStation, open and click Generate New API Keys. The API Secret is shown only once — copy it before navigating away. Step-by-step: Generate ShipStation API Credentials.
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.
Open the account at , switch to the Automated Actions tab, and toggle Auto Import Orders?, Auto Export Orders?, or Auto Import Shipment Details? to Yes. Then click the Scheduled Actions link next to the toggle to activate the matching scheduled action and pick a run interval (default 1 day).
Stores, Carriers & Services¶
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.
Go to , 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.
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.
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.
ShipStation distinguishes between carrier-provided packaging (e.g. FedEx Envelope) and your own packaging. When Is Your Packaging is Yes, 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¶
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.
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 disabled on the account, the order is skipped for that run. Enable the toggle (or pre-import the catalogue) and re-run the import.
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 — configure the field before going live.
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.
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¶
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.
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.
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.
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.
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 — switch to production once setup is validated.
Tracking & Sync¶
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.
On the next sync the connector sees that the order is Cancelled and cancels the related delivery order in Odoo.
No. The connector reads each shipment’s status and skips any that were voided.
10 days. A daily cleanup removes older log entries automatically. Export to an external system if you need long-term audit.
Pricing & Rates¶
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.
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 Yes) and that the carrier-service-package combination is supported for the destination.
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.
Yes. After a label is generated, the connector writes ShipStation Shipping Cost on the delivery order with the value reported by ShipStation.
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¶
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.
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.
Go to , 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.
Run the Import Shipment Details operation: , 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.
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¶
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 live with you — not a PDF, not a chatbot, real developer support.
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.