v202 | desco.be

Version 2.02 of the Desco API is active since 18 June 2021 (beta) and released 08 Juli 2022. It is superseded by versie 2.03

Changes in Version 2.02

New api endpoint urls (version change).
remove some obsolete and empty tags in GetAllProducts
activate RateLimit on GetAllProducts
added additional field "ProductHierarchy" in GetBasket, PVCheck and GetAllProducts (2021-09-22)
added new call GetOrder (2021-11-08)
added status 9 to documentation

Introduction

You can interact with Desco with a small set op REST calls over https. This allows the partner to choose any platform/technology to implement an integration.

The calls are specific for each partner. Wherever you encounter the word “yourpartnerid”, just replace it with the partner-alias that Desco gives you (after simple request).

Careful with xml values

Remember, values in XML all have to be HtmlEncoded, meaning some special characters need to be encoded:

ampersand: & --> &
greater-than: > --> >
less-than: < --> <
apostrophe: ’ --> '
quote: ” --> "

Response Status

Every Response will return a Status.

Responses regarding Products will return a global status as well as a product-specific status. eg <Status code="1">onbekende gebruiker</Status>
globale return statussen
- 0: the call was succesful
- 1: onbekende gebruiker = login failed
- 2: geen artikelen in de winkelwagen = when shoppingcart is empty and hence no products can be returned
- 5: onbekende artikelnummers = when a PVCheck finds unknown products (so when there is at least 1 product with product-specific-status = 3)
- 9: other error = any other error that occurred
product-specific status
- 0: no errors
- 3: artikelnummer onbekend = when a PVCheck finds an unknown products

Disclaimer

We welcome any feedback as we want to make your integration as smooth as possible.

GETAUTOLOGONURL

Returns a url that can be used in a browser. This url is intended for immediate use and hence is only valid for 90sec.

This url will bring the visitor to the Partner shoppingcart and will logon that user.

This Shoppingcart is part of a stripped-down version of the Desco website. The user can search products and add them to the shoppingcart.

With the "GetBasket" call you can import the products of that cart.

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAutoLogonUrl

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAutoLogonUrl

username
- should be the email address of the user
password
- make sure to HtmlEncode this value
customerid
language
- is optional; possible values: [FR, NL]. Defines the preferred language of user.

Example with credentials in plain text (but over HTTPS)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAutoLogonUrl?username=yourlogin@yourdomain.be&password=123fake!&customerid=77777

Example with encryption (obsolete, supported for backwards compatibility)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAutoLogonUrl?username=oaftwghSl1VyH8Ztk9c26LLxIInlqth9UgV0OCOW73%2FlJmRWhB%2FHnOJKWWgjiZm7&Password=4q7uJ6ND%2BnKW54mfWLQkGA%3D%3D&customerid=ZIrxEBB6o82ur5OZjp5XhQ%3D%3D

Each value was Encrypted, then Base64 encoded and then URL escaped

https://www.desco.be/nl-be/desco-login?qpl=836b51d27d0743c480f032e0b0f04ab2ef03d0494082ec0bd8a0e9e3b5909be4e6d8a549bfd23059f666245ffa9e3fd6ab740d11585e5b295186145d395dff9cf5803c604ad51a13ad520ba5d0b67cfac995eaae15cd0cfe5954fd245e6db18af95a21778d57239a43d0322b8f460415b8cd868baacac9ecde5146ed83b40f99e2e06db2bf8e98a9831e36b16f7e97e73f2e68a0c25481dccd5683b8611544c96fc41a05abefc776833f24a52c38cf75

GETBASKET

Returns the content of the Partner shoppingcart in xml format.

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetBasket

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetBasket

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>

<UserId>yourlogin@yourdomain.be</UserId>

</Customer>

</Request>

</DescoXml>

Example empty basket:

<?xml version="1.0" encoding="UTF-8" ?>

geen artikelen in de winkelwagen

</Status>

</Response>

</DescoXml>

Example filled basket with 2 product

<?xml version="1.0" encoding="UTF-8" ?>

</Status>

<Item>

<DescriptionNl>OPHANGSYSTEEM WC SANBLOC GEBERIT</DescriptionNl>

<DescriptionFr>SYST.DE SUSP.WC SANBL.GEBERIT</DescriptionFr>

<ProductDetailPageNl>https://test.desco.be/nl-be/producten/info?qpid=66100</ProductDetailPageNl>

<ProductDetailPageFr>https://test.desco.be/fr-be/produits/info?qpid=66100</ProductDetailPageFr>

<ProductImage>https://test.desco.be/portals/0/files/OCA/160/OCA16092_M.jpg</ProductImage>

</Item>

<Item>

<DescriptionNl>TUB ACRYL NEWFORM 80-80-4 WIT</DescriptionNl>

<DescriptionFr>TUB ACRYL NEWFORM 80-80-4 BLANC</DescriptionFr>

<ProductDetailPageNl>https://test.desco.be/nl-be/producten/info?qpid=134376</ProductDetailPageNl>

<ProductDetailPageFr>https://test.desco.be/fr-be/produits/info?qpid=134376</ProductDetailPageFr>

<ProductImage>https://test.desco.be/portals/0/files/OCA/195/OCA19548_M.jpg</ProductImage>

</Item>

</Response>

</DescoXml>

CLEARBASKET

Returns an XML with pricing information about the products listed in the original Request.

Endpoint Url - PRODUCTION environment (preferred endpoint as this does only alters your shoppingcart state)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/ClearBasket

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/ClearBasket

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>

<UserId>yourlogin@yourdomain.be</UserId>

</Customer>

</Request>

</DescoXml>

<?xml version="1.0" encoding="UTF-8" ?>

</Status>

</Response>

</DescoXml>

PVCHECK

Returns an XML with pricing information about the products listed in the request.

Throttled: max 10 request per minute.

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/PVcheck

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/PVcheck

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>
<DescoXml version="1.0">
<Request>
    <Customer>
      <CustomerNumber>77777</CustomerNumber>
      <UserId>yourlogin@yourdomain.be</UserId>
      <Password>123&fake!</Password>
    </Customer>
    <Item>
        <ProductId>10001</ProductId>
    </Item>
</Request>
</DescoXml>

<?xml version="1.0" encoding="UTF-8" ?>
<DescoXml version="1.0">
    <Response>
        <Status code="0">
        </Status>
        <Item>
            <Status code="0">
            </Status>
            <ProductId>10102</ProductId>
            <DescriptionNl>RK ELLEBOOG 90° MF 22MM</DescriptionNl>
            <DescriptionFr>CUIVRE A SOUDER COUDE 90° MF 22MM</DescriptionFr>
            <Quantity>0</Quantity>
            <Unit>ST</Unit>
           <Price>2,10</Price>
            <NettPrice>1,60</NettPrice>
            <LineTotal>0</LineTotal>
            <MinimalOrderQuantity>1</MinimalOrderQuantity>
<ProductHierarchy>020001000100000001</ProductHierarchy>
            <SupplierProductId>092022</SupplierProductId>
            <EanCode></EanCode>
            <Recupel></Recupel>
            <ProductDetailPageNl>http://desco.iis.holoncom.eu/nl-be/producten/info?qpid=10102</ProductDetailPageNl>
            <ProductDetailPageFr>http://desco.iis.holoncom.eu/fr-be/produits/info?qpid=10102</ProductDetailPageFr>
            <ProductImage>http://desco.iis.holoncom.eu/portals/0/files/OCA/000/OCA00015_M.jpg</ProductImage>
            <TechnicalDatasheetNl></TechnicalDatasheetNl>
            <TechnicalDatasheetFr></TechnicalDatasheetFr>
            <DeeplinkNl></DeeplinkNl>
            <DeeplinkFr></DeeplinkFr>
            <ProductType>STO</ProductType>
        </Item>
        <Item>
            <Status code="0">
            </Status>
            <ProductId>11086</ProductId>
            <DescriptionNl>GORDIJNHOUDER RECHT 200CM +BEVESTIGING</DescriptionNl>
            <DescriptionFr>PORTE-RIDEAU DROIT 200CM AVEC FIXATION</DescriptionFr>
            <Quantity>0</Quantity>
            <Unit>ST</Unit>
            <Price>31,30</Price>
            <NettPrice>23,79</NettPrice>
            <LineTotal>0</LineTotal>
            <MinimalOrderQuantity>1</MinimalOrderQuantity>
            <SupplierProductId>11086</SupplierProductId>
            <EanCode></EanCode>
            <Recupel></Recupel>
            <ProductDetailPageNl>http://desco.iis.holoncom.eu/nl-be/producten/info?qpid=11086</ProductDetailPageNl>
            <ProductDetailPageFr>http://desco.iis.holoncom.eu/fr-be/produits/info?qpid=11086</ProductDetailPageFr>
            <ProductImage>http://desco.iis.holoncom.eu/portals/0/files/OCA/126/OCA12686_M.jpg</ProductImage>
            <TechnicalDatasheetNl>http://www.desco.be/Portal/TF/OTA12686.pdf</TechnicalDatasheetNl>
            <TechnicalDatasheetFr>http://www.desco.be/Portal/TF/OTA12686.pdf</TechnicalDatasheetFr>
            <DeeplinkNl></DeeplinkNl>
            <DeeplinkFr></DeeplinkFr>
            <ProductType>STO</ProductType>
        </Item>
    </Response>
</DescoXml>

GETORDER

Returns an XML with Order information about the order listed in the request.

WARNING: This call has a rate limit. Every CustomerId-IPaddress combo can only call this method once every second.

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetOrder

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetOrder

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>
<DescoXml version="1.0">
<Request>
    <Customer>
      <CustomerNumber>100001</CustomerNumber>
      <UserId>yourlogin@yourdomain.be</UserId>
      <Password>123&fake!</Password>
    </Customer>
    <OrderIds>
        <OrderId>2000001</OrderId>
    </OrderIds>
</Request>
</DescoXml>

<DescoXml version="1.0">
<Response>
<Status code="0"></Status>
<Order>
<Status code="0"/>
<OrderId>2000001</OrderId>
<CustomerId>100001</CustomerId>
<Created>2021-11-25T00:00:00</Created>
<CreatedBy/>
<VatTotal>255,2200</VatTotal>
<TotalExclVat>1215,3400</TotalExclVat>
<Total>1470,5600</Total>
<OpenAmount>0,0000</OpenAmount>
<AmountPayed>0</AmountPayed>
<OrderReference>Opsmuk</OrderReference>
<Remark/>
<RequestedDeliveryDate>2022-01-14T00:00:00</RequestedDeliveryDate>
<ShippingCondition>VC10 - direct leveren</ShippingCondition>
<Project/>
<Project1/>
<Project2/>
<WishlistId>2109396NR</WishlistId>
<SalesOffice>1030</SalesOffice>
<OnSiteContact>
<Name>KLANTNAAM BVBA</Name>
<Name2/>
<ZipCode>2000</ZipCode>
<Location>ANTWERPEN</Location>
<Street>GROTE MARKT</Street>
<Number>1000</Number>
<CountryName>België</CountryName>
<Email>contactnaam@desco.be</Email>
</OnSiteContact>
<OrderLines>
<OrderLine>
<LineItemId>5</LineItemId>
<LineType>ZTX2</LineType>
<LineStatus/>
<ProductId>R</ProductId>
<SupplierPartNumber/>
<EanNumber/>
<ProductType/>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/images/img_noimage.gif</ImageUrl>
<DescriptionNl>Badkamer</DescriptionNl>
<DescriptionFr>Badkamer</DescriptionFr>
<Quantity>0,000</Quantity>
<Unit>ST</Unit>
<ListPrice>0,0000</ListPrice>
<NettPrice>0,0000</NettPrice>
<LineTotal>0,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>10</LineItemId>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>12486</ProductId>
<SupplierPartNumber>038370699</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/215/OCA21541.jpg</ImageUrl>
<DescriptionNl>HAAKSE SCHELLKRAAN+AANSL.VAATWAS.1/2"CHR</DescriptionNl>
<DescriptionFr>HAAKSE SCHELLKRAAN+AANSL.VAATWAS.1/2"CHR</DescriptionFr>
<Quantity>10,000</Quantity>
<Unit>ST</Unit>
<ListPrice>58,3000</ListPrice>
<NettPrice>10,0000</NettPrice>
<LineTotal>100,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>14</LineItemId>
<LineType>ZTX2</LineType>
<LineStatus/>
<ProductId>R</ProductId>
<SupplierPartNumber/>
<EanNumber/>
<ProductType/>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/images/img_noimage.gif</ImageUrl>
<DescriptionNl>Bom</DescriptionNl>
<DescriptionFr>Bom</DescriptionFr>
<Quantity>0,000</Quantity>
<Unit>ST</Unit>
<ListPrice>0,0000</ListPrice>
<NettPrice>0,0000</NettPrice>
<LineTotal>0,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>15</LineItemId>
<LineType>ZTXT</LineType>
<LineStatus/>
<ProductId/>
<SupplierPartNumber/>
<EanNumber/>
<ProductType/>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/images/img_noimage.gif</ImageUrl>
<DescriptionNl>tekst</DescriptionNl>
<DescriptionFr>tekst</DescriptionFr>
<Quantity>0,000</Quantity>
<Unit/>
<ListPrice>0,0000</ListPrice>
<NettPrice>0,0000</NettPrice>
<LineTotal>0,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>20</LineItemId>
<LineType>ZTAP</LineType>
<LineStatus/>
<ProductId>700522</ProductId>
<SupplierPartNumber/>
<EanNumber/>
<ProductType>BOM</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/images/img_noimage.gif</ImageUrl>
<DescriptionNl>MBL NEWFORM 130 1 TIR.STABLE BLANC MIR.</DescriptionNl>
<DescriptionFr>MBL NEWFORM 130 1 TIR.STABLE BLANC MIR.</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>0,0000</ListPrice>
<NettPrice>0,0000</NettPrice>
<LineTotal>0,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems>
<BomItem>
<LineItemId>30</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136425</ProductId>
<SupplierPartNumber>136425</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/206/OCA20674.jpg</ImageUrl>
<DescriptionNl>VASQ.A POS.NEWFORM DIAM.34CM SN.TR-P BL</DescriptionNl>
<DescriptionFr>VASQ.A POS.NEWFORM DIAM.34CM SN.TR-P BL</DescriptionFr>
<Quantity>2,000</Quantity>
<Unit>ST</Unit>
<ListPrice>112,0000</ListPrice>
<NettPrice>67,2000</NettPrice>
<LineTotal>134,4000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>2,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>40</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136599</ProductId>
<SupplierPartNumber>DN120K4016</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/ACA/136/ACA136599.jpg</ImageUrl>
<DescriptionNl>SOUS MEUBLE NEWFORM 1TIROIR 120CM BLANC</DescriptionNl>
<DescriptionFr>SOUS MEUBLE NEWFORM 1TIROIR 120CM BLANC</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>438,0000</ListPrice>
<NettPrice>262,8000</NettPrice>
<LineTotal>262,8000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>50</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136631</ProductId>
<SupplierPartNumber>WM5013004016</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/208/OCA20814.jpg</ImageUrl>
<DescriptionNl>TABLETTE P.LAV.A POSER NEWF.130CM BLANC</DescriptionNl>
<DescriptionFr>TABLETTE P.LAV.A POSER NEWF.130CM BLANC</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>117,0000</ListPrice>
<NettPrice>70,2000</NettPrice>
<LineTotal>70,2000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>60</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136633</ProductId>
<SupplierPartNumber>STM507454016</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/208/OCA20815.jpg</ImageUrl>
<DescriptionNl>PANNEAU LATERAL NEWFORM 74,5-5CM BLANC</DescriptionNl>
<DescriptionFr>PANNEAU LATERAL NEWFORM 74,5-5CM BLANC</DescriptionFr>
<Quantity>2,000</Quantity>
<Unit>ST</Unit>
<ListPrice>170,0000</ListPrice>
<NettPrice>102,0000</NettPrice>
<LineTotal>204,0000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>2,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>70</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136475</ProductId>
<SupplierPartNumber>SG012</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/009/OCA00971.jpg</ImageUrl>
<DescriptionNl>MIROIR STANDARD FIMS 600X1200X5MM</DescriptionNl>
<DescriptionFr>MIROIR STANDARD FIMS 600X1200X5MM</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>62,6000</ListPrice>
<NettPrice>37,5600</NettPrice>
<LineTotal>37,5600</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>80</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136892</ProductId>
<SupplierPartNumber>Z1100X540</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/209/OCA20926.jpg</ImageUrl>
<DescriptionNl>PLAQUE BASE POUR MIROIR FIMS NEW 120CM</DescriptionNl>
<DescriptionFr>PLAQUE BASE POUR MIROIR FIMS NEW 120CM</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>79,0000</ListPrice>
<NettPrice>47,4000</NettPrice>
<LineTotal>47,4000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>90</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136767</ProductId>
<SupplierPartNumber>63267610</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/208/OCA20879.jpg</ImageUrl>
<DescriptionNl>ECLAIR.LED PR.ARM.TOILETTE NEWFORM 5,2W</DescriptionNl>
<DescriptionFr>ECLAIR.LED PR.ARM.TOILETTE NEWFORM 5,2W</DescriptionFr>
<Quantity>2,000</Quantity>
<Unit>ST</Unit>
<ListPrice>99,0000</ListPrice>
<NettPrice>59,4400</NettPrice>
<LineTotal>118,8800</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>2,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
<BomItem>
<LineItemId>100</LineItemId>
<BomPartLineNumber>20</BomPartLineNumber>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>136933</ProductId>
<SupplierPartNumber>CO81201CR</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/209/OCA20938.jpg</ImageUrl>
<DescriptionNl>CREP.LONG.DC 5/4"RONDE S.TROP-PLEIN CHR.</DescriptionNl>
<DescriptionFr>CREP.LONG.DC 5/4"RONDE S.TROP-PLEIN CHR.</DescriptionFr>
<Quantity>2,000</Quantity>
<Unit>ST</Unit>
<ListPrice>58,0000</ListPrice>
<NettPrice>34,8000</NettPrice>
<LineTotal>69,6000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>2,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
</BomItem>
</BomItems>
</OrderLine>
<OrderLine>
<LineItemId>110</LineItemId>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>60036</ProductId>
<SupplierPartNumber>0854004</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/126/OCA12674.jpg</ImageUrl>
<DescriptionNl>PANNEAU DE MONTAGE CLIC AC.ZING.1M</DescriptionNl>
<DescriptionFr>PANNEAU DE MONTAGE CLIC AC.ZING.1M</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>11,5000</ListPrice>
<NettPrice>6,9000</NettPrice>
<LineTotal>6,9000</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>120</LineItemId>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>10000</ProductId>
<SupplierPartNumber>7011411</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/000/OCA00001.jpg</ImageUrl>
<DescriptionNl>TUYAU CUIVRE 12-1,0MM SD LONGEUR 5M PM</DescriptionNl>
<DescriptionFr>TUYAU CUIVRE 12-1,0MM SD LONGEUR 5M PM</DescriptionFr>
<Quantity>50,000</Quantity>
<Unit>M</Unit>
<ListPrice>4,9000</ListPrice>
<NettPrice>2,8500</NettPrice>
<LineTotal>142,5900</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>50,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>5,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>130</LineItemId>
<LineType>ZTAN</LineType>
<LineStatus>A</LineStatus>
<ProductId>123456</ProductId>
<SupplierPartNumber>348595</SupplierPartNumber>
<EanNumber/>
<ProductType>STO</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/169/OCA16929.jpg</ImageUrl>
<DescriptionNl>PROFIPRESS GAZ JOINT VIEGA 18MM</DescriptionNl>
<DescriptionFr>PROFIPRESS GAZ JOINT VIEGA 18MM</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>1,5300</ListPrice>
<NettPrice>0,9100</NettPrice>
<LineTotal>0,9100</LineTotal>
<QuantityInComing>0,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>1,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
<OrderLine>
<LineItemId>140</LineItemId>
<LineType>ZREF</LineType>
<LineStatus>A</LineStatus>
<ProductId>27816</ProductId>
<SupplierPartNumber>119703161</SupplierPartNumber>
<EanNumber/>
<ProductType>REF</ProductType>
<CancellationReasonId/>
<ConfirmedDeliveryDate>0001-01-01T00:00:00</ConfirmedDeliveryDate>
<ImageUrl>/portals/0/files/OCA/041/OCA04194.jpg</ImageUrl>
<DescriptionNl>TUYAU DE CHASSE ALIMENTATION RES.GEBERIT</DescriptionNl>
<DescriptionFr>TUYAU DE CHASSE ALIMENTATION RES.GEBERIT</DescriptionFr>
<Quantity>1,000</Quantity>
<Unit>ST</Unit>
<ListPrice>74,8400</ListPrice>
<NettPrice>44,9000</NettPrice>
<LineTotal>44,9000</LineTotal>
<QuantityInComing>1,000</QuantityInComing>
<QuantityInTransit>0,000</QuantityInTransit>
<QuantityAvailable>0,000</QuantityAvailable>
<QuantityToBePicked>0,000</QuantityToBePicked>
<QuantityDelivered>0,000</QuantityDelivered>
<MinOrderQuantity>1,000</MinOrderQuantity>
<BomItems></BomItems>
</OrderLine>
</OrderLines>
</Order>
</Response>
</DescoXml>

ProductType values is one of the following

STO: product in stock
REF: product that we need to order
BOM: composite product
GA: product that we ordered once

LineType values is one of the following

ZTXT: a free text line. not an article, hence no price info.
ZTX2: a free text line. not an article, hence no price info.
ZTAN: a product that we hold in stock. see also field ProductType
ZREF: a product that we do not hold in stock. see also field ProductType

GETALLPRODUCTS

Returns an XML with pricing information of all the Desco products.

This call might take a while to respond. So allow a Response time of 180sec.

WARNING: This call has a rate limit. Every CustomerId-IPaddress combo can only call this method once every 5 minutes.

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request so no harm can be done)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAllProducts

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetAllProducts

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>

<UserId>yourlogin@yourdomain.be</UserId>

</Customer>

</Request>

</DescoXml>

<?xml version="1.0" encoding="UTF-8" ?>
<DescoXml version="1.0">
    <Response>
        <Status code="0"></Status>
        <Item>
            <Status code="0"></Status>
            <ProductId>10102</ProductId>
            <DescriptionNl>RK ELLEBOOG 90° MF 22MM</DescriptionNl>
            <DescriptionFr>CUIVRE A SOUDER COUDE 90° MF 22MM</DescriptionFr>
            <Quantity>0</Quantity>
            <Unit>ST</Unit>
            <Price>2,10</Price>
            <NettPrice>1,60</NettPrice>
            <LineTotal>0</LineTotal>
            <MinimalOrderQuantity>1</MinimalOrderQuantity>
<ProductHierarchy>020001000100000001</ProductHierarchy>
            <SupplierProductId>092022</SupplierProductId>
            <EanCode></EanCode>
            <Recupel></Recupel>
            <ProductDetailPageNl>http://desco.iis.holoncom.eu/nl-be/producten/info?qpid=10102</ProductDetailPageNl>
            <ProductDetailPageFr>http://desco.iis.holoncom.eu/fr-be/produits/info?qpid=10102</ProductDetailPageFr>
            <ProductImage>http://desco.iis.holoncom.eu/portals/0/files/OCA/000/OCA00015_M.jpg</ProductImage>
            <TechnicalDatasheetNl></TechnicalDatasheetNl>
            <TechnicalDatasheetFr></TechnicalDatasheetFr>
            <DeeplinkNl></DeeplinkNl>
            <DeeplinkFr></DeeplinkFr>
            <ProductType>STO</ProductType>
<LastUpdated>8/06/2021 22:37:59</LastUpdated>
        </Item>
        <Item>
            <Status code="0"></Status>
            <ProductId>11086</ProductId>
            <DescriptionNl>GORDIJNHOUDER RECHT 200CM +BEVESTIGING</DescriptionNl>
            <DescriptionFr>PORTE-RIDEAU DROIT 200CM AVEC FIXATION</DescriptionFr>
            <Quantity>0</Quantity>
            <Unit>ST</Unit>
            <Price>31,30</Price>
            <NettPrice>23,79</NettPrice>
            <LineTotal>0</LineTotal>
            <SupplierProductId>11086</SupplierProductId>
            <EanCode></EanCode>
            <Recupel></Recupel>
            <ProductDetailPageNl>http://desco.iis.holoncom.eu/nl-be/producten/info?qpid=11086</ProductDetailPageNl>
            <ProductDetailPageFr>http://desco.iis.holoncom.eu/fr-be/produits/info?qpid=11086</ProductDetailPageFr>
            <ProductImage>http://desco.iis.holoncom.eu/portals/0/files/OCA/126/OCA12686_M.jpg</ProductImage>
            <TechnicalDatasheetNl>http://www.desco.be/Portal/TF/OTA12686.pdf</TechnicalDatasheetNl>
            <TechnicalDatasheetFr>http://www.desco.be/Portal/TF/OTA12686.pdf</TechnicalDatasheetFr>
            <DeeplinkNl></DeeplinkNl>
            <DeeplinkFr></DeeplinkFr>
            <ProductType>STO</ProductType>
        </Item>
    </Response>
</DescoXml>

GETDESCOPICKUPLOCATIONS

Returns the list of Desco Pickup location addresses

Endpoint Url - PRODUCTION environment (preferred endpoint as this is a GET request so no harm can be done)

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetDescoPickupLocations

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/GetDescoPickupLocations

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>

<UserId>yourlogin@yourdomain.be</UserId>

</Customer>

</Request>

</DescoXml>

<DescoXml version="1.0">
<Response>
<Status code="0"></Status>
<Locations>
<Location>
<Name>Desco Aalst</Name>
<Street>Industrielaan</Street>
<Number>9</Number>
<ZipCode>9320</ZipCode>
<City>Aalst</City>
<CountryCode>BE</CountryCode>
<Telephone>+32 53 38 29 38</Telephone>
</Location>
<Location>
<Name>Desco Aartselaar</Name>
<Street>Kontichsesteenweg</Street>
<Number>34</Number>
<ZipCode>2630</ZipCode>
<City>Aartselaar</City>
<CountryCode>BE</CountryCode>
<Telephone>+32 3 334 44 44</Telephone>
</Location>
...
</Locations>
</Response>
</DescoXml>

PLACEORDER

Places an Order.

Endpoint Url - PRODUCTION environment

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/PlaceOrder

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/PlaceOrder

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>

