ShipStation

ShipStation is a web-based, multi-carrier shipping solution for eCommerce retailers. Designed to streamline the fulfillment process, this software offers many integrations that allow you to import and process orders.

ShipStation and MRPeasy can work seamlessly together, so orders are prepared in MRPeasy and shipped from ShipStation using a wide selection of available carriers.

Jump to:

1. Connecting MRPeasy and ShipStation.
2. General information:
   1. General principles.
   2. Data sent to ShipStation.
   3. Shipment’s weight.
   4. Selling prices, taxes, discounts.
   5. Addresses.
   6. Limitations.
3. Using the ShipStation integration:
   1. Sending a shipment to ShipStation.
   2. Deleting a shipment already sent to ShipStation.

Connecting MRPeasy and ShipStation

1. You must have an active account in ShipStation.
2. Log in to your ShipStation account, go to Settings -> Account -> API settings:
   • Now press the green button “Generate API keys” if the keys have not been generated earlier or “Regenerate API keys” if they have been generated earlier.
3. ShipStation generates two keys: API Key and API Secret. Example:
   • API Key:                0b7ae06eb123456789f60d00f3454052
   • API Secret:            22f2b1234a5a678eaef19bd60d466ef4 
4. Log in to your MRPeasy account, go to Settings -> System settings -> Integrations:
   • Press the button “Connect to ShipStation” in the section “ShipStation.”
   • In the opened window, Input the ShipStation API Key and API Secret into the relevant fields and press “Save.” 

General information

General principles

The integration between MRPeasy and ShipStation is mostly a one-way integration:

• Shipments are prepared in MRPeasy and sent to ShipStation for shipment.
• Carrier selection, label printing, package shipping, and tracking are performed in ShipStation.
• When an order is shipped in ShipStation, a tracking number is imported from ShipStation to the shipment details in MRPeasy.

Data sent to ShipStation

The following data is sent to ShipStation

• The order number.
• The order date.
• The order status.
• Customer email.
• SKU, part name, quantity, weight, price, and tax for each shipment row.
• Address.

Shipment’s weight

If Packing is enabled in MRPeasy, the shipment's weight will be sent to ShipStation.

Selling prices, taxes, discounts

1. The price and tax are sent to ShipStation for Shipments originating from Customer Orders.
   • Customer returns (Return Merchandise Authorization) and Purchase Order (Subcontracting) shipments are sent without prices.
2. Prices are taken directly from the Customer Order, incorporating any applied discounts.
   • ShipStation lacks a separate discount field. Therefore, prices sent to ShipStation already reflect any discounts applied in MRPeasy.
3. Taxes are derived from invoices linked to the Shipment:
   • If an invoice is linked to the shipment, taxes are taken from that invoice.
   • If no linked invoice exists, but an invoice with the same items is found in the Customer Order, taxes are taken from that invoice.
   • Only invoice type “Invoice” is considered, excluding prepayment or credit invoices.
4. MRPeasy cannot send the currency information to ShipStation. Therefore, the prices will be displayed in the default ShipStation currency even when it differs from the Customer Order’s currency.

Addresses

Structured addresses must be used for customers or vendors to be able to send them to ShipStation.

• The shipping address must include a valid postal code.
• Free-text addresses are not supported.

Important limitations

1. Minor price discrepancies:
   • If the same product appears on multiple lines in a customer order with different prices, the prices in ShipStation may differ from those in MRPeasy.
   • If a discount is not an integer, the resulting prices in ShipStation may differ slightly from those calculated in MRPeasy.
   • Also, due to rounding, a 1-cent difference may occur between MRPeasy and the total displayed in ShipStation.
2. Shipments cannot be sent if any item has a decimal quantity.
3. When updating a Shipment, discount or tax updates may not be reflected correctly in ShipStation.

Using the ShipStation integration

Sending a shipment to ShipStation

1. Create a Shipment for a customer order, RMA return, or subcontracting PO.
2. Press the “Send to ShipStation” button.
   • If the shipment status in MRPeasy is “New,” then the ShipStation order will have the status “On hold.”
   • If the shipment status in MRPeasy is “Ready for shipment” or “Shipped,” then the ShipStation order will have the status “Awaiting shipment.”
3. If the shipment is modified in MRPeasy, then after saving changes, you can press the “Send to ShipStation” button to update the order in ShipStation.
   • Changes cannot be made if the ShipStation order has the status “canceled” or “shipped.”
   • Note that discount or tax updates must be verified manually in ShipStation.
4. When an order is shipped in ShipStation, a tracking number is imported from ShipStation to the shipment details in MRPeasy.

Deleting a shipment already sent to ShipStation

When you delete a shipment in MRPeasy, MRPeasy checks if it had been sent to ShipStation earlier:

1. If yes, then MRPeasy asks if you want to delete it in ShipStation.
2. If you select that you wish to delete it in ShipStation, it will be canceled in ShipStation.
   • ShipStation orders cannot be canceled if their ShipStation status is “canceled” or “shipped.”