Message sent between XTND WMS and XTND BACKEND to change balance of an item. This may occur e.g. due to many reasons, in the segment ItemLoadChangeCode you´ll find different codes for different type of adjustments of the item.
The message can also be used for blocking and deblocking of balance. this means that the warehouse system can mark a product as not available, but it's still physical in the warehouse
1. XTND ItemChange, ITCHG
1.1 XML Structure
ExtendItemChange (1)
ExtendItemChange\Envelope (1)
Attribute | Code | Mand. | Explanation | XTND BACKEND | XTND WMS |
FromPartner | Y | From system | X | X | |
FromPartnerUser | Y | User from system / Client | X | X | |
ToPartner | Y | To system | X | X | |
DateTime | N | Time for creation of message (YY-MM-DD hh:mm) | X | X | |
ReferensNumber | Y | Message reference number | X | X | |
InterchangeTest | N | Indicating testmessage | - | - |
LXIRItemChange\Header (1)
LXIRItemChange\Header\HeaderInfo (1)
Attribut | Kod | Mand. | Explanation | XTND BACKEND | XTND WMS |
CreationDate | N | Created date | X | X | |
DocumentName | ITECHG | Y | Name of message: ITECHG | X | X |
DocumentNumber | Y | Message reference number | X | X |
ExtendItemChange\Header\ItemChange (1-999)
Attribute | Code | Mand. | Explanation | XTND BACKEND | XTND WMS |
OperationCode | 2 | Y | 2 = Change | X | X |
Employee | Y | Identity of who registered the change. Always sent by WMS | X | X | |
UppdateTime | Y | Date and time. Always sent from LWS | X | ||
UpdateTime | Y | Date and time. Always sent from WMS | X | ||
ItemLoadChangeCode | BL ST MI MR SI IF | Block/Unblock of balance Inventory. Balance: increase/decrease Manual embedding. Balance: increase Manual correction of manual embedding. Balance: increase/decrease Balance inventory Balance: increase/decrease Internal change Balance: increase/decrease, no balance change on receieving side. | X X X X X X X X X - | X X X X X X X X X X | |
ChangeText | Y | Part change description. Always from MWS | X | X | |
DeliveryNumber | N | Purchaseordernumber. | X | - | |
PurchaseOrderNumber | N | Purchaseordernumber. | - | X | |
OwnerNumber | N | Client affinity, i.e.NASE(VMI) | X | ||
ArticleIdOld | Y | Article identity in WMS | X | X | |
QuantityOld | Y | Balance in stock location or article. Always from WMS | X | X | |
QuantityNew | Y | New balance in stock location or article. | X | X | |
BlockCodeOld |
| Y | Blockcode. XX = Block code | X | X |
BlockCodeNew | Y | Blockcode. XX = Blockcode | X | X | |
WarehouseOld | Y | Identification for the warehouse where message origin from | X | X | |
CustomerOrderNumber | Y | CustomerOrderNumber | X | X | |
BatchNumber | N | Batchnumber | X | X | |
SerialNumber | N | Serialnumber | ? | X |
LXIRItemChange\Header\ItemChange\ItemChangeInfo (1)
Blockcode
1.2 Structure
BlockCodeOld | BlockCodeNew | Rules | XTND BACKEND | XTND WMS |
00 (nollnoll) | Filled | This means that the balance is to be blocked and the number to be blocked is QuantityNew | X | X |
Filled | 00 (nollnoll) | This means that the balance is to be blocked and the number to be locked is QuantityNew | X | X |
Filled | Filled | Balance change of blocked number. | X | X |
At BockCodeOld = XX and BlockCodeNew = XX; Number as the balance change means = QuantityNew (balance after) - QuantityOld (balance before) is based here on blocked balances.
Ex. QuantityNew = 10 and QuantityOld = 6 entails a balance change of +4, ie 4 units should be blocked.
QuantityNew / QuantityOld
Number as the balance change means = QuantityNew (balance after) - QuantityOld (balance before).
WMS never sends a sign of the change, ie it will never be a minus balance.
Triggering of message
WMS creates message after event by warehouse personnel.
Demand
The product must be existing in XTND BACKEND on the client
<?xml version=”1.0” encoding=”ISO-8859-1” ?>
- <LXIRItemChange>
<Envelope FromPartner=”EWS” FromPartnerUser=”KERAKOLL” ToPartner=”XOE” ToPartnerUser=”KERAKOLL” DateTime=”2008-03-12 14:42” ReferensNumber=”0010000078” InterchangeTest=”” />
- <Header>
<HeaderInfo CreationDate=”2008-03-12 14:42” DocumentName=”ITECHG” DocumentNumber=”0010000078” />
- <ItemChange>
<ItemChangeInfo OperationCode=”2” Employee=”” UppDateTime=”2008-03-12 14:40:51” UpdateTime=”2008-03-12 14:40:51” ItemLoadChangeCode=”ST” ChangeText=”test” DeliveryNumber=”” OwnerNumber=”” ArticleIdOld=”01441” QuantityOld=”0” QuantityNew=”1” BlockCodeOld=”00” BlockCodeNew=”00” WarehouseOld=”CLJO” CustomerOrderNumber=”” />
</ItemChange>
- <ItemChange>
<ItemChangeInfo OperationCode=”2” Employee=”” UppDateTime=”2008-03-12 14:41:07” ItemLoadChangeCode=”ST” ChangeText=”test” DeliveryNumber=”” OwnerNumber=”” ArticleIdOld=”02223” QuantityOld=”0” QuantityNew=”1” BlockCodeOld=”00” BlockCodeNew=”00” WarehouseOld=”CLJO” CustomerOrderNumber=”” BatchNumber=”” SerialNumber=”” />
</ItemChange>
</Header>
</LXIRItemChange>
Version. | Date | Author/change | Comment |
A | 2003-02-17 | Joakim Petersson | Move the document to LXIRNG with new document no. |
B | 2004-02-13 | Erik Sylvan | Changed the document to describe the flow between LXIR and LWS / EWS, added example messages |
B1 | 2004-02-26 | Erik Sylvan | Team to explain BlockBode BL (XX, XX) |
PC | 2008-03-18 | Björn Johansson | Adjusted from LXIR3 and EWS |
C | 2008-03-31 | Martin Fransson | Accepted |
C1 | 2008-05-05 | Lasse Sääf | Set ReferenceNumber to Mandatory |
D | 2010-09-21 | Björn Johansson | Adjusted off lws and published on sharepoint and removed no longer valid product changes (RL, RO, RM and RF) |
E | 2012-02-27 | Lasse Sääf | Added OwnerNumber |
F | 2014-06-04 | Lasse Sääf | Added BatchNumber |
F1 | 2014-06-04 | Lasse Sääf | Added SerialNumber |
| G | 2021-03-29 | Josefin Kvillert | Changed wording from Extend to XTND BACKEND and XTND WMS |