Installation (Unix and Windows) Web Services menu
Web Services is a set of Softworks Basic programs that simulates an HTTP server on the World Wide Web. The Web server does not support the GET function which is normally used to retrieve web pages.
Only the POST function is available for the following api methods.
order.create Create a new order with a unique order # for a specific customer order.modify.header Change values in the order header file oehtrx.dat for a specific order # order.modify.detail Add/Change values in the order detail file oedtrx.dat for a specific order # and line item order.submit Send the order to "warehouse" or "shop" so the items on the order will get "picked" order.cancel Cancel an order. item.get.info Return the customer's price and discount information for a specific item number
For a complete description of each of the above api methods see the Web Services design document at webservices_1_4.pdf
A Word for Windows version of the above web services spec is kept on OneDrive \archive\MVSWEB_spec\web_services\webservices_1_4.doc.
In April 2016 we added dimensional support to the API and discovered the OED_DLEN and OED_DWIDTH variables can have unexpected values.
- Originally the meaning of OED_DLEN is backwards and will contain the value for width (not length). And OED_DWIDTH will contain the value for height or length (not width).
- To make things even more confusing the 2nd character of the ORDENT.INI parameter DIM’ORDER[2;1]=”R” (reversed) will swap the meaning again back to their expected values where OED_LEN contains length or height and OED_WIDTH contains width. You must know the value of DIM'ORDER to know which field holds which value.
- To know for sure how values ultimately map to OED_DLEN and OED_DWIDTH you can do a MySQL select statement like "SELECT oed_dlen, oed_dwidth FROM oedtrx_dat WHERE oed_ord_num=??????;"
Using the Web Services API , a web browser can create new sales orders, add items to an order, change certain fields on the order, submit the order, and cancel the order.
The Web browser can also create quotes and credit memos. It can also change a quote into a sale order.
The Submit function does NOT invoice the order. It merely generates a picking ticket in the warehouse so the order will get shipped. Invoicing must still be done in the back office.