...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Description |
This method can be called to create new web sales orders in SupplyStream. The products within the order must have sufficient available stock for the order to be created if "PushToDC" is set to true. |
System behaviours
The Sale Order is defined by the SalesOrderNumber (Identifier)
If one Line Item in the sales order returns an error (for example, 'Error Submitting SalesOrder: TESTSO - Error. Product 5963405 has no free stock.'), then the entire sales order fails to upload.
The address is not validated on upload.
The sales order cannot be edited once uploaded
In a CSV, if a sales order number is used, and then repeated later on in the file (separated by another sales order), these entities will be treated as separate sales orders.
A single Sales Order (defined by the Sales Order number) does not accept multiple lines of the same ProductCode.
Anything that comes through as a SalesOrderLineItem will need inventory and we will need to fully process as a pick.
Once a Sales Order is at status Dispatched, the Sales Order is closed. No further dispatches will be sent for this sales order.
If any of the billing address fields are provided, then the full address fields are required.
Available formats
...
...
...
...
XML
...
x
...
x
...
JSON
...
x
...
CSV
...
x
...
x
Entity Relationships
This diagram shows the high level relationship between the entities detailed in the Field Level Details section of this page.
...
WebSalesOrder
...
Field
...
Description
...
Data Type
...
Value Limits
...
Requirement
...
Use on standard documents
...
Field returned in service ID/table/field (multi services split by ";")
...
SalesOrderNumber
...
Sales Order Number. Must be unique.
...
nvarchar(50)
...
Must be unique.
...
Mandatory
...
Dispatch Note, Commercial Inv, Pick Note
...
12/Dispatch/ SalesOrderNumber
...
SalesOrderReference
...
Open reference field
...
nvarchar(50)
...
Dispatch Note, Commercial Inv
...
12/Dispatch/ SalesOrderReference
...
OnHold
...
Related to wholesale, retail environment; build and then send. Order is not sent for picking but available stock is assigned to the order. Release a Sales Order from hold from SEKO 360 or using the Load Release Sales Order from Hold service.
...
Boolean
...
TRUE, FALSE
...
DoNotPushToDC
...
If set to TRUE, the order is sent to SEKO360, but no stock is assigned to it and is not sent to be picked by the DC. A dispatch request must then be made from your SEKO360 account.
...
Boolean
...
TRUE, FALSE
...
CourierName
...
Courier the goods should be dispatched on. CourierName accepted values supplied by SEKO.
...
Nvarchar(100)
...
Values provided by SEKO
...
If required by DC
...
CourierService
...
Courier service the goods should be dispatched on. CourierService accepted values supplied by SEKO.
...
Nvarchar(100)
...
Values provided by SEKO
...
If required by DC
...
NotificationMethod
...
Method in which the customer wishes to be notified by the carrier (if applicable):
email = Email Notification
SMS = Text / SMS Notification
...
Nvarchar(50)
...
SMS,EMAIL
...
Notes
...
If there is not enough or no stock for a SKU on an order, the order will be rejected. The sales order would either need to be uploaded again once the stock is present, the out of stock SKU's removed (or quantity reduced), or the order cancelled on the client system.
The carriers do not support foreign characters
In a CSV file, if you have a multi line order, the details of the order (address, SO number, etc.), but be included on every row.
Available formats
Entity Relationships
This diagram shows the high level relationship between the entities detailed in the Field Level Details section of this page.
Field level details
WebSalesOrder | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
SalesOrderNumber | Sales Order Number. Must be unique. | nvarchar(50) | Must be unique. | Mandatory | Dispatch Note, Commercial Inv, | 12/Dispatch/ SalesOrderNumber |
SalesOrderReference | Open reference field | nvarchar(50) | Dispatch Note, Commercial Inv | 12/Dispatch/ SalesOrderReference | ||
OnHold | Related to wholesale, retail environment; build and then send. Order is not sent for picking but available stock is assigned to the order. Release a Sales Order from hold from SEKO 360 or using the Load Release Sales Order from Hold service. | Boolean | true, false | |||
NIFNumber | This will be populated by exception. It will hold a personal taxation code and is needed for shipping to some destinations. (potential rename of field) | nvarchar(100) | Conditional: When required for the carrier | |||
CourierName | Courier the goods should be dispatched on. CourierName accepted values supplied by SEKO. | Nvarchar(100) | Values provided by SEKO | If required by DC | ||
CourierService | Courier service the goods should be dispatched on. CourierService accepted values supplied by SEKO. | Nvarchar(100) | Values provided by SEKO | If required by DC | ||
Notes | Open notes field that appears on the standard outbound documentation | nvarchar(4000) | Dispatch Note,(Char limit 237) Commercial |
Inv | |||||
SpecialInstructions | A note to the DC. (Not seen if wave picking is used) | nvarchar(4000) | Pick Note |
ShippingTotal
Placeholder.
decimal(18, 2)
TaxTotal
Placeholder.
decimal(18, 2)
SubTotal
Placeholder.
decimal(18, 2)
SalesOrderDate
SalesOrderDate | The date as appears on the outbound documentation. If left blank, the date in which the sales order was created will be used. | Datetime | CSV: dd/MM/YYYY e.g. 12/09/2016 yyyyMMdd HHmmss | Dispatch Note, Commercial Inv | ||
OrderType | The type of order. |
We exclude the following order types from Wave Picking: Retail, Wholesale, WorkOrder | nvarchar(100) | Web, |
NIFNumber
Retail, Wholesale, WorkOrder | Mandatory | |||||
SalesInvoiceNumber | Sales Invoice number | nvarchar(100) | 12/Dispatch/ SalesInvoiceNumber | |||
DocumentIdentifier |
Placeholder.
nvarchar(100)
Used to identify different documents. This code is provided by SEKO. | nvarchar(100) |
ShippingVAT
Placeholder.
decimal(18, 2)
ShippingExVAT
Placeholder.
decimal(18, 2)
CustomsValueTotal
Placeholder.
decimal(18, 2)
DiscountPriceTotal
Placeholder.
decimal(18, 2)
GiftWrap
Placeholder
Boolean
TRUE/FALSE
GiftMessage
The message to the person the gift is being sent to. Pick Note will specify "Yes" if a Gift Message is present.
nvarchar(500)
GiftMessageFrom
GiftMessage | The message to the person the gift is being sent to. Pick Note will specify "Yes" if a Gift Message is present. | nvarchar(500) | ||||
GiftMessageFrom | The person the gift is from. The new field can be populated as required, including personalised names i.e. “Mum”. If first name and last name is required, the entire name should be populated within this field. | nvarchar(100) | ||||
GiftMessageTo | The person who the gift is being sent to. The new field can be populated as required, including personalised names i.e. |
LastName
Last name of the billing contact
nvarchar(50)
Dispatch Note, Commercial Inv
Line1
Line 1 of the billing contacts address
nvarchar(100)
Conditional: for commercial inv
Dispatch Note, Commercial Inv
Line2
Line 2 of the billing contacts address
nvarchar(100)
Dispatch Note, Commercial Inv
Line3
Line 3 of the billing contacts address
nvarchar(100)
Dispatch Note, Commercial Inv
Line4
Line 4 of the billing contacts address
nvarchar(100)
Dispatch Note, Commercial Inv
City
City of the billing contacts address
nvarchar(50)
Conditional: for commercial inv
Dispatch Note, Commercial Inv
County
County of the billing contacts address
nvarchar(50)
Dispatch Note, Commercial Inv
PostcodeZip
Postcode of the billing contacts address
nvarchar(20)
Conditional: for commercial inv
Dispatch Note, Commercial Inv
CountryCode
Country of the billing contacts address
Appears on physical docs as full country name (ISO-2).
nvarchar(2)
Conditional: for commercial inv
Dispatch Note, Commercial Inv
PhoneNumber
Phone number of the billing contact
nvarchar(20)
Dispatch Note, Commercial Inv
EmailAddress
Email address of the billing contact
nvarchar(150)
ForwardingAgent
Field
Description
Data Type
Value Limits
Requirement
Use on standard documents
Field returned in service ID/table/field (multi services split by ";")
CompanyCode
Placeholder
nvarchar(100)
CompanyDescription
Placeholder
nvarchar(200)
ContactCode
Placeholder
nvarchar(100)
Title
Placeholder
nvarchar(20)
FirstName
Placeholder
nvarchar(50)
LastName
Placeholder
nvarchar(50)
Line1
Placeholder
nvarchar(100)
Line2
Placeholder
nvarchar(100)
Line3
Placeholder
nvarchar(100)
Line4
Placeholder
nvarchar(100)
City
Placeholder
nvarchar(50)
County
Placeholder
nvarchar(50)
PostcodeZip
Placeholder
nvarchar(20)
CountryCode
Placeholder
nvarchar(2)
PhoneNumber
Placeholder
nvarchar(20)
EmailAddress
Placeholder
nvarchar(150)
SalesOrderHeader
Field
Description
Data Type
Value Limits
Requirement
Use on standard documents
Field returned in service ID/table/field (multi services split by ";")
DCCode
SEKO created code that uniquely identifies the DC from other SEKO DC's. This code is supplied by SEKO.
Nvarchar(100)
Conditional: If more than one DC in use
SalesOrderLineItem
Field
Description
Data Type
Value Limits
Requirement
Use on standard documents
Field returned in service ID/table/field (multi services split by ";")
LineNumber
Integer that uniquely identifies a line of an order. Must be more than 0. Character length restriction on the Line Number is 8.
The SupplyStream system will order the line items by ascending LineNumber.
Int
Mandatory
12/DispatchLineItem/LineNumber
ProductCode
SKU to be dispatched. Must be unique per sales order. There must be available stock on the SKU.
nvarchar(100)
Mandatory
Dispatch Note, Commercial Inv, Pick Note
12/DispatchLineItem/ProductCode
ASNNumber
Placeholder
nvarchar(50)
CustomsValue
Customs Value is used based on various carrier requirements. Some carriers require it when shipping outside the EU. Some carriers require when shipping outside the UK. It is a value determined by the country of import - for example, a shipment to Germany will be subject to VAT and duties dependent on the product and its value.
It is an optional field. Customs Value takes precedence over unit price but the system takes unit price if customs value is not provided. If neither are provided and the carrier requires this for customs purposes it may fail.
decimal(18, 2)
Conditional: When required for the carrier
UnitDiscountPrice
Placeholder.
“Dad”. It also allows the user to specify the “To” when the gift message is for someone else who lives at the same address as the delivery recipient. If first name and last name is required, the entire name should be populated within this field. | nvarchar(100) |
GiftMessageTo
The person who the gift is being sent to. The new field can be populated as required, including personalised names i.e. “Dad”. It also allows the user to specify the “To” when the gift message is for someone else who lives at the same address as the delivery recipient. If first name and last name is required, the entire name should be populated within this field.
nvarchar(100)
UltimateDestination
Placeholder
nvarchar(100)
GUID
SEKO360 Globally Unique Identifier. If GUID not provided, this will be automatically generated by the system. System generated example: a99645dc-5b45-4917-890c-4b02c68ac342. Returned in API response message. Must be unique to the service. If mapped to CSV, the field must be populated.
varchar(100)
12/Dispatch/ InterfaceRecordId
LocationType
Placeholder
nvarchar(100)
ScheduledShipDate
Placeholder
Datetime
API: YYYY-MM-dd e.g. 2013-12-12
ShipmentTerms
DDU, DDP, etc.
nvarchar(100)
Conditional: When required for the carrier
Commercial Inv
DeliveryAddressLocationType
Placeholder
nvarchar(100)
CarrierCustomerAccountNo
Placeholder
nvarchar(100)
CurrencyCode
Placeholder
nchar(3)
ShippingTerm
Placeholder
nvarchar(50)
ShippingTermLocation
Placeholder
nvarchar(50)
DeliveryDetails
Field
Description
Data Type
Value Limits
Requirement
Use on standard documents
Field returned in service ID/table/field (multi services split by ";")
ContactCode
Placeholder
nvarchar(100)
Title
Title of the delivery contact i.e. Mrs, Mr, etc. If 'Title' included, DeliveryDetails→ FirstName or DeliveryDetails→ LastName required.
nvarchar(20)
FirstName
First name of the delivery contact
nvarchar(50)
Conditional: Required if DeliveryDetails→ LastName not included
Dispatch Note, Commercial Inv
12/Dispatch/ ShipToAttention
LastName
Last name of the delivery contact
nvarchar(50)
Conditional: Required if DeliveryDetails→ FirstName not included
Dispatch Note, Commercial Inv
12/Dispatch/ ShipToAttention
Line1
Line 1 of the delivery contacts address. If you have a web order that is being delivered to a Company address, this should be the Company Name.
nvarchar(100)
Mandatory
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressLine1
Line2
Line 2 of the delivery contacts address
nvarchar(100)
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressLine2
Line3
Line 3 of the delivery contacts address
nvarchar(100)
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressLine3
Line4
Placeholder
nvarchar(100)
Dispatch Note, Commercial Inv
City
City of the delivery contacts address
nvarchar(50)
Mandatory
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressCity
County
County of the delivery contacts address
nvarchar(50)
Mandatory
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressCounty
PostcodeZip
Postcode of the delivery contacts address. Postcode is not validated by the SEKO system
nvarchar(20)
Mandatory
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressPostCode
CountryCode
Country of the delivery contacts address (ISO-2).
Appears on standard physical docs as full country name.
nvarchar(2)
Mandatory
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryAddressCountry
PhoneNumber
Phone number of the delivery contact
Used by some carriers to send customer SMS notifications.
nvarchar(20)
Conditional: required by some carriers
Dispatch Note, Commercial Inv
12/Dispatch/ DeliveryPhoneNumber
EmailAddress
Email address of the delivery contact
Used by some carriers to send customer email notifications
nvarchar(150)
Mandatory
12/Dispatch/ DeliveryEmailAddress
BillingDetails
Field
Description
Data Type
Value Limits
Requirement
Use on standard documents
Field returned in service ID/table/field (multi services split by ";")
ContactCode
Placeholder
nvarchar(100)
Title
Title of the billing contact i.e. Mrs, Mr.
If 'Title' included, BillingDetails → FirstName or BillingDetails → LastName required.
nvarchar(20)
FirstName
First name of the billing contact
If the FirstName is not included, then the Billing Address is stored with no connection to a specific contact. This means that if the same Billing Address is specified in a Sales Order without a First or Last name, then the address will be taken from the system instead of the sales order. The Billing Address system comparison is completed against the Mandatory fields. For example, if the same Billing Address is specified and the County is different in the sales order, the Address from the system will be taken, as County is not a Required field.
nvarchar(50)
Conditional: If billing address Line1 is provided and for commercial inv
Dispatch Note, Commercial Inv
ShipmentTerms | DDP, DDU & DAP are the options. | nvarchar(100) | Conditional: When required for the carrier | Commercial Inv | ||
CourierShopID | Code used during carrier allocation. | nvarchar(50) |
DeliveryDetails | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
Title | Title of the delivery contact i.e. Mrs, Mr, etc. If 'Title' included, DeliveryDetails→ FirstName or DeliveryDetails→ LastName required. | nvarchar(20) | ||||
FirstName | First name of the delivery contact | nvarchar(50) | Conditional: Required if DeliveryDetails→ LastName not included | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ ShipToAttention | |
LastName | Last name of the delivery contact | nvarchar(50) | Conditional: Required if DeliveryDetails→ FirstName not included | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ ShipToAttention | |
Line1 | Line 1 of the delivery contacts address. If you have a web order that is being delivered to a Company address, this should be the Company Name. | nvarchar(100) | Mandatory | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ DeliveryAddressLine1 | |
Line2 | Line 2 of the delivery contacts address | nvarchar(100) | Dispatch Note, Commercial Inv | 12/Dispatch/ DeliveryAddressLine2 | ||
Line3 | Line 3 of the delivery contacts address | nvarchar(100) | Commercial Inv | 12/Dispatch/ DeliveryAddressLine3 | ||
Line4 | Line 4 of the delivery contacts address | nvarchar(100) | ||||
City | City of the delivery contacts address | nvarchar(50) | Mandatory | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ DeliveryAddressCity | |
County | County of the delivery contacts address | nvarchar(50) | Mandatory | Commercial Inv, Pick Note | 12/Dispatch/ DeliveryAddressCounty | |
PostcodeZip | Postcode of the delivery contacts address. Postcode is not validated by the SEKO system | nvarchar(20) | Mandatory | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ DeliveryAddressPostCode | |
CountryCode | Country of the delivery contacts address (ISO-2 or ISO-3). | nvarchar(2) | Mandatory | Dispatch Note, Commercial Inv, Pick Note | 12/Dispatch/ DeliveryAddressCountry | |
PhoneNumber | Phone number of the delivery contact | nvarchar(20) | Conditional: required by some carriers | Commercial Inv | 12/Dispatch/ DeliveryPhoneNumber | |
EmailAddress | Email address of the delivery contact | nvarchar(150) | Conditional: required by some carriers | 12/Dispatch/ DeliveryEmailAddress |
BillingDetails | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
Title | Title of the billing contact i.e. Mrs, Mr. | nvarchar(20) | ||||
FirstName | First name of the billing contact If the FirstName is not included, then the Billing Address is stored with no connection to a specific contact. This means that if the same Billing Address is specified in a Sales Order without a First or Last name, then the address will be taken from the system instead of the sales order. The Billing Address system comparison is completed against the Mandatory fields. For example, if the same Billing Address is specified and the County is different in the sales order, the Address from the system will be taken, as County is not a Required field. | nvarchar(50) | Conditional: If billing address Line1 is provided and for commercial inv | Commercial Inv | ||
LastName | Last name of the billing contact | nvarchar(50) | Commercial Inv | |||
Line1 | Line 1 of the billing contacts address | nvarchar(100) | Conditional: for commercial inv | Commercial Inv | ||
Line2 | Line 2 of the billing contacts address | nvarchar(100) | Commercial Inv | |||
Line3 | Line 3 of the billing contacts address | nvarchar(100) | Commercial Inv | |||
Line4 | Line 4 of the billing contacts address | nvarchar(100) | ||||
City | City of the billing contacts address | nvarchar(50) | Conditional: for commercial inv | Commercial Inv | ||
County | County of the billing contacts address | nvarchar(50) | Commercial Inv | |||
PostcodeZip | Postcode of the billing contacts address | nvarchar(20) | Conditional: for commercial inv | Commercial Inv | ||
CountryCode | Country of the billing contacts address | nvarchar(2) | Conditional: for commercial inv | Commercial Inv | ||
PhoneNumber | Phone number of the billing contact | nvarchar(20) | ||||
EmailAddress | Email address of the billing contact | nvarchar(150) |
SalesOrderHeader | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
DCCode | SEKO created code that uniquely identifies the DC from other SEKO DC's. This code is supplied by SEKO. | Nvarchar(100) | Conditional: If more than one DC in use |
UnitPrice
SalesOrderLineItem | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
LineNumber | Integer that uniquely identifies a line of an order. Must be more than 0. Character length restriction on the Line Number is 8. The SupplyStream system will order the line items by ascending LineNumber. For CSV, can be auto incremented if this cannot be provided, which will increment each sales order starting from 1. | Int | Mandatory | 12/DispatchLineItem/LineNumber | ||
ProductCode | SKU to be dispatched. Must be unique per sales order. There must be available stock on the SKU. | nvarchar(100) | Mandatory | Dispatch Note, Commercial Inv, | 12/DispatchLineItem/ProductCode | |
OrderLineMessage | Message assigned to the SKU on line level. Used for purposes such as engraving, where the engrave message would appear in this field. |
nvarchar(100)
Pick Note
EAN
Placeholder
nvarchar(50)
Quantity
Quantity of the SKU to be dispatched in units
Int
Mandatory
Pick Note
GUID
SEKO360 Globally Unique Identifier. If GUID not provided, this will be automatically generated by the system. System generated example: a99645dc-5b45-4917-890c-4b02c68ac342. Must be unique to the line of the order.
varchar(100)
12/DispatchLineItem/LineInterfaceRecordId
If the clients populate the "Order Line Message" , then this order will be a non standard requirement | nvarchar(250) | |||||
CustomsValue | This is a unit value, per unit, calculated by the client to show duties due. If “SalesOrderLineItem.CustomsValue” is greater than zero then “SalesOrderLineItem.UnitPrice” is required | decimal(18, 2) | ||||
Quantity | Quantity of the SKU to be dispatched in units | Int | Mandatory | |||
UnitPrice | Unit Price per unit. The price of the unit (per unit) i.e. 4.99. Ex VAT if VAT field is provided in separate VAT field. Unit price should not be 0 if required by carrier or Commercial Invoice required. |
Unit Price is recalculated on short shipment. | decimal(18, 2) | Conditional: if required for shipping If CustomsValue or VAT are populated | Commercial Inv | ||
VAT | VAT per unit. The VAT of the unit (per unit) i.e. 0.67. This is added together to the Unit Price * Quantity value in the "Amount" column on the standard commercial invoice. |
= Amount As a note, if supplying VAT irrespective of DDU/DDP, the unit value must be NET not GROSS. If “SalesOrderLineItem.Vat” is greater than zero then “SalesOrderLineItem.UnitPrice” is required | decimal(18, 2 |
Conditional: When required for the carrier
Commercial Inv
ExternalDocumentNo
Placeholder
nvarchar(100)
LotNo
Placeholder
nvarchar(100)
Channel
Placeholder
nvarchar(100)
) | Conditional: When required for the carrier | |||
CurrencyCode | The currency code of the unit price etc. (ISO-3) |
nchar(3)
Conditional: if required for shipping
Commercial Inv
CountryCode
The country of origin of the SKU. The country of origin specified in the product master will be used. If none specified on product master, system will check this field for a value.
nvarchar(100)
Commercial Inv
SecondaryCurrencyCode
Placeholder
nchar(3)
SecondaryUnitPrice
Placeholder
decimal(18, 2)
SecondaryVAT
Placeholder
. Use the same code for the entire order. Although the system will not reject the order if different currencies are provided. | nchar(3) | Conditional: if UnitPrice, CustomsValue or VAT are populated | Commercial Inv |