Our internal sales portals are designed to give your internal/asset purchasing team the ability to place orders directly in order to fulfil your companies IT equipment needs.

No need to sift through thousands of products: A list of pre-approved products and pricing can be added and tailored to your needs by your account manager.

Delivery addresses can be predefined and fixed or entered at the point of order.

User accounts can be added/removed by request to your account manager or we can provide SSO (Single Sign On) automatic user provisioning via SCIM/SAML with current support for Okta and Microsoft Entra platforms.

Permissions can be customised and set on a per user basis.

Purchasers can see their order history and arrange collections for items if there are any problems.

Collections for pre-existing assets can be arranged and packaging delivered before hand to ensure items get back to us safely.

Associated products and mandatory addons can be set up to make sure your team order the correct accessories.

Custom reporting is available by request.

Each sales portal can be customised with your own logos and colour schemes to fit with your companies branding.

curl --request POST \
  --url https://test-api.novatech.co.uk/token/get \
  --header 'Content-Type: application/json' \
  --data '{ "email":"test.email@novatech.co.uk", "password":"aVeryLongAndSecurePassword" }'

{
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc",
    "expires_on": "2018-10-08 14:50:24"
  }

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
  --url https://test-api.novatech.co.uk/token/change-password \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' \
  --data '{ "email":"test.email@novatech.co.uk", "current_password":"aVeryLongAndSecurePassword", "new_password":"aNewVeryLongAndSecurePassword" }'

{
  "success":true
  }
  

Please see our "Errors" section for the expected response format for errors.

None required.

curl --request GET \
  --url https://test-api.novatech.co.uk/stock \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
    "skus": [
      {
        "sku": "TEST-SKU01",
        "description": "Example SKU 01",
        "stock_level": 50,
        "price": 314.99
      },
      {
        "sku": "TEST-SKU02",
        "description": "Example SKU 02",
        "stock_level": 3,
        "price": 973.67
      },
      {
        "sku": "TEST-SKU03",
        "description": "Example SKU 03",
        "stock_level": 0,
        "price": 229.04
      }
    ]
  }

Please see our "Errors" section for the expected response format for errors.

curl --request GET \
  --url https://test-api.novatech.co.uk/stock/TEST-SKU01 \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
    "sku": "TEST-SKU01",
    "description": "Example SKU 01",
    "stock_level": 50,
    "price": 314.99
  }

Please see our "Errors" section for the expected response format for errors.

None required.

curl --request GET \
  --url https://test-api.novatech.co.uk/portal/groups/list \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
  "groups": [ 
  {
          "product_group_id": "6e3b36c5-e895-4f4c-a224-f7cab00e7b3b",
          "scim_id": "897d2d51-566c-45ef-8310-7c4e065a1440",
          "display_name": "Tech team"  
      },
      {
          "product_group_id": "80a2dcb0-f808-491e-9439-f3d3db1fc7bf",
          "scim_id": "34780516-a2de-48b7-a632-51c258e077aa",
          "display_name": "Engineering team",
      }
  ]   
                      }

Please see our "Errors" section for the expected response format for errors.

curl --request GET \
  --url https://test-api.novatech.co.uk/portal/groups/stock/07594101-65af-4349-b3c1-5c72242a9660 \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
  "product_group_id": "07594101-65af-4349-b3c1-5c72242a9660",
  "skus": [
          {
              "sku": "CAB-C5END",
              "description": "Network Cable Connectors",
              "stock_level": 19,
              "price": 1.24,
              "portal_enabled": true
          },
          {
              "sku": "CAB-C6/2",
              "description": "Grey Cat6 Network Cable - 2m",
              "stock_level": 4,
              "price": 1.84,
              "portal_enabled": true
          }
      ]   
                      }

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
  --url https://test-api.novatech.co.uk/portal/groups/stock/07594101-65af-4349-b3c1-5c72242a9660 \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' \
  --header 'Content-Type: application/json' \
  --data '
  {
    "skus": [
      "CAB-C5END", "CAB-C6/2"
    ]
  }'
  

