This option enables a user to execute remotely authorization procedure for set of orders, change cards quantity for the order and cancel order. An external shopping cart could be integrated with this option and could use it at the end of checkout process. Below are the fields that will be passed and the meaning of those fields.
| Required | Form Element Name | Value | Max. length in characters |
Type | Source |
| Text type includes all syntax signs. Source OPC means that value of the field should be received from OPC system (interactively or via other interfaces) before the request Source Input means that value of the field should be defined by User |
|||||
| Required | username | Account Number/Name | 12 | Numeric | OPC |
| Required | password | The users password | 10 | Alpha-numeric | OPC |
| Required | name | The users full name | 50 | Alphabetical | Input |
| Required | start | Value must be 'shoppingcart' | 12 | Alphabetical | OPC |
| Required | url | The URL you want the user to return to when the request is complete. | 256 | URL | Input |
| Required | ac | Action code: "a" - authorize orders "c" - change quantity for the order or cancel the order if quantity is zero (quantity=0) | 2 | Alphabetical | Input |
| Required for Action code "c" | ordernumber | The order number to use with action code "c" | 10 | Alpha-numeric | OPC |
| Required for Action code "c" | quantity | The Quantity of the Order to use with action code "c" | 5 | Numeric | Input |
| Required for Action code "a" | ordernumber1 ... ordernumberN | The order numbers to use with action code "a" | 10 | Alpha-numeric | OPC |
| Optional for Action code "a" | q1 ... qN | Updated quantity to use with action code "a" | 10 | Alpha-numeric | OPC |
| Optional | memo1 | Comments to use with action code "a". | 300 | Text | Input |
| Optional | po | Purchase order number to use with action code "a". | 40 | Alpha-numeric | Input |
| Optional | brokerpo | Broker's purchase order number to use with action code "a". | 40 | Alpha-numeric | Input |
| Optional | sname | Shipping first name and last name to use with action code "a". | 40 | Text | Input |
| Optional | saddress | Shipping address Line 1 to use with action code "a". | 40 | Text | Input |
| Optional | saddress2 | Shipping address Line 2 to use with action code "a". | 40 | Text | Input |
| Optional | scity | Shipping city to use with action code "a". | 25 | Alphabetical | Input |
| Optional | sstate | Shipping state to use with action code "a". | 20 | Alphabetical | Input |
| Optional | szip | Shipping zip code to use with action code "a". | 10 | Numeric | Input |
| Optional | scountry | Shipping country to use with action code "a". | 40 | Alphabetical | Input |
| Optional | scode | Shipping code to use with action code "a". | 15 | Alpha-numeric | Input |
| Optional | shipmethod | Shipping method to use with action code "a". | 50 | Alpha-numeric | Input |
| Optional | cemail | Email address for order confirmation to use with action code "a". | 100 | Text | Input |
| Username and password should belong to the same customer which have created these orders or to some customer having rights to authorize orders created under other subaccounts (the same username but different passwords). | |||||
| Response. After request is processed, the users browser will be redirected to 'url' (see description of this form element above). Redirection will be done as HTML form submit containing fields described below. |
|||||
| Form Element Name | Value | Max. length in characters |
Type | Source | |
| message | Value is 'OK' if request was processed successfully otherwise it will contain error message. OK Field sname has not an alphabetic type Field ac has wrong length Field url cannot be empty If response field 'ordernumber' is not empty then field 'message' contains system error. | 256 | Text | OPC | |
| ordernumber | if request was processed unsuccessfully then this value will contain number of last order which was authorized successfully | 10 | Alpha-numeric | OPC | |
The actual request form looks like this that.
|
<form ACTION="http://www.orderprinting.com/remote.asp" METHOD="GET or POST if summary length of all fields more 256 characters"> <input type="hidden" name="username" value="Account Number/Name"> <input type="hidden" name="password" value="The users password"> <input type="hidden" name="name" value="The users full name"> <input type="hidden" name="start" value="Value must be 'shoppingcart'"> <input type="hidden" name="url" value="The URL you want the user to return to when the request is complete."> <input type="hidden" name="ac" value="Action code: "a" - authorize orders "c" - change quantity for the order."> <input type="hidden" name="ordernumber" value="The order number to use with action code "c""> <input type="hidden" name="quantity" value="The order number to use with action code "c""> <input type="hidden" name="ordernumber1 ... ordernumberN" value="The order numbers to use with action code "a""> <input type="hidden" name="po" value="Purchase order number to use with action code "c""> <input type="hidden" name="sname" value="First Name."> <input type="hidden" name="saddress" value="Shipping address Line 1 to use with action code "a"."> <input type="hidden" name="saddress2" value="Shipping address Line 2 to use with action code "a"."> <input type="hidden" name="scity" value="Shipping city to use with action code "a"."> <input type="hidden" name="sstate" value="Shipping state to use with action code "a"."> <input type="hidden" name="szip" value="Shipping zip code to use with action code "a"."> <input type="hidden" name="scountry" value="Shipping country to use with action code "a"."> <input type="hidden" name="scode" value="Shipping code to use with action code "a"."> <input type="hidden" name="shipmethod" value="Shipping method to use with action code "a"."> <input type="hidden" name="cemail" value="Email address for order confirmation to use with action code "a"."> </form> |
Remote Login Feature Technical Specifications
|