---
title: Items
slug: webservices-v1/items
createdAt: 2022-07-01T07:59:35.000Z
---
## GetItems: Synchronize Products
The getItems method sends back all the products referenced in the inventory. Note that the getItems response is in several parts. The number of products sent back is limited to 200 each time, so you have to do several getItems requests to receive your full inventory.
**Entry parameters**
| **Field** | **Type/Size** | **Remarks** |
| -------------------- | ------------- | ---------------------------------------------------- |
| PageNumber | Integer | Result page number |
| DateModificationFrom | DateTime | Sends back only the products updated after this date |
| SKU | String | Sends back only the products matching with this SKU |
**Results of the method**
| **Field** | **Type/Size** | **Remarks** |
| ----------------- | ------------------------- | ------------------------------------ |
| nb\_pages integer | Integer | Total number of pages (parts) |
| nb\_items integer | Integer | Number of Products |
| cur\_page intege | Integer | Current page |
| Items | tns\:ArrayOfInventoryItem | Results tables (product information) |
***
## PostItems: Inventory Import
Synchronising your inventory with Neteven is done through the **postItems method, **which can either be used to create or to update a product.
Synchronisation is based on the Stock Keeping Unit (SKU) of a product.
PostItems request has to include a list of items elements that conform with the **InventoryItem** type described in the WSDL.
The number of fields characterising an **InventoryItem **element type allow you to make a very detailed indexation of your products.
Please note that apart from the SKU no field is mandatory to send a request, therefore you can regularly send simple updates such as SKU and quantity.
Some information can be sent in several languages:
- Title
- Subtitle
- Description
- Remark (Commentaire)
- Specific fields (Champs spécifiques)
To provide the langage of one of these fields, you must specify the value of the **language\_id** attribute in the matching tag. Example :
…
\Needle\
\Aiguille\
…
With regard to specific fields, the **ArrayOfSpecificFields** parameter allows you to send this information for each of your products. Example :
```xml
\couleur\
\yellow\
```
Also, some information is available according to the currency:
- Prix Fixe (Fixed price)
- Prix de depart (Starting price)
- Prix de reserve (Reserve price)
All price information is now available in several currencies.
A **postItems** request can include different product categories (specific fields of each category will be taken into account).
*Note: in a single request, an item must only be returned once.*
***‘1.4 additions part 1’ start here***
With regard to additional images and other medias, the **ArrayOfMedias **parameter allows you to send this information for each of your products.
**Media type**: Image (Currently only images are available as media type)
- (image1 \~ image50)
**Example :**
```xml
\image1\
\www\.image.com\
```
***‘1.4 additions part 1’ end here***
***‘1.4 additions part 2’ start here***
With regard to price fields, the **ArrayOfPrices **parameter allows you to send this information for each of your products.
- price\_fixed
- price\_starting
- price\_reserved
- price\_retail
- price\_second\_chance
- price\_best\_offer
- price\_additional\_1 \~ price\_additional\_250
- price\_shipping\_local\_1 \~ price\_shipping\_local\_20
- price\_shipping\_int\_1 \~ price\_shipping\_int\_20
- price\_shipping\_supp\_local\_1 \~ price\_shipping\_supp\_local\_20
- price\_shipping\_supp\_int\_1 \~ price\_shipping\_supp\_int\_20
**Example :**
```xml
\price\_fixed\
\10.99\
```
*********‘1.4 additions part 2’ end here******.***
**Entry parameters**
| **Field** | **Type** | **Remarks** |
| --------- | -------------------- | ------------------- |
| Items | ArrayOfInventoryItem | InventoryItem array |
**Description of InventoryItem type data**
| **Field** | **Type/Size** | **Remarks** |
| --------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Title | string\[255]
| Product title |
| SubTitle | string\[255]
| Subtitle |
| Description | Text | Product description |
| Comment | Comment | Remarks, if any |
| SKU | string\[50]
| Stock Keeping Unit – product ID |
| SKUFamily | String\[50]
| Family Stock Keeping Unit – Family identifier |
| Brand | String | Product brand |
| EAN | String | EAN code |
| UPC | String | UPC code |
| ISBN | String | ISBN code |
| ASIN | String | ASIN code |
| PartNumber | String | Other product Code (apart from EAN,ISBN,ASIN) |
| Quantity | Integer | Available quantity in stockCan be updated by the merchant |
| QuantityAvailable | Integer | Available quantity, calculated from Neteven by a substraction between
the quantity from the merchant and the stock reserved by unshipped
orders.Can’t be updated by the merchant |
| QuantityReserved | Integer | Reserved quantity calculated from Neteven by the stock from the merchant and the total stock from unshipped orders in NetevenCan’t be updated by the merchant |
| Cost | Price | Buying Price |
| Tva | Double | Cost of Vat including ecotax |
| Ecotaxe | Double | Amount of ecotax including tax as it’s considered as a merchant service |
| PriceFixed | Price | Fixed Price |
| PriceStarting | Price | (ebay) Starting price for bid listings |
| PriceReserved | Price | (ebay) Reserve Price |
| PriceRetail | Price | Retail Price |
| PriceSecondChance | Price | (ebay) Second Chance Price (not used) |
| PriceBestOffer | Price | Best Offer Price (not used) |
| PriceAdditional1 to 15 | Price | Additional field allowing merchants to specify special selling prices for definite periods (fall, winter (…) sales, …) |
| Etat | Enum (integer) | 0: Not specified1: Used –Like new2: Used – Very good condition3: Used – Good condition4: Used – Correct condition5: Collector – Like New6: Collector – Very good condition7: Collector – Good condition8: Collector – Correct condition9: Refurbished by the Seller10: Refurbished by the Manufacturer11: New (with tag/packaging)12: New (without tag/packaging)13: New with flaws15: For spare parts/out of order16: Refurbished – Like new17: Refurbished – very good condition18: Refurbished – good condition19: Recondionated – correct state |
| LotSize | integer | If a lot: number of products |
| Classification | String | Product categorization, for example \:Movies/DVD |
| Weight | Double | |
| Height | Double | \*\* \*\* |
| Width | Double | \*\* \*\* |
| Depth | Double | \*\* \*\* |
| PriceShippingLocal1 à 3 | Price | Shipping costs (local) |
| PriceShippingSuppLocal1 à 3 | Price | Additional shipping costs (local) |
| PriceShippingInt1 à 3 | Price | Shipping costs (international) |
| PriceShippingSuppInt1 à 3 | Price | Additional shipping costs (international) |
| ShippingDelay | Integer | Shipping delay |
| Image1 to Image16 | string\[255]
| Product photo URL |
| WarehouseId | Double | Warehouse ID (reading only) |
| WarehouseStock | Double | Warehouse available stock (reading only) |
| WarehouseShipped | Double | Stock waiting to be received by external warehouse (FBA) |
| ArrayOfSpecificFields | ArrayOfSpecificFields | List of Specific Fields (see WSDL) |
| ArrayOfMedias | ArrayOfMedias | List of Medias (see WSDL) |
| ArrayOfPrices | ArrayOfPrices | List of Prices (see WSDL) |
**Results of the method**
| **Field** | **Type/Size** | **Remarks** |
| ----------------- | ------------------------- | ------------------------------ |
| nb\_pages integer | Integer | Total number of pages (parts) |
| nb\_items integer | Integer | Number of Products |
| cur\_page intege | Integer | Current page |
| Items | tns\:ArrayOfInventoryItem | List of elements InventoryItem |
**Extract of a PHP5 script: Execution of a postItems request or the creation of two products with specific fields**
::Image[]{src="https://api.archbee.com/api/optimize/ghphd2IJMfAWqrLDyV5lf/51vYp69GHT3njMJdrhWzz_image.png" size="50" isUploading="false" showCaption="false"}
::Image[]{src="https://api.archbee.com/api/optimize/ghphd2IJMfAWqrLDyV5lf/paq1ps1SZAJg_p-pugNCK_image.png" size="50" isUploading="false" showCaption="false"}
::Image[]{src="https://api.archbee.com/api/optimize/ghphd2IJMfAWqrLDyV5lf/zKBRGT_gPWhY33IMkj3gz_image.png" size="50" isUploading="false" showCaption="false"}
::Image[]{src="https://api.archbee.com/api/optimize/ghphd2IJMfAWqrLDyV5lf/5HaOff4STfHAJ2uNmG8HS_image.png" size="50" isUploading="false" showCaption="false"}
Apart from the InventoryItemStatusResponse value, a **postItems** response encloses a summary table for each product with the errors encountered during the upload, if any (in general, a missing mandatory value).
Please note that for large uploads we recommend you separate the postItems request into several parts.