Skip to main content

Resources and actions

Shipmondo supports the following resources:

  • orders
  • shipments
  • shipment drafts
  • shipment monitor (used for tracking delivery status changes).

Each of the resources have a list of supported actions that triggers an event. All of the actions for a resource result in a payload with the same format. Below are some examples of the payloads of the events that the webhooks will send.

Sales Order​

The Sales Order resource is an representation of orders, and provides a way of picking, packing, and creating shipments. It can be used to keep track of the state of your orders, whenever changes are made.

You can subsribe to the following actions:

  • Created: Triggered when a new sales order is created.
  • Update status: Fires when the status of a sales order is updated (e.g., from "processing" to "shipped").
  • Fulfillment created: Occurs when a fulfillment record is created for an order, indicating the order is being prepared.
  • Shipment created: Triggered when a shipment is created, signaling the order is ready to be dispatched.
  • Payment captured: Fires when the payment for an order is successfully captured.
  • Payment refunded: Triggered when a payment is refunded for an order.
  • Payment voided: Occurs when a payment is voided, i.e., authorization on the payment was canceled before the funds were captured
  • Deleted: Fires when a sales order is deleted from the system.

You can read more about the sales order structure here

{
  "webhook": "Sales Order",
  "data": {
    "id": 83837161,
    "order_id": "56623",
    "ordered_at": "2024-07-08T10:08:32.000+02:00",
    "order_status": "open",
    "fulfillment_status": "fulfilled",
    "payment_status": "authorized",
    "shipped_percent": 0,
    "fulfilled_percent": 100,
    "archived": false,
    "source_name": "Min Virksomhed ApS",
    "order_note": null,
    "created_at": "2024-07-08T10:08:58.541+02:00",
    "updated_at": "2024-07-08T10:08:58.541+02:00",
    "ship_to": {
      "name": "Lene Hansen",
      "attention": null,
      "address1": "Skibhusvej 52",
      "address2": null,
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "email": "lene@email.dk",
      "mobile": "70 40 04 07",
      "phone": "70 40 04 07",
      "instruction": null,
      "vat_id": null,
      "address_validation": {
        "state": null,
        "suggestion": null
      }
    },
    "bill_to": {
      "name": "Lene Hansen",
      "attention": null,
      "address1": "Skibhusvej 52",
      "address2": null,
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "email": "lene@email.dk",
      "mobile": "70400407",
      "phone": "70400407"
    },
    "service_point": {
      "id": "99333",
      "name": "Kvickly Skibhusvej",
      "address1": "Skibhusvej 70A",
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "shipping_agent": "gls"
    },
    "sender": {
      "name": "Min Virksomhed ApS",
      "address1": "Hvilehøjvej 25",
      "address2": null,
      "zipcode": "5220",
      "city": "Odense SØ",
      "country_code": "DK",
      "email": "info@minvirksomhed.dk",
      "telephone": "70400407",
      "mobile": "70400407"
    },
    "payment_details": {
      "amount_excluding_vat": "1015.0",
      "amount_including_vat": "1268.75",
      "authorized_amount": "1268.75",
      "captured_amount": null,
      "refunded_amount": null,
      "currency_code": "DKK",
      "vat_amount": "253.75",
      "vat_percent": "0.25",
      "payment_method": "Bambora",
      "transaction_id": "373998052"
    },
    "order_lines": [
      {
        "id": 1234567810,
        "line_type": "item",
        "item_name": "T-Shirt",
        "item_sku": "TS001-WH",
        "item_variant_code": "White",
        "item_barcode": null,
        "quantity": "2.0",
        "unit_price_excluding_vat": "500.0",
        "discount_amount_excluding_vat": "0.0",
        "amount_excluding_vat": "1000.0",
        "amount_including_vat": "1250.0",
        "vat_amount": "250.0",
        "vat_percent": "0.25",
        "currency_code": "DKK",
        "shipped_quantity": "0.0",
        "unit_weight": 350,
        "cost_price": null,
        "country_code_of_origin": null,
        "customs_code": null,
        "customs_description": null,
        "image_url": null,
        "item_bin": "100",
        "item_id": 12345678
      },
      {
        "id": 1234567811,
        "line_type": "shipping",
        "item_name": "GLS PakkeShop",
        "item_sku": "shipping",
        "item_variant_code": null,
        "item_barcode": null,
        "quantity": "1.0",
        "unit_price_excluding_vat": "15.0",
        "discount_amount_excluding_vat": "0.0",
        "amount_excluding_vat": "15.0",
        "amount_including_vat": "18.75",
        "vat_amount": "3.75",
        "vat_percent": "0.25",
        "currency_code": "DKK",
        "shipped_quantity": "0.0",
        "unit_weight": null,
        "cost_price": null,
        "country_code_of_origin": null,
        "customs_code": null,
        "customs_description": null,
        "image_url": null,
        "item_bin": null,
        "item_id": 12345679
      }
    ],
    "order_fulfillments": [
      {
        "id": 12345678,
        "code": "56623-1",
        "type": "outbound",
        "shipment_id": null,
        "fulfilled_by_third_party": false,
        "order_packaging_id": null,
        "cancelled": false,
        "created_at": "2024-07-08T10:16:55.314+02:00",
        "updated_at": "2024-07-08T10:16:55.314+02:00",
        "fulfillment_lines": [
          {
            "id": 12345678,
            "shipped_quantity": "2.0",
            "order_line_id": 1234567810
          }
        ]
      }
    ]
  },
  "url": "https://example.com/webhook"
}

