Info
  • Web service URL: BASE_URL/api/Order

Similar with an pickup Order request, with the below mandatory specifications.


Name
Type
Required
Description
CourierIdinteger
only available for Sameday(6) and FAN(3)
AddressFrom
Address[]
YesSee object below
PaymentintegerYes2 (recipient) - sender payment not supported
includeCourierResponse
boolean

true for Sameday as PIN is retuned in courier response



Address[] :

NameTypeRequiredDescription
Namestring[64]Yes
ContactPersonstring[100]Yes
Countrystring[2]

CountyNamestring
not mandatory if PostalCode is sent
LocalityNamestring
either LocalityName + CountyName or LocalityName + PostalCode
AddressTextstring[100]

PostalCodestring[50]

Phonestring[64]Yes
Emailstring[100]Yes
FixedLocationIdstringYesInnoship Fixed Location Id obtained using Get Fixed Locations Request (Location service)
CourierFixedLocationIdstringInstead of FixedLocationIdCan be used instead of FixedLocationId if available. To use this field the CourierId is mandatory and the courierFixedLocationId is not validated by our system. 

Example Request:

{
  "ServiceId": 1,
  "CourierId": 6,
  "ShipmentDate": "2023-05-26T11:29:36+02:00",
  "ShipmentDateEnd": "2023-05-26T11:29:36+00:00",
  "AddressFrom": {
    "Name": "LockReturn TEST",
    "ContactPerson": "LockReturn TEST",
    "Country": "RO",
    "CountyName": "Bucuresti",
    "LocalityName": "Bucuresti",
    "AddressText": "Str Stefan Stoika 27",
    "PostalCode": "012243",
    "Phone": "+40761479785",
    "Email": "avcc@yahoo.co.uk",
    "FixedLocationId": "157"
  },
  "Payment": 2,
  "Content": {
    "EnvelopeCount": 0,
    "ParcelsCount": 1,
    "PalettesCount": 0,
    "TotalWeight": 1,
    "Contents": "Comanda",
    "Package": "box",
    "OversizedPackage": false,
    "Parcels": [
      {
        "SequenceNo": 1,
        "Size": {
          "Width": 20,
          "Height": 10,
          "Length": 20
        },
        "Weight": 1,
        "Type": 2,
        "Reference1": "91808259.1"
      }
    ]
  },
  "Extra": {
  },
  "Parameters": {
    "Async": true,
    "GetParcelsBarcodes": true,
    "IncludeCourierResponse": true,
    "IncludePriceBreakdown": false,
    "IncludeAddressInResponse": false
  },
  "ExternalClientLocation": "RO",
  "ExternalOrderId": "locker88",
  "Metadata": "",
  "SourceChannel": "",
  "Observation": ""
}

Example API response with courier response included:


{
    "clientOrderId": "6|1SDYLR1162395",
    "courierShipmentId": "1SDYLR1162395",
    "courier": 6,
    "courierParcelsBarcodes": [
        {
            "sequenceNo": 1,
            "barcode": "1SDYLR1162395001"
        }
    ],
    "price": {
        "amount": 10.0,
        "vat": 1.90,
        "totalAmount": 11.90,
        "currency": "RON"
    },
    "calculatedDeliveryDate": "2023-05-28T21:00:00Z",
    "trackPageUrl": "https://track.innoship.io/ATvdQgskKEmV4wqKJK2mJA",
    "courierResponse": {
        "awbNumber": "1SDYLR1162395",
        "awbCost": 10.0,
        "parcels": [
            {
                "Position": 1,
                "AwbNumber": "1SDYLR1162395001"
            }
        ],
        "pdfLink": "https://sameday-api.demo.zitec.com/api/awb/download/1SDYLR1162395",
        "deliveryLogisticLocationId": "",
        "deliveryLogisticLocation": "",
        "pickupLogisticLocation": "TM_TIMISOARA_A04",
        "pickupLogisticLocationId": "122",
        "deliveryLogisticCircle": "",
        "sortingHubId": "",
        "sortingHub": "",
        "lockerReturnChargeCode": "JAD7E8G",
        "returnAwbs": null
    },
    "extra": {
        "bankRepaymentCurrency": "RON",
        "openPackage": false,
        "saturdayDelivery": false,
        "reference1": "91808259",
        "returnOfDocuments": false,
        "returnPackage": false
    }
}