PUT
/
allocations
/
allocation-request-id
/
{allocationRequestId}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id
string
required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-channel-id
string
required

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-fabric-request-id
string

Unique request ID

Path Parameters

allocationRequestId
string
required

Allocation request ID is a 24-character allocation ID configured by the merchant

Body

application/json

Allocation request details

allocationRequestId
string
required

Merchant-specified unique ID. If omitted, this is generated by fabric’s sequence generator using Configuration service.

locationNumber
string
required

Inventory location number to identify ship-from location or Buy Online Pickup from Store (BOPIS) location. This must be the locationNumber stored in the fabric Location service.

allocationNumber
integer

Merchant-specified unique number assigned to each allocation. If omitted, is this generated by fabric’s sequence generator using Configuration service

attributes
object

User defined custom attributes. This is a placeholder for additional info in key value pairs.

currency
string

Currency

decisionContexts
object[]

A list of decision contexts.

items
object[]

List of items to be shipped

itemsType
string

This is an inherited attribute from Orders that pertains to item types such as WEB_SHIP, WEB_PICKUP, WEB_SDD INTERNATIONAL, POS, POS_SHIP, and POS_PICKUP.

locationType
string

Inventory location type such as, DC or Store from where the order is picked up

notifiedToPPSAt
string

fabric system-generated time when allocation service sent event notification to package tracking service.

orderSubType
string

During allocation creation, this attribute is inherited from fabric Orders and includes subtypes such as IOS, ANDROID, INTERNATIONAL, among others.

parentAllocationId
string

Allocation ID that's generated while creating the allocation for the first time. Initially this will be the same as allocationRequestId. If there is a reallocation, the parentAllocationId will be assigned the same value as the initial allocationRequestId, and will serve as a means of monitoring all subsequent child allocations.

previousAllocatedLocationNums
string[]

In case of reallocation, it keeps track of previously allocated location numbers.

recipients
object[]

Recipient details like name, email address, and phone number

shipToAddress
object

Address details

shipToId
string

System-generated UUID associated with shipInfo, generated from CnC service. <p> Note: An order can have multiple ship-to (delivery) locations and items going to the same location have one shipToId. </p>

shipmentMethod
string

Shipping method. This attribute is inherited from order.shipInfo during allocation creation.

shipmentType
string

This attribute is inherited from order.shipInfo during allocation creation. Acceptable value: SHIP_TO_ADDRESS, CUSTOMER_PICKUP, PICKUP, SDD, SHIP_TO_STORE

shippedAt
string

Time of order shipment, generated by allocation service when shipment service calls allocation after shipment is created.

statusCode
enum<string>

Allocation status

Available options:
ALLOCATED,
PENDING_DROP,
PENDING_ALLOCATION,
PENDING_PICK,
SHIPPED,
PARTIALLY_SHIPPED,
REALLOCATED,
CANCELLED,
PARTIALLY_CANCELLED,
PENDING_REALLOCATION,
PARTIAL_PENDING_REALLOCATION
type
enum<string>

Allocation type. ALLOCATED: Order is allocated for fulfillment. SCRATCHED: Order is canceled during allocation due to unavailability of inventory. RETURNED: Allocation created for the return items.

Available options:
ALLOCATED,
SCRATCHED,
RETURNED

Response

200 - application/json

Allocation response details

allocationId
string
required

24-character system-generated allocation ID

allocationRequestId
string
required

Merchant-specified unique ID. If omitted, this is generated by fabric’s sequence generator using Configuration service.

createdAt
string
required

System-generated time of allocation record creation

locationNumber
string
required

Inventory location number to identify ship-from location or Buy Online Pickup from Store (BOPIS) location. This must be the locationNumber stored in the fabric Location service.

version
integer
required

Allocation document version. The version number is incremented each time the allocation document undergoes an update. Update to an allocation document happens automatically when the status changes from one state to another based on the statusCode.

allocationNumber
integer

Merchant-specified unique number assigned to each allocation. If omitted, is this generated by fabric’s sequence generator using Configuration service

auditLogs
object[]

Change history details

currency
string

Currency

decisionContexts
object[]

A list of decision contexts.

items
object[]

List of items to be shipped

itemsType
string

This is an inherited attribute from Orders that pertains to item types such as WEB_SHIP, WEB_PICKUP, WEB_SDD INTERNATIONAL, POS, POS_SHIP, and POS_PICKUP.

locationType
string

Inventory location type such as, DC or Store from where the order is picked up

notifiedToPPSAt
string

fabric system-generated time when allocation service sent event notification to package tracking service.

orderSubType
string

During allocation creation, this attribute is inherited from fabric Orders and includes subtypes such as IOS, ANDROID, INTERNATIONAL, among others.

parentAllocationId
string

Allocation ID that's generated while creating the allocation for the first time. Initially this will be the same as allocationRequestId. If there is a reallocation, the parentAllocationId will be assigned the same value as the initial allocationRequestId, and will serve as a means of monitoring all subsequent child allocations.

previousAllocatedLocationNums
string[]

In case of reallocation, it keeps track of previously allocated location numbers.

recipients
object[]

Recipient details like name, email address, and phone number

shipToAddress
object

Address details

shipToId
string

System-generated UUID associated with shipInfo, generated from CnC service. <p> Note: An order can have multiple ship-to (delivery) locations and items going to the same location have one shipToId. </p>

shipmentMethod
string

Shipping method. This attribute is inherited from order.shipInfo during allocation creation.

shipmentType
string

This attribute is inherited from order.shipInfo during allocation creation. Acceptable value: SHIP_TO_ADDRESS, CUSTOMER_PICKUP, PICKUP, SDD, SHIP_TO_STORE

shippedAt
string

Time of order shipment, generated by allocation service when shipment service calls allocation after shipment is created.

statusCode
enum<string>

Allocation status

Available options:
ALLOCATED,
PENDING_DROP,
PENDING_ALLOCATION,
PENDING_PICK,
SHIPPED,
PARTIALLY_SHIPPED,
REALLOCATED,
CANCELLED,
PARTIALLY_CANCELLED,
PENDING_REALLOCATION,
PARTIAL_PENDING_REALLOCATION
type
enum<string>

Allocation type ALLOCATED: Order is allocated for fulfillment SCRATCHED: Order is canceled during allocation due to unavailability of inventory RETURNED: Allocation created for the return items

Available options:
ALLOCATED,
SCRATCHED,
RETURNED
updatedAt
string

System-generated time when allocation record was last modified