One important use case for pCon.ui is the integration into shop systems, but often the shops don’t want to use the product prices available in the OFML data. For example, there are no prices available for different currencies or promotion discounts of the shops cannot be applied. Therefore, a functionality is needed that allows the shop to overwrite the prices coming from the OFML data in pCon.ui.

Access-Control-Allow-Headers: Content-Type
Access-Control-Allow-Method: POST
Access-Control-Allow-Origin: https://ui.pcon-solutions.com

When users insert a product or configure it, a POST request with a JSON including a link to an OBX file is sent to a webservice of the shop. The OBX file contains all pieces of information on the product (manufacturer, article code, configuration, …). The webservice of the shop downloads and parses this XML file and gets the required information to determine the price. The new price, currency and the article ID are sent back to pCon.ui as JSON file. pCon.ui reads this file and displays the new price to the users. The url to priceservice script has to be send to us to make it work.

The POST request sent by pCon.ui looks as follows:

{
    "obxUrl": "<url>"
    "customFields": ""
}

The URL leads to an OBX file. This file contains the information on the inserted products. Note that the link expires after 24 hours. If you desire to persist the OBX file, please store it on your own server. If customFields parameter was set in pCon.ui URL, the JSON contains this as well.

If required, a detailed OBX specification can be found here. The elements important for the price service are:

<bskArticle basketId='c45f23d5-8e3f-43a5-b542-f5bddcb14194' itemType='BasketArticle'>
  <manufacturer id='EGR'>
      <name lang='  '>EasternGraphics GmbH</name>
  </manufacturer>
  <series id='SE'>
      <name lang='  '>Series Name</name>
  </series>
  <artNr type='base'> NU3456 </artNr>
  <artNr type='final' default='1'> NU3456-TE </artNr>
  <artNr type='varcode'>CLASS1.PROP1=01;CLASS1.PROP2=06;CLASS2.PROP1=ABC</artNr>
  <description type='short' default='0'>
      <text lang='de'>Example Product</text>
  </description>
  <itemPrice type='purchase' currency='EUR' value='103.0' />
  <itemPrice type='sale' pd='1' currency='EUR' value='103.0' />
  <taxInfos>
      <taxInfo typeId='ECO_FR' categoryId='workplace_wood' />
  </taxInfos>
</bskArticle>

<bskArticle basketId='main_article_ID' itemType=' BasketAggregate'>
  … (see example above)
  <bskArticle basketId='child1_ID' itemType='BasketAggregate' subItem='1'>
    … (see example above)
  </bskArticle>
</bskArticle>

Prices can be manipulated in many different ways:

Manipulation Type	Description	Things to consider
change price	manipulate price given by manufacturer ac-cording to your needs (eg. give discount)	Take given price, do calculations with it, send new price back with mandatory fields (see this section).
visualize discount	manipulate price given by manufacturer eg. with given discount percentage or set new price	Take given price, set discount, send default and new price back with optional fields (see this section).
gross price	show gross price of articles in pCon.ui	Given price is net price by default so you will have to do the correct calculation of gross price on your side considering the vat tax for your country and send new price back with mandatory fields (see this section). There will be no conversion from net to gross price on our side if you use a price service.
change currency	change the currency given by manufacturer	Default currency given by the manufacturers is mostly EUR. If you want to display a different currency, you have to do the conversion from the default currency to the desired one by yourself and send the new price and currency back with mandatory fields (see this section). There will be no conversion from EUR to other currencies on our side if you use a price service.

After the price service system determined the price, it has to send the information back to pCon.ui as JSON. The JSON file needs to contain the following elements:

{
    "currency": "EUR",
    "taxCode": "DE",
    "articles": [
        {
            "basketId": "f7d06042-5cda-49b7-a2f1-47a4901e3fa9",
            "salesPrice": "1.0",
            "vat": "0.19",
            "eco": "0.1",
            "eco_info": "eco info text"
        }
    ]
}

{
    "currency": "EUR",
    "taxCode": "DE",
    "articles": [
        {
            "basketId": "main_article_id",
            "salesPrice": "2.0",
            "vat": "0.4",
            "eco": "0.2",
            "eco_info": "eco info text"
        },
        {
            "basketId": "child_article_id",
            "salesPrice": "1.0",
            "vat": "0.19",
            "eco": "0.1",
            "eco_info": "eco info text"
        }
    ]
}