Neoship Api (1.0.0)

Login to Neoship to obtain a token

Refresh JWT token after expriation

Create new package

Bulk action to create new packages. Packages are created only if all values are valid. If one package is invalid no one package is created

Combined endpoint that creates packages and immediately prints stickers in a single call. The label PDF is saved to storage (accessible via GET /package/{id}/label) and is not returned in the response.

This endpoint combines the functionality of POST /package/bulk/{shipper_id} (package creation) and POST /package/bulk/ with action=send_print_sticker (sticker printing) into one atomic operation.

Info package

Edit package which has not been exported

Delete package which has not been exported

Downloads the label PDF for a package that has been exported (sticker printed). The label must have been previously generated via POST /package/bulk/ with action=send_print_sticker or via POST /package/bulk-create-and-print/{shipper_id}.

Cancel package. Cancels the shipment at the shipper and marks the package as cancelled. Reference number is prefixed with X. Only packages in shipping (not yet exported) or service packages can be cancelled.

List of packages

List of packages by the list of reference numbers. If the list of reference numbers contains invalid reference numbers, the packages corresponding to invalid reference numbers are not included in response content.

Bulk action for getting stickers or acceptance protocol.

Calculate available package shipping quotes for the authenticated user.

Calculate available package shipping quotes for a selected user. The response includes purchase prices when available.

Detail about user

List of parcelshop

Detail of parcelshop

Tracking of packages by tracking number. This is usefull, if you want to show the information in your app.

Tracking of packages by reference number and user id. This tracking is returning the page with the styles, not needed parsing response or anything else.

Tracking of packages by tracking number. This tracking is returning the page with the styles, not needed parsing response or anything else.

The parcelshop picker is an embeddable map UI for selecting a delivery point. It is intended for checkout or shipment forms where the customer chooses a parcelshop.

For usage on your own domain, create a parcelshop picker API key in Neoship and store the exact parent page origin for that key, for example https://eshop.example. One key can have multiple allowed origins in Neoship.

Use https://aplikacia.neoship.sk for production and https://t-we-nshp-webapp-01-app.azurewebsites.net for testing.

JavaScript integration

Load the versioned JavaScript library on your page:

<script src="https://aplikacia.neoship.sk/parcelshop-picker/v1/library.js"></script>

Open the picker:

<button type="button" id="open-picker">Choose parcelshop</button>

<script>
  const apiKey = "XXXXXXXXXXXXX";

  document.getElementById("open-picker").addEventListener("click", () => {
    window.NeoshipParcelshopPicker.pick(apiKey, (parcelshop) => {
      if (parcelshop === null) {
        // Picker was closed without selection.
        return;
      }

      // Save parcelshop.parcelshopId into your order/package parcelshop field.
      console.log(parcelshop);
    });
  });
</script>

pick() opens the picker in a full-screen iframe dialog, validates messages from the iframe origin, dispatches the neoship:parcelshop-picker:selected browser event, and closes the previous picker before opening a new one.

Selection payload

The selected parcelshop payload has this shape:

{
  "shipperId": "3",
  "parcelshopId": "12345",
  "name": "Parcelshop name",
  "street": "Main street 1",
  "zip": "81101",
  "city": "Bratislava",
  "stateCode": "SK",
  "lat": 48.1486,
  "lng": 17.1077,
  "openingHours": null,
  "boxType": null,
  "occupancyStatus": null
}

Use parcelshopId as the parcelshop value when creating a parcelshop package.

JavaScript API

window.NeoshipParcelshopPicker.pick(apiKey, callback, options);
window.NeoshipParcelshopPicker.close();

You can also use object-style arguments:

window.NeoshipParcelshopPicker.pick({
  apiKey: "XXXXXXXXXXXXX",
  selectedShipper: "GLS",
  availableShippers: ["GLS", "Packeta"],
  countries: ["SK", "CZ"],
  language: "sk-SK",
  autoZoomToUser: true,
  onSelect: (parcelshop) => {},
  onClose: () => {},
});

The callback receives the selected parcelshop payload. If the picker is closed without selection, the callback receives null. close() closes the currently open picker, which is useful for single-page applications and host-page modal cleanup.

Options

These options can be passed in the options object, or in the object-style pick({...}) call.

When the library is loaded from https://aplikacia.neoship.sk/parcelshop-picker/v1/library.js, the default picker iframe opens https://aplikacia.neoship.sk/neoship/parcelshop-picker/ even when the script is embedded on another domain. You can override this only with url or pickerUrl in advanced integrations.

Manual iframe integration

The JavaScript library is recommended. If you need to render the iframe manually, use the picker page directly and handle window.postMessage yourself:

<iframe
  src="https://aplikacia.neoship.sk/neoship/parcelshop-picker/?apiKey=XXXXXXXXXXXXX&selected_shipper=GLS&available_shippers=GLS,Packeta&countries=SK,CZ&language=sk-SK"
  title="Výber parcelshopu"
  allow="geolocation"
  style="width: 100%; height: 700px; border: 0;"
></iframe>

const pickerOrigin = "https://aplikacia.neoship.sk";

window.addEventListener("message", (event) => {
  if (event.origin !== pickerOrigin) {
    return;
  }

  const message = event.data || {};

  if (message.type === "neoship:parcelshop-picker:selected") {
    const parcelshop = message.detail;
    // Save parcelshop.parcelshopId into your order/package parcelshop field.
  }

  if (message.type === "neoship:parcelshop-picker:close") {
    // Close your modal or hide the iframe.
  }
});

Posted messages

The iframe sends these message types to the parent window:

• neoship:parcelshop-picker:ready - picker loaded and initialized
• neoship:parcelshop-picker:selected - user selected a parcelshop
• neoship:parcelshop-picker:error - picker initialization or data loading failed
• neoship:parcelshop-picker:close - user clicked close or pressed Escape