Download OpenAPI specification:Download
The IOM Order State REST API supports the obtaining of order details and order status information.
Obtain the order states of the orders which are matching the given search criterias
shopId required | integer <int64> Example: shopId=200 The id of the IOM shop instance |
orderNumber | Array of strings Example: orderNumber=2019-17891,2019-21432 Order number as used by the shop |
customerNumber | Array of strings Example: customerNumber=CUST-930293,283102 Customer number as used by the shop |
productNumber | Array of strings Example: productNumber=100120,200230 Product number as used by the shop |
orderState | Array of strings Example: orderState=[STATE_COMMISSIONED, STATE_DISPATCHED] Order state as used by the shop if configured, otherweise the IOM internal names of order states |
orderCreationDate[gte] | string <date> Example: orderCreationDate[gte]= The earliest 'shop order creation date' of an order |
orderCreationDate[lte] | string <date> Example: orderCreationDate[lte]= The latest 'shop order creation date' of an order |
orderBy | string Enum: "ORDER_ID" "ORDER_NUMBER" "CUSTOMER_NUMBER" "CREATION_DATE" Example: orderBy=ORDER_NUMBER The attribute on which should be sorted. 'ORDER_ID' - Sort by the id of the order. 'ORDER_NUMBER' - Sort by the shop order number. 'CUSTOMER_NUMBER' - Sort by the shop customer number. 'CREATION_DATE' - Sort by the shop order creation date. |
sortDirection | string Default: "ASC" Enum: "ASC" "DESC" Example: sortDirection=ASC The sort direction the attribute should be sorted with. 'ASC' - Sort by the attribute ascending. 'DESC' - Sort by the attribute descending. |
offset | integer <int32> Default: 0 Example: offset=50 The starting row (index) of the first element to return |
limit | integer <int32> Default: 50 Example: limit=25 The number of items to return |
OK
Bad Request
Authentication information is missing or invalid
Forbidden
Not Acceptable
An unexpected error occured
{- "data": [
- {
- "state": "STATE_DISPATCHED",
- "invoiceAddressId": 0,
- "shop": {
- "id": 10496,
- "type": "BILLING",
- "contact": {
- "email": "string",
- "telephone": "string",
- "mobile": "string",
- "fax": "string"
}, - "location": {
- "city": "Jena",
- "postCode": "07740",
- "district": "string",
- "country": "DEU",
- "additions": [
- "string"
]
}, - "receiver": {
- "person": {
- "salutation": "Mr",
- "title": "Dr.",
- "firstName": "Fred",
- "lastName": "Müller"
}
}
}, - "customer": {
- "contact": {
- "email": "string",
- "telephone": "string",
- "mobile": "string",
- "fax": "string"
}, - "orderNumber": "BST:09037",
- "salutation": "Mr",
- "title": "Prof.",
- "firstName": "Max",
- "lastName": "Meyer",
- "type": "PERSON"
}, - "sales": {
- "paymanetMethod": "CREDITCARD",
- "currency": "EUR",
- "sum": {
- "netAmount": 42.1,
- "grossAmount": 47.6,
- "tax": [
- {
- "type": "FullTax",
- "amount": 1.7
}
]
}, - "total": {
- "netAmount": 42.1,
- "grossAmount": 47.6,
- "tax": [
- {
- "type": "FullTax",
- "amount": 1.7
}
]
}, - "charges": [
- {
- "type": "DELIVERYCHARGE",
- "tax": {
- "type": "FullTax",
- "amount": 1.7
}, - "netAmount": 5,
- "grossAmount": 6.7
}
]
}, - "positions": [
- {
- "number": "1",
- "state": "STATE_DO_APPROVE",
- "shipToAddressId": 10497,
- "product": {
- "name": "Demo Product",
- "productNumber": "100-0001",
- "ean": "9783161484100",
- "isbn": "978-3-16-148410-0",
- "supplierProductNumber": "902312a"
}, - "supplier": {
- "name": "Demo Supplier US",
- "commissionDate": "2019-05-28T12:36:17.158Z"
}, - "ordered": {
- "quantity": 1,
- "deliveryDays": 0,
- "sales": {
- "sum": {
- "netAmount": 10.2,
- "grossAmount": 12.99,
- "tax": {
- "type": "FullTax",
- "amount": 1.7
}
}, - "unit": {
- "netAmount": 10.2,
- "grossAmount": 12.99,
- "tax": {
- "type": "FullTax",
- "amount": 1.7
}
}
}, - "delivery": {
- "type": "STANDARD"
}, - "deliveryOptions": "Delivery on same day"
}, - "confirmed": {
- "type": "string",
- "confirmationDate": "2020-04-16T16:12:31Z",
- "quantities": [
- {
- "value": 1,
- "plannedDeliveryDate": "2020-04-16"
}
], - "cancelled": [
- {
- "quantity": 1,
- "cancelDate": "2020-04-16T16:12:31Z",
- "reason": {
- "id": "RCL021",
- "value": "string"
}
}
]
}, - "dispatched": [
- {
- "quantity": 1,
- "deliveryNoteNumber": "980392-481",
- "dispatchDate": "2020-04-16T16:12:31Z",
- "carrier": {
- "name": "DHL",
- "packages": 1,
}, - "units": [
- {
- "serialNumber": "89712007"
}
]
}
], - "returned": [
- {
- "state": "CLOSED",
- "supplierEntryDate": "2020-04-16T16:12:31Z",
- "quantity": 2,
- "returnReason": {
- "value": "RET990",
- "type": "RET"
}, - "payment": {
- "reduction": {
- "reduceText": "string",
- "reduceReason": "AK-0"
}, - "refundNet": 12.87
}
}
], - "properties": [
- {
- "id": "Customer-Information",
- "properties": [
- {
- "key": "string",
- "value": "string"
}
]
}
]
}
], - "notes": [
- {
- "message": "Unsatisfied customer",
- "type": "ESCALATION",
- "creationDate": "2019-10-28T07:22:44.838Z"
}
], - "payment": {
- "paymentStatus": {
- "invoicingDebitAmount": 0,
- "invoicingCreditAmount": 0,
- "chargedDebitAmount": 0,
- "chargedCreditAmount": 0,
- "chargedOpenAmount": 0,
- "bookedDebitAmount": 0,
- "bookedCreditAmount": 0,
- "bookedOpenAmount": 0,
- "creationDate": "2019-12-28T17:46:49.838Z",
- "lastCaptureDate": "2019-12-10T20:16:23.838Z",
- "lastRefundDate": "2019-12-28T17:46:49.838Z",
- "lastCalculationDate": "2019-11-28T17:46:49.838Z",
- "currency": "EUR"
}, - "paymentHistory": [
- {
- "currency": "EUR",
- "comment": "string",
- "type": "inbound",
- "action": "capture",
- "paymentMethod": "CREDITCARD",
- "invoiceNumber": "string",
- "creationDate": "2019-12-28T17:46:49.838Z",
- "modificationDate": "2019-12-28T17:46:49.838Z",
- "amount": 109.78
}
]
}, - "documents": [
- {
- "type": "invoiceNote",
- "creationDate": "2018-12-24T14:22:32.123Z",
- "mimeType": "application/pdf"
}
], - "properties": [
- {
- "id": "Customer-Information",
- "properties": [
- {
- "key": "string",
- "value": "string"
}
]
}
], - "addresses": [
- {
- "id": 10496,
- "type": "string"
}
]
}
], - "meta": {
- "property1": "string",
- "property2": "string"
},
}