Set up Proof of Delivery
Overview
Komet Sales allows you to set up your PODs (Proof of Delivery) to automatically upload them onto the system once they are saved in a specific folder from your computer. This is a one-time setup that integrates the Komet System to generate POD files in PDF format from your system to Komet Sales.
Instructions
You need to run this process as a service in Windows installing the NSSM utility.
To configure the Komet POD service, follow these steps:
System requirements
Before you begin, make sure to:
Install JDK (Java Development Kit) from the Oracle's website
Set up and test JAVA_HOME variable. For further information about this process, read this article.
Generate a company token with access to the invoice.pod.receive API method. This method allows the Komet System to search for POD files in the folder.pending folder and upload them to Komet.
Download and unzip the NSSM utility here. We recommend you use the pre-release build 2.2.4-101 to avoid compatibility issues running the service in your system.
Download and unzip the Komet Sales POD files uploader here. Preferably, unzip this service in your C Windows folder (C:\Windows) for ease of access. The file location will depend on your computer or server configuration.
Look for the bin folder and modify the following attributes from the config.properties file using a text editor.
Important
Use Notepad or WordPad text editors to preserve the line breaks of the file.
Use backslash ( \ ) or double slash ( // ) to name the pod folders. Do not combine them!
token: replace the default token with the token generated in Komet Sales.
folder.in-progress: replace the << Path >> with the folder location where the files are processed. For example, C://pod//in-progress
folder.pending: replace the << Path >> with the folder location of files pending to process. For example, C://pod//pending
folder.error: replace the << Path >> with the folder location of incorrect files. For example, C://pod//error
folder.processed: replace the << Path >> with the folder location of successfully processed files. For example, C://pod//processed.
Go to the Start menu and search for Command Prompt (CMD), right-click on it and run it as administrator.
Enter the path location where the NSSM utility is installed. For example:
cd C:\Program Files\nssm-2.24-101-g897c7ad\win64Run the following command to open the NSSM service installer window:
nssm.exe install KometPODUploader-PRODUCTIONSelect the file kometsales_pod_upload.bat from the path field in the Application tab and Click on Install service to complete the service installation.
Go to the Start menu and search for Services. Look for KometPODUploader-PRODUCTION on the services list and right-click on it or click on to start the service.
The PODs are uploaded on the Komet system once they saved in the folder. pending folder and manually named with the same invoice number as the one within Komet Sales. The system allows you to upload a single POD or several at the same time. You can print or email processed PODs to customers within the system once you complete the process. For more information, read Emailing & Printing PODs. If still in doubt, please email us at support@kometsales.com
Failed to load PDF document
In case you get the error message Failed to load PDF document, create a folder and make sure to save all the POD files you will upload. Once you do that, transfer them to the folder named folder.pending for the system to process them. Read POD is not working for further information.
Related Articles
Important
Komet Sales is not responsible for the installation of these server files in your system. Be sure to have your IT personnel perform this configuration. Contact us at support@kometsales.com if you have any questions regarding this process.
Use to walk you through the POD setup.