# Version History



<table data-header-hidden><thead><tr><th width="123">Versie</th><th width="117">Datum      </th><th width="126.1395211825826">Auteur</th><th width="356.8604788174174">Reden van wijziging</th></tr></thead><tbody><tr><td>Versie</td><td>Datum      </td><td>Auteur</td><td>Reden van wijziging</td></tr><tr><td>1.0</td><td>28-01-2015</td><td></td><td>Original version</td></tr><tr><td>2.0</td><td>29-11-2016</td><td>Roland Vonk</td><td>Updating of all interfaces</td></tr><tr><td>2.1</td><td>2-12-2016</td><td>Peter Leermakers</td><td>Extension of the Customer Information Interface with VAT number and GLN. Casing of element names corrected in interface description. FirstName, MiddleName and LastName fields added to description. Casing of elements corrected in description Gross price information interface.</td></tr><tr><td>2.1.1</td><td>5-12-2016</td><td>Eddie Reinhoudt</td><td>Expansion of the gross price list with tiers</td></tr><tr><td>2.2</td><td>7-12-2016</td><td>Peter Leermakers</td><td>Batch interface extension1 with Customer XML 2.0 definition</td></tr><tr><td>2.3</td><td>14-12-2016</td><td>Weiwen Lau</td><td>Update realtime interface: StemService globally replaced by ShoxlService; complex types placed with methods for clarity</td></tr><tr><td>2.4</td><td>16-1-2017</td><td>Peter Leermakers</td><td>Identification element removed as part of Customer ImportSettings. From now on, the way a customer is identified is regulated by a setting in Vendisto.</td></tr><tr><td>2.5</td><td>23-1-2017</td><td>Peter Leermakers</td><td>The vendisto setting 'Customer identifying property' determines whether the Debit number must be unique and is mandatory for customer import. Customer import extended with PartialUserImport setting.</td></tr><tr><td>2.6</td><td>24-2-2017</td><td>Weiwen Lau</td><td>Filter type possibilities of the method GetOrderHistory adjusted. "Jobnumber" and "order placed by name" removed. </td></tr><tr><td>2.7</td><td>18-05-2017</td><td>Roland Vonk</td><td>PlaceOrder Web service type Order extended with Orderstate (open/closed). type Orderline extended with status 0 (open) and status names changed (1 = backordered, 2 = shipped instead of shipped/delivered, 3 = cancelled instead of cancelled/credited). Added field QuantityNotShipped to Orderline. Address type Invoicing changed to Invoice. Added new webservice GetInvoice, which returns an invoice in PDF format. Added component GrossPriceExclVAT to OrderLine</td></tr><tr><td>2.8</td><td>07-06-2017</td><td>Roland Vonk</td><td>Added AccountNumber as a mandatory field when querying both OrderHistoryDetail and InvoiceHistoryItem, so that this function can also be used outside the context of OrderHistory and InvoiceHistory for searching Orders/Invoices by customers.</td></tr><tr><td>2.9</td><td>27-6-2017</td><td>Peter Leermakers</td><td>In sample XML from CustomerImport, UserName node has been changed to Username.</td></tr><tr><td>2.10</td><td>11-7-2017</td><td>Peter Leermakers</td><td>Import of discount prices added at gross price interface.</td></tr><tr><td>2.11</td><td>19-10-2017</td><td>Roland Vonk</td><td>AddressType Value Invoice changed to Invoicing </td></tr><tr><td>2.12</td><td>13-12-2017</td><td>Peter Leermakers</td><td><p>Description Authorization interface</p><p>Extension Customer interface with Authorization Element</p></td></tr><tr><td>2.13</td><td>15-3-2018</td><td>Peter Leermakers</td><td>Adjustment Explanation Authorisation interface</td></tr><tr><td>2.14</td><td>06-04-2018</td><td>Peter Leermakers</td><td>Superfluous space removed in XML declaration Legacy Customer interface</td></tr><tr><td>2.15</td><td>11-04-2018</td><td>Peter Leermakers</td><td>Expansion of Customer interface with Authorisation element at User level</td></tr><tr><td>2.16</td><td>25-4-2018</td><td>Peter Leermakers</td><td>Extension of the customer interface with e-mail address and BuyOnCredit at user level</td></tr><tr><td>2.17</td><td>23-08-2107</td><td>Roland Vonk</td><td>Formatted / removed formatting errors in section “Structuur Customer XML”</td></tr><tr><td>2.18</td><td>27-08-2018</td><td>Kristian Jacobs</td><td>Added PreferredBranche to Customer</td></tr><tr><td>2.19</td><td>27-09-2018</td><td>Peter Leermakers</td><td><p>Added description for pagenumber of GetOrderHistoryResult</p><p>Replaced tempuri.org namespace by shoxl.com for realtime interfaces</p><p>Type of InvoicePdf in GetInvoiceResult changed to base64Binary</p><p>Updated cardinality of ArrayOfOrderLineRequest</p><p>Updated namespaces in element names realtime interfaces</p><p>Added reference to WSDL document for realtime interfaces</p></td></tr><tr><td>2.20</td><td>01-10-2018</td><td>Kristian Jacobs</td><td>Added OrderNumber to the PlaceOrderResult object</td></tr><tr><td>2.21</td><td>30-11-2018</td><td>Peter Leermakers</td><td>Correction of FTP server specifications. The FTP server supports FTPS and not SFTP.</td></tr><tr><td>2.22</td><td>10-12-2018</td><td>Peter Leermakers</td><td>Zipped format is now also supported for Authorization import</td></tr><tr><td>2.23</td><td>05-03-2019</td><td>Roland Vonk</td><td>Added clarification of Authorization working principle.</td></tr><tr><td>2.24</td><td>11-03-2019</td><td>Peter Leermakers</td><td>StreetAddress1, PostalCode, City and Country are no longer optional under Loose ValidationType of Customer import</td></tr><tr><td>2.25</td><td>12-03-2019</td><td>Peter Leermakers</td><td>Added currency to batch price interface</td></tr><tr><td>2.26</td><td>20-06-2019</td><td>Peter Leermakers</td><td>Added currency attribute to DiscountPriceExclVat element in batch price interface</td></tr><tr><td>2.27</td><td>05-07-2019</td><td>Peter Leermakers</td><td>ERP Cache import formats</td></tr><tr><td>2.28</td><td>09-07-2019</td><td>Peter Leermakers</td><td>Description of Order XML Export Batch interface format</td></tr><tr><td>2.29</td><td>19-07-2019</td><td>Aleksandar Staykov, Peter Leermakers</td><td>Added description of Article XML import format</td></tr><tr><td>2.30</td><td>22-07-2019</td><td>Peter Leermakers</td><td>Added suggested retail price field to gross price batch import</td></tr><tr><td>2.31</td><td>26-08-2019</td><td>Peter Leermakers</td><td>Added ERP Cache import format for exchange rates. Fixed error in description of ERP Cache CustomerPrice interface.</td></tr><tr><td>2.32</td><td>06-09-2019</td><td>Peter Leermakers</td><td>Added description of settings on Article XML import</td></tr><tr><td>2.33</td><td>08-10-2019</td><td>Peter Leermakers</td><td>Added Coc Number to Order XML Export format</td></tr><tr><td>3.0</td><td>12-11-2019</td><td>Peter Leermakers</td><td>Definition of Customer XML version 2.1</td></tr><tr><td>3.1</td><td>9-1-2020</td><td>Peter Leermakers</td><td>Added ExternalId to CustomerAddress element in Customer XML import format</td></tr><tr><td>3.2</td><td>3-2-2020</td><td>Peter Leermakers</td><td>Updated Webservice wsdl to ShoxlWebService_v3.wsdl. Updated Shipping and Billing order address fields in webservice definition. </td></tr><tr><td></td><td>6-2-2020</td><td>Peter Leermakers</td><td>Fixed fault in description of CustomerAddress AddressType element in customer batch import. Changed 'Invoice' to 'Invoicing'.</td></tr><tr><td></td><td>11-2-2020</td><td>Peter Leermakers</td><td>Removed PartialUserImport node from customer batch import example</td></tr><tr><td>3.3</td><td>11-2-2020</td><td>Peter Leermakers</td><td>Added ERP Cache import format for delivery dates</td></tr><tr><td>3.4</td><td>12-3-2020</td><td>Peter Leermakers</td><td>Renamed ERP Cache DeliveryDate batch interface to ProductDeliveryScheme. Added MaximumOrderDate element.</td></tr><tr><td>3.5</td><td>26-3-2020</td><td>Roland Vonk</td><td>Changed description of Authorization Import to clarify that authorizations also apply to general content, not just product info</td></tr><tr><td></td><td>20-4-2020</td><td>Peter Leermakers</td><td>Added AuthorizationProfiles to Article XML import Batch interface</td></tr><tr><td></td><td>25-5-2020</td><td>Peter Leermakers</td><td>Added DeliveryDate to Order Export XML format</td></tr><tr><td>3.6</td><td>22-6-2020</td><td>Peter Leermakers</td><td>Added WarehouseId to ERP Cache Stock Batch data format</td></tr><tr><td>3.7</td><td>16-9-2020</td><td>Kristian Jacobs</td><td>Added UserRestrictedProducts and ProfileRestrictedProducts import description</td></tr><tr><td></td><td>19-11-2020</td><td>Peter Leermakers</td><td>Version 2.2 of Customer import batch interface</td></tr><tr><td>3.8</td><td>15-2-2021</td><td>Peter Leermakers</td><td>Quantity and RemainingQuantity elements in ERP Cache Order XML format were changed from Integer to Decimal. Quantity element in Order Export XML definition was also changed from Integer to Decimal.</td></tr><tr><td></td><td>17-2-2021</td><td>Peter Leermakers</td><td>Updated description of NettoPricePerItemExclVat fields in GetProductInformation Webservice call and in PriceList and CustomerPrice ERP Cache batch formats.</td></tr><tr><td>2021.1</td><td>17-2-2021</td><td>Peter Leermakers</td><td>Added DeliverySchemeCode to ERP Cache Customer and ERP Cache DeliverySchemes Batch import formats.</td></tr><tr><td></td><td>17-2-2021</td><td>Peter Leermakers</td><td>Added description of ERP Cache Cleanup import format</td></tr><tr><td>2021.3</td><td>24-3-2021</td><td>Peter Leermakers</td><td><p>Changed type of stock field from int to decimal in GetProductInformation webservice. Updated interface definition to ShoxlWebService_v4.wsdl.</p><p>Updated ErpCache_Stock XML from version 1.1 to 1.2. The stock import now supports decimal values for stock.</p></td></tr><tr><td></td><td>29-3-2021</td><td>Peter Leermakers</td><td>Added description of ERP Cache Invoice history import format.</td></tr><tr><td>2021.4</td><td>1-4-2021</td><td>Peter Leermakers</td><td>Added ERP Cache OrderDocument import format</td></tr><tr><td></td><td>22-4-2021</td><td>Peter Leermakers</td><td><p>Updated ErpCache_PriceLists XML from version 1.0 to 1.1.<br>Updated ErpCache_CustomerPrices XML from version 1.0 to 1.1.</p><p>Added Currency attributes on both import formats in order to support prices in multiple currencies without the need to use Exchange rates in the ERP Cache.</p></td></tr><tr><td>2021.6</td><td>19-07-2021</td><td>Christian de Koning</td><td><p>Updated ERPCache_CustomerPrices XML from version 1.1 to 1.2</p><p>Added VatCode, BaseUnit and PriceUntit to the customer price import</p></td></tr><tr><td>2021.7</td><td>23-7-2021</td><td>Peter Leermakers</td><td>Definition of a REST API version of the realtime interface as an alternative for the SOAP API.</td></tr><tr><td>2021.9</td><td>2-8-2021</td><td>Peter Leermakers</td><td><p>Made some small adjustments to ShoxlRestApiSwagger_v1.json on order to let the REST interface comply more with the WSDL interface. The following fields are now nullable: <em>stock</em> and <em>PriceUnit</em> on <em>GetProductInformationResult</em>, <em>orderDate</em> and <em>PaymentMethodCode</em> on <em>Order</em>, <em>FilterType</em> on <em>GetOrderHistoryRequest</em>, <em>TotalPriceExclVat</em> and <em>TotalPriceInclVat</em> on <em>OrderHistoryItem</em> and <em>TotalOutstanding</em> and <em>TotalPrice</em> on <em>InvoiceHistoryItem</em>.</p><p></p></td></tr><tr><td>2021.9</td><td>3-8-2021</td><td>Peter Leermakers</td><td>Added paragraph on webservice security.</td></tr><tr><td>2021.9</td><td>27-9-2021</td><td>Roland Vonk</td><td>Added explanation to the article batch import, regarding the exact working of the partial import</td></tr><tr><td>2021.10</td><td>11-10-2021</td><td>Peter Leermakers</td><td>Added preferredDeliveryDate to REST API definition of PlaceOrder Webservice. Introduced ShoxlRestApiSwagger_v2.json</td></tr><tr><td>2021.12</td><td>8-12-2021</td><td>Peter Leermakers</td><td>Added orderState to result of GetOrderHistory webservice. Introduced ShoxlWebService_v5.wsdl and ShoxlRestApiSwagger_v3.json</td></tr><tr><td>2021.12</td><td>8-12-2021</td><td>Christian de Koning</td><td>Added RelatedProductNumber and Type to orderline to the result of CalculateOrder webservice</td></tr><tr><td>2021.12</td><td>9-12-2021</td><td>Peter Leermakers</td><td>Added comment on 1-based pagenumbering for GetOrderHistory and GetInvoiceHistory webservices.</td></tr><tr><td>2021.12</td><td>14-12-2021</td><td>Peter Leermakers</td><td>Added description of LineNumber element in ErpCache_Order import format.</td></tr><tr><td>2021.12</td><td>15-12-2021</td><td>Peter Leermakers</td><td>Added comment to default number of orders/invoices on GetOrderHistory/GetInvoiceHistory webservices.</td></tr><tr><td>2021.12</td><td>16-12-2021</td><td>Peter Leermakers</td><td>Added comment on format of Decimal field in batch interfaces.</td></tr><tr><td>2021.12</td><td>21-12-2021</td><td>Peter Leermakers</td><td>Added paragraph headings for the SOAP API descriptions in the webservices documentation.</td></tr><tr><td>2021.12</td><td>24-12-2021</td><td>Peter Leermakers</td><td>Added ArticleNumber, CostLineType and DiscountPercentage elements to CostLine of Order Export XML</td></tr><tr><td>2022.1</td><td>27-1-2022</td><td>Peter Leermakers</td><td>Changed PriceInclVat for Required to Optional in Gross Prices Import.<br>Added General Patterns section in ERP Integration Guid with pages on Import file naming and zipped XML.<br>Added Currency and Incoterm elements to description of Customer XML import format.</td></tr><tr><td>2022.1</td><td>3-2-2022</td><td>Peter Leermakers</td><td>Removed stockindication codes 1, 2 and 3 from description ErpCache Stock Importer</td></tr><tr><td>2022.1</td><td>4-2-2022</td><td>Peter Leermakers</td><td>BaseUnit and PriceUnit are now marked as Required in the Gross Prices import</td></tr><tr><td>2022.1</td><td>9-2-2022</td><td>Peter Leermakers</td><td>Added GIROPAY, UBERWEISUNG, APPLEPAY and BANCONTACT to definition of OrderXML Batch export</td></tr><tr><td>2022.1</td><td>11-2-2022</td><td>Peter Leermakers</td><td>Added CustomOrderFields field on OrderLine to REST API definition of PlaceOrder Webservice.<br>Introduced ShoxlRestApiSwagger_v4.json</td></tr><tr><td>2022.3</td><td>8-3-2022</td><td>Peter Leermakers</td><td>Added description of Package Units Import batch interface. Added General Pattern page on Package Units import.<br>Added optional AdditionQuantity field on Gross Prices Import.<br>Added DeleteNotImportedProperties import option to Article XML Import.<br>Incoterm field on customer is no longer restricted to 3 characters.</td></tr><tr><td></td><td>11-3-2022</td><td>Peter Leermakers</td><td><p>Added shippingCountry to REST API defintion of CalculateOrder Webservice. </p><p>Removed Required attribute from ExternalOrderNumber of request on  CalculateOrder WebService</p><p>Introduced ShoxlRestApiSwagger_v5.json</p></td></tr><tr><td></td><td>14-3-2022</td><td>Peter Leermakers</td><td>Added DeliveryEmailAddress and DeliveryPhoneNumber to Order Export XML format. Updated to xsd version OrderXmlExport_v6.xsd.</td></tr><tr><td></td><td>17-3-2022</td><td>Peter Leermakers</td><td>Added description of MatchOwnArticleNumbers enpoint to REST API.</td></tr><tr><td></td><td>23-3-2022</td><td>Peter Leermakers</td><td>Added GetProductInformations REST API endpoint as a replacement of the GetProductInformation endpoint. Introduced ShoxlRestApiSwagger_v6.json.<br>Added shippingCountry example to CalculateOrder REST API.</td></tr><tr><td></td><td>28-3-2022</td><td>Peter Leermakers</td><td>Added ArticleGroupDefaultTitle and EnableArticleGroupSplitting import settings of Article XML import.</td></tr><tr><td></td><td>4-4-2022</td><td>Peter Leermakers</td><td>Introduced type on OrderLine of REST API PlaceOrder webservice</td></tr><tr><td>2022.4</td><td>26-4-2022</td><td>Peter Leermakers</td><td>Introduced OrderLineType on ErpCache Order History</td></tr><tr><td></td><td>13-5-2022</td><td>Peter Leermakers</td><td>Added PartialImport import setting to ErpCache PriceLists XML format.</td></tr><tr><td>2022.5</td><td>28-6-2022</td><td>Peter Leermakers</td><td>Added extra description on discountAmountPerItemExclVat fields in API.</td></tr><tr><td></td><td>4-7-2022</td><td>Peter Leermakers</td><td>Correction of GetProductInformations request example</td></tr><tr><td>2022.7</td><td>6-7-2022</td><td>Peter Leermakers</td><td>Added GetReturnOrders and GetReturnOrderDetail REST endpoints to Webservice definition. Introduced ShoxlRestApiSwagger_v7.json.</td></tr><tr><td>2022.7</td><td>13-7-2022</td><td>Peter Leermakers</td><td>Updated ImportSettings Version number in example XML of ErpCache_CustomerPrices batch file.</td></tr><tr><td>2022.7</td><td>27-7-2022</td><td>Peter Leermakers</td><td>Added InvoiceTo field to Customer and ErpCache_Customer XML formats.<br>Updated default name of Importer node of Articles XML import.<br>Added PartialImport element to ERP Cache CustomerPrices import settings.</td></tr><tr><td>2022.7</td><td>29-7-2022</td><td>Peter Leermakers</td><td>Introduction of taxPercentage in REST API. The vatCode field is replaced by taxPercentage in CalculateOrder, PlaceOrder and GetOrderHistoryDetails. TaxPercentage is introduced as a new field in GetProductInformations next to vatCode, which is preserved for backwords compatiblity reasons but is also marked as deprecated.</td></tr><tr><td>2022.9</td><td>12-9-2022</td><td>Peter Leermakers</td><td>Added PreferredDeliveryDate on order level to Order XML export format.</td></tr><tr><td></td><td>10-10-2022</td><td>Peter Leermakers</td><td>Marked OrderDate as a required element in the ErpCache Order history import format. </td></tr><tr><td>2022.11</td><td>7-11-2022</td><td>Peter Leermakers</td><td>Added ErpCache Customer Products import format. With this import format it is possible to disclose customer specific productnumers in the shop.</td></tr><tr><td></td><td>8-11-2022</td><td>Peter Leermakers</td><td>Introduction of GetCustomerProducts and MatchCustomerProducts REST API endpoints. These endpoints replace the MatchOwnArticleNumbers endpoint.</td></tr><tr><td></td><td>23-12-2022</td><td>Peter Leermakers</td><td>PriceListNumber of Gross Prices Import is a legacy field and made optional.</td></tr><tr><td>2023.2</td><td>2023-02-06</td><td>Antoine Granpre Moliere</td><td>Price fields made nullable for results of Calculate Order and GetProductInformations</td></tr><tr><td>2023.3</td><td>3-3-2023</td><td>Peter Leermakers</td><td>Replaced VatCode element by VatPercentage in GrossPrices XML format as well as in ERP Cache PriceList, CustomerPrice and Order history formats.</td></tr></tbody></table>

