Overview

The Sourcing features determine which warehouse a demand line should be sourced from. The primary factors for this determination are inventory availability and proximity to end destination.

Using these factors, along with other business logic, Orchestrate loops a demand line through several sourcing policies and corresponding warehouses until a feasible solution is found.

While Sourcing can be used without inventory awareness, we highly encourage grouping these functions together.

Additionally, inventory awareness allows sourcing logic to factor in a Ship-Complete philosophy, meaning you can prioritize shipping an entire order line from a single warehouse before attempting to split it across multiple locations.

POST /Sourcing

Request Body

Property	Data Type	Notes
itemNumber	string	Unique identifier for the item demanded.
quantity	number	Quantity of units for the demand line. decimal
unitOfMeasure	string	Unit of measure as defined by the host system. Note Orchestrate does not define nor execute unit of measure conversions.
shipDate	string	Requested ship date for the demand. date-time
partialFulfillment	boolean	Yes: The line can be partially fulfilled. Where there are 10 requested units, and there are only 5 units remaining in the given warehouse, the line will be partially fulfilled for 5 units. No: The line must be entirely fulfilled. Where there are 10 requested units, and there are only 5 units remaining in the given warehouse, the line will not be allocated any units.

deliveryAddress

Property	Data Type	Notes
name	string	max length: 100
company	string	max length: 150
attentionTo	string	max length: 150
addressLines	string
city	string	max length: 150
postalCode	string	max length: 15
stateProvinceCode	string	max length: 5
country	string
countryCode	string	max length: 5
phoneNumber	string	max length: 20
residential	boolean
taxId	string
emailAddress	string	max length: 400
county	string	max length: 30

identificationNumbers

Property	Data Type	Notes
vat	string
eori	string

attributes

Property	Data Type	Notes
name	string	Name of the given attribute attached to the requested demand line.
value	string	Where applicable, the value of the given attribute.

Response

Property	Data Type	Notes
sourcingPolicyId	string	The policy used to determine where and how to source the given demand lines.
region	string	The region selected based on the attributes and address of the demand line.
directDelivery	boolean	Yes: The line will be fulfilled by direct delivery. A purchase order ship from address will be provided based on the default vendor for the item. No: The line will be fulfilled by a combination of warehouses.
vendorName	string	If the line is being fulfilled by direct delivery, the vendor executing the shipment.
requestedQuantity	number	Quantity of the item being demanded. decimal
quantity	number	Quantity satisfied for the demand line based on inventory availability for the warehouse. decimal
warehouse	string	The warehouse providing inventory for the demand line.
unitOfMeasure	string	Unit of measure as defined by the host system.
errorMessages	string	If any errors were encountered, they appear here.

shipFromAddress

Property	Data Type	Notes
name	string	max length: 100
company	string	max length: 150
attentionTo	string	max length: 150
addressLines	string
city	string	max length: 150
postalCode	string	max length: 15
stateProvinceCode	string	max length: 5
country	string
countryCode	string	max length: 5
phoneNumber	string	max length: 20
residential	boolean
taxId	string
emailAddress	string	max length: 400
county	string	max length: 30

identificationNumbers

Property	Data Type	Notes
vat	string
eori	string

shipToAddress

Property	Data Type	Notes
name	string	max length: 100
company	string	max length: 150
attentionTo	string	max length: 150
addressLines	string
city	string	max length: 150
postalCode	string	max length: 15
stateProvinceCode	string	max length: 5
country	string
countryCode	string	max length: 5
phoneNumber	string	max length: 20
residential	boolean
taxId	string
emailAddress	string	max length: 400
county	string	max length: 30

identificationNumbers

Property	Data Type	Notes
vat	string
eori	string

Browser not supported