Shipment​

The Shipment resource is the representation of carrier-booked shipping, and can be used to track what and where you ship.

You can subsribe to the following actions:

  • Shipment created: Triggered when new shipment is successfully created.
  • Shipment cancelled: Triggered when an existing shipment is canceled

You can read more about the shipment structure here

{
  "webhook": "Shipment",
  "data": {
    "id": 123456789,
    "created_at": "2024-06-20T11:14:55.639+02:00",
    "updated_at": "2024-06-20T11:14:55.700+02:00",
    "carrier_code": "gls",
    "description": "ShopDelivery",
    "contents": null,
    "product_id": 54,
    "services": "15",
    "price": "50.00",
    "reference": null,
    "order_id": null,
    "pkg_no": "012345678910",
    "receiver": {
      "name": "Lene Hansen",
      "attention": null,
      "address1": "Skibhusvej 52",
      "address2": "",
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "vat_id": null,
      "email": "lene@email.dk",
      "mobile": "12345678",
      "telephone": null,
      "instruction": null,
      "access_code": null,
      "date": "2024-06-20",
      "from_time": null,
      "to_time": null,
      "member_id": null
    },
    "sender": {
      "name": "Min Virksomhed ApS",
      "attention": null,
      "address1": "Hvilehøjvej 25",
      "address2": "",
      "zipcode": "5220",
      "city": "Odense SØ",
      "country_code": "DK",
      "vat_id": null,
      "email": "info@minvirksomhed.dk",
      "mobile": "12345678",
      "telephone": "12345678"
    },
    "parcels": [
      {
        "quantity": 1,
        "weight": 1000,
        "content": null,
        "package_type": null,
        "pkg_no": "012345678910",
        "pkg_nos": [
          "012345678910"
        ],
        "weight_kg": "1.0",
        "dangerous_goods": []
      }
    ],
    "service_point": {
      "id": "99333",
      "name": "Kvickly Skibhusvej",
      "address1": "Skibhusvej 70A",
      "address2": "Pakkeshop: 99333",
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "shipping_agent": "gls"
    },
    "pick_up": {
      "name": null,
      "attention": null,
      "address1": null,
      "address2": null,
      "zipcode": null,
      "city": null,
      "country_code": null,
      "telephone": null,
      "phone": null,
      "date": null,
      "instruction": null,
      "from_time": null,
      "to_time": null,
      "pickup_custom": false
    },
    "paperless_trade": false,
    "pallet_exchange": {
      "pallets1": null,
      "pallets2": null,
      "pallets4": null
    },
    "source_id": null,
    "source_type": "manual",
    "return_shipment_id": null,
    "origin_shipment_id": null
  },
  "url": "https://example.com/webhook"
}

Drafts​

The Drafts resource is representation of a shipment draft, which can be used to create a shipment. It can be used to track the usage or deletion of drafts.

You can subsribe to the following actions:

  • Draft created: Triggered when a new draft is created in the system.
  • Draft deleted: Triggered when a draft is deleted.
  • Shipment created based on a draft: Triggered when a shipment is generated from a draft.

You can read more about the draft structure here

{
  "webhook": "Draft",
  "data": {
    "id": 12345678,
    "carrier_code": "gls",
    "product_code": null,
    "service_codes": null,
    "sms_notification": null,
    "email_notification": null,
    "order_id": "12345",
    "reference": "12345",
    "source": "minvirksomhed.dk",
    "shop_integration_id": 12345,
    "archived": false,
    "label_created": true,
    "created_at": "2024-07-08T10:09:01.049+02:00",
    "updated_at": "2024-07-08T10:29:25.105+02:00",
    "receiver": {
      "name": "Lene Hansen",
      "attention": null,
      "address1": "Skibhusvej 52",
      "address2": "",
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "email": "lene@email.dk",
      "mobile": "70 40 04 07",
      "telephone": "70 40 04 07",
      "instruction": null,
      "access_code": null
    },
    "sender": {
      "name": "Min Virksomhed ApS",
      "attention": null,
      "address1": "Hvilehøjvej 25",
      "address2": null,
      "zipcode": "5220",
      "city": "Odense SØ",
      "country_code": "DK",
      "email": "info@minvirksomhed.dk",
      "mobile": "12345678",
      "telephone": "12345678"
    },
    "service_point": {
      "id": "99333",
      "name": "Kvickly Skibhusvej",
      "address1": "Skibhusvej 70A",
      "zipcode": "5000",
      "city": "Odense C",
      "country_code": "DK",
      "shipping_agent": "gls"
    }
  },
  "url": "https://example.com/webhook"
}

Shipment Monitor​

The Shipment Monitor resource is a representation of a shipment tracking event, and provides a way of tracking the current status of shipments. It updates once a day.

You can subsribe to the following actions:

  • Latest: Triggered when there is a status update on the package, containing the most recent status of the shipment.

  • Delivered: Fires when the shipment has been successfully delivered to its destination.

{
  "name": "Shipment Monitor",
  "data": {
    "shipment_id": 123456,
    "current_status": "DELIVERED",
    "current_state": "SUCCESS",
    "current_status_text": "Your package has been delivered.",
    "current_status_registered_at": "2024-06-21T07:59:00.000+02:00",
    "carrier_code": "gls",
    "carrier_track_id": "012345678910",
    "weight": "0.6",
    "length": "",
    "height": "",
    "width": "",
    "location": "null",
    "city": "Odense SØ",
    "country_code": "DK"
  },
  "url": "https://example.com/webhook"
}