{
  "success": true
                      }

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
  --url https://test-api.novatech.co.uk/order \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' \
  --header 'Content-Type: application/json' \
  --data '
  {
    "order_number": "MONZ0001",
    "deliver_to": {
      "name": "Joe Smith",
      "address_lines": [
        "1 Hamilton Road",
        "Portsmouth"
      ],
      "postal_code": "PO6 4PU",
      "email_address": "customer@company.com",
      "phone_number": "07171071071"
    },
    "order_lines": [
      {
        "sku": "TEST-SKU01",
        "quantity": 1
      },
      {
        "sku": "TEST-SKU02",
        "quantity": 2
      }
    ]
  }'

  {
    "trade_code": "API001",
    "order_number": "MONZ0001",
    "novatech_order_number": 6010361,
    "order_date": "2018-10-09 09:04:00",
    "order_status": "A",
    "ex_vat_total": 722.39,
    "vat": 144.48,
    "inc_vat_total": 866.87,
    "order_lines": [
      {
        "status": "A",
        "description": "EXAMPLE SKU 01",
        "quantity": 1,
        "price": 392.05,
        "ex_vat_total": 392.05,
        "vat": 78.41,
        "inc_vat_total": 470.46,
        "sku": "TEST-SKU01"
      },
      {
        "status": "A",
        "description": "EXAMPLE SKU 02",
        "quantity": 2,
        "price": 165.17,
        "ex_vat_total": 330.34,
        "vat": 66.07,
        "inc_vat_total": 396.41,
        "sku": "TEST-SKU02"
      },
      {
        "status": "A",
        "description": "*         ** NEXT DAY **",
        "quantity": 1,
        "price": 0,
        "ex_vat_total": 0,
        "vat": 0,
        "inc_vat_total": 0,
        "sku": "DELI01"
      }
    ]
    }
    

Please see our "Errors" section for the expected response format for errors.

curl --request GET \
  --url https://test-api.novatech.co.uk/orders
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
    "orders": [
      {
        "order_number": "MONZ0003"
        "novatech_order_number": 6010361
        "order_date" : "2018-10-24 10:40:00",
        "order_status": "A"
      },
      {
        "order_number": "MONZ0002"
        "novatech_order_number": 6010360
        "order_date" : "2018-10-23 11:43:00",
        "order_status": "I"
      },
      {
        "order_number": "MONZ0001"
        "novatech_order_number": 6010359
        "order_date" : "2018-10-21 09:05:00",
        "order_status": "I"
      }
    ],
      "info": {
          "total_rows": 3,
          "current_page": 1,
          "orders_per_page": 500,
          "start_record": 1,
          "end_record": 3
      }
  }

Please see our "Errors" section for the expected response format for errors.

curl --request GET \
  --url https://test-api.novatech.co.uk/order/6010361 \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
    "trade_code": "API001",
    "order_number": "MONZ0001",
    "novatech_order_number": 6010361,
    "order_date": "2018-10-09 09:04:00",
    "order_status": "A",
    "ex_vat_total": 722.39,
    "vat": 144.48,
    "inc_vat_total": 866.87,
    "order_lines": [
      {
        "status": "A",
        "description": "EXAMPLE SKU 01",
        "quantity": 1,
        "price": 392.05,
        "ex_vat_total": 392.05,
        "vat": 78.41,
        "inc_vat_total": 470.46,
        "sku": "TEST-SKU01"
      },
      {
        "status": "A",
        "description": "EXAMPLE SKU 02",
        "quantity": 2,
        "price": 165.17,
        "ex_vat_total": 330.34,
        "vat": 66.07,
        "inc_vat_total": 396.41,
        "sku": "TEST-SKU02"
      },
      {
        "status": "A",
        "description": "*         ** NEXT DAY **",
        "quantity": 1,
        "price": 0,
        "ex_vat_total": 0,
        "vat": 0,
        "inc_vat_total": 0,
        "sku": "DELI01"
      }
    ],
    "dispatch_info": [
      {
        "dispatch_number": 3089457,
        "dispatch_date": "2018-10-09 00:00:00",
        "box_number": 1,
        "item_number": 3,
        "courier_service": "ParcelForce",
        "tracking_url": "https://www.parcelforce.com/track-trace?trackNumber=NX1212121"
      }
    ],
    "tracking_info": [
      {
        "sku": "TEST-SKU01",
        "track_no": 12006527,
        "date_tracked": "2018-10-09 13:20:34"
      },
      {
        "sku": "TEST-SKU02",
        "track_no": 11824374,
        "serial_no": "7441474-001",
        "date_tracked": "2018-10-09 13:20:34"
      },
      {
        "sku": "TEST-SKU02",
        "track_no": 11824374,
        "serial_no": "7441474-002",
        "date_tracked": "2018-10-09 13:20:34"
      }
    ]
  }

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
  --url https://test-api.novatech.co.uk/newstarter/create \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' \
  --data '{ "name":"test name", "email":"test.email@emaildomain.co.uk", "level":3, "linkonly":true, "mobileno":"01234567890", "startdate":"2023-11-23", "internalid":"test.email@novatech.co.uk" }'

{
      "name": "test2",
      "link_only": true,
      "link": "https://test.novatechportal.co.uk/onboarding/4411C408-485B-4401-82BD-B83951B97193",
      "level": 1,
      "email": "test@test.com",
      "uuid": "4411C408-485B-4401-82BD-B83951B97193"
  }
  

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
  --url https://test-api.novatech.co.uk/newstarter/cancel/4411C408-485B-4401-82BD-B83951B97193 \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
      "cancelled": true,
      "info": "Success"
  }
  

