> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Linking your webshop to Robaws

**Context**

Are you the owner of a wholesale business? Would you like to link your webshop to Robaws and reach new customers that way?
From now on you can build this integration yourself, or have it built by a third party.

**How?**

1. **Let us know first** that you would like to link up with Robaws. Fill in [this form](https://robaws.notion.site/0e778aad53ea4398a9b04f56f512cce9) to do so. We will then provide you with the necessary authentication details, as well as a test environment against which you can test the integration.

Make sure to mention the following details:

* your company details (registered name, address, VAT number)
* the names of a few shared customers
* your motivation for building the integration
* specify how end users authenticate in your webshop. Possible options: OAuth2, username and password, an API key, etc.
* the name under which your webshop should appear on the integrations page of a Robaws environment
* the test endpoint URL of the API
* will the API support the creation of supply orders?
* will the API support decimal quantities when supply orders are created?
* will the API return a URL to which the user must be redirected when a supply order is created?
* will the API support a stock check?

2. **Build a restful API** that follows the specification documented here: [https://bitbucket.org/eforge/webshop-demo](https://bitbucket.org/eforge/webshop-demo)

3. **Test the integration** by importing items, placing a supply order, and so on.

4. Submit this [form](https://robaws.notion.site/0e778aad53ea4398a9b04f56f512cce9) to let us know that your integration is ready. What do we need to know?

* the final production endpoint URL of the API
* your logo (in PNG format, for example)
* a test user for us, so that we can validate the integration as well

Once your integration has been tested and approved, we will publish you on our integrations page.

**More information or questions** about this? Feel free to send an email to relations@robaws.be