Reference > Shop flow URLs > Order Management subsystem URLs > Orders URLs
ShipInfoPrepare URL
Reconciles the SHIPINFO table and ORDERITEMS table to look for orphaned SHIPINFO records, and deletes any orphaned records from the SHIPINFO table. An orphaned SHIPINFO record is one that does not have a matching record in the ORDERITEMS table. This situation can occur if a shipping address is deleted after a SHIPINFO record is created.
For example, suppose a customer, Mary, has placed an order and has entered shipping instructions, but then later modifies the order to change the address or ship mode. When Mary moves forward in the shopping flow, she will not see any instructions for the new combination of ship mode and address because the saved instructions were for the previous combination, which has since changed.
URL structure
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
name-value pair with the &
character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />
Parameter values
- storeId
- Required: The store ID of the order.
- orderId
- Required: The identifier of the order to which the shipping information applies. Specify zero or more orders, using order reference numbers or one of the special abbreviations ".", "*", ".t", "*t". See the Order abbreviations for a description of these abbreviations. If this parameter is omitted, it defaults to ".".
- URL
- Required: The URL to be called when the command completes successfully.
- addressId_ i
- Optional: Contains a distinct addressId value if shipping instructions are provided and depending on what shipping information is being stored, for the enumeration group specified as i. If shipping instructions are being stored, the addressId is the identifier of the address associated with the shipping instructions.
Example
The following example causes the shipping information for order 445566 to be cross-checked with the information in the ORDERITEMS table to see if the shipping charge information exists for that address ID.
http://host_name/webapp/wcs/stores/servlet/ShipInfoPrepare?orderID=445566&storeId=10001 &addressId=2&URL=/
Behavior
When the ShipInfoPrepare URL command is run, shipping information (shipping instructions or shipping charge data/carrier account number) is validated between the SHIPINFO and ORDERITEMS database tables. If shipping instructions are provided, if the address ID value of -1 is specified, the shipping charge data/carrier account number is checked against the ORDERITEMS table. If some other value is specified for the address ID, it is assumed that shipping instructions are associated with the address ID.
If the SHIPINFO record that is checked does not have a corresponding record in the ORDERITEMS table, the SHIPINFO record is considered orphaned and is removed from the SHIPINFO table. If the record does exist in the ORDERITEMS table, the shipping information is validated against the information shown in the ORDERITEMS table.
When calling the ShipInfoPrepare controller command in a JSP file, be sure to include the form action attribute in the calling JSP file. For example:
<form NAME=ShipMethodPage METHOD=GET action="ShipInfoPrepare">
Exception conditions
None.
Related concepts
Related reference
Order Management subsystem URLs