Sign in



Ship Help

Search Ship Help

Activating and using the Developer Tools

Avatar
Malene Tidemann
Updated

The Developer Tools enable you to test and build requests to the Shipment Server API. This article will help you get started.

You need a Portal login to access the Developer Tools. Contact nShift Customer Service to get a Portal account if you don't have one already.


Go to:

 

Activating the Developer Tools

  1. Log into nShift Portal.

  2. Go to Ship > Configuration > Settings.

    settings-tab.png

  3. Scroll down and check Show developer tools under the New Booking headline.

    developer-tools.png

  4. You will now have access to the Developer Tools at the bottom of all relevant pages under New Bookings.

 

Using the Developer Tools

The Developer Tools section has two drop-down menus where you can set the label type and the command. Notice that there are different commands available depending on which page you are on. If shipment data is needed in the request, the Developer Tools will use the data you have filled in on the current page. This way you can easily fill in relevant information and see what the request will look like.

developer-tools-section.png


The Data field shows the request. Some commands support additional options, which are added in the Options field. Please see our list of methods here to see which options are available for each command. The Response field shows the response you receive after sending your request.

 

 

Example of how to create a SubmitShipment request

The SubmitShipment command creates a shipment and generates a response with a label.

  1. Go to Ship > New and fill out all the fields related to the shipment, i.e. address fields, carrier, and goods information.

  2. In the Developer Tools section, choose the SubmitShipment command. This will show the request in the Data field, using the shipment data you have filled in. You can fill in data in reference fields, messages, etc., and immediately see how they are added to the request.

  3. Click the Send button. If the request is successful, you will receive a response containing the label. If something is missing in the request, you will receive an error message in the response. 

  4. Click the View labels button to see the label(s) of a successful SubmitShipment request. 

  5. Use the Reformat data if you have edited it or copy-pasted a request into the data field and want the data in a reading-friendly format. 

 

Tip: If you are building requests for Shipment Server, you can always copy-paste your requests into the Data field and test them. If your request already contains all the necessary information, you don't have to fill in the fields on the page. The user interface just provides an easy way to see how data is added to a request.

 

For more information on Commands, Methods and Options click here.

For an appendix of objects and fields, click here.

Related articles