- Print
- DarkLight
ShipStation Integration Overview
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) | ErrorMessage | Details/Action |
---|---|---|
Errors Specific to ShipStation API | ||
ServiceCode | Invalid servicecode provided for Service [ship method] | |
Disabled or un-processable servicecode provided for Service [ship method] | ||
TransactionID | Invalid transaction id provided | |
Missing the required field: tranaction_id | ||
Tracking Number | Please provide a valid tracking number | |
VoidRequests | Missing the required field: void_requests | |
ClientID, Username, Password | Missing 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 | ||
Address | Missing the following required [address/country/state/postalcode] field | |
LabelFormat | Invalid 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] | ||
LabelLayout | Invalid label layout provided: [label layout] | |
The requested label layout is not supported in ZPL format: [label layout] | ||
Converter error message | ||
Label | The label path does not exist | |
Item | Missing 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: 400 | Bad Request | The request was malformed and the server was unable to process it. Once the issue has resolved, retry the API call. |
HTTP Code: 404 | The endpoint provided cannot be found: [endpoint] | |
HTTP Code: 500 | Internal Server Error | The 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: 501 | Not Implemented | The server does not support the functionality required to fulfill the request. |
HTTP Code: 502 | Bad Gateway | The 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: 504 | Gateway Timeout | The 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 |