Supplier Oasis API Data Model Reference 1.0
Supplier Oasis API Data Model Reference 1.0
0-SNAPSHOT
This document refers to version1.0-SNAPSHOT of the SOFS API.
These materials are the exclusive property of Supplier Oasis Fulfillment Services, Inc. hereafter known as SOFS,
and constitute proprietary information of SOFS. Any duplication, copying, distribution, modification, or
transmission of the materials is strictly prohibited.
The materials are provided “as is” without any warranties of any kind including warranties of merchantability,
fitness for a particular purpose, or non-infringement. SOFS does not warrant the accuracy and completeness of
the materials and may make changes to them at any time without notice.
API Endpoints Reference ........................................................... 7
Inventory resource ................................................................. 8
GET ............................................................................. 8
Request ........................................................................ 8
Response XSD element ............................................................ 8
GET ............................................................................. 8
Request ........................................................................ 8
Response XSD element ............................................................ 8
Sales Orders resource .............................................................. 8
GET ............................................................................. 8
Request XSD element ............................................................. 8
Response XSD element ............................................................ 8
POST............................................................................. 9
Request ........................................................................ 9
Request XSD element ............................................................. 9
Response XSD element ............................................................ 9
Shipments Resource ................................................................. 9
POST .............................................................................. 9
Request.......................................................................... 9
POST /shipments................................................................. 9
Request XSD element ............................................................. 9
Response XSD element ............................................................ 9
Top-level Elements .................................................................10
API Model Reference ................................................................11
Complex Types......................................................................11
AddressType.........................................................................11
AddressType elements ................................................................11
BrandingType ........................................................................11
BrandingType elements ................................................................11
CodeType...........................................................................12
CodeType element ...................................................................12
CurrencyType ........................................................................13
CurrencyAmountType elements ..........................................................13
CurrentInventoryMessageType ............................................................13
CurrentInventoryMessageType elements ....................................................13
CurrentInventoryQuantityDetailsType ........................................................13
CurrentInventoryQuantityDetailsType elements ................................................13
CurrentInventoryType ...................................................................14
CurrentInventoryType elements ..........................................................14
CurrentWarehouseQuantityType ...........................................................14
CurrentWarehouseQuantityType elements ...................................................14
DimensionsType ......................................................................14
DimensionsType elements ..............................................................14
InventoryAdjustmentType ................................................................15
InventoryAdjustmentType elements ........................................................15
InventoryHistoryMessageType.............................................................15
InventoryHistoryMessageType element .....................................................15
ItemSpecialHandlingListType..............................................................16
ItemSpecialHandlingListType element ......................................................16
ItemSpecialHandlingType ................................................................16
ItemSpecialHandlingListType element ......................................................16
LTLShipmentType .....................................................................16
LTLShipmentType elements .............................................................16
LengthUnitOfMeasureType ...............................................................16
LengthUnitOfMeasureType elements .......................................................16
LightWeight0to16OzShipmentType..........................................................17
LightWeight0to16OzShipmentType elements .................................................17
LightWeightGreaterThan1LbShipment .......................................................17
LightWeightGreaterThan1LbShipmentType elements ............................................17
NonThirdPartyBillingShipmentType .........................................................18
NonThirdPartyBillingShipmentType elements .................................................18
PackageDetailType ....................................................................18
PackageDetailType elements ............................................................18
ProcessedSalesOrderLineType ............................................................18
ProcessedSalesOrderLineType elements ....................................................18
ProcessedSalesOrderMessageType.........................................................19
ProcessedSalesOrderMessageType elements ................................................19
ProcessedSalesOrderType ...............................................................20
ProcessedSalesOrderType elements .......................................................20
ProductDescriptionType .................................................................21
ProductDescriptionType elements .........................................................21
ProductUnitOfMeasureType ..............................................................21
ProductUnitOfMeasureType element .......................................................21
SalesOrderAcknowledgementMessageType ...................................................22
SalesOrderAcknowledgementMessageType element ............................................22
SalesOrderAcknowledgementResponseMessageType ............................................22
SalesOrderAcknowledgementResponseMessageType element .....................................22
SalesOrderAcknowledgementResponseType...................................................22
SalesOrderAcknowledgementResponseType elements ..........................................22
SalesOrderAcknowledgementType..........................................................22
SalesOrderAcknowledgementType elements .................................................23
SalesOrderBaseType ...................................................................23
SalesOrderBaseType elements...........................................................23
SalesOrderLineResponseType ............................................................24
SalesOrderLineResponseType elements ....................................................24
SalesOrderLineType ...................................................................24
SalesOrderLineType elements ...........................................................24
SalesOrderMessageType ................................................................25
SalesOrderMessageType elements ........................................................25
SalesOrderResponseMessageType .........................................................25
SalesOrderResponseMessageType elements .................................................25
SalesOrderResponseType ...............................................................25
SalesOrderResponseType elements .......................................................25
SalesOrderType ......................................................................25
SalesOrderType elements ..............................................................26
ShipConfirmationType ..................................................................26
ShipConfirmationType elements ..........................................................26
ShipmentDetailType....................................................................27
ShipmentDetailType elements ...........................................................27
ShippingSpecificationsType...............................................................27
ShippingSpecificationsType elements ......................................................27
ShortShipType .......................................................................28
ShortShipType elements ...............................................................28
SkuInventoryAdjustmentType .............................................................28
SkuInventoryAdjustmentType elements .....................................................28
SkuInventoryHistoryMessageType ..........................................................28
SkuInventoryHistoryMessageType elements ..................................................29
SmallParcelShipmentType ...............................................................29
SmallParcelShipmentType elements .......................................................29
SpecialHandlingCodeType ...............................................................29
SpecialHandlingCodeType elements .......................................................29
SupplierInventoryMessageType ............................................................29
SupplierInventoryMessageType elements....................................................29
SupplierInventoryResponseMessageType .....................................................30
SupplierInventoryResponseMessageType elements.............................................30
SupplierInventoryResponseType ...........................................................30
SupplierInventoryResponseType elements ...................................................30
SupplierInventoryType ..................................................................30
SupplierInventoryType elements ..........................................................30
SupplierShipConfirmationType.............................................................30
SupplierInventoryType elements ..........................................................31
SupplierShipmentMessageType............................................................31
SupplierShipmentMessageType element ....................................................31
SupplierShipmentResponseMessageType.....................................................31
SupplierShipmentResponseMessageType elements ............................................31
SupplierShipmentResponseType ...........................................................31
SupplierShipmentResponseType elements ...................................................31
SupplierShipmentType ..................................................................32
SupplierShipmentType elements ..........................................................32
SupplierWarehouseQuantityResponseType ....................................................32
SupplierWarehouseQuantityResponseType elements ...........................................32
SupplierWarehouseQuantityType ...........................................................33
SupplierWarehouseQuantityType elements...................................................33
ThirdPartyBillingShipmentType ............................................................33
ThirdPartyBillingShipmentType elements ....................................................33
WarehouseInventoryAdjustmentType ........................................................33
WarehouseInventoryAdjustmentType elements ................................................33
WeightType .........................................................................34
WeightType elements .................................................................34
WeightUnitOfMeasureType ...............................................................34
WeightUnitOfMeasureType element .......................................................34
Simple Types ........................................................................34
AbsoluteQuantityType ..................................................................34
AbsoluteQuantityType element ...........................................................34
CodeSimpleType ......................................................................34
CodeSimpleType - A string that contains a coded value. ..........................................35
CurrencyCodeType ....................................................................35
CurrencyCodeType values ..............................................................35
CurrencyCodeType ....................................................................35
CurrencyCodeType - A type that is based on CodeSimpleType .....................................35
DispositionType.......................................................................35
DispositionType .....................................................................35
LengthType..........................................................................35
MoneyType element ..................................................................36
MoneyType..........................................................................36
MoneyType element ..................................................................36
OrderFulfillmentType ...................................................................36
OrderFulfillmentType values .............................................................36
ReasonCode.........................................................................36
ReceiptStatusType values ..............................................................36
ReceiptStatus ........................................................................37
ReceiptStatusType values ..............................................................37
SalesOrderLineCancelReasonType .........................................................37
SalesOrderLineCancelReasonType values ...................................................37
SalesOrderLineStatusType ...............................................................37
SalesOrderLineStatusType values.........................................................37
SalesOrderStatusType ..................................................................38
SalesOrderStatusType values............................................................38
ShipmentStatusType ...................................................................38
ShipmentStatusType values .............................................................38
XSD’s .............................................................................39
BatchJob XSD: ......................................................................39
Common Types XSD: .................................................................40
InventoryUpdate XSD: .................................................................44
SalesOrder XSD: ....................................................................50
Because the Accept and Content Type headers are commonly understood, they are not
documented repeatedly. Please note the following:
• Content Type options for inventory calls are CSV, XML, and text.
• Content Type options for the shipments calls are XML and text.
• Content Type options for sales order calls are XML and CSV.
Most of the HTTP methods require startTime and endTime query parameters, which must
conform to the W3C recommendation in section 3.2.7 at http://www.w3.org/TR/xmlschema-
2/#dateTime
Examples are:
• startTime=2013-08-01.
• startTime=2013-08-01&endTime=2013-08-02
• startTime=2013-08-01T00:00:00&endTime=2013-08-02T12:00:00
GET
Handles the HTTP GET action for inventory, to get current statuses for inventory items.
Request
GET /inventory
GET
Handles the HTTP GET action for a history of changes to the inventory.
Request
GET /inventory/history
GET
Handles the HTTP GET action for all processed sales orders that were created or modified
within a specified date range. Use this call to track newly created orders and to check
fulfillment activity on existing orders.
GET /salesorders?starttime=datetime&endtime=datetime
Request
POST /salesorders
Shipments Resource
/shipments
POST
Handles the HTTP POST action for creating a shipment confirmation or a short shipment.
Request
POST /shipments
• salesOrderAcknowledgementResponseMessage of type,
SalesOrderAcknowledgementResponseMessageType
Complex Types
Complex types are listed alphabetically.
AddressType
A complex type that describes a physical location.
AddressType elements
Name Type Description
*contactName string Name of person associated with this address
*address1 string First line of the address
address2 string Additional line for the address
address3 string Another optional line for the address
district string Name of the district for the address
*city string Name of the city
*stateOrProvince string Name of the state
*postalCode string USPS zip code; five or nine digits are supported.
*country code CountryCodeType ISO 3166-1 alpha-3 country code
*phoneNumber string Phone number
alternatePhone string Additional alternate phone number
email string Email address associated with the address
BrandingType
Company information that could be included in a parcel that is delivered to a customer.
BrandingType elements
Name Type Description
packingSlipPromoText string Promotional text for the sales channel that appears on the
packing slip
CodeType
A CodeType contains an xs:string that resolves to a code. Codes are used as abbreviations of longer names. For
example, a state code of CA represents California. The intent of the code is to allow systems to process based on a
known set of values. Typically, these values are fairly static but occasionally might change. For Supplier Oasis, the code
list for a particular type is available on the Supplier Oasis API Website.
CodeType element
Name Type Description
CurrencyAmountType elements
Name Type Description
CurrentInventoryMessageType
Defines the current inventory for a set of products (SKUs) at each warehouse.
CurrentInventoryMessageType elements
Name Type Description
currentInventory CurrentInventoryType Current inventory for a set of products
(SKUs)
CurrentInventoryQuantityDetailsType
The breakdown of specific types of inventory for an item.
CurrentInventoryQuantityDetailsType elements
Name Type Description
totalQuantity AbsoluteQuantityType Total quantity that physically resides at a warehouse; the
sum of all provided specific quantities
Name Type Description
reserved AbsoluteQuantityType Quantity that has been reserved for sales orders; a
product is in this state after a sales order is received but
has not yet shipped.
sellable AbsoluteQuantityType Quantity that is available for sale
onHold AbsoluteQuantityType Quantity that is temporarily flagged by the warehouse as
not sellable or reserved; this state may be used to
identify damaged goods.
CurrentInventoryType
Current inventory for a specific product at multiple warehouses.
CurrentInventoryType elements
Name Type Description
productDescription ProductDescriptionType Collection of attributes that describes a
product
currentWarehouseQuantity CurrentWarehouseQuantityType Quantity of a product in a warehouse
CurrentWarehouseQuantityType
The quantities of a product at a selected warehouse.
CurrentWarehouseQuantityType elements
Name Type Description
warehouseName CodeType Mnemonic identifier for a SOFS
warehouse
barcode string Scannable label of code that represents
the contents of the box
DimensionsType
Represents the physical dimensions for the length, width, and height of a container.
DimensionsType elements
Name Type Description
InventoryAdjustmentType
An adjustment to the quantity of a product at a specific warehouse.
InventoryAdjustmentType elements
Name Type Description
productDescription ProductDescriptionType Collection of attributes that describe
an item in a warehouse
warehouseInventoryAdjustment WarehouseInventoryAdjustmentType Adjustments to inventory at a
warehouse
InventoryHistoryMessageType
Defines a history of inventory changes to a product; changes may be positive or negative.
InventoryHistoryMessageType element
Name Type Description
ItemSpecialHandlingListType element
Name Type Description
itemSpecialHandling ItemSpecialHandlingType Type that defines the basic data for itemSpecialHandling
code
ItemSpecialHandlingType
Defines the basic data for item special handling code.
ItemSpecialHandlingListType element
Name Type Description
*warehouseName string Mnemonic identifier for the warehouse fulfilling the sales
order
specialHandlingCode string A special handling code for this item at the warehouse
LTLShipmentType
Shipment details that apply to LTL shipping solutions.
LTLShipmentType elements
Name Type Description
freightPayorAddress AddressType Address of the payor of the freight
ltlServiceLevel CodeType Level of service for this LTL shipment (Curbside, White
Glove, etc.)
carrierNotes string Optional notes for the Carrier
carrier CodeType Code that identifies the Carrier
LengthUnitOfMeasureType
Java class for the LengthUnitOfMeasureType complex type.
LengthUnitOfMeasureType elements
Name Type Description
*code string Code for the unit of measure
LightWeight0to16OzShipmentType
Shipment details for packages weighing less than 1 lb.
LightWeight0to16OzShipmentType elements
Name Type Description
shippingServiceLevel CodeType Shipping service level for shipment of the order; if not
specified, Ground or Basic service is assumed.
shipperOfRecordAccountN umberstring Partner's identifying account number with the carrier; not
necessarily the same as the shipping account number
used for billing
LightWeightGreaterThan1LbShipment
Shipment details that apply to lightweight shipping solutions for packages from 1 to 8 lbs.
LightWeightGreaterThan1LbShipmentType elements
Name Type Description
shippingServiceLevel CodeType Shipping service level for shipment of the order; if not
specified, Ground or Basic service is assumed.
shipperOfRecordAccountN umberstring Partner's identifying account number with the carrier;
not necessarily the same as the shipping account
number used for billing
Name Type Description
NonThirdPartyBillingShipmentType elements
Name Type Description
*shippingServiceLevel CodeType Shipping service level for shipment of the order; if not
specified, Ground or Basic service is assumed.
PackageDetailType
Java class for the PackageDetailType complex type.
PackageDetailType elements
Name Type Description
*packageID long SOFS identifier for shipment package
*packageType CodeType Code for the type of package
*packageNumber long Package n of the total in a shipment
packageWeight double Weight of package as displayed on the label
packageWeightUnitOfMeasure CodeType Code for the unit of measure for the package weight
trackingNumber string Carrier tracking number for this package
ProcessedSalesOrderLineType
Contains information about a sales order line that has been processed by SOFS.
ProcessedSalesOrderLineType elements
Name Type Description
salesChannelLineNumber long External sales order line number, as entered in
the sales channel's system
*partnerSku string Partner's unique identifier for the order line
item
barcode string Label of machine-scannable code with
corresponding numerals that represents the
contents of the box
Name Type Description
*salesChannelSKU string SKU for this merchandise as known by the
sales channel; prints on the packing slip
*quantity long Total numeric count
specialHandling CodeType Code defining outbound special handling
for this order line; a legacy field replaced by
specialHandlingCode
giftWrapText string Text applied to the card that accompanies gift
wrapping
itemPrice decimal Dollar amount of an item
specialHandlingCode SpecialHandlingCodeType Code defining outbound special handling for
this order line
lineId long Supplier Oasis primary key for sales order line
itemId long Supplier Oasis identifier for the item on this line
ProcessedSalesOrderMessageType
Message containing one or more processed sales orders; message flows from SOFS to the partner.
ProcessedSalesOrderMessageType elements
Name Type Description
processedSalesOrder ProcessedSalesOrderType Information about a sales order that exists in the Supplier
Oasis network; includes basic identifying information and
one or more sales order lines.
ProcessedSalesOrderType
Collection of attributes that describe a sales order that has been created in SOFS; it includes basic identifying information
and one or more sales orderlines.
ProcessedSalesOrderType elements
Name Type Description
retailOrderNumber string Unique number on the retail channel for this order
*processedSalesOrderLine ProcessedSalesOrderLineType
ProductDescriptionType
Description of a product that has inventory.
ProductDescriptionType elements
Name Type Description
partnerSku string Partner-defined SKU for the product
productUnitOfMeasure ProductUnitOfMeasureType Unit of measure for this product
ProductUnitOfMeasureType
Code that indicates the unit of measure for a product. Examples may include EA (Each), BX (Box).
ProductUnitOfMeasureType element
Name Type Description
*code string Code for the unit of measure for a product
SalesOrderAcknowledgementMessageType
Message that contains information about sales order(s) being acknowledged by the Supplier; this data flows from the
Supplier to SOFS.
SalesOrderAcknowledgementMessageType element
Name Type Description
SalesOrderAcknowledgementResponseMessa
geType
Type that indicates errors encountered while processing the salesOrderAcknowledgementMessage; this data flows from
SOFS to the Supplier.
SalesOrderAcknowledgementResponseMessageType element
Name Type Description
salesOrderAcknowledgeme ntResponseSalesOrderAcknowledgementResponseTypeMessage about errors
encountered while processing a
salesOrderAcknowledgementMessage
SalesOrderAcknowledgementResponseType
Type that indicates errors encountered while processing the salesOrderAcknowledgementMessage; this data flows from
SOFS to the Supplier.
SalesOrderAcknowledgementResponseType elements
Name Type Description
salesChannelName string Mnemonic identifier for the retailer.
salesChannelOrderNumber string External sales order number, as entered in the sales
channel's system.
acknowledgementResponse CodeCodeType TBD
SalesOrderAcknowledgementType
Information about a sales order being acknowledged to the Supplier Oasis network. Includes basic identifying information
and one or more sales orders; this data flows from the Supplier to SOFS.
SalesOrderAcknowledgementType elements
Name Type Description
*salesChannelOrderNumbe rstring External sales order number, as entered in the sales
channel's system.
*salesChannelName string Mnemonic identifier for the retailer.
SalesOrderBaseType
Java class for the SalesOrderBaseType complex type.
SalesOrderBaseType elements
Name Type Description
salesChannelOrderNumber string External sales order number as entered in the sales
channel's system
salesChannelName string Mnemonic identifier for the retailer
*orderDate dateTime Date that the order was placed
SalesOrderLineResponseType elements
Name Type Description
salesChannelName string Mnemonic identifier for the sales channel
salesChannelLineNumber long External sales order line number as entered in
the sales channel's system
salesChannelOrderNumber string External sales order number as entered in the
sales channel's system
salesOrderlineResponseCode CodeType Code for the sales order line response
SalesOrderLineType
Defines the basic data for a single line on a sales order.
SalesOrderLineType elements
Name Type Description
*salesChannneLineNumber long External sales order line number, as entered in the sales
channel's system
PartnerSKU string Partner's unique identifier for the merchandise
represented by this order line.
barcode string An optional field to indicate a barcode for this item that
may be different than the SKU
salesChannelSKU string SKU for this merchandise as known by the sales channel;
prints on the packing slip.
*quantity long Number of units ordered on this order line
specialHandling CodeType Replaced by specialHandlingCode.
giftWrapText string Text to put on gift wrapping card
itemPrice MoneyType Unit price for the item on this order line; required for export
only.
*itemPriceCurrencyCode CurrencyCodeType Currency code for the itemPrice
vatRate decimal VAT rate for this item
specialHandlingCode CodeType Codes defining outbound special handling for this order
line
SalesOrderMessageType
Message containing one or more sales orders being submitted; data flows from a partner to SOFS.
SalesOrderMessageType elements
Name Type Description
salesOrder SalesOrderType Information about a sales order submitted to SOFS that
includes basic identifying information and one or more
sales order lines
SalesOrderResponseMessageType
Type to indicate errors encountered while processing the salesOrderMessage.
SalesOrderResponseMessageType elements
Name Type Description
*salesOrderResponse SalesOrderResponseType Details about the error.
SalesOrderResponseType
SOFS acknowledgement that an order has been received; this data flows from SOFS to the Supplier.
SalesOrderResponseType elements
Name Type Description
SalesOrderType
Information about a sales order being submitted to the Supplier Oasis network that includes basic identifying information
and one or more sales order lines.
SalesOrderType elements
Name Type Description
totalValuePaid CurrencyType Total value of the order, less any credits. This is
the actual amount the customer is charged.
shippingTotal CurrencyType Total shipping amount of the order
ShipConfirmationType
Java class for ShipConfirmationType complex type.
ShipConfirmationType elements
Name Type Description
*quantityShipped long Sales order line quantity shipped in this package
*packageDetail PackageDetailType Details that describe the package an order shipped in
*shipmentDetail ShipmentDetailType Details of a shipment confirmation
ShipmentDetailType
Java class for ShipmentDetailType complex type.
ShipmentDetailType elements
Name Type Description
billingAccountNumber string Freight account number used for billing the shipment
shippingServiceLevel CodeType Service level for shipment of the order; if not specified,
Ground or Basic service is assumed
ShippingSpecificationsType
Java class for ShippingSpecificationsType complex type.
ShippingSpecificationsType elements
Name Type Description
*isThirdPartyBilling boolean Whether billing third party billing on your sales
channel
isSignatureRequired boolean whether a signature is required; if blank, then
FALSE is assumed
isDeclaredValueRequired boolean whether a declared value is required for this sales
order; if TRUE, then warehouse calculates from
replacement cost. If blank, FALSE is assumed.
transportationTerms string Applies to export; trade terms that apply to the
shipment
ltlShipment LTLShipmentType LTL shipment information
smallParcelShipment SmallParcelShipmentType Small parcel shipment information
ShortShipType
Java class for the ShortShipType complex type
ShortShipType elements
Name Type Description
reasonCode CodeType Code for the reason for a short ship
SkuInventoryAdjustmentType
Adjustments to quantities for a specific product at multiple warehouses.
SkuInventoryAdjustmentType elements
Name Type Description
SkuInventoryHistoryMessageType
A message containing inventory adjustments to a specific SKU across multiple warehouses.
SkuInventoryHistoryMessageType elements
Name Type Description
SmallParcelShipmentType
Shipment details that apply to parcel shipping solutions such as UPS and FedEx.
SmallParcelShipmentType elements
Name Type Description
shippingServiceLevel CodeType Code for the shipping service level
billingAccountNumber string Account number used for billing this shipment
shipperOfRecordAccountNumber string Partner's identifying account number with the carrier; not
necessarily the same as the shipping account number
used for billing
carrier CodeType Carrier used to ship the order
SpecialHandlingCodeType
Defines the basic data for special handling code.
SpecialHandlingCodeType elements
Name Type Description
SupplierInventoryMessageType
Inventory create or update requests that a Supplier sends to SOFS.
SupplierInventoryMessageType elements
Name Type Description
SupplierInventoryResponseMessageType elements
Name Type Description
successCount int Total successful inventory create/update
messages received by SOFS
errorCount int Total inventory create/update requests
that failed
supplierInventoryResponse SupplierInventoryResponseType SOFS response to Supplier's inventory
updates
SupplierInventoryResponseType
Defines an inventory create/update response for one partner SKU; this data flows from SOFS to the Supplier.
SupplierInventoryResponseType elements
Name Type Description
partnerSku string Partner's unique
identifier for the item
supplierWarehouseQuantityResponse SupplierWarehouseQuantityResponseType Quantity response from
a Supplier warehouse
SupplierInventoryType
Java class for the SupplierInventoryType complex type.
SupplierInventoryType elements
Name Type Description
partnerSku string Partner's SKU for the inventory update
supplierWarehouseQuantity SupplierWarehouseQuantityType Quantity of a specific SKU in a Supplier
warehouse
SupplierShipConfirmationType
Java class for the SupplierShipConfirmationType complex type.
SupplierInventoryType elements
Name Type Description
SupplierShipmentMessageType
Java class for the SupplierShipmentMessageType complex type.
SupplierShipmentMessageType element
Name Type Description
supplierShipment SupplierShipmentType Shipment information from a Supplier warehouse.
SupplierShipmentResponseMessageType
Java class for the SupplierShipmentResponseMessageType complex type; this data flows from SOFS to the Supplier.
SupplierShipmentResponseMessageType elements
Name Type Description
SupplierShipmentResponseType
Java class for the SupplierShipmentResponseType complex type; this data flows from SOFS to the Supplier.
SupplierShipmentResponseType elements
Name Type Description
*success boolean Indicates whether Supplier shipment was successfully
processed
Name Type Description
errorCode CodeType Code for the error
supplierShipment SupplierShipmentType Order fulfillment/shipment information from a Supplier
warehouse
SupplierShipmentType
Java class for shipment information from a Supplier warehouse.
SupplierShipmentType elements
Name Type Description
SupplierWarehouseQuantityResponseType
Defines an inventory create/update response; this data flows from SOFS to the Supplier.
SupplierWarehouseQuantityResponseType elements
Name Type Description
success boolean Indicates whether the create/update request
succeeded
message string Error or other message
SupplierWarehouseQuantityType elements
Name Type Description
warehouseName string Mnemonic identifier for the warehouse
*quantity AbsoluteQuantityT ypeThe new quantity
timestamp dateTime Timestamp for the quantity
barcode string Required only if the barcode for this item is different from the SKU
ThirdPartyBillingShipmentType
Java class for the ThirdPartyBillingShipmentType complex type.
ThirdPartyBillingShipmentType elements
Name Type Description
*shippingServicelevel anyType Designation of carrier for this order
*billingAccountNumber string Account number used for billing this shipment
WarehouseInventoryAdjustmentType
A quantity adjustment at a specific warehouse.
WarehouseInventoryAdjustmentType elements
Name Type Description
*warehouseName string Mnemonic identifier for the warehouse
barcode string Required only if the barcode for this item is different from
the SKU
*quantity long Adjustment to inventory, either positive or negative.
reasonCode CodeType Reason for this adjustment; reason codes and
descriptions are provided by the SOFS API.
adjustmentDate dateTime Date that the inventory adjustment was processed
WeightType
Java class for the WeightType complex type.
WeightType elements
Name Type Description
WeightUnitOfMeasureType
Code for the unit of measure for weight, based on the CodeType.
WeightUnitOfMeasureType element
Name Type Description
*code string Unit of measure for weight
Simple Types
Types are listed alphabetically.
AbsoluteQuantityType
A definition of a quantity that cannot be less than zero.
AbsoluteQuantityType element
Name Type Description
Quantity long A quantity that cannot be less than zero.
CodeSimpleType
A CodeType is an xs:string which contains a coded value. The intent of the code is to allow systems to process based on
a known set of values. Typically, these values are fairly static but might occasionally change. For Supplier Oasis, the code
list for a particular type will be made available on the Supplier Oasis web site.
CodeSimpleType - A string that contains a coded value.
Name Type Description
CurrencyCodeType
Currencies are identified by their ISO 4217 currency codes. See http://www.iso.org/iso/en/prods-services/popstds/
currencycodes.html for a table of currency codes.
CurrencyCodeType values
Name Type Description
USD string US Dollar; default value
Name Type Description
CNY string Chinese yuan
CurrencyCodeType
Currencies are identified by their ISO 4217 currency codes. See http://www.iso.org/iso/en/prods-services/popstds/
currencycodes.html for a table of currency codes.
Restriction base: decimal fractionDigits value = 2 Supported types: USD (default) and CNY.
DispositionType
Disposition of a returned item, expressed as a status.
DispositionType
Name Type Description
LIQUIDATE string Item is liquidated.
RESTOCK string Item is to be restocked.
WAREHOUSE string Item is in warehouse.
LengthType
Java class for the LengthType simple type.
MoneyType element
Name Type Description
MoneyType
Java class for the InboundShipmentStatusType simple type.
MoneyType element
Name Type Description
MoneyType decimal Use the CurrencyType instead, for international support.
(DEPRECATED)
OrderFulfillmentType
Defines the kind of fulfillment for this order.
OrderFulfillmentType values
Name Type Description
ALLOW_PARTIAL_FILL string Allow partial order fulfillment
ReasonCode
Status codes for return reasons.
ReceiptStatusType values
Name Type Description
BUYERS_REMORSE string Customer regrets the purchase.
ITEM_DEFECTIVE string Item has some defect.
DAMAGED_IN_TRANSIT string Item damaged during transport by the carrier.
ReceiptStatusType values
Name Type Description
ERROR string Shipment triggered an error upon receipt.
RECEIVED_SELLABLE string Shipment received; product sellable.
RECEIVED_DAMAGED string Shipment received; product damaged.
SalesOrderLineCancelReasonType
Java class for the SalesOrderLineCancelReasonType simple type.
SalesOrderLineCancelReasonType values
Name Type Description
INSUFFICIENT_QUANTITY string Numeric count too low for fulfillment
UNKNOWN_ITEM string OrderLine item cannot identified
USER_CANCELED string Supplier canceled order line
USER_CANCELLED string Supplier cancelled order line
SalesOrderLineStatusType
Java class for the SalesOrderLineStatusType simple type.
SalesOrderLineStatusType values
Name Type Description
PROCESSING string SalesOrderLine is being fulfilled.
SHIPPED string OrderLine item has shipped.
CANCELED string SalesOrderLine was canceled.
SalesOrderStatusType
Java class for the SalesOrderStatusType simple type.
SalesOrderStatusType values
Name Type Description
PROCESSING string SalesOrder is being processed.
COMPLETE string SalesOrder is complete; no missing data.
CANCELED string SalesOrder is canceled.
CANCELLED string SalesOrder is cancelled.
ENTERED string SalesOrder is in SOFS
ACCEPTED string SalesOrder is valid, accepted for fulfillment.
ShipmentStatusType
Java class for the ShipmentStatusType simple type.
ShipmentStatusType values
Name Type Description
PENDING string SOFS is processing this inbound shipment
OPEN string Warehouse received this inbound shipment notification but has not received the
product on site.
CLOSED string All lines for this inbound shipment have been received by the warehouse.
XSD’s
BatchJob XSD:
<xs:complexType name="BatchJobProgressType">
<xs:sequence>
<xs:element minOccurs="1" name="batchJobId" type="xs:long" />
<xs:element minOccurs="0" name="batchJobName" type="xs:string">
<xs:annotation>
<xs:documentation>Optional user-defined convenience identifier. Does not need to be unique</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="1" name="status" type="xs:string" />
<xs:element minOccurs="1" name="totalRecordCount" type="xs:int" />
<xs:element minOccurs="1" name="recordsProcessedSoFar" type="xs:int">
<xs:annotation>
<xs:documentation>Approximate number of records that have been processed thus far</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>
Common Types XSD:
InventoryUpdate XSD:
SalesOrder XSD:
</xs:sequence>
</xs:complexType>
<xs:complexType name="SpecialHandlingCodeType">
<xs:annotation>
<xs:documentation>Defines the basic data for special handling code.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="specialHandlingCode" type="CodeType">
<xs:annotation>
<xs:documentation>a special handling code for this SalesOrder Line</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="LTLShipmentType">
<xs:annotation>
<xs:documentation>Shipment details which apply to LTL shipping solutions.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="freightPayorAddress" type="AddressType" minOccurs="0"/>
<xs:element minOccurs="0" name="ltlServiceLevel" type="CodeType">
<xs:annotation>
<xs:documentation>Level of Service for this LTL shipment. (Curbside, White Glove, etc.)</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="carrierNotes" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Optional notes for the carrier.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="carrier" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="LightWeight0to16OzShipmentType">
<xs:annotation>
<xs:documentation>Shipment details which apply to lightweight shipping solutions for packages less than 1 LB.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="shippingServiceLevel"/>
<xs:element minOccurs="0" ref="shipperOfRecordAccountNumber"/>
<xs:element minOccurs="0" ref="carrier"/>
<xs:element minOccurs="0" ref="uspsMailerId"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="LightWeightGreaterThan1LbShipmentType">
<xs:annotation>
<xs:documentation>Shipment details which apply to lightweight shipping solutions for packages from 1 to 8 LBS.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="shippingServiceLevel"/>
<xs:element minOccurs="0" ref="shipperOfRecordAccountNumber"/>
<xs:element minOccurs="0" ref="carrier"/>
<xs:element minOccurs="0" ref="uspsMailerId"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SmallParcelShipmentType">
<xs:annotation>
<xs:documentation>Shipment details which apply to parcel shipping solutions, such as UPS and FedEx.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="shippingServiceLevel"/>
<xs:element minOccurs="0" ref="billingAccountNumber"/>
<xs:element minOccurs="0" ref="shipperOfRecordAccountNumber"/>
<xs:element minOccurs="0" ref="carrier"/>
<xs:element minOccurs="0" ref="uspsMailerId"/>
</xs:sequence>
</xs:complexType>
<xs:element name="billingAccountNumber" type="xs:string">
<xs:annotation>
<xs:documentation>Account number used for billing this shipment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="shipperOfRecordAccountNumber" type="xs:string">
<xs:annotation>
<xs:documentation>Partner's identifying account number with the carrier.
Not necessarily the same as the Shipping Account Number used for billing.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="uspsMailerId" type="xs:string">
<xs:annotation>
<xs:documentation>Mailer ID defined by USPS.
Required for UPSMI, Fedex Smartpost, UPS Surepost, DHL Global Mail and USPS.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="SupplierShipmentMessageType">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="supplierShipment" type="SupplierShipmentType"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SupplierShipmentType">
<xs:sequence minOccurs="1">
<xs:element name="supplierSku" minOccurs="0" type="xs:string">
<xs:annotation>
<xs:documentation>The supplier SKU shipped.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="salesChannelName" type="xs:string" minOccurs="1">
<xs:annotation>
<xs:documentation>Mnemonic identifier for the retailer.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="salesChannelOrderNumber" minOccurs="1"/>
<xs:element ref="retailOrderNumber" minOccurs="0"/>
<xs:element ref="salesChannelLineNumber" minOccurs="1"/>
<xs:element name="warehouse" type="CodeType" minOccurs="1">
<xs:annotation>
<xs:documentation>A unique identifier for the warehouse.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:sequence minOccurs="1">
<xs:element name="supplierShipConfirmation" type="SupplierShipConfirmationType"
minOccurs="1"/>
<xs:element name="shortShip" type="ShortShipType" minOccurs="1"/>
</xs:sequence>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SupplierShipConfirmationType">
<xs:sequence>
<xs:element name="quantity" type="xs:integer" minOccurs="1">
<xs:annotation>
<xs:documentation>Quantity shipped.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="carrier" minOccurs="1"/>
<xs:element name="trackingNumber" type="xs:string" minOccurs="1">
<xs:annotation>
<xs:documentation>The carrier tracking number for the shipment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="shipDate" type="xs:dateTime" minOccurs="1">
<xs:annotation>
<xs:documentation>Date shipped.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="serviceLevel" type="CodeType">
<xs:annotation>
<xs:documentation>Service level of the shipment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="supplierInvoiceNumber" type="xs:string">
<xs:annotation>
<xs:documentation>Suppliers Invoice Number to link to Retailers Order Line
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="sequenceNumber" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Sequence Number to allow same tracking numner for multiple
shipments.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ShortShipType">
<xs:sequence>
<xs:element minOccurs="0" name="reasonCode" type="CodeType">
<xs:annotation>
<xs:documentation>Reason code for short ship.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SupplierShipmentResponseMessageType">
<xs:sequence>
<xs:element name="successCount" type="xs:int"/>
<xs:element name="errorCount" type="xs:int"/>
<xs:element maxOccurs="unbounded" name="supplierShipmentResponse"
type="SupplierShipmentResponseType"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SupplierShipmentResponseType">
<xs:sequence>
<xs:element name="success" type="xs:boolean"/>
<xs:element minOccurs="0" name="errorCode" type="CodeType"/>
<xs:element name="supplierShipment" type="SupplierShipmentType"/>
</xs:sequence>
</xs:complexType>
<xs:element name="salesOrderAcknowledgementMessage" type="SalesOrderAcknowledgementMessageType">
<xs:annotation>
<xs:documentation>Contains information about a sales order being acknowledged by the
Supplier.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="SalesOrderAcknowledgementMessageType">
<xs:annotation>
<xs:documentation>Message containing one or more sales orders being Acknowledged.
Information flows from Supplier to Supplier Oasis.
</xs:documentation>
</xs:annotation>
<xs:sequence maxOccurs="unbounded">
<xs:element name="salesOrderAcknowledgement" type="SalesOrderAcknowledgementType">
<xs:annotation>
<xs:documentation>Information about a sales order being acknowledged to the Supplier Oasis network.
Includes basic identifying information and one or more sales orders.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SalesOrderAcknowledgementType">
<xs:sequence>
<xs:element name="salesChannelOrderNumber" type="xs:string" minOccurs="1">
<xs:annotation>
<xs:documentation>External sales order number, as entered in the sales channel's system.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="salesChannelName" type="xs:string" minOccurs="1">
<xs:annotation>
<xs:documentation>Mnemonic identifier for the retailer.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SalesOrderAcknowledgementResponseMessageType">
<xs:annotation>
<xs:documentation>Type to indicate errors encountered while processing the
salesOrderAcknowledgementMessage.</xs:documentation>
</xs:annotation>
<xs:sequence maxOccurs="1">
<xs:element name="successCount" type="xs:int"/>
<xs:element name="errorCount" type="xs:int"/>
<xs:element maxOccurs="unbounded" name="salesOrderAcknowledgementResponse"
type="SalesOrderAcknowledgementResponseType"/>
</xs:sequence>
</xs:complexType>
<xs:element name="salesOrderAcknowledgementResponseMessage"
type="SalesOrderAcknowledgementResponseMessageType"/>
<xs:complexType name="SalesOrderAcknowledgementResponseType">
<xs:sequence>
<xs:element ref="salesChannelName"/>
<xs:element ref="salesChannelOrderNumber"/>
<xs:element maxOccurs="1" name="acknowledgementResponseCode" type="CodeType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>