Please see our "Errors" section for the expected response format for errors.

curl --request POST \
          --url https://test-api.novatech.co.uk/collection/book \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' \
          --data '{
    "collection_reference": "APITEST",
    "collect_from": {
        "name": "Joe Smith",
        "address_lines": [
            "1 Hamilton Road",
            "Portsmouth"
        ],
        "postal_code": "PO6 4PU"
    },
    "notification_email_address": "customer@company.com",
    "notification_phone_number": "07171071071",
    "packaging_lines": [
        {
            "packaging_type": "laptop",
            "asset_tag": "1234567890"
        },
        {
            "packaging_type": "laptop",
            "asset_tag": "0987654321"
        }
    ]
  }'

{
    "supplier_order_number": 6195185,
    "collection_reference": "APITEST",
    "collect_from": {
      "name": "Joe Smith",
      "address_lines": [
          "1 Hamilton Road",
          "Portsmouth"
      ],
      "postal_code": "PO6 4PU"
    },
    "notification_email_address": "customer@company.com",
    "notification_phone_number": "07171071071",
    "number_of_boxes": 2,
    "created_date": "2022-07-05 13:32:59",
    "booked": false,
    "collection_url": "https://collections.novatechportal.co.uk/collection/bac5b960-168d-4e37-a548-6ae2af9e5be5",
    "assets": [
      {
          "asset_tag": "1234567890",
          "type": "LAPTOP",
          "received_back": false
      },
      {
          "asset_tag": "0987654321",
          "type": "LAPTOP",
          "received_back": false
      }
    ]
  }

Please see our "Errors" section for the expected response format for errors.

You can search using two different search types; either using your collection reference or the asset tag, or a combination of the two.

The response will be a JSON array of collection objects as detailed below.

curl --request GET \
  --url https://test-api.novatech.co.uk/collection/search?collection_ref=APITEST \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

[
      {
          "supplier_order_number": 6195185,
          "collection_reference": "APITEST",
          "collect_from": {
              "name": "Joe Smith",
              "address_lines": [
                  "1 Hamilton Road",
                  "Portsmouth"
              ],
              "postal_code": "PO6 4PU"
          },
          "notification_email_address": "customer@company.com",
          "notification_phone_number": "07171071071",
          "number_of_boxes": 2,
          "created_date": "2022-07-05 13:32:59",
          "booked": false,
          "collection_url": "https://collections.novatechportal.co.uk/collection/bac5b960-168d-4e37-a548-6ae2af9e5be5",
          "assets": [
              {
                  "asset_tag": "1234567890",
                  "type": "LAPTOP",
                  "received_back": false
              },
              {
                  "asset_tag": "0987654321",
                  "type": "LAPTOP",
                  "received_back": false
              }
          ]
      },
      {
          "supplier_order_number": 6195184,
          "collection_reference": "APITEST",
          "collect_from": {
              "name": "Joe Smith",
              "address_lines": [
                  "1 Hamilton Road",
                  "Portsmouth"
              ],
              "postal_code": "PO6 4PU"
          },
          "notification_email_address": "customer@company.com",
          "notification_phone_number": "07171071071",
          "number_of_boxes": 2,
          "created_date": "2022-06-27 11:40:51",
          "booked": false,
          "collection_url": "https://collections.novatechportal.co.uk/collection/c46e2ce6-37e2-453a-a99a-d7f114567f1f",
          "requested_collection_date": "2021-11-13 13:59:41",
          "assets": [
              {
                  "asset_tag": "1234567890",
                  "type": "LAPTOP",
                  "received_back": false
              },
              {
                  "asset_tag": "0987654321",
                  "type": "LAPTOP",
                  "received_back": false
              }
          ]
      }
  ]

Please see our "Errors" section for the expected response format for errors.

curl --request GET \
  --url https://test-api.novatech.co.uk/audit \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZWFuLndpbGxpYW1zQG5vdmF0ZWNoLmNvLnVrIiwidG9rZW4iOiIxMDNkMTFhNC1jODdhLTQxMDgtOTIwNS1jMTUxZDM4YjY3YmQiLCJleHAiOjE1MzkwMDY2MjR9.19DQ_uwE5Ye1ALrwiW9o7wsMhoetUqDLQMNcFCxwtEc' 
  

{
    "audit_log": [
      {
        "timestamp": "2018-10-24 11:40:00",
        "email": "test.email@novatech.co.uk",
        "action": "Placed order: 6010362"
      },
      {
        "timestamp": "2018-10-24 11:25:00",
        "email": "test.email@novatech.co.uk",
        "action": "Performed Stock Check"
      },
      {
        "timestamp": "2018-10-24 11:21:00",
        "email": "test.email@novatech.co.uk",
        "action": "Login: Success"
      },
      {
        "timestamp": "2018-10-24 11:20:00",
        "email": "test.email@novatech.co.uk",
        "action": "Login: Failure"
      }
    ]
  }

