1. Description

The flow describes a message flow of new customer order messages sent from LXIR to / EWS. Only new customer order messages are sent. Changing and canceling customer orders is not possible.

The answer to a CUSORD sent to the EWS is always a CORRES and it is always seen as a final delivery. If a customer order line cannot be picked for any reason, a CORRES message will nevertheless be sent in response and a change of the customer order line can be made at a later time and when is dependent on the reason for the picking deviation.

If several customer order lines are sent in the same CUSORD then a common reply message is always sent for these lines, CORRES from the EWS. This happens when the pick is ready for all sent lines.

LXIR - EWS only works with balances, not the concept of "be".

No information is sent back today regarding the chosen mode of transport from the EWS.

2. Simple flow chart

3. Message triggering

All triggerings are created by event in LXIR

New: Customer order placed against EWS-controlled warehouse for the client. When picking dates are sent, CUSORD is sent to the EWS if the other terms on the customer order are met in LXIR (Crossdocking and part delivery). Transmission may occur depending on the answer. A sold customer order is counted as new.

Change: Not allowed

Cancellation: Not allowed

4. Requirements

Manual routines are required each time a payment customer of transport is placed in LXIR, which is to be handled by the EWS. (Set up in party table - agreement - customer number, etc.).
The article must be made available to the client.
Packing for the article must be made available.

In the case of delivery methods that require postgironr and bank giro, this is sent in the intended CUSORD-ADR field.

5. Specifications

LXIROrder, CUSORD

LXIROrder (1)

LXIROrder\Envelope (1)

Element	Mand	Explanation	Lxir	EWS	Comment
FromPartner	J	From system	X	X
FromPartnerUser	J	Users from system / client	X	X
ToPartner	J	To system	X	X
ToPartnerUser	J	User System / Client	X	X
DateTime	N	Time to create the message (YY-MM-DD hh: mm)	X	X
ReferensNumber	J	The reference number of the message	X	X
InterchangeTest	N	Indicates test message			Deleted

LXIROrder\Header (1-999)

