ShipStation Integration Overview
  • 02 Aug 2024
  • 3 Minutes to read
  • Contributors
  • Dark
    Light

ShipStation Integration Overview

  • Dark
    Light

Article summary

This guide provides basic information regarding the integration between ShipStation and Landmark Global’s TMS platform, Mercury. The integration allows users to generate and retrieve Landmark international shipping labels and tracking within ShipStation. Processed Mercury shipments can also be voided from ShipStation.

Requirements

Use provided Landmark Client ID, username, password to set up Landmark Global as a carrier in ShipStation.

Customs information MUST be linked to SKUs. To do this, set ShipStation to create declarations from order items in Settings > Shipping > International Settings.

Users must have a Platinum plan or higher with ShipStation in order to integrate with Landmark.

Sending orders to Landmark

Filter by international orders, then select a service code to use and create a label. Order information is entered into Mercury and the label is viewable within ShipStation. A tracking number is also returned.

After this the order will need to be processed through Mercury—client services will be able to assist with any questions along this process.

Service selection options

LGI Standard DDP

LGI Standard DDU

LGI Expedited DDP

LGI Expedited DDU

LGI Regular DDU – Non-tracked service

LGI Postal Tracked DDU

If shipping strictly DDU shipments, SKUs can be auto-generated upon import if they aren’t available within ShipStation.

Setting Tax ID information in ShipStation

Tax ID information such as IOSS tax IDs can be added directly in ShipStation. To set tax IDs, go to Account Settings > Shipping > International Settings. Here you can click the "Add a Tax Identifier" button to configure.

Troubleshooting

Possible error: “Bad Request: Missing item information: sku TransactionID=example”

Resolution: This error typically occurs when customs information isn’t correctly linked with SKUs. To fix this:

1) Set international setting to "Create declarations from order items".

OR

2) Add customs information in the product record under the customs tab. 

These are the only methods to ensure customs information will be associated with SKUs. Predefined settings can't be used in any way to attach SKUs. Be sure to apply settings to already existing orders when changes are made.


Additional Information on Available Features and Integration Notes: Landmark Global ShipStation Integration Overview


Possible Errors

This table lists all errors that may be returned by the ShipStation API endpoint. [Brackets] in the ErrorMessage are used to represent to the value passed for the related element. An example is provided when an ErrorMessage is variable.

Related Element(s)ErrorMessageDetails/Action
Errors Specific to ShipStation API
ServiceCodeInvalid servicecode provided for Service [ship method]

Disabled or un-processable servicecode provided for Service [ship method]

TransactionIDInvalid transaction id provided
Missing the required field: tranaction_id
Tracking NumberPlease provide a valid tracking number
VoidRequestsMissing the required field: void_requests
ClientID, Username, PasswordMissing registration info: client_id, username, and password

Client ID, username, and password are required to make this request
Could not authorize user [username] for client [client id] with the login information provided
AddressMissing the following required [address/country/state/postalcode] field
LabelFormatInvalid label format provided: [label format]
The requested label format is not supported for shipments that are not Landmark routed: [label format

Could not generate a label image in the desired format: [requested label format]

LabelLayoutInvalid label layout provided: [label layout]

The requested label layout is not supported in ZPL format: [label layout]
PDFConverter error message
LabelThe label path does not exist
ItemMissing item information: [info missing]
Please provide an item quantity greater than zero
Currencies of the items are not all the same.  Found [item's currency], but expected [shipment's currency]

Server/HTTP Errors
HTTP Code: 400Bad RequestThe request was malformed and the server was unable to process it. Once the issue has resolved, retry the API call.
HTTP Code: 404The endpoint provided cannot be found: [endpoint]
HTTP Code: 500Internal Server ErrorThe server servicing the request ran into an unexpected error. Retry the API call and if the issue persists, reach out to itsupport@landmarkglobal.com
HTTP Code: 501Not ImplementedThe server does not support the functionality required to fulfill the request.
HTTP Code: 502Bad GatewayThe systems servicing the request ran into an issue communicating with each other. Retry the API call and if the issue persists reach out to itsupport@landmarkglobal.com
HTTP Code: 504Gateway TimeoutThe gateway servicing the request did not receive a response back from the backend server in the allotted time. Retry the API call and if the issue persists, reach out to itsupport@landmarkglobal.com 


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.