Please see our "Errors" section for the expected response format for errors.

The verification signature is calculated using the supplier_order_number, order_number and type fields. They are appended together using a fullstop as the delimiter. For example:

6010365.MONZ0002.ORDER_DISPATCHED

The string is then encoded using the HmacSHA256 algorithm using a long secret key pre-determined between Novatech and you. Finally the value is Hex encoded and included in the JSON.

Each request simply expects a HTTP 200 code in response. If any other HTTP status code is received the notification will be resent later, and will continue to be so until the 200 code is received.

{
    "supplier_order_number": 6010365,
    "type": "ORDER_DISPATCHED",
    "order_number": "MONZ0002",
    "order": {
      "trade_code": "API001",
      "order_number": "MONZ0002",
      "novatech_order_number": 6010365,
      "order_date": "2019-01-18 12:57:00",
      "order_status": "I",
      "ex_vat_total": 11.27,
      "vat": 2.25,
      "inc_vat_total": 13.52,
      "order_lines": [
        {
          "status": "I",
          "description": "2M CAT 6",
          "quantity": 1,
          "price": 3.32,
          "vat": 0.66,
          "sku": "CAB-C6/2",
          "ex_vat_total": 3.32,
          "inc_vat_total": 3.98
        },
        {
          "status": "I",
          "description": "*         ** NEXT DAY **",
          "quantity": 1,
          "price": 7.95,
          "vat": 1.59,
          "sku": "DELI01",
          "ex_vat_total": 7.95,
          "inc_vat_total": 9.54
        }
      ],
      "dispatch_info": [
        {
          "dispatch_number": 1234567,
          "dispatch_date": "2019-01-18 00:00:00",
          "box_number": 1,
          "item_number": 1,
          "courier_service": "DPD",
          "tracking_url": "http://www.dpd.co.uk/service/tracking?consignment=1234567890"
        }
      ],
      "tracking_info": [
        {
          "sku": "CAB-C6/2",
          "track_no": 1234567,
          "date_tracked": "2019-01-18 15:23:24",
          "serial_no": "abc00022"
        }
      ]
    },
    "tracking": {
          "supplier_order_number": "6010365",
          "order_reference": "MONZ0002",
          "courier": "DPD",
          "tracking_reference": "15500000000001",
          "event": "DELIVERED",
          "event_info": "Delivered, received by TEST USER Proof of Delivery SMS notification sent",
          "event_date": "2019-01-19 10:00:00"
      },
    "verification_signature": "e86f90f643284a36b486c4c5ea1c159b0ba9311b7a497c02e994bb982cb09142"
  }
  

{
    "supplier_order_number": 6195185,
    "type": "COLLECTION_REQUESTED",
    "order_number": "APITEST",
    "collection": {
      "supplier_order_number": 6195185,
      "collection_reference": "APITEST",
      "collect_from": {
        "name": "Joe Smith",
        "address_lines": [
          "1 Hamilton Road",
          "Portsmouth"
        ],
        "postal_code": "PO6 4PU"
      },
      "notification_email_address": "customer@company.com",
      "notification_phone_number": "07171071071",
      "number_of_boxes": 2,
      "created_date": "2022-07-05 13:32:59",
      "booked": false,
      "collection_url": "https://collections.novatechportal.co.uk/collection/bac5b960-168d-4e37-a548-6ae2af9e5be5",
      "assets": [
        {
          "asset_tag": "1234567890",
          "type": "LAPTOP",
          "received_back": false
        },
        {
          "asset_tag": "0987654321",
          "type": "LAPTOP",
          "received_back": false
        }
      ]
    },
    "verification_signature": "1c5306f2fcbc112e38a24d603e80f0deb2986b20e6a3d2e6a1cbdfd1040e687e"
  }
  

For all of the various error response codes our system will return standard HTTP status codes along with JSON error messages in one of 2 formats.

Standard errors include a JSON response in the following format:

{
    "msg": "HTTP 415 Unsupported Media Type",
    "code": 415,
    "timestamp": "2018-10-09 10:09:17",
    "status": "Unsupported Media Type"
  }

Errors relating to JSON Objects failing validation i.e. a field is too long or has an invalid quantity then the JSON will be structured like this:

{
    "code": 400,
    "errors": [
      "deliverTo.name size must be between 5 and 30",
      "orderLineList[0].quantity must be greater than or equal to 1"
    ],
    "timestamp": "2018-10-09 10:13:19",
    "status": "Bad Request"
  }