Stock | Warehouses

A warehouse is a place where products are stored. Information about the warehouses is necessary for the functioning of the platform. Information about the warehouse will be visible to the customer on the fronted ONe platform. Multiple warehouses can be assigned. Later, products and their stock quantity will be assigned to the created warehouses.
In the ONE system through the integration API it is possible to create and update warehouses.

Table of contents


required field, warehouse identifier, used to communicate with API
only descriptive meaning, used in front, if empty: name will be used
this is the name that will be displayed to customers on the fronted of the platform
identifier of parent CENTRAL warehouse, valid only for LOCAL warehouse
flag indicating whether the goods can be picked up from a given warehouse
flag indicating whether the goods can be reserved from a given warehouse. Reservation of products on a sales order means that after placing an order, the amount of available products is reduced by the amount of products from the order. The reserved quantity is visible on the created sales order in the Reserved Quantity column. It is possible to reservation of goods for the customer in the backoffice. For more information on how to do this via backkoffice check here
reservation time in hours, required when reservation is true. The reservation time is valid for reservations on the shopping cart. Time is not a parameter that determines the validity of a reservation on a sales order. Time is given in hours
shipping time for the warehouse (in hours, eg. 24 means 1 day/24 hours)
flag indicating whether the warehouse supports sales from ONe
required field, specifying whether the warehouse is local or central Listing: "CENTRAL" "LOCAL”
address: TIN type firstName lastName companyName zip city street number apartment country phone latitude longitude additionalInfo
tax Identification Number the field specifies whether the address is personal or whether it is a company (enum: "PERSONAL" "COMPANY") first name of the contact person for the address (for personal address) last name of the contact person for the address (for personal address) name of company (for company address) zip of addres city of addres street of addres number of addres apartament of addres country of addres phone of addres geographic latitude geographic longitude additional information that will appear only on the backoffice (the client will not see it)

PUT - create or update warehouse with given id

As previously mentioned, the warehouse can only be created via API in an external system (eg ERP). The warehouse can be updated via an external system as well as on the ONe platform
Important! In the settings in the backoffice (Configurations → Warehouses) you can edit whole information except warehouseId
The diagram below shows the dependency of communicating with the API when warehouse was created or update in external system:
Image without caption
Use PUT /api/v1/account/integrations/auth-required/warehouses to create / update the warehouse. Then you need in request put the following data:
  • id
  • name
  • type
Providing other information as in the example below is not required, but it is worth completing during creation the warehouse.
All information provided during the creation of the warehouse should be included in the content in order to update the information
Example request
curl -X PUT "" -H "accept: */*" -H "one-tenant: {tenant}" -H "ApiAuth: {apiKey}" -H "Content-Type: application/json" -d "{ "id": "WRO", -- required "label": "Wrocław warehouse", "name": "Wrocław", -- required "parent": null, "pickupPoint": true, "reservation": true, "reservationTime": 3, "shippingTime": 24, "supported": true, "type": "CENTRAL", -- required "address": { "TIN": "111111111", "type": "COMPANY", "firstName": null, "lastName": null, "companyName": "Speedimex", "zip": "54-045", "city": "Wrocław", "street": "Międzyleska", "number": "25", "apartment": null, "country": "Polska", "phone": "111111111", "latitude": 51.079923, "longitude": 17.068543, "additionalInfo": "Warehouse operated by a third party" } }"

Powered by Notaku