API documentation for POS integrations
How to connect a Point of Sales system (or other system) to Vinify.
This allows you to have your POS be always in sync with your cellar/wine list/stock count/analytics in Vinify.
We are flexible and not limited to the documentation below.
For any questions, please contact Roko Cupic: rcupic@profico.hr
The basic “back and forth”
Articles (products/wines) are created and edited in Vinify and sent to the POS. Vinify functions as the master database of articles.
When an article is sold via the POS, the POS sends that information to Vinify, which allows Vinify to update the cellar quantity of the article.
Vinify requirements
Authentification
One Vinify cellar can have one POS account. In order to establish connection between cellar and POS, we must authenticate Vinify and cellar. We are open for any kind of authentication.
Articles
Groups
Articles are organised in groups that make it easy for Sommeliers to find an article in the POS. It would be great if articles from the same group can inherit the same settings.
Recommended setup is having 3 layers of groups with next hierarchy:
Style → Country → Region
Ex.: White wine → France → Champagne
Groups could have different VAT, color and additional attributes.
Articles
The main entity of integration are articles. Each article is located inside of one group from which it inherits settings. Also, each article can have its own attributes and settings.
Article ID can be defined from our side, or it can be automatically generated by POS service.
Articles can include many details/metadata, including but not limited to: Name, group, selling price, URL, cellar location.
Glass articles
Used for selling wines by the glass via the POS system.
Glass articles are separate articles and transactions are processed differently.
Transactions
The most important information for us is amount of sold articles and article identification, because for that amount we will decrement cellar article quantity. We can process transactions either continuously or once a day.
Launching new clients
New clients are launched manually by admins. After a client is created in POS, we will link his cellar with the POS account.