frequently asked questions

All your questions in one place.

Products

This method returns the Winbiz Items. This method uses a pagination in order to avoid to stress the API with useless calls and returns. The Class returned always contains 100 items at the most.

Pay attention to the fact that this method returns, for the moment, also the pictures associated to the items. We're going to add a parameter that allows not to return the pictures, but in the meantime you must take into consideration that pictures will slow down the delivery of the results.

BODY - RAW

{
      "Method": "Products",
      "Parameters": [
            [<nLastItemId>],
            [<dModifiedSince>],
            [<cItemList>],
            [<bOnlyEcommerce>],
            [<nPriceRound>],
            [<cCurrencyCode>],
            [<nPriceTableId>],
            [<cCategoryName>],
            [<bNoPictures>]
      ]
}

PARAMETERS

Property Description
nLastItemId

ID of the first item to be returned. You'll typically parse the results of a call, and then pass as a parameter the biggest (last) ID received, in order to obtain the next 100 products.

If the method returns less than 100 Products, that means that it has returned everything (according to the parameters used)

dModifiedSince Allows to return only the items changed/created/deleted since the date passed as a parameter.
cItemList  A list of ID, separated by semi-columns to use as a filter.
bOnlyEcommerce Allows to return only the items that are flagged as items to be published to a e-commerce site.
nPriceRound

Rounding method to be used to round prices. the possible values are:

- 0 où 1 - arrondi à 1ct

- 2 - arrondi à 5ct

- 3 arrondi à 1chf

cCurrencyCode ISO Code of the currency in which the prices has to be returned.
nPriceTableNr Number of the price table to be returned
cCategoryName Name of the only category to be returned
bNoPictures Allows not to return the pictures associates with the items. 

 

EXAMPLE

*/ Return the first 100 items

{
      "Method": "Products",
      "Parameters": [
            0
       ]
}

*/ Return the first 100 items having an ID (ar_numero) bigger than 54879

{
      "Method": "Products",
      "Parameters": [
            54789
       ]
}

*/ Return the first 100 items created or modified after the 01.01.2017.

{
      "Method": "Products",
      "Parameters": [
            0,
            "2017-01-01"
      ]
}

*/ Return the first 100 items having an ID (ar_numero) bigger than 23487 and having been created or modified after the 01.01.2017.

{
      "Method": "Products",
      "Parameters": [
            23487,
            "2017-01-01"
      ]
}

 

CLASS RETURNED

Property Description
Id Item id
StockQuantity Quantity available in stock
Code Item Code (ar_code)
BarCode Item BarCode
Price Item price (according to the parameters passed to the method).
PurchasePrice Item purchase price
CreationDate Date of the creation of the item
LastUpdateDate Date of the last modification of the item
Unit Item unit
Weight Weight of the article in kg
Availability True means that the item can be sold. False means that the item is not resellable anymore.
AccountingMethod

Id of the accounting method of the item.

More details about the AccountingMethod (VAT rate, Included or Not included, etc.) can be returned via the method CptMod.

ShortDescriptionFrench Short description of the item, in french
ShortDescriptionGerman Short description of the item, in german
ShortDescriptionItalian Short description of the item, in italian
ShortDescriptionEnglish Short description of the item, in english
ShortDescriptionOtherLanguage Short description of the item, in the language specified as Other in Winbiz
LongDescriptionFrench Long description of the item, in french
LongDescriptionGerman Long description of the item, in german
LongDescriptionItalian Long description of the item, in italian
LongDescriptionEnglish Long description of the item, in english
LongDescriptionOtherLanguage Long description of the item, in the language specified as Other in Winbiz
CategoryId Id of the Category of the Item
BrandId Id of the Brand of the Item
MiscellaneousField1 Miscellaneaous Field number 1
MiscellaneousField2 Miscellaneaous Field number 2
MiscellaneousField3 Miscellaneaous Field number 3
MiscellaneousField4 Miscellaneaous Field number 4
MiscellaneousField5 Miscellaneaous Field number 5
MiscellaneousField6 Miscellaneaous Field number 6
MiscellaneousField7 Miscellaneaous Field number 7
MiscellaneousField8 Miscellaneaous Field number 8
MiscellaneousField9 Miscellaneaous Field number 9
MiscellaneousField10 Miscellaneaous Field number 10
MiscellaneousField11 Miscellaneaous Field number 11
MiscellaneousField12 Miscellaneaous Field number 12
Pictures Pictures, encoded in base 64, that are associated to each Item

 

Did you find this article useful?

0 out of 1 found this helpful