saveWarehouse

Create or update a store (location, warehouse). Access right to newly created store will be given to creator only. If its require to give access to newly created store for all existing users, specify addAccessForAllUsers = 1

To retrieve a list of locations, see getWarehouses.

Input parameters

Parameter name Description Possible value Required
warehouseID Integer
name Warehouse name. Use either general parameter "name" or one or more of the following parameters if you need to set the names in specific languages. String
nameENG String
nameSPA String
nameGER String
nameSWE String
nameFIN String
nameRUS String
nameEST String
nameLAT String
nameLIT String
nameGRE String
code Warehouse code. String
storeRegionID

Store region ID, available only if "Store regions" module has been enabled on your account.

To get a list of store regions, see getStoreRegions.

Integer
assortmentID

Assortment ID.

An assortment defines which product can be sold and/or purchased in this location.

Using assortments requires the "Assortments" extra module which customer support can enable on your account.

To get a list of assortments and their contents, see getAssortments and getAssortmentProducts.

Integer
priceListID Warehouse first price list Integer
priceListID2 Warehouse second price list Integer
priceListID3 Warehouse third price list Integer
storeGroups A comma-separated list of store groups String
companyName Set a custom "company name" for this location.

Typically you should not use this field. This may be needed only if the location is a separate corporate entity: your business is a franchise chain that operates in a single Erply account, instead of using a separate account for each entity.
String
companyCode Set a custom "company registry number" for this location. See the comment above. String
companyVatNumber Set a custom "company VAT number" for this location. See the comment above. String
addressID Set the ID of location's address. The ID MUST be one of the addresses on your company card.

(It is not possible to edit company information or add corporate addresses via API, and API call getCompanyInfo does not return a list of all corporate addresses. Therefore this field is probably useful only if the address has been defined in Erply back office beforehand, and you know its ID.)
Integer
timeZone Set a time zone for a location. This could be used if the time zone of a location is different from the time zone of the main account. Example value: "Europe/Tallinn" String
phone Set the location's phone number. This information is displayed for example on invoice and receipt printouts.

If you do not specify a phone number for this location, the printouts will display general corporate phone number, from your company card. (The same comment also applies to the fields below.)
String
fax Set the location's fax number. String
email Set the location's e-mail address. String
website Set the location's web site address. String
bank Set the location's bank name. String
account Set the location's bank account number. String
swift Set the location's bank BIC/SWIFT code. String
iban Set the location's IBAN (international bank account number). String
shift1Start Salon-specific attribute. Available only if Salon / Spa module is enabled on your account. ISO time (hh:mm), am/pm allowed
shift1End Salon-specific attribute. Available only if Salon / Spa module is enabled on your account. ISO time (hh:mm), am/pm allowed
shift2Start Salon-specific attribute. Available only if Salon / Spa module is enabled on your account. ISO time (hh:mm), am/pm allowed
shift2End Salon-specific attribute. Available only if Salon / Spa module is enabled on your account. ISO time (hh:mm), am/pm allowed
addAccessForAllUsers Give access to newly created warehouse to all existing user Integer (1 or 0)
***** Additional attributes associated with this item.
Attributes must be supplied as a flat list, each attribute defined by the following set of three parameters. Replace # with set number (1, 2, 3, ...). When updating an existing entry, API will only update the attributes specified in input data and leave all other existing attributes unchanged. To delete an attribute, set its value to 'null' or 'undefined'.
attributeName# Attribute name. Name can only contain the following symbols: A-Z, a-z, 0-9, dash and underscore. String
attributeType# Attribute type, possible types are 'text', 'int' and 'double'. By default 'text'. String
attributeValue# Value of the attribute. Set value to 'null' or 'undefined' to delete an attribute.
'text' attribute can be any string, maximum 255 characters.
'int' must be a signed 32-bit integer.
'double' must be a decimal number.
String

Response

Field name Type Description
warehouseID Integer ID of the newly-created or updated item