Receive order/article update
: Upcomming system maintainence
26th of October we will do some system maintainence on our applications this will affect our APIs. You migth experience some outage of our APIs between 07:00 and 09:00 Sunday 26th of October.
Order information/update from Bring. Bring Warehousing can send order information to you or you can pull the data from us. How often you want order lifestyle updates is up to you. Bring Warehousing can also send you Inventory reports (full overview over all articles) and Inventory adjustment reports (update per article after an adjustment is made).
Authentication
In order for us to make API requests to you, you will need to send us an API key from your web service site. Steps for getting a key and description of headers should be similar to ours and can be found on the general API Getting Started page.
Formats
REST XML/JSON over HTTPS. This is common for most REST APIs.
Order Information
In order to obtain information about an order/get the receipt for an order, you have two options:
- You can obtain data from Mybring.
- We can push data to you if you set up a webservice on your side
You should use a REST web service which needs to be secured through https.
After you have set up your web service, you must send the information about the URL and its authentication to us, so that we can set up a link from our side.
The data sent from Bring will be in GS1 3.3 format. General information about GS1 3.3 can be found here: https://www.gs1.org/standards/gs1-xml/3-3
Authentication
Bring supports https with basic username and password authentication.
Message header authorization options:
- Authorization: Basic bWFnZ2llOnN1bW1lcnM = ???? or
- API key: X-API-KEY: abcdef12345
Verification
Your webservice must verify and return a response to us that the message was received ok.
Your response will have to follow the format below. It's important that the following is set in the response:
- Message must be equal to success
- Request ID has to be a unique ID for each message.
Response Example
| XML Sample | JSON Sample |
Response Schema
| XML Schema |