Generate allocation

We have a brand new Developer Portal!

This page will be expiring soon; be sure to bookmark the new link.

Generate allocation

Generates allocation for each item in the order. The response includes fabric-generated allocationID, which is required for GET /allocation/{allocationId}.

Request

header Parameters

required

object

x-site-context value

Request Body schema: application/json

detailType

required

string

Event type

Enum: "ORDER_CREATED" "SHIPMENT_CREATED" "PICKUP_CREATED" "PICKUP_COMPLETED" "BOPIS_REMINDER_EMAIL" "BACKORDER_CREATE" "BACKORDER_30_DAYS_CONSENT_TO_DELAY_EMAIL" "BACKORDER_53_DAYS_CONSENT_TO_DELAY_EMAIL" "BACKORDER_CANCEL" "BACKORDER_AUTH_DECLINE" "ORDER_CANCELLATION_EMAIL_WEBCSC_ORDER_ITEM_CANCEL" "ORDER_CANCELLATION_EMAIL_WEBCSC_ORDER_CANCEL" "ORDER_CANCELLATION_EMAIL_LOCATE_ORDER_ITEM_CANCEL" "RETURN_NOTIFICATION_EMAIL" "REFUND_NOTIFICATION_EMAIL" "APPEASEMENT_NOTIFICATION_EMAIL" "BACKORDER_AUTH_DECLINE_EMAIL" "INVOICE_POSTING"

object

Responses

200

Allocation Assigned

206

Partial Content

400

Bad Request

404

Order/item/Details Not Found/Valid

500

Internal Server Error

post/allocation/

Request samples

Payload

application/json

{"detailType": "ORDER_CREATE",
"detail": {"orderNumber": "ship1233234555g",
"channel": "ship1233234555g",
"tenant": "ship1233234555g",
"id": "98ff5c0bec0aed3c86202c32",
"documentType": "ALLOCATION",
"items": [{"lineItemId": "134fqfaa532qrf",
"allocationLineNumber": 1,
"quantity": 3
}
]
}
}

Response samples

application/json

[{"allocationId": "62ff5c0bec0aed3c86202c32",
"version": 2,
"allocationRequestId": "62ff5c0bec0aed3c86202c32",
"allocationNum": "xxyyzz12345",
"parentAllocationId": "62ff5c0bec0aed3c86202c32",
"sentToPPSDate": "2022-08-01T18:03:28.483971941Z",
"allocationDate": "2022-08-01T18:03:28.483971941Z",
"updatedAt": "2022-08-01T20:03:28.483971941Z",
"type": "ALLOCATED",
"previousAllocationLocationNum": 410,
"poNumber": "1125",
"itemsType": "WEB_SHIP",
"orderSubType": "BORDERFREE",
"vendorId": "56",
"shipDate": null,
"shipType": "SHIP_TO_ADDRESS",
"shipMethod": "Overnight Delivery",
"shipToId": "98ff5c0bec0aed3c86202c32",
"statusCode": "PENDING_PICK",
"locationNum": "1234B",
"locationType": "1234B",
"shipToAddress": { },
"recipient": [{"name": {"first": "John",
"middle": "Middle",
"last": "Doe"
},
"email": "demo@xyz.inc",
"phone": {"number": "55555555555",
"type": "MOBILE"
},
"pickupType": "Primary"
}
],
"items": [{"orderLineId": "134fqfaa532qrf",
"itemId": "100064",
"sku": "123k4h123k",
"orderId": "123k4h123k",
"orderDate": "2022-08-01T18:03:28.483971941Z",
"estimatedDeliveryDate": "2022-08-01T18:03:28.483971941Z",
"quantity": 3,
"allocationLineNumber": 3,
"parentAllocationLineNumber": 3,
"reallocationRequestId": "123k4h123k",
"shippedQuantity": 1,
"scratchQuantity": 1,
"scratchedReasonCode": "Scratched during shipment",
"reshipReasonCode": "Reshipping during shipment",
"reallocationReasonCode": "Reallocating due to unavailability of location number",
"channelId": "12",
"segment": null,
"vendorId": "56",
"title": "Demo",
"weight": 5.5,
"cost": 500.2,
"price": 50.2,
"itemStatus": "ALLOCATED",
"attributes": {"property1": { },
"property2": { }
},
"uom": "KG"
}
],
"auditLogs": [{"lineItemId": "4",
"auditId": "62272e917b12209e68751d94",
"auditType": "UPDATE",
"employeeId": "62272e917b12209e68751d94",
"auditTimestamp": "2022-05-12T09:24:54.804Z",
"source": "POS",
"reasonCode": "POS",
"subReasonCode": "POS",
"policyCode": "POS",
"note": "Note",
"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": { }
}
}
]
}
]