1-4 additions
Neteven has enriched its WSDL with new fields as described below.
To manage these fields, please integrate the new URL: https://ws1-4.neteven.com/NWS
No other change has been operated. It is compliant with the previous WSDL.
- Arrayofmedias in PostItems and GetItems. (refer to changes tagged as ‘1.4 additions part 1’)
- Arrayofprices in PostItems and GetItems. (refer to changes tagged as ‘1.4 additions part 2’)
- ArrayofAdditionalfields in GetItems Response, PostItems Body, GetOrders Response, PostOrders Body, PostItemsStock Body. (refer to changes tagged as ‘1.4 additions part 3’)
- ArrayOfExtraFilterFields in GetItems Body, GetOrders Body and GetItemsStock. (refer to changes tagged as ‘1.4 additions part 4’)
- Currency Management for Array of Prices (International Management). (refer to changes tagged as ‘1.4 additions part 5’)
- GetItemsStock and PostItemsStock: New resources created to manage stock in warehouses. (refer to changes tagged as ‘1.4 additions part 6’)
Please refer to the individual sections for detailed updates.
GetItems Response, PostItems Body, GetOrders Response, PostOrders Body, PostItemsStock Body
‘1.4 additions part 3’ start here
For all these, we are going to add a place holder array named: ArrayOfAdditionalFields that will allow us to add more fields in the future without actually having to update the WSDL.
Example :
\<ns1\:ArrayOfAdditionalFields>
\<ns1\:AdditionalField>
\<ns1\:Name>xyz\</ns1\:Name>
\<ns1\:Value>abc\</ns1\:Value>
\</ns1\:AdditionalField>
\</ns1\:ArrayOfAdditionalFields>Except for GetOrders, This is currently a placeholder without any values. This is added so that we can use this in future without having to add more fields into the webservices.
‘1.4 additions part 3’ end here
GetItems Body, GetOrders Body and GetItemsStock
‘1.4 additions part 4’ start here
ArrayOfExtraFilterFields: this array will act as a filter also that will allow the merchants to fetch specific products without having to fetch the entire data.
Example :
\<ns1\:ArrayOfExtraFilterFields>
\<ns1\:ExtraFilterField>
\<ns1\:Name>xyz\</ns1\:Name>
\<ns1\:Value>abc\</ns1\:Value>
\</ns1\:ExtraFilterField>
\</ns1\:ArrayOfExtraFilterFields>This is currently a placeholder without any values. This is added so that we can use this in future without having to add more fields into the webservices.
‘1.4 additions part 4’ end here
International Management
Neteven now handles prices in multiple currencies and text in several languages.
In order to use these functionalities, you must adapt your communications in order to indicate:
- The language identifier: language_id whose values follow the ISO 639-1 norm
- The currency identifier: currency_id whose values follow the ISO 4217 norm
Examples:
Language code | **** | Currency code | **** |
|---|---|---|---|
| language_label | | currency_label |
ISO 639-1 | **** | ISO 4217 | |
fr | French | EUR | Euros |
de | German | EUR | Euros |
en | English | GBP | Sterling Pound |
es | Spanish | EUR | Euros |
it | Italian | EUR | Euros |
nl | Dutch | EUR | Euros |
Below is an example of xml formulated with this information:
<ns1:FixedPrice currency_id=”EUR”>25.00</ns1:FixedPrice>
Specific fields are available in several languages. Notice that In order to have a multilingual support, you’ve got to send the text fields (title, description, comments,…) among the specific fields.
Text fields should be sent with specific fields in the corresponding Array:
\<ns1\:SpecificField lang=”en”>
\<ns1\:Name>couleur\</ns1\:Name>
\<ns1\:Value>yellow\</ns1\:Value>
\</ns1\:SpecificField>Underneath, an array containing the languages and currencies availables:
Refers currencyEnum section in the wsdl
Currency code
Currency_id | currency_label |
|---|---|
AUD | Australian Dollar |
CAD | Canadian Dollar |
DKK | Danish crown |
EUR | Euro |
GBP | Livre sterling |
JPY | Yen |
MYR | Ringgit |
RMB | Yuan |
USD | US Dollar |
‘1.4 additions part 5’ start here
Prices are available in several currencies.
Text fields should be sent with specific fields in the corresponding Array:
\<ns1\:Price>
\<ns1\:Name currency\_id = “EUR”>Price\_Fixed\</ns1\:Name>
\<ns1\:Value>10.99\</ns1\:Value>
\</ns1\:Price>‘1.4 additions part 5’ end here
Refers to langEnum section in the wsdl
Language code | ** ** |
|---|---|
language_id | language_label |
de | German |
en | English |
en_US | American |
es | Spanish |
fr | French |
It | Italian |
ja | Japanese |
ms | Malaysian |
nl | Dutch |
zh | Chinese |
Fields (previous update)
Click & Collect feature Point Relais and Relais
2 new fields are available in the GetOrders method
\<xsd\:complexType name=”MarketPlaceAddress”>
\<xsd\:sequence>
…
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”RelayName” type=”xsd\:string”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”RelayId” type=”xsd\:string”/> 
\</xsd\:sequence>
\</xsd\:complexType>New Price fields
- 10 price fields and 10 image fields
- Cost Price fields has been move next to the other price fields.
They are all available in the GetItems and PostItems calls:
\<xsd\:complexType name=”InventoryItem”>
\<xsd\:sequence>
….
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”Cost” type=”tns\:price”/> (changement de place)
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceFixed” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceStarting” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceReserved” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceRetail” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceSecondChance” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceBestOffer” type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional1″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional2″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional3″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional4″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional5″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional6″ type=”tns\:price”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional7″ type=”tns\:price”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional8″ type=”tns\:price”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional9″ type=”tns\:price”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional10″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional11″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional12″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional13″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional14″ type=”tns\:price”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”unbounded” name=”PriceAdditional15″ type=”tns\:price”/>
….
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image1″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image2″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image3″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image4″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image5″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image6″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image7″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image8″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image9″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image10″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image11″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image12″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image13″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image14″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image15″ type=”xsd\:string”/>
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Image16″ type=”xsd\:string”/>
….
\</xsd\:sequence>
\</xsd\:complexType>New field PriceHT to get the price without VAT for an order line and EAN product’s are available in the GetOrders method:
\<xsd\:complexType name=”MarketPlaceOrder”>
\<xsd\:sequence>
….
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”EAN” type=”xsd\:string”/>
….
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”PriceHT” type=”tns\:price”/>
….
\</xsd\:sequence>
\</xsd\:complexType>New filters in the GetOrders
\<xsd\:element name=”GetOrders”>
\<xsd\:complexType>
\<xsd\:sequence>
….
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”MarketPlaceOrderId” type=”xsd\:string”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”OrderLineID” type=”xsd\:string”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”Status” type=”xsd\:string”/> 
\<xsd\:element minOccurs=”0″ maxOccurs=”1″ name=”WarehouseShippable” type=”xsd\:boolean”/>
\</xsd\:sequence>
\</xsd\:complexType>
\</xsd\:element>NOTE : Please note that responses contains all order lines for an order when at least an order line correspond to a filter