Update_WCS_OrderStatus 訊息為一種入埠訊息,其中含有 WebSphere Commerce 訂單的狀態資訊。 訊息有四種可能的格式。 雖然各格式的 XML 元素相同, 但連結的指令卻不一樣。 各訊息格式的映射如下:
「訂單狀態」訊息類型 | 指令 |
---|---|
OrderConfirm | OrderConfirmStatus |
(OrderShipping 方面) | OrderShippingStatus |
OrderInvoice | OrderInvoiceStatus |
OrderStatus | OrderStatus |
當後端系統收到訂單時,它會產生此訊息(其中含有任何訂單實行狀態資訊),並將之傳送到 WebSphere Commerce 入埠訊息佇列中,讓 WebSphere Commerce 系統從中接收訊息。WebSphere Commerce 會呼叫適當的控制程式指令, 以便以新的訂單狀態資訊來更新 ORDSTAT 以及 ORDISTAT 表格。
Update_WCS_OrderStatus 訊息採用 XML 訊息格式, 且遵循 Update_WCS_OrderStatus_20.dtd。
下表說明 Update_WCS_OrderStatus 訊息的格式。除非特別註明,這四種「訂單狀態」訊息類型皆遵循同一格式。 下表將說明 XML 元素值的格式與來源。 有關資料庫直欄的說明, 請依循其相關表格的鏈結進行。所有欄位皆為選用的(除非另有註明)。 在 XML 訊息中,INT、BIGINT 與 DOUBLE 類型之資料庫欄位的標籤值長度分別是 CHAR (10)、CHAR(19) 與 CHAR(16)。
層次 | 欄位名稱 | 備註 | 表格名稱 | 直欄名稱 | 附註 |
---|---|---|---|---|---|
1 | OrderStatusType | 必要 | N/A | N/A | OrderConfirm、OrderShipping、OrderInvoice 或 OrderStatus |
1.1 | SerializationInfo | N/A | N/A | 若有提供,則用來檢查訊息的序列化資訊。 | |
1.1.1 | SequenceNumber
|
ORDSTAT | OSSEQNUM | ||
1.1.2 | LastUpdate Timestamp | ORDSTAT | OSUPDTIME | ||
1.2 | OrderStatus Header | 必要 | N/A | N/A | |
1.2.A1 | Versioning | 屬性 | N/A | N/A | 'TRUE' 或 'FALSE' 值。若為 'TRUE',則會啟用版本化。 |
1.2.1 | OrderNumber | ORDSTAT | ORDERS_ID/ OSMORDER | 若 type=ByWCS,則為 ORDERS_ID(代表 WebSphere Commerce 的訂單參考號碼), 否則則為 OSMORDER(代表後端系統產生的訂單參考號碼)。 | |
type | 屬性 | ByWCS 或 ByBackend | |||
1.2.2 | TotalPriceInfo | N/A | N/A | ||
1.2.2.A1 | 貨幣 | 屬性 | ORDSTAT | OSCPCUR | |
1.2.2.1 | TotalNetPrice | ORDSTAT | OSPRTOT | ||
1.2.2.2 | TotalTaxPrice | ORDSTAT | OSTXTOT | ||
1.2.2.3 | TotalShippingPrice | ORDSTAT | OSSHTOT | ||
1.2.2.4 | TotalTaxOn ShippingPrice | ORDSTAT | OSSHTXTOT | ||
1.2.3 | Status | ORDSTAT | OSSTATUS | 預設值: 'C'='已確認'(OrderConfirm 方面) 'S'='已出貨' (OrderShipping 方面) 'I'='已開發票'(OrderInvoice 方面) |
|
1.2.4 | PlacedDate | 必要 | ORDSTAT | OSPLTIME | |
1.2.5 | ShippingInfo | N/A | N/A | ||
1.2.5.A1 | ShipCondition | 屬性 | ORDSTAT | OSSCOND | 以代碼指出是否容許訂單採部份出貨方式 'SC'=完整出貨,'SP'=部份出貨。 |
1.2.5.A2 | ShipModeFlag | 屬性 | ORDSTAT | OSSMFLAG | 此代碼用以指出出貨地址與出貨模式是用在訂單層次或訂單項目層次上。 'O' = 訂單層次 'I' = 訂單項目層次。 |
1.2.5.1 | RequestShipDate | ORDSTAT | OSRSTIME | ||
1.2.5.2 | ScheduledShip Date | ORDSTAT | OSSSTIME | ||
1.2.5.3 | ActualShipDate | ORDSTAT | OSASTIME | ||
1.2.6 | InvoiceInfo | ||||
1.2.6.1 | InvoiceDate | ORDSTAT | OSINVTIME | ||
1.2.6.2 | InvoiceValue | ORDSTAT | OSINVVAL | ||
1.2.7 | 備註 | ORDSTAT | OSCMNT | ||
1.2.8 | CustomerField | 第一次出現 | ORDSTAT | FIELD1 | |
1.2.8 | CustomerField | 第二次出現 | ORDSTAT | FIELD2 | |
1.2.8 | CustomerField | 第三次出現 | ORDSTAT | FIELD3 | |
1.2.9 | UserData | N/A | N/A | ||
1.3 | OrderStatusItem | 可重複 | N/A | N/A | 向量 |
1.3.A1 | Versioning | 屬性 | N/A | N/A | 'TRUE' 或 'FALSE' 值。若為 'TRUE',則會啟用版本化。 |
1.3.1 | ItemNumber | ORDISTAT | ORDERITMES_ID/ OIMITEM | 若 type = ByWCS,則為 ORDERITMES_ID;若 type = ByBackend,則為 OIMITEM | |
1.3.1.A1 | type | 屬性 | N/A | N/A | ByWCS 或 ByBackEnd。 |
1.3.2 | ProductNumber ByMerchant | ORDISTAT | PARTNUMBER | ||
1.3.3 | QuantityInfo | N/A | N/A | ||
1.3.3.1 | RequestedQuantity | ORDISTAT | OIQTREQUEST | ||
1.3.3.2 | ConfirmedQuantity | ORDISTAT | OIQTCONFIRM | ||
1.3.3.3 | ShippedQuantity | ORDISTAT | OIQTSHIP | ||
1.3.4 | ItemUnitPrice | ORDISTAT | OIUNPRC | ||
1.3.5 | TotalPriceInfo | N/A | N/A | ||
1.3.5.A1 | 貨幣 | 屬性 | ORDISTAT | OICPCUR | |
1.3.5.1 | TotalNetPrice | ORDISTAT | OIPRTOT | ||
1.3.5.2 | TotalTaxPrice | ORDISTAT | OITXTOT | ||
1.3.5.3 | TotalShippingPrice | ORDISTAT | OISHTOT | ||
1.3.5.4 | TotalTaxOn ShippingPrice | ORDISTAT | OISHTXTOT | ||
1.3.6 | Status | ORDISTAT | OISTATUS | ||
1.3.7 | PlacedDate | ORDISTAT | OIPLTIME | ||
1.3.8 | ShippingInfo | N/A | N/A | ||
1.3.8A1 | ShipCondition | ORDISTAT | OISCOND | 以代碼指出是否容許分項採部份出貨方式。'SC'=完整出貨 'SP'=部份出貨 |
|
1.3.8A2 | ShipModeFlag | N/A | N/A | ||
1.3.8.1 | Requested ShipDate | ORDISTAT | OIRSTIME | ||
1.3.8.2 | Scheduled ShipDate | ORDISTAT | OISSTIME | ||
1.3.8.3 | ActualShipDate | ORDISTAT | OIASTIME | ||
1.3.9 | InvoiceInfo | N/A | N/A | ||
1.3.9.1 | InvoiceDate | ORDISTAT | OIINVTIME | ||
1.3.9.2 | InvoiceValue | ORDISTAT | OIINVVAL | ||
1.3.10 | 備註 | ORDISTAT | OICMNT | ||
1.3.11 | CustomerField1 | 第一次出現 | ORDISTAT | FIELD1 | |
1.3.11 | CustomerField2 | 第二次出現 | ORDISTAT | FIELD2 | |
1.3.11 | CustomerField3 | 第三次出現 | ORDISTAT | FIELD3 | |
1.3.12 | UserData | N/A | N/A |
![]() |