Profits Plus modules»Web Services
  • RSS Feed

Last modified on 4/7/2017 4:44 PM by User.

Tags:

Web Services

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.