Change URL (Webhook)

Follow
In the company menu, you can create a URL address that can send a notification when master data changes, also called webhooks. The message can either apply to all master data directories or to a specific directory. When a record is created, deleted or updated, the Uniconta server will call the specified URL, with information about Company, Table, Key, RowId and Operation. It is also possible to see if the inventory changes by using the "InvItemStorage" folder Version-93: In web hooks, there is now an option to include the record itself back in the call as a Json document. This avoids having to search Uniconta to get the new values. If you use this new method, the Json record is included as part of the body. The method is activated by checking the 'Post' box. Here is an overview of the directories that we can use the URL changes for. As these are updated continuously, you need to see the current directories in Uniconta.   The change URL can be used to update e.g. individual items in your stock on a webshop, item number and so on. So instead of synchronizing at night or every hour, we can now update instantly.

How to make use of the Change URL

Select under Company/Maintenance/Change URL

Local menu for Change URL

  1. Add post
    • Adds a line where you can write your Change URL
  2. Delete post
    • Deletes the current line, the line you have selected in the overview
  3. Gem
    • Saves the created change URLs
  4. Update
    • After making a change or creating a new record, press Update to see the latest corrections.
  5. Layout
    • Change the layout of the form itself
NOTE: You cannot change a URL entry. If you want to make changes to it, you must create the entry/line again.

Create a Change URL

To create a Change URL, you can do the following:
  • Click on Add record
  • Select the Folder you want to make changes to. See the list in the Folder dropdown box
  • It's also possible to see when a Job is running, e.g. Recalc Storage.
  • Enter the URL to which the changes should be sent. You can use Webhook.site to test against.
  • Click Save to save the record
    Below is selected Debtor (Debtor table) as the directory to send updates to the selected URL   Below are several created Change URLs, and you can create as many as you want Arguments do not need to be filled in. It's just a parameter we insert in the URL that you get back in the call.  

Setup on your WebServer

If we imagine that you have a webshop with a URL like www.mywebshop.dk/unicontalog you will receive data from us with the following link: http://www.mywebshop.dk/unicontalog?CompanyId=123&Table=InvItem&RowId=543&Key=1000&Action=Update This means that you must receive on your web server:
  • CompanyID
  • Table
  • RowId
  • Key
  • Action