Download OpenAPI specification:Download
fabric's Order APIs are high performance endpoints built on highly scalable architecture, and include a configurable data model to orchestrate the order fulfillment process. These APIs let merchants create order records, initiate post-order process workflows and manage order related data such as, invoicing, tracking, returns, exchange, cancellation, appeasements, backorders, and other use cases.
Appeasement refers to a goodwill credit applied to a fulfilled order when customer faces difficulties for an order, for example late delivery, received damaged product, and like wise. This endpoint help in creating appeasement for customer orders.
Creates an appeasement for customer order.
required | object (XSiteContext) x-site-context value |
Appeasement Completed
Bad Request
Not Found
Internal Server Error
{- "orderNumber": "123",
- "appeasementType": "refund",
- "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "userID": "12",
- "source": "SFSC",
- "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Late Delivery",
- "subReasonCode": "subReasonCode",
- "value": 12.5,
- "notes": "Any additional info",
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "items": [
- {
- "lineItemId": "d538b1f1-0e45-43c6-bfc6-9666fc1188ca",
- "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Late Delivery",
- "subReasonCode": "subReasonCode",
- "value": 12.5,
- "notes": "Any additional info",
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
]
}
]
}
{- "responseCode": "SUCCESS",
- "responseMessage": "API Operation successfully completed",
- "responseData": {
- "orderNumber": "12",
- "totalAmountRefunded": 25.5,
- "channel": "12",
- "tenant": "5f689caa4216e7000750d1ef"
}
}
Acknowledges package tracking details
required | object (XSiteContext) x-site-context value |
OK
Bad Request
Not found
Internal Server Error
{- "orderNumber": "order123",
- "eventType": "ORDER_CREATE_IN_PTS",
- "entity": "ORDER",
- "shipmentId": "shipment123"
}
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Retrieves payment details for a specific order by order number
required | object (XSiteContext) x-site-context value |
Payment Status
Bad request
Not found!
Internal server error
{- "paymentIdentifier": "62272e917b12209e68751d94",
- "type": "VISA",
- "status": "Success",
- "balances": {
- "captured": 0,
- "capturable": 0,
- "refunded": 0,
- "refundable": 0
}, - "connectorInfo": {
- "connectorName": "stripe",
- "paymentMethodType": "Credit card",
- "eventId": "string"
}
}
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Checks if a specific order is eligible for cancellation.
OK
Bad request
Not found
Internal server error
{- "orderId": "62f3982438bcab1951be0a19",
- "eligibleReasonCodes": [
- "wrong item"
], - "policyType": "Exchange or return or cancellation",
- "period": "30D00H00M",
- "items": [
- {
- "lineItemId": "62f3dfc438bcab1951be0a19",
- "eligibleQuantity": 10,
- "eligible": true
}
], - "fees": [
- {
- "platinumFee": 33.9,
- "currency": "USD"
}
]
}
Cancels order
required | object (XSiteContext) x-site-context value |
Order cancelled
Bad request
Not found
Internal server error
{- "orderId": "62f3982438bcab1951be0a19",
- "reasonCode": "wrong item",
- "subReasonCode": "Ordered item doesn't match",
- "source": "string",
- "employeeId": "AD5069",
- "note": "Wrong item is sent to customer",
- "policyCode": "Cancel",
- "attributes": {
- "IsCancellationEligibile": true
}, - "items": [
- {
- "lineItemId": 12345,
- "quantity": 1,
- "reasonCode": "wrong item",
- "subReasonCode": "Mismatched item"
}
]
}
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
An order is a customer's request to purchase one or more products from a shop or from a website. Order endponts let merchants get order details, create, update, and delete orders.
Creates an order. After an order is created, Notification APIs of fabric OMS send order notification to customers.
required | object (XSiteContext) x-site-context value |
Order Created
Bad Request
Not Found
Internal Server Error
{- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "orderDiscount": 1.23,
- "feeTotal": 12.34,
- "taxTotal": 12.34,
- "orderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order created",
- "attributes": {
- "property1": {
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approver": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "KKMH0R12TQ46",
- "fraudScore": "31"
}, - "property2": {
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approver": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "KKMH0R12TQ46",
- "fraudScore": "31"
}
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion"
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "02",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "fab3456"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.45,
- "chargedAmount": 60,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "AUTHORIZED",
- "authExpirationDate": "2022-01-27T16:15:58-05:00",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "itemFeeTotal": 5,
- "itemDiscountsTotal": 55,
- "itemTaxTotal": 5,
- "itemTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion"
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
]
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
]
}
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Retrieves an order by orderId or orderNumber. If orderId or orderNumber is not provided, this endpoint retrieves all orders for a merchant.
Order Found
Bad Request
Order not found
Internal Server Error
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Updates an order by order number
required | object (XSiteContext) x-site-context value |
Order object Updated
Bad request
Order not found
Internal Server Error
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
{- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Retrieves orders based on query model passed in the request body.
required | object (XSiteContext) x-site-context value |
Matched orders
Bad request
Orders not found
Internal server error
{- "limit": 10,
- "offset": 0,
- "sortBy": "updatedAt",
- "sortDirection": "desc",
- "filters": {
- "retail": {
- "locationNum": 12
}, - "orderSubTotal": {
- "gte": 1300,
- "lt": 1400
}, - "orderNumber": "order-*Z",
- "statusCode": [
- "ORDER_CREATED"
], - "createdAt": {
- "lt": "2022-09-11T23:12:00.123Z"
}, - "shipInfo": {
- "shipToId": [
- "23434",
- "23436"
]
}
}
}
{- "count": 100,
- "limit": 10,
- "offset": 1,
- "orders": [
- {
- "version": 0,
- "orderId": "5349b4ddd2781d08c09890f4",
- "orderNumber": "309019176",
- "orderDate": "2022-05-12T09:30:31.198Z",
- "cancellationDate": "2022-05-12T09:30:31.198Z",
- "allocationDate": "2022-05-12T09:30:31.198Z",
- "channelId": "12",
- "cartId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "type": "WEB",
- "subType": "International",
- "processName": "CANCEL",
- "employeeId": "43278",
- "retail": {
- "locationNum": 123,
- "cashierId": "C-123",
- "registerId": "113",
- "transactionId": "R123-431-1133-2129"
}, - "orderSubTotal": 123.45,
- "originalSubTotal": 113.45,
- "orderDiscount": 1.23,
- "originalDiscounts": 1.45,
- "feeTotal": 12.34,
- "originalFeeTotal": 12.34,
- "taxTotal": 12.34,
- "appeasementTotal": 12.34,
- "originalTaxTotal": 12.34,
- "returnTotal": 12.34,
- "cancelTotal": 12.34,
- "invoiceTotal": 12.34,
- "orderTotal": 146.9,
- "originalOrderTotal": 146.9,
- "currency": "USD",
- "statusCode": "ORDER_CREATED",
- "statusDescription": "Order Created",
- "attributes": {
- "type": "String/Number/JSON",
- "purchaseOrder": "String",
- "salesRepId": "String",
- "approve": "String",
- "fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
- "fraudCheckStatus": "UPDATED",
- "fraudCheckTransId": "0R12TQ46",
- "fraudScore": "31"
}, - "fees": [
- {
- "type": "shipping",
- "value": 34.56,
- "invoiceValue": 34.56
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- {
- "paymentCounter": 1,
- "refundAmount": 40
}
]
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "customer": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john@fabric.inc",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "userId": "62272e917b12209e68751d94",
- "accountId": "62272e917b12209e68751d94",
- "employeeId": "62272e917b12209e68751d94",
- "company": "fabric"
}, - "payments": [
- {
- "paymentCounter": 1,
- "paymentDate": "2022-01-27T16:15:58-05:00",
- "billToId": "62272e917b12209e68751d94",
- "paymentIdentifier": {
- "cardIdentifier": "3456",
- "expirationYear": "2029",
- "expirationMonth": "2029",
- "paymentId": "62272e917b12209e68751d94",
- "fabricPaymentReference": "test"
}, - "paymentProvider": "stripe",
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "paymentMethod": "CREDIT_CARD",
- "authAmount": 123.2,
- "chargedAmount": 60,
- "refundAmount": 40,
- "currency": "USD",
- "conversion": 1,
- "paymentStatus": "OK",
- "partialCapture": "false",
- "finalCapture": "false",
- "paymentLog": "payment response list",
- "billToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "attributes": {
- "expirationMonth": 12
}
}
], - "items": [
- {
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "itemId": "1234",
- "sku": "P1234",
- "channelId": "WHBM",
- "segment": "P1234",
- "vendorId": "P1234",
- "title": "Item",
- "type": "WEB_SHIP",
- "subType": "Borderfree",
- "backorder": true,
- "orderedQuantity": 60,
- "backOrderedQuantity": 10,
- "pendingShippedQuantity": 10,
- "pendingShippedBackOrderQuantity": 10,
- "shippedQuantity": 10,
- "deliveredQuantity": 10,
- "invoiceQuantity": 10,
- "cancelledQuantity": 10,
- "pendingReturnQuantity": 10,
- "processingReturnQuantity": 10,
- "rejectedReturnQuantity": 10,
- "returnedQuantity": 10,
- "reshippedQuantity": 10,
- "uom": "EA",
- "shipToId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "itemUnitPrice": 10,
- "itemSubTotal": 600,
- "originalItemSubTotal": 600,
- "itemFeeTotal": 5,
- "originalFeeTotal": 5,
- "itemShippingTotal": 5,
- "originalShippingTotal": 5,
- "appeasementTotal": 5.5,
- "itemDiscountsTotal": 55,
- "originalDiscounts": 55,
- "itemTaxTotal": 5,
- "originalTaxTotal": 555,
- "itemTotal": 555,
- "originalItemTotal": 555,
- "outstandingItemTotal": 555,
- "originalOutstandingItemTotal": 555,
- "invoiceTotal": 555,
- "currency": "USD",
- "employeeId": "5345HJH",
- "associateId": "5345HJH",
- "fees": [
- {
- "type": "tax",
- "value": 34.56,
- "invoiceQuantity": 34,
- "refundAmount": 10.4,
- "quantity": 12
}
], - "appeasements": [
- {
- "appeasementCounter": 1,
- "reasonCode": "Incorrect item",
- "subReasonCode": "Late shipping",
- "value": 34.56,
- "invoiceValue": 34.56,
- "payments": [
- null
]
}
], - "returns": [
- {
- "shipmentId": "12353543",
- "shipmentLineItemId": "2412341",
- "shipmentQuantity": 1,
- "refundAmount": 11.29,
- "invoicedAmount": 11.29,
- "returnsCreatedAt": "2022-09-14T14:07:36.861Z"
}
], - "taxCode": "FR01",
- "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "discounts": [
- {
- "quantity": 2,
- "amount": 2.4,
- "unit": "AMOUNT_OFF",
- "value": 2,
- "promoId": "HNY2022",
- "promoCode": "HNY2022",
- "promoTitle": "Happy New Year",
- "type": "promotion",
- "invoiceQuantity": 2,
- "returnQuantity": 2,
- "cancelQuantity": 2
}
], - "attributes": {
- "isDonation": true,
- "isGiftCard": false,
- "isFinalSale": false,
- "returnsLink": true
}, - "exchangeItem": true,
- "parentLineItemNumber": 12,
- "pendingExchangeQuantity": 12,
- "exchangeQuantity": 13,
- "refundAmount": 12.4,
- "lineOrderStatus": "VALID",
- "infiniteConsent": true,
- "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "gifting": true
}
], - "shipInfo": [
- {
- "shipToId": "5349b4ddd2781d08c09890f4",
- "taxCode": "FR01",
- "locationNum": "123",
- "pickup": [
- {
- "name": {
- "first": null,
- "middle": null,
- "last": null
}, - "email": "john123@gmail.com",
- "phone": {
- "number": null,
- "type": null
}, - "pickupType": "Primary"
}
], - "shipToAddress": {
- "name": {
- "first": "John",
- "middle": "Middle",
- "last": "Doe"
}, - "email": "john123@gmail.com",
- "phone": {
- "number": "55555555555",
- "type": "MOBILE"
}, - "address1": "First line of address",
- "address2": "123 Parking Lot",
- "address3": "Third line of address",
- "address4": "Fourth line of address",
- "city": "Beaumont",
- "state": "TX",
- "country": "USA",
- "postalCode": "77705",
- "type": "residence",
- "latitude": 35.294952,
- "longitude": 32.294952
}, - "taxDetail": [
- {
- "type": "tax",
- "value": 34.56
}
], - "shipMethod": "Express Delivery",
- "shipToType": "SHIP_TO_ADDRESS",
- "estimatedShipDate": "2022-05-12T09:30:31.198Z",
- "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
- "shipToPrice": 20,
- "shipToDiscount": 12.6,
- "shipToTaxTotal": 12.6,
- "shipmentInstructions": "User instructions",
- "attributes": {
- "isOpenBox": false,
- "isOTPDElivery": true
}
}
], - "auditLogs": [
- {
- "auditId": "62272e917b12209e68751d94",
- "auditType": "string",
- "employeeId": "62272e917b12209e68751d94",
- "auditTimestamp": "2022-05-12T09:24:54.804Z",
- "source": "POS",
- "reasonCode": "POS",
- "subReasonCode": "POS",
- "policyCode": "POS",
- "note": "Note",
- "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
- "lineItemNumber": 1,
- "sku": "F5F",
- "quantity": 1,
- "amount": 2.4,
- "paymentToken": {
- "token": "pi_34tr6787rt",
- "paymentType": "VISA"
}, - "success": true,
- "paymentResponse": { },
- "updatedFields": [
- {
- "fieldName": "UOM",
- "fieldOriginalValue": "PK"
}
], - "attributes": {
- "property1": { },
- "property2": { }
}
}
], - "notes": [
- {
- "timestamp": "2022-05-12T09:30:31.198Z",
- "user": "62272e917b12209e68751d94",
- "notes": "Extra information to be provided"
}
], - "orderReleaseTimestamp": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}