Order Confirmation Webhook

In this article, you will learn how to set up the order confirmation webhook and enable email notifications to notify salespeople if there is an error during the synchronization process with an external system so they can reconfirm the orders once the issue is solved.

User Roles: Admin.

Step one: Create the Order Confirmation Webhook in Your System

When creating the endpoint in your system, it is important to consider the following details:

Request

URL: https://theexternalsystem.com

Content-Type: application/JSON

Method: POST

Header

authenticationToken (optional)(string:50)

You can use this optional parameter to add your token that will identify you when integrating with external systems or extract it from the token. The method chosen will depend on your specific operation.

Body

companyId (long)

Komet Sales Internal Company ID.

orderId (long)

Komet Sales internal Order ID.

Request Example

{
   "companyId":6316,
   "orderId":6908
}

Response

Content-Type: application/JSON

Body

status (boolean)

Result of the request.

Valid values: 0 = Error | 1 = Success

message (string)

This parameter allows you to enter a customized message describing the status. The message will be reflected in Komet Sales.

Response Example

{
   "status":"1",
   "message":"<<Custom Success Message>>"
}

Back to top

Step two: Set up the Order Confirmation Webhook

Once you have created the endpoint in your system, you need to add it to your Komet Sales account.

To add your endpoint, do the following instructions:

Go to Setup and select Settings.
Click on Webhooks from the Integrations group of settings.
Select Order Confirmation from the dropdown list.
Enter the URL that Komet Sales will call when this webhook is triggered.
Select your authentication type:
1. Basic. Enter your username and password.
2. Bearer Token. Enter your authentication token.
Enter the email addresses that the system will notify when an error occurs in the external system in the Error Notification field. You can enter up to 5 email addresses.
Click on Save.