LXIROrder\Header\HeaderInfo (1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
DocumentNumber		J	Order number reference number	X	X
DocumentName	CUSORD	J	Order message name: CUSORD	X	X
CreationDate		N	Created date	-	-	Part

LXIROrder\Header\Addresses(1-2)

LXIROrder\Header\ Addresses\Address(1)

Element	Code	Mand	Explanation	Lxir	EWS
Name1		J	Name field 1, customer (Delivery point)	X	X
Name2	CUSORD	J	Name field 2, customer	X	X
Name3		N	Name field 3, customer	-	X
Address1		J	Address field 1 (Delivery point)	X	X
Address2		N	Address field 2	X	X
Address3		N	Address field 3	X	X
State		N	Region / State	X	X
City		J	City (Place of Delivery)	X	X
PostalCode		J	Postcode (Delivery Point)	X	X
Country		J	Country (Place of Delivery)	X	X
CountryCode		J	Country code (SE = Sweden) Specifies the language of the documents	X	-
Phone		N	Phone in shipto (for notification) Phone in Billto refers to office telephone. Phone in Servicepoint refers to the telephone number of the delivery point.	X	X
Contact1		N	Customer's shipping address 2 (Name2)	X	X
Email		N	Mail address for ship to (notification)	X	X
OrganisationNumber		N	Organization number
VatNumber		N	Vat number
PostGiroAccount		N	Post giro account
BankGiroAccount		N	Bank giro account

LXIROrder\Header\ Addresses\Information(1)

Element

Code

Mand

Explanation

Lxir

EWS

Comment

PartyProfile

PIECE

J

Profile (constant) in ship and billto, in service points is this identity for the delivery point.

X

AddressType

ShipTo
BillTo

Seller

ServicePoint

J

Specifies the type of address
ShipTo = Shipping address,
BillTo = Billing Address
seller =
ServicePoint = Delivery point

X

Seller Only supports BankGiroAccount

Postal Giro Account

organization Number

VATNUMBER

LXIROrder\Header\OrderHeader(1)

LXIROrder\Header\OrderHeader\OrderHeaderInfo(1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
OrderNumber		J	Internal order number	X	X
OrderNumberExternal	CUSORD	N	External order number	X	X
OrderNumberEndCustomer		N	End customer's order number	X	X	EWS=slutkundorderid
OrderDate		J	Order date (YY-MM-DD hh: mm)	X	X
SequenceNumber		N	Sequence number, 000	X	X
OrderType	N E F W	N	Order Type N = Normal Order E = Express Order F = Replacement Order W = Webshop Order	X	X
OrderReference		N	Reference	X	X	Your reference
OrderReference2		N	Our reference	X	X	Our reference
ShipToId		N	Customer number	X	X
BillToId		N	Bills	X	-
DeliveryMethod		N	Mode of delivery	X	X
ServicePointId		N	Identifier for Servicepoint, ServicePoint (Corresponds to DeliveryLocationId in LxirCustomerOrder1.0 format)	X	X	New field 090526
NoOfRows		N	Number of order lines	X	-
DeliveryRouteNumber		N	For route planning	X	X
WarehouseId		N	Internal stock No.	X	X
ForwarderPartyId		N	Customer number with carrier	X	-
VatPercent		J	VAT rate in percent	X	X
PalletRegistrationNumber		N	pallet Registration	X	X
Currency		J	Currency (SEK = Swedish kronor)	X	X
FreightCost		N	FREIGHT	-	-
OrderMethod		N	Order method used when booking	X	-	Nytt 2012-05-07.
AllowPartialDelivery		N	Full or partial delivery information	X	-	Nytt 2012-05-07
CompanyGroupId		N	Short name Goods owner / group	X	X	Nytt 2013-05-17
ConsolidateDelivery		N	Identity of orders to be collected	X	X	Nytt 2014-06-04
DepartureId		N	Retirement / Depa identity	X	X	Nytt 2015-05-11
RouteId		N	route number	X	X	Nytt 2015-05-11
CodFee		N	Withdrawal fee / Postal deposit etc.	-	X
DispatchFee		N	SERVICE FEE	-	X
AmountTotal		N	Total sum	X	X
VatAmountTotal		N	Tax Total Total	-	X
OwnerId		N	Identity of resellers in the EWS	-	X	Identitet för återförsäljare
InvoiceDate		N	invoice Date	X	X
InvoiceNumber		N	invoice number	X	X
DueDate		N	Due date for Invoice	X	X
PaymentTerms		N	Payment terms clear	X	X
PaymentType		N	Payment method short name INV = Invoice INV-P = Invoice CCA = Credit Card American Express CCV = Credit card Visa CC = Credit card COD = COD	X	X
AskedDeliveryDate		N	Asked delivery date	X		Ongoing specific field
SalesChannel		N	Sales channel, (nvarchar(100))		X
DeliveryStartDatetime		N	Delivery window start	X
DeliveryEndDatetime		N	Delivery window end		X

LXIROrder\Header\OrderHeader\OrderHeaderDescriptions(0-99)

Element	Mand	Explanation	Lxir	EWS
Function	J	Code for the description	X	X
Description1	J	Description field 1	X	X
Description2	N	Description field 2	X	X
Description3	N	Description field 3	X	X

LXIROrder\Header\OrderHeader\OrderRow(1-99999)

LXIROrder\Header\OrderHeader\OrderRow\OrderRowInfo(1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
OrderPosition		J	Order line position	X	X
OrderSubPosition		J	Order line subposition	X	X
OrderRowType	N 1 11 V	J	Order line type N = Normal 1 = Postage / Shipping 11 = Credits' –Price should be negative V = Value added service	X X X	X X X X X
OwnerNumber		N	Article owner	X	X
ArticleId		J	Article	X	X
SupplierArticleID		?	Supplier's product number	X	X
PackageId	ST	J	Unit ST = Piece	X	X
SalesPackageID		J	Sales unit	X	X
OrderQuantity		J	Ordered quantity	X	X
SalesOrderQuantity		J	Sold quantity	X	X
Price		J	Price, 00000000.0000	X	X
SalesPrice		J	Selling price	X	X
VatPercent		J	VAT rate in percent 00,000	X	X
Currency		J	Currency	X	-
ShipDate		N	Shipping Date	X	-
ExpectedDeliveryDate		N*	Expected delivery date	X	X
OrderRowStatusCode	1 2	J	Order Line Status 1 = Incoming 2 = Reserved	X	X	"1" refers to listed lines and is used together with "Expecteddelivery"
ArticleName		N	Article Name	X	X
Intrastat				-	-	Should be replaced by CustomsCommodityCode
CustomsCommodityCode				-	X
VisibilityType		N	values AlwaysVisible nonpublic	X	X	Used only for OrderRowType = ”V” Value added service * If none is specified AlwaysVisible is used
StructureId		N	Is Supplymode is BOM then its "Position" Else if ParentOrderRowPosition is not empty then set to this	X	X
ArticleId		N	Product number	X	X
ArticleTypeId		N	Hard coded string 999 if supplymode is BOM		X

* When orderrowstatuscode = '1' is specified, this is used to present a scheduled delivery date on delivery note to recipient.

LXIROrder \ header \ OrderHeader \ OrderRow \ OrderRowAdditions (0-1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
OperationCode		N	Order Line Status 1 = New Row		X

LXIROrder\Header\OrderHeader\OrderRow\OrderRowDescriptions(0-99)

Element	Mand	Explanation	Lxir	EWS
Function	J	Code for the description	X	X
Description1	J	Description field 1	X	X
Description2	N	Description field 2	X	X
Description3	N	Description field 3	X	X
Description4	N	Description field 4	X	X

Free Text Field MAIN

Free texts that are current are DEL, MKS, TRA, HAN, FREETEXT and TEXT 1 - 5. If free text is longer than 70 characters, the free text is cut (truncated).

Function	Explanation	Lxir	EWS
DEL	Intended for, Delivery instructions, Free text field "Notes on order headers" in LXIR (Delivery instructions in EWS)	X	X
MKS	Merchandising, Free text field "Marking on order head" in LXIR	X	X
TRA	Live instruction, Selected / selected options on additional services are sent in plain text, in Description1 "thermo" and coded in Description2 as "HOT".	X	X
HAN	Action ground from order head	X	X
FREETEXT	Free text	-	X
TEXT1	Free text 1 for client	-	X
TEXT2	Free text 2 for client	-	X
TEXT3	Free text 3 for client	-	X
TEXT4	Free text 4 for client	-	X
TEXT5	Free text 5 for client	-	X
OCR	OCR number	X	X
DELIVERYTERMS	Delivery terms Combiterms Description1ska contain the numerical code according to incoterms 2000	-	X
EMCS-SND	Description1 the sender's EMCS identity	X	X
EMCS-REC	Description1 the recipient's EMCS identity	X	X
EMCS-ARC	Description1 contain ARC numbers	X	X

Free Text Field Row

Free texts that are current are MKS, TRA and HAN. If free text is longer than 70 characters, the free text is cut off (truncated).

A free text is sent per element, OrderRowDescriptions on. Thus, there can be several free text fields one after the other. Only Description1 is used, ie 70 characters are max in a free text.

(The five FTX_1 to the FTX_5 rows contained in the EWS message specification are seen as a long field where "#" is used as row separator between them and must be at position 70.)

Function	Explanation	Lxir	EWS
MKS	Branding (shipping market in EWS and LXIR)	X	X
TRA	Live instruction, Selected / selected options on additional services are sent in plain text, in Description1 "thermo" and coded in	X	-
HAN	Action ground from order line	X	X
SER	Serial number	-	X
BAT	Batch number	-	X

6. LXIROrderResult, CORRES

LXIROrderResult (1)

Envelope (1) LXIROrderResult

Element	Mand	Explanation	Lxir	EWS	Comment
FromPartner	J	From system	X	X
FromPartnerUser	J	Users from system / client	X	X
ToPartner	J	To system	X	X
ToPartnerUser	J	User System / Client	X	X
DateTime	N	Time to create the message (YY-MM-DD hh: mm)	X	X
ReferensNumber	J	The reference number of the message	X	X
InterchangeTest	N	Indicates test message	-	-	deleted

Header (1-999)

Header (1) LXIROrderResult

Element	Code	Mand	Explanation	Lxir	EWS
CreationDate		J	Time when the message was created (YY-MM-DD hh: mm)	X	X
DocumentNumber		J	Order number reference number	X	X
DocumentName	CUSORD	J	Order Announcement Name: CORRES	X	X

LXIROrderResult \ header \ Order Head (1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
OrderNumber		J	Internal order number	X	X
SequenceNumber		J	sequence number	X	X

LXIROrderResult \ header \ Shipment (0-1)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
ShipmentNumber		J	Shipping number	X	X
ConsolidatedDelivery	False True	N	Delivered with previous orders	X	X	Y / N
ShipmentOwner		N		X	X
TransportWeight		J	Shipping weight	X	X
TransportVolume		J	The volume of the broadcast	X	X
TransportCost		J	The value of the consignment	X	X	EWS Always sends 0
PackageNumber		J	Package number, semicolon separated	X	X
PackageNumberOf		J	Number of packages	X	X
PalletNumberOf		J	Number of pallets EUR	X	X
PalletNumberOf2		J	Number of B-pallets	X	X
PalletNumberOf3		N	Number of half pallets	X	X
PalletNumberOf4		N	Number of SRS pallet	X	X
DeliveryMethod		J	Delivery method and additional services (see note)	X	X

LXIROrderResult \ header \ Shipment \ Packages (0-1)

LXIROrderResult \ header \ Shipment \ Package (1-99999)

Element	Mand	Explanation	Lxir	EWS
PackageNumber	J	Package number, semicolon separated	X	X
PackageTypeDescription	N		X	X
PackageType	J		X	X
PackageWidth	J		X	X
PackageLength	J		X	X
PackageHeight	J		X	X
PackageWeight	J		X	X

LXIROrderResult \ header \ OrderRows (1-99999)

Element	Code	Mand	Explanation	Lxir	EWS	Comment
OrderPosition		J	Order line position	X	X
OrderSubPosition		J	Order line subposition	X	X
OwnerNumber		J	Item owner, client number	X	X
ArticleNumber		J	Article	X	X
PickedQuantity		J	Picked quantity	X	X
DiscrepancyQuantity		J	Remaining (deviating) quantity	X	X
DiscrepancyCode	N S A U	N	Discrepancy Code: N = Balance available, can not be picked. Reservation attempts are postponed for 1 working day until picking takes place. S = Out of stock. A = Agreed overdelivery. U = Agreed sub-delivery. M = Manual handling. D = Balance available, can not be picked. Reservation attempts are possible immediately.	X	X
SerialNumber		N	Serial number?	X	X
BatchNumber		N	BatchNumber	X	X
ConsNote			parcel number	X	X	Same as Packagenumber on OrderHead

DiscrepancyCode N

Balance available, can not be picked. Reservation attempts are postponed for 1 working day until picking takes place. Sales order will be resent from XTND BACKEND the next picking day until picking has taken place. Otherwise, the same information is sent as the original order. XTND WMS handles this as a new order. Now the same message as the original order is sent again but now with the following information In the element LXIROrder \ Header \ OrderHeader:

Element	Explanation	Lxir
\ Header \ OrderHeader		X
\ OrderHeaderInfo \ OrderNumber	Same as the original order.	X
\ OrderHeaderInfo \ SequenceNumber	Listed one step for each time OrderNumber is sent to the XTND WMS.	X
The current line that received the code "N":		X
\ OrderRow \ OrderRowInfo \ ShipDate	Next day for a new try.	X
\ OrderRow \ OrderRowInfo \ OrderQuantity	Remaining quantity.	X

In XTND BACKEND, the order lines will continue to be reserved. An N-receipt does not release the reservation. This means that for an N receipt, the order will go towards the same shipment. If in one and the same message two lines are normally acknowledged and one with N, these lines will still be on the same shipment. The two normal rows will be sent when the remaining row is acknowledged to eg External system.

N-receipt is thus a temporary code that should only be used for one and the same day.

DiscrepancyCode S

Out of stock. For XTND BACKEND, acknowledgment with 0 (zero) in the field \ OrderRows \ PickedQuantity may occur, but it is often the case that some are delivered. Wait for an ITECHG message with inventory code ST on the product. Recalculation takes place on a confirmed date thereafter. In XTND BACKEND, what is not delivered will be reserved and moved forward one day.

Code S should not normally occur. It should be noted that in XTND BACKEND you can choose that partial delivery is not allowed and this can then lead to a partial delivery despite the choice.

The S code and "Picking days in advance"(warehouse settings) does not work well together. The desired delivery date is postponed by one day, a possible picking shift means that the order still goes down directly again for picking in that scenario.

The same applies if the order is typed as express or express order.

DiscrepancyCode A

Agreed overdelivery i.e. an agreement with the customer. If the number picked exceeds the ordered number, a new row with a new subposition and status picked must be created on the part that is handed over.

DiscrepancyCode U

Agreed subcontracting, i.e. an agreement with the customer that results in cancellation of the deviating number.

A check is made that \ OrderRows \ PickedQuantity + \ OrderRows \ DiscrepancyQuantity = ordered quantity. If this is not the case, an error logging will take place.

DiscrepancyCode M

The code M stands for Manual Handling. Not supported in XTND WMS, but external storage systems such as Ongoing can in some cases set this code which then indicates that the system will require the line to be handled manually in XTND Backend. De-reservation is made of a reserved balance. Shipdate and NextReservationAttempt are set for the far future. The order line is blocked for reservation with the flag "WaitReservation".

DiscrepancyCode D

Balance available, can not be picked. Reservation attempts are possible immediately. This is the same logic as the N-receipt, i.e. a de-reservation is made. However, expectedDeliveryDate and Shipdate do not change on the order line, unlike the N acknowledgment which postpones the dates one working day.

ConsNote

Here comes the shipping number in some cases and it depends on the delivery method and settings in the EWS. If a shipping number is created per order, it can be sent but not if it is the same shipping number for several different orders.

XSD files (LxirOrder)

XSD files (LxirOrderResult and LxirOrderResultASN)

7. Examples

LXIR Order

<?xml version=”1.0” encoding=”utf-8” ?>

- <LXIROrder>

- <Header>

- <Addresses>

</Addresses>

- <Addresses>

</Addresses>

- <Addresses>

</Addresses>

- <OrderHeader>

<OrderHeaderInfo OrderNumber=”OC-299” OrderNumberExternal=”NOB-67” OrderNumberEndCustomer=”” OrderDate=”2010-03-30 15:25” SequenceNumber=”1” OrderType=”N” OrderReference=”Nalle Nallesson” OrderReference2=”” ShipToId=”60” BillToId=”NOB” ServicePointId=”” DeliveryMethod=”BRIABREV” NoOfRows=”2” DeliveryRouteNumber=”60” WarehouseId=”HHV” ForwarderPartyId=”NOB” VatPercent=”25.000” PalletRegistrationNumber=”” Currency=”NOK”

InvoiceDate=”3/31/2010 6:04:31 AM” InvoiceNumber=”282” DueDate=”4/14/2010 12:00:00 AM” PaymentTerms=”14” PaymentType=”CC” AmountTotal=”450.000” CompanyGroupId=”GRP01” />

- <OrderRow>

<OrderRowInfo OrderPosition=”10” OrderSubPosition=”0” OrderRowType=”N” OwnerNumber=”NOB” ArticleId=”12009” SupplierArticleId=”12009” PackageId=”ST” SalesPackageId=”ST” OrderQuantity=”1” SalesOrderQuantity=”1” Price=”450.0000” SalesPrice=”450.0000” VatPercent=”00.000” Currency=”NOK”

ShipDate=”2010-03-31 08:00” ExpectedDeliveryDate=”2010-04-07 08:00” OrderRowStatusCode=”2” ArticleName=”200 kr. Hamsun 2009” />

</OrderRow>

- <OrderRow>

<OrderRowInfo OrderPosition=”20” OrderSubPosition=”0” OrderRowType=”1” OwnerNumber=”NOB” ArticleId=”FRAKT” SupplierArticleId=”” PackageId=”ST” SalesPackageId=”ST” OrderQuantity=”1” SalesOrderQuantity=”1” Price=”00.0000” SalesPrice=”00.0000” VatPercent=”25.000” Currency=”NOK”

ShipDate=”2010-03-31 08:00” ExpectedDeliveryDate=”2010-04-07 08:00” OrderRowStatusCode=”2” ArticleName=”Frakt – Brev A-prioritet” />

</OrderRow>

</OrderHeader>

</Header>

</LXIROrder>

LxirOrderResult

<?xml version=”1.0” encoding=”ISO-8859-1” ?>

- <LXIROrderResult>

- <Header>

- <OrderHeader>

<OrderRows OrderPosition=”10” OrderSubPosition=”0” OwnerNumber="574" ArticleNumber="12009" PickedQuantity="1" DiscrepancyQuantity="0"

DiscrepancyCode="" SerialNumber="" BatchNumber="" ConsNote="108" />

</OrderHeader>

</Header>

</LXIROrderResult>

8. Document version history

Version.	Date	Author/change	Comment
A	2003-02-17	Joakim Petersson	Move the document to LXIR with new document no.
PA1	2003-08-26	Tanja Brkic	Added documentation for Residual code A and U.
B	2004-02-12	Erik Sylvan	Changed the document to describe the flow between LXR and LWS / EWS, added example messages.
PB1	2004-02-24	Joakim Petersson	Clarified what happens in LxiR at the different codes.
C	2005-09-22	Lasse Sääf	Added Delivery Terms
PD	2008-03-18	Björn Johansson	Adjusted from LXIR3 & EWS
D	2008-03-31	Martin Fransson	Accepted
E	2008-04-14	Lasse Sääf	Corrected explanatory text for free text field row
E1	2008-05-05	Lasse Sääf	Set ReferenceNumber to Mandatory
F	2008-08-26	Patrick Gebhard	Supplemented with support for some fields in LWS
G	2009-03-05	Mathias Niebel	Complemented PaymentType for cash on delivery.
hrs	2009-04-29	Björn Johansson	Complement with INV-P in payment type
IN	2009-04-27	Martin Hagman	Supplemented with ServicePoint as type in address info
J	2009-05-26	Martin Hagman	Completed with LocationId in OrderHeaderInfo
PJ1	2009-05-27	David Frendin	Changed LocationId to ServicePointId in OrderHeaderInfo
PJ2	2009-06-16	Björn Johansson	Adjusted Order / Header addresses regarding telephone, mail and contact, supplemented party profile with delivery point.
K	2009-09-17	Björn Johansson	Adjusted support for address type vendor from Lxir, amounttotal & OCR.
L	2010-04-19	Björn Johansson	Added Order Type W, PalletNumberof2, DeliveryRouteNumber. + new examples.
M	2010-09-10	Björn Johansson	Deleted data related to LWS, published on sharepoint
N	2011-06-28	Lasse Sääf	Correct spelling for Duedate to DueDate
O	2012-05-07	Björn Johansson	Added Order Method and AllowPartialDelivery
O	2012-05-21	Björn Johansson	Supplementary text to orderrowstatuscode.
P	2012-05-17	Lasse Sääf	Added CompanyGroupId
Q	2014-06-04	Lasse Sääf	Added BatchNumber and ConsolidateDelivery
R	2015-05-11	Martin Fransson	Added DepartureId and RouteId
S	2015-08-26	Lasse Sääf	Added ConsolidatedDelivery ShipmentOwnerId Pallet NumbersOf3, Pallet NumbersOf3
T	2016-01-18	Lasse Sääf	Added VisibilityType and Value added service
U	2017-05-24	Lasse Sääf	Added State
V	2019-09-17	Muhammad Jawad	Added package information in shipment node
W	2020-12-01	Muhammad Jawad	Added DeliveryStartDatetime and DeliveryEndDatetime
Y	2022-02-06	Zohaib Anees	Added StructureId, ArticleI and ArticleTypeId in LxirOrder row section

LXIR, ORDER / ORDER RESULT

2. Simple flow chart

3. Message triggering

4. Requirements

5. Specifications

6. LXIROrderResult, CORRES

DiscrepancyCode N

DiscrepancyCode S

DiscrepancyCode A

DiscrepancyCode U

DiscrepancyCode M

DiscrepancyCode D

ConsNote

XSD files (LxirOrder)

XSD files (LxirOrderResult and LxirOrderResultASN)

7. Examples

8. Document version history