ShipEngine Connector FAQs

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

Getting Started

What does the ShipEngine Connector do?

It connects Odoo to multiple shipping carriers through one ShipEngine integration. Odoo sends order details to ShipEngine and gets shipping labels, tracking numbers, and real-time rates back. You can also cancel shipments in ShipEngine from Odoo.

Can I connect more than one ShipEngine account?

Yes. You can connect and set up multiple ShipEngine accounts in your Odoo database.

Does the connector handle domestic and international shipments?

Yes. You can configure delivery methods for both local and global shipments. Each imported service shows whether it is Domestic ? or International ?. For international shipments, the connector can generate a commercial invoice.

Setup

How do I connect my ShipEngine account to Odoo?

Create a shipping partner record and choose the ShipEngine option.
Enter your ShipEngine key in API Key.
Click Retrieve Available Carrier to import your carriers.

Details: Configure ShipEngine Connector.

How do I import services and packages for a carrier?

Open the imported carrier and click Get Services and Get Packages. Then use the Services and Packages buttons to see what was imported.

What information does an imported carrier show?

Each carrier shows its Name, ID, Code, and Provider. It also shows Primary, Requires Funded Amount?, Balance, Multi-Package Support?, and Support Label Message?.

How do I set up a ShipEngine delivery method?

Create a delivery method and choose Ship Engine as its provider. Choose configured Shipping Partner. Then open the Configuration tab and set:

Carrier and Default Package Type.
Confirmation, Shipment Content Type, and Non Delivery.
Weight Unit and Dimension Unit.
Insurance Provider.
Saturday Delivery, Non Machinable, Delivery Duty Paid, and Is a Commercial Invoice Required? as needed.

Details: Configure ShipEngine Connector.

Which delivery confirmation options can I choose?

Confirmation sets the type of delivery confirmation that the shipment needs. The options are None, Delivery, Signature, Adult Signature, Direct Signature, Delivery Mail, and Verbal Communication.

What do Shipment Content Type and Non Delivery control?

Shipment Content Type sets the type of contents in the shipment: Merchandise, Documents, Gift, Returned Goods, or Sample. This may affect import duties or customs treatment. Non Delivery tells the carrier what to do if a package cannot be delivered: Return To Sender or Treat As Abandoned.

Which weight and dimension units are supported?

Weight Unit supports Kilogram, Pound, Ounce, and Gram. Dimension Unit supports Inch and Centi Meter (cm).

Which insurance providers can I use?

Insurance Provider sets who insures any insured packages in the shipment. The options are Carrier, Shipsurance, and Third Party.

What do Saturday Delivery, Non Machinable, and Delivery Duty Paid do?

Saturday Delivery enables Saturday delivery, if the carrier supports it.
Non Machinable marks a package that is too large or irregularly shaped to process automatically. It is mainly for USPS shipments.
Delivery Duty Paid means you pay the international delivery duties. UPS, FedEx, and DHL Express support this option.

Daily Use

How do I compare ShipEngine rates on a sales order?

Choose your ShipEngine delivery method on the sales order. The ShipEngine Carriers tab lists the available services. Each one shows its Shipengine Service, Shipengine Carrier, Delivery Time, Shipping Amount, Insurance Amount, and Total Charges. Pick the best option and click Add to order.

Can I get rates from the delivery order too?

Yes. After you select the carrier on the delivery order, use the Get Rates button next to it to fetch rates and choose a service.

What happens when I validate the delivery order?

The connector generates the shipping label automatically. It also generates the commercial invoice when that is turned on. The chatter shows “Shipment created!” with the tracking numbers. The delivery order also stores the ShipEngine Tracking URL(s) and the Label Id.

Can I ship an order in more than one package?

Yes. Use the Put in Pack operation on the delivery order to split the goods into several packages. Tracking and shipping information is shown for single and multiple parcels.

How do I get a commercial invoice for an international shipment?

Turn on Is a Commercial Invoice Required? on the delivery method. When the label is created, ShipEngine’s commercial invoice is attached to the delivery order with the label.

How do I track a shipment?

Open the delivery order and use the ShipEngine Tracking URL(s). This shows the status and location of your order.

Can I cancel a shipment from Odoo?

Yes. You can cancel the shipment in ShipEngine from the delivery order with a single click. The chatter then shows “Shipment #… has been cancelled”.

Troubleshooting

I see "ShipEngine Account not defined to import Carrier list". What should I check?

The connector cannot find a ShipEngine account to import carriers from. Check that your shipping partner record uses the ShipEngine option and that its API Key is filled in. Then click Retrieve Available Carrier again.

I see "A production key is required to get your ShipEngine carriers." What does it mean?

The key in API Key is not a valid API key. Enter your ShipEngine production key and retrieve the carriers again.

I see "Please select at least one service by clicking on Get Rates." What should I do?

No ShipEngine service is selected for the delivery order. Click Get Rates, next to the carrier on the delivery order, and select a service.

I see "Unsupported unit of measure." What should I check?

The weight unit is not supported by carrier or service. Check the Weight Unit on the delivery method.

I see "HTTP error occurred", "Request error occurred", or "Failed to parse JSON response from Shipengine." What does it mean?

Odoo could not get a valid reply from ShipEngine. The message includes the error details. Check your API Key and try again. If the error does not go away, contact support. See ShipEngine Connector Support Policy.