Skip to main content

Sandbox

With Shipmondo Sandbox, you can test your API integration, shipment bookings, prints, and other features in a closed test environment at no cost to you. When using the Shipmondo API, our sandbox allows you to confirm that your data is delivered correctly and that the booking has been successful.

How to Get Started with Shipmondo Sandbox​

If you want to test your data in our sandbox, you need to send a request to our support team, providing the following information:

  • Name
  • Email address
  • Reason for wanting to use Shipmondo Sandbox

You will then receive an email from our customer service with login details, and you will be ready to test the Shipmondo API or Shipmondo Sandbox.

Go to https://sandbox.shipmondo.com/account/login/ and log in with your Shipmondo account.

At the top of your Shipmondo account you can see it is a sandbox version. img alt

Test: Booking Shipments​

There is no limit to the number of shipments you can book. However, there is a limitation on which carriers you can choose when creating the shipment. Currently, you can choose from the largest and most commonly used carriers.

Our sandbox supports the following carriers:

  • Bring Denmark, Norway, Sweden
  • dao
  • DHL Freight Sweden, Denmark
  • DHL Parcel Germany
  • GLS Denmark
  • PostNord Denmark, Norway, Sweden, Finland
  • UPS

You can find your booked shipments under the menu Shipments > Booked in your sandbox Shipmondo account.

Using the Print Client in the Sandbox​

The Print Client is supported in the Sandbox. You just need to make a few small changes to the config file to make it connect to the Sandbox instead of Production.

First step is to locate the config file. The file is named settings.json. On Windows it is located in AppData\Local\Shipmondo and on Mac it is located in .local/share/Shipmondo/settings.json.

You need to update the following keys:

  • apiUrl = https://sandbox.shipmondo.com/api/public/v3/
  • wsUrl = wss://ps-sandbox.shipmondo.com/websocket
  • psUrl = https://ps-sandbox.shipmondo.com/api/
  • psDomain = .ps-sandbox.shipmondo.com (the dot in the beginning of the line is important)

When testing you can consider setting testPrint to true. This causes the Print Client to handle jobs normally, but it will skip the actual printing phase.

Below is an example for settings.json that connects to the Sandbox and skips the printing step.

{
  "apiUser": "paste-in-api-user",
  "apiKey": "paste-in-api-key",
  "inputPath": null,
  "successPath": null,
  "outputPath": null,
  "failPath": null,
  "locale": "da-DK",
  "responseFormat": null,
  "openOnStartUp": false,
  "useFileIntegration": false,
  "minimizeOnStartUp": false,
  "version": null,
  "apiUrl": "https://sandbox.shipmondo.com/api/public/v3/",
  "wsUrl": "wss://ps-sandbox.shipmondo.com/websocket",
  "psUrl": "https://ps-sandbox.shipmondo.com/api/",
  "psDomain": ".ps-sandbox.shipmondo.com",
  "debugMode": true,
  "persistentLog": false,
  "proxyUrl": null,
  "proxyUsername": null,
  "proxyPassword": null,
  "testPrint": true
}

Please note​

  • The speed in the sandbox environment cannot be compared to the production API. Therefore, it cannot be used to test performance.

  • You cannot use payment cards in the sandbox, as all tests are free. In connection with creating a login for the Sandbox, you will receive fictitious money in your balance. When you book your shipments, you will be presented with a price, but you simply choose to use the balance as payment.

Transitioning from Sandbox to Live​

When you have tested that your data is delivered correctly in our sandbox, you are ready to switch to live. To do this, you need to change the URL in your API from https://sandbox.shipmondo.com to https://app.shipmondo.com and update the keys. You can find your API keys under Settings > API > Access.