Integrate Komet With Other Systems

Owned by Andres Toledo
Last updated: May 27, 2024
4 min read

Komet Sales has a variety of API methods and integrations that help users connect Komet with third-party systems. If you want your Komet Account to be synchronized with your external system, please contact us so we can evaluate the technical requirements. Depending on your role and need, choose one of the following options.

Create Tokens

To create an API token from the Company account, do the following instructions:

  1. Go to Setup and select Settings.

  2. Click on Tokens under the Integrations group.

  3. Click on New Token.

  4. Enter a Token description.

  5. Select the Token Type from the drop-down menu:

    1. Company.

    2. Customer.

    3. Vendor.

  6. If the token is Vendor or Customer type, enter their name in the Vendor or Grower field.

  7. Select the methods that the token will have access to from the list.

  8. Copy the Token and click Save to complete the token generation.

Create API Tokens from Setup > Settings > Integrations > Tokens.

 

Remember to create only one token per Customer or Vendor.

Back to top

Integrations for Vendors

Komet is integrated directly with cargo agencies and grower systems such as Unosof, Ventures, Vida 18, Cargo Master, and other systems. You can also virtually connect Komet with your system through the next methods.

Need

Utility

Need

Utility

Change box codes

The method box.code.change allows changing one or more box codes.

Obtain a list of box types

The method boxtype.list allows to obtain a list of box types sorted by box type code.

Obtain a list of products

The method product.list allows to obtain a list of products with its description.

Create Purchase Orders

The method purchase.order.create allows to create Purchase Orders based on Prebooks.

Add products to an AWB

The method purchase.order.item.awb.add allows adding product lines of a Purchase Order to an AWB.

Delete items from a Purchase Order

Through the method purchase.order.item.delete users can delete products from a Purchase Order.

Obtain a list of Purchase Orders

The method purchase.order.list returns a list of Purchase Orders with its corresponding details.

Create Purchase Orders with assorted product

Through the method purchase.order.mixed.create users can create Purchase Orders with assorted products of Prebooks in units.

Upload Vendor Invoices

The method v2/vendor/invoice enables vendors to upload their invoices.

Vendor Token Generation

You need an authentication token to use the Komet Sales API as a Vendor. Vendors can generate and reset their API tokens conveniently through the Vendor Portal, or the Company can create them.

Below you will find instructions on creating a Vendor token as a Company and as a Vendor.

Option A: Create a Vendor Token from the Company’s Account

To create a Vendor token from the Company account, do the following instructions:

  1. Go to Setup and select Settings.

  2. Click on Tokens under the Integrations group.

  3. Click on New Token.

  4. Enter a Token description.

  5. Select Vendor from the Token Type drop-down menu.

  6. Enter ASINFO + The Vendor name on the Vendor field.

  7. Select the methods that the token will have access to from the list. We recommend selecting these methods as a minimum:

    • boxtype.list

    • carrier.list

    • product.list

    • purchase.order.items.awb.add

    • purchase.order.items.awb.add

    • purchase.order.list

    • v2/vendor/invoice

  8. Click Save to complete the token generation process.

Remember to create only one token per Vendor.

Option B: Create a Vendor Token from the Vendor Portal

To generate a Vendor token, do the following instructions:

  1. Log in to the Vendor Portal using the username and the password provided via email.

  2. Click on your account's profile icon to show its menu options.

  3. Select Vendor Token from the menu list.

  4. Hover your cursor over the token and click on it to copy it to your clipboard to start connecting your systems with your other companies.

By default, this token has access to the following API methods:

Reset a Vendor Token from the Vendor Portal

To get a new Vendor token, do the following instructions:

  1. Log in to the Vendor Portal using the username and the password provided via email

  2. Click on your account's profile icon to show its menu options

  3. Select Vendor Token from the menu list.

  4. Click on the refresh icon; this will create a new token.

Back to top

Integrations for Inventory and Invoices

Need

Available Methods

Need

Available Methods

Share Inventory to Komet's Account

This can be done through the API method inventory.add. It is possible to use the parameter confirmInventory so the inventory updates in the external system once a product synchronized is sold or deleted from Komet's account.

Update in real time the synchronized inventory

Once the inventory is shared from the external system into Komet, it is possible to use the inventory.update or inventory.delete API methods to every time a product is sold in the external system, the actual quantity available gets update in Komet.

Create invoices in Komet

The invoice.create method allows you to create an invoice on Komet Sales with its corresponding product items. 

Obtain a list of invoices created in Komet

The API method invoice.details.list returns a list of invoices created in Komet.

Obtain a list of invoices

The method invoice.details.list returns a list of invoices with their corresponding details.

Mark a single invoice as successfully synchronized

The method invoice.mark.sync.status.ok allows you to mark a single invoice as successfully synchronized. 

Back to top

Integrations for Prebooks and Purchase Orders

Need

Available Methods

Need

Available Methods

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11176882

This method allows users to add a Prebook to Komet Sales and update existing Prebooks.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11176974

Use this method to delete Prebooks from Komet Sales. If you use a vendor token, the system will update the quantities to 0.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11176919

This method returns a list of Prebooks with their corresponding details.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11177108

Use this method to create Purchase Orders based on Prebooks.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11177203

Use this method to add product lines of a Purchase Order to an AWB.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11177227

Use this method to delete products from a Purchase Order.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11177079

Use this method to get a list of Purchase Orders with its corresponding details.

https://kometsales.atlassian.net/wiki/spaces/APIDocs/pages/11177140

Use this method to create Purchase Orders with assorted products of Prebooks in units.

Back to top

Related Articles