Article ID: 116492, created on Jul 18, 2013, last review on Dec 9, 2014

  • Applies to:
  • Business Automation


PBA allows to change status of an order via Public API according the defined order flow using the OrderStatusChange_API method. The method itself is described in PBA documentation and requires the Signature parameter, which is MD5 sum of concatenated order details:

  • Order ID
  • Order number
  • Creation time
  • Total amount
  • Description

The order details listed above may be obtained with the help of the GetOrder_API PBA API method, it returns XML document which has to be carefully parsed to generate signature for the OrderStatusChange_API method. It may take much time to generate correct signature manually.


Use the instruction below and the attached Python script to automate process of generating signature for the OrderStatusChange_API method.

  1. Download the attached Python script

  2. Run the script, pass an order ID as an argument:

    # python 10653

    By default localhost is used as an entry point, if you run the script from host other than PBA application server or xmlrpcd is not setup to listen on, pass the correct URL as the second argument:

    # python 10628
  3. Output of the script (seen in the examples above) is the signature that should be used in the OrderStatusChange_API method.

Script description

  • Script can be run on any host with python > 2.5.
  • Usage:

    python OrderID [http://PBA.XMLRPCD.IP:5224/RPC2>]

    where OrderID is an obligatory argument, http://PBA.XMLRPCD.IP:5224/RPC2 shall be passed when the script is executed from the host other than PBA application server or xmlrpcd is not listened on

  • If run on the pba application server, the script automatically detects the price precision (taken from /usr/local/stellart/share/currencies.txt) and generates the signature accordingly. If run from other host, the default precision (2) is used.


caea8340e2d186a540518d08602aa065 198398b282069eaf2d94a6af87dcb3ff e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF