Develop > Controller layer > Integrate with back-end systems and external applications > Back-end integration legacy messages
Order Status Update message
The Order Status Update message is an inbound message that contains status information for a WebSphere Commerce order. A back-end application generates this message and sends it to the WebSphere Commerce inbound message queue, where the WebSphere Commerce system receives the message. WebSphere Commerce uses the OrderStatus command to update the tables ORDSTAT and ORDISTAT with the new order status information.
The Order Status Update message supports two sets of application data: Order Status Update v01 and Order Status Update v02. Version 02 includes a superset of the data within v01.
The Order Status Update message uses the WebSphere Commerce message format and consists of a set of records, which follow each other sequentially in a buffer. The following data describes the Order Status Update message:
<ECEDOC> <PROLOG>ORDER_STATUS_UPDATE_PROLOG_DATA</PROLOG> <HEADER> <HDR010>ORDER_STATUS_UPDATE_HDR010_DATA</HDR010> <USRLST> <DATUSR>DATUSR_DATA</DATUSR> . .DATUSR repeated loop . <DATUSR>DATUSR_DATA</DATUSR> </USRLST> </HEADER> <ITMLST> <ITMDAT> <ITM010>ORDER_STATUS_UPDATE_ITM010_DATA</ITM010> <USRLST> <DATUSR>DATUSR_DATA</DATUSR> . .DATUSR repeated loop . <DATUSR>DATUSR_DATA</DATUSR> </USRLST> </ITMDAT> . .ITEM repeated loop . <ITMDAT> <ITM010>ORDER_STATUS_UPDATE_ITM010_DATA</ITM010> <USRLST> <DATUSR>DATUSR_DATA</DATUSR> . .DATUSR repeated loop . <DATUSR>DATUSR_DATA</DATUSR> </USRLST> </ITMDAT> </ITMLST> </ECEDOC>
Notes:
- All records are in sequential order in the buffer. Indentation is used here for readability; it does not appear in the buffer.
- All fields in the data segments are left-justified and padded to the right with spaces in the buffer.
Data Segments for Order Status Update
- ORDER_STATUS_UPDATE_PROLOG_DATA Specifies the type of message the application data defines. In this case, the message is Order Status Update.
- ORDER_STATUS_UPDATE_HDR010_DATA Specifies order information within the Order Status Update message.
- DATUSR_DATA Specifies optional information to be added to the Order Status Update message. DATUSR_DATA appears in the <HDR> and <ITM> sections of this message.
- ORDER_STATUS_UPDATE_ITM010_DATA Specifies item or product shipping information within the Order Status Update message.
- ORDER_STATUS_UPDATE_HDR010_DATA
The Order Status Update message includes the ORDER_STATUS_UPDATE_HDR010_DATA segment. This data segment consists of order specifications for the Order Status Update message.
- ORDER_STATUS_UPDATE_ITM010_DATA
The Order Status Update message includes the ORDER_STATUS_UPDATE_ITM010_DATA segment. This data segment consists of item or product shipping specifications for the Order Status message.
- ORDER_STATUS_UPDATE_PROLOG_DATA
The Order Status Update message includes the ORDER_STATUS_UPDATE_PROLOG_DATA segment. This data segment identifies the type of message that is being defined; that is, the segment indicates that the message is an Order Status Update message with a field value of OS (Order Status).
Related reference
Back-end integration legacy messages