<UserId>yourlogin@yourdomain.be</UserId>

</Customer>

<OrderReference>my first order</OrderReference>

<Remark>an optional</Remark>

<Order>

<DescriptionNl>OPHANGSYSTEEM WC SANBLOCGEBERIT</DescriptionNl>

<DescriptionFr>SYST.DE SUSP.WCSANBL.GEBERIT</DescriptionFr>

</OrderItem>

<DescriptionNl>SCHROEF VOOR HYDROBLOK L REMEHA</DescriptionNl>

<DescriptionFr>SCHROEF VOOR HYDROBLOK L REMEHA</DescriptionFr>

</OrderItem>

</Order>

<Name>naam adres</Name>

<Street>straatnaam</Street>

<Number>nummer</Number>

<Location>Gemeente</Location>

</DeliveryAddress>

<OnSiteContact>Naam Contactpersoon, BE +32 3 456 78 90</OnSiteContact>

</Request>

</DescoXml>

Example of a valid order placement, with a warning message

<?xml version="1.0" encoding="UTF-8" ?>

Warning: The WantedDeliveryDate is unexpected. Please contact your Desco contact.

</Status>

</Response>

</DescoXml>

Example of a failed order placement

<?xml version="1.0" encoding="UTF-8" ?>

<Status code="9">unexpected error: Unknown Location</Status>

</Response>

</DescoXml>

WantedDeliveryDate is required and must be in form yyyy-mm-dd
ShippingCondition is required and must be 10, 20 or 30
- 10 = direct leveren
- 20 = order op afroep
- 30 = leveringsdatum is vermoedelijk
OrderReference has a maxlength of 32
Remark can be used for additional information or remarks for the Order processor.
Order must have at least one OrderItem.
QuantityAsked must obey then minimal quantity requirement of a product. The minimal quantity requirement is from now on available in the PVCheck.
UNIT is required.
Unit price is required.
Totalprice is required.
ZipCode is required, Location is not.
It is allowed to concatenate ZipCode and Location seperated with a “ “ (space) into the ZipCode field.
CountryIsoCode must be BE, LU or NL
OnSiteContact: name & phone number of a contact on site. Must be in the format <naam> - <tel landcode><telefoonnummer> (eg "werfleider fase 1 - BE +32 3 456 78 90")
DeliveryAddress.Name is required and as a maxlength of 35

ECHO

This method is for debugging purposes. It simply tries to parse your XML and returns an error and/or the XML.

Endpoint Url - PRODUCTION environment

https://www.desco.be/desktopmodules/desco/api/v202/yourpartnerid/Echo

Endpoint Url - TEST environment

https://test.desco.be/desktopmodules/desco/api/v202/yourpartnerid/Echo

none

POST Body example

<?xml version="1.0" encoding="UTF-8" ?>
<DescoXml version="1.0">
<Request>
    <Customer>
<CustomerNumber>77777</CustomerNumber>
      <UserId>yourlogin@yourdomain.be</UserId>
      <Password>123&fake!</Password>
    </Customer>
</Request>
</DescoXml>

Api Documentation v2.02 (supported until 8 aug 2025)