Voorraadservice

Via het elektronische bestelsysteem op rensa.nl, gevier.nl en gafco.nl kan je 24 uur per dag, 7 dagen per week, jouw orders plaatsen. Via de voorraadservice kunnen de voorraden van Rensa, Gevier en Gafco elektronisch opgevraagd worden. Hieronder staat beschreven hoe de voorraadservice geïmplementeerd kan worden.

  • Rensa
  • Gevier
  • Gafco

GetStockAvailability

De GetStockAvailability endpoint wordt gebruikt om de voorraad bij ons op te vragen.

Request

In het ServiceAuthenticator element moeten de volgende XML-elementen gevuld worden met dezelfde waarden als bij het starten van de voorraadservice.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

  • TradeItemID: het artikelnummer waar de voorraad van opgevraagd wordt

  • OrderingUnitQuantity: gewenste aantal

XML SOAP request getStockAvailability

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

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">

<Header>

<ServiceAuthenticator xmlns="http://etim.nl/">

<Debiteurnummer>[DebiteurNummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</Header>

<Body>

<getStockAvailability xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://etim.nl/">

<request>

<lines>

<StockAvailabilityRequestLine>

<TradeItemID>[Artikelnummer]</TradeItemID>

<OrderingUnitQuantity>[Gewenste aantal]</OrderingUnitQuantity>

</StockAvailabilityRequestLine>

</lines>

</request>

</getStockAvailability>

</Body>

</Envelope>

Response

  • OrderingUnitQuantity: de beschikbare voorraad
    (indien er 10 gewenst is en er is maar 2 op voorraad, dan zal hier 2 staan en de response status is dan NOK)

  • ResponseStatus:

    • OK: gewenste aantal is op voorraad

    • NOK: gewenste aantal is niet op voorraad

  • Note: indien het gewenste aantal niet op voorraad is dan staat hier de verwachte nieuwe voorraad datum in het volgende formaat: Verwachte nieuwe voorraad op: dd-MM-yyyy

XML SOAP successful response getStockAvailability

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

    <soap:Body>

        <getStockAvailabilityResponse xmlns="http://etim.nl/">

            <getStockAvailabilityResult>

                <lines>

                    <StockAvailabilityResponseLine>

                        <TradeItemID>0555112</TradeItemID>

                        <OrderingUnitQuantity>1</OrderingUnitQuantity>

                        <ResponseStatus>OK</ResponseStatus>

                    </StockAvailabilityResponseLine>

                </lines>

            </getStockAvailabilityResult>

        </getStockAvailabilityResponse>

    </soap:Body>

</soap:Envelope>

GetStockAvailabilityQuantity

Naast de GetStockAvailability is er ook een GetStockAvailabilityQuantity beschikbaar, deze endpoint werkt net iets anders dan de GetStockAvailability. Het verschil is dat bij dit endpoint altijd de volledige beschikbare voorraad wordt teruggegeven, het gewenste aantal is optioneel. Ook geeft deze endpoint ResponseStatus OK terug als het gewenste aantal niet op voorraad is. Dat komt omdat er bij deze endpoint gekeken wordt of er genoeg voorraad is en als er niet genoeg voorraad is dan wordt er gekeken of wij nog nieuwe voorraad van het artikel verwachten. Mocht het artikel uitlopend / vervallen zijn, en is het gewenste aantal niet op voorraad, dan geven wij een ResponseStatus NOK terug. In de GetStockAvailabilityQuantity request is het enige verschil het eerste element na de <Body>, namelijk <GetStockAvailabilityQuantity>. De endpoint staat hieronder per veld beschreven:

Request

In het ServiceAuthenticator element moeten de volgende XML-elementen gevuld worden met dezelfde waarden als bij het starten van de voorraadservice.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

  • TradeItemID: het artikelnummer waar de voorraad van opgevraagd wordt

  • OrderingUnitQuantity (optioneel): gewenste aantal

XML SOAP request getStockAvailabilityQuantity

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

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">

<Header>

<ServiceAuthenticator xmlns="http://etim.nl/">

<Debiteurnummer>[DebiteurNummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</Header>

<Body>

<getStockAvailabilityQuantity xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://etim.nl/">

<request>

<lines>

<StockAvailabilityRequestLine>

<TradeItemID>[Artikelnummer]</TradeItemID>

<OrderingUnitQuantity>[Gewenste aantal (optioneel)]</OrderingUnitQuantity>

</StockAvailabilityRequestLine>

</lines>

</request>

</getStockAvailabilityQuantity>

</Body>

</Envelope>

Response

  • OrderingUnitQuantity: geeft altijd de huidige voorraad van ons terug ongeacht het gewenste aantal

  • ResponseStatus:

    • OK: gewenste aantal is op voorraad of het gewenste aantal is niet op voorraad, maar wordt verwacht (de verwachte nieuwe voorraad staat in het veld Note)

    • NOK:

      • Artikel is uitlopend of vervallen en gewenste voorraad is niet beschikbaar, hier verwachten wij ook geen nieuwe voorraad voor

      • Artikel onbekend

  • Note: indien het gewenste aantal niet op voorraad is dan staat hier de verwachte nieuwe voorraad datum in het volgende formaat: Verwachte nieuwe voorraad op: dd-MM-yyyy

XML SOAP successful response getStockAvailabilityQuantity

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

    <soap:Body>

        <getStockAvailabilityQuantityResponse xmlns="http://etim.nl/">

            <getStockAvailabilityQuantityResult>

                <lines>

                    <StockAvailabilityResponseLine>

                        <TradeItemID>0555112</TradeItemID>

                        <OrderingUnitQuantity>639.0</OrderingUnitQuantity>

                        <ResponseStatus>OK</ResponseStatus>

                    </StockAvailabilityResponseLine>

                </lines>

            </getStockAvailabilityQuantityResult>

        </getStockAvailabilityQuantityResponse>

    </soap:Body>

</soap:Envelope>

Webselectie starten

Het starten van de webselectie wordt geinitieerd door vanuit het calculatiepakket de webselectie URL aan te roepen. De URL bevat vier parameters die verplicht meegestuurd dienen te worden.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

  • Calculatiepakket: de naam van het calculatiepakket;

De parameter sequenceid is op dit moment altijd 1.

Test omgeving

https://webselectie-tst.gevier.nl/inloggen?debiteurnummer=[debiteurnummer]&followupnumber=[volgnummer]&wachtwoord=[wachtwoord]&calculatiepakket=[calculatiepakket]&sequenceid=1

Productie omgeving

https://webselectie.gevier.nl/inloggen?debiteurnummer=[debiteurnummer]&followupnumber=[volgnummer]&wachtwoord=[wachtwoord]&calculatiepakket=[calculatiepakket]&sequenceid=1

Webselectie SOAP webservice

Om een GetBasket en een DeleteBasket uit te voeren is er een SOAP webservice beschikbaar.

WDSL

Test

Productie

Service endpoint

Test

Productie

GetBasket


In het ServiceAuthenticator element moeten de volgende XML-elementen gevuld worden met dezelfde waarden als bij het starten van de webselectie.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

XML SOAP request


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

<soap:Envelope

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Header>

<ServiceAuthenticator

xmlns="http://www.gevier.nl/">

<Debiteurnummer>[Debiteurnummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</soap:Header>

<soap:Body>

<GetBasket

xmlns="http://www.gevier.nl/" />

</soap:Body>

</soap:Envelope>

DeleteBasket

In het ServiceAuthenticator element moeten de volgende XML elementen gevuld worden met de zelfde waarden als bij het starten van de webselectie.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

XML SOAP request


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

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soap:Header>

<ServiceAuthenticator

xmlns="http://www.gevier.nl/">

<Debiteurnummer>[Debiteurnummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</soap:Header>

<soap:Body>

<DeleteBasket

xmlns="http://www.gevier.nl/" />

</soap:Body>

</soap:Envelope>

Webselectie starten

Het starten van de webselectie wordt geinitieerd door vanuit het calculatiepakket de webselectie URL aan te roepen. De URL bevat vier parameters die verplicht meegestuurd dienen te worden.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

  • Calculatiepakket: de naam van het calculatiepakket;

De parameter sequenceid is op dit moment altijd 1.

Test omgeving

https://webselectie-tst.gafco.nl/inloggen?debiteurnummer=[debiteurnummer]&followupnumber=[volgnummer]&wachtwoord=[wachtwoord]&calculatiepakket=[calculatiepakket]&sequenceid=1

Productie omgeving

https://webselectie.gafco.nl/inloggen?debiteurnummer=[debiteurnummer]&followupnumber=[volgnummer]&wachtwoord=[wachtwoord]&calculatiepakket=[calculatiepakket]&sequenceid=1

Webselectie SOAP webservice

Om een GetBasket en een DeleteBasket uit te voeren is er een SOAP webservice beschikbaar.

WDSL

Test

Productie

Service endpoint

Test

Productie

GetBasket


In het ServiceAuthenticator element moeten de volgende XML-elementen gevuld worden met dezelfde waarden als bij het starten van de webselectie.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

XML SOAP request


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

<soap:Envelope

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Header>

<ServiceAuthenticator

xmlns="http://www.gafco.nl/">

<Debiteurnummer>[Debiteurnummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</soap:Header>

<soap:Body>

<GetBasket

xmlns="http://www.gafco.nl/" />

</soap:Body>

</soap:Envelope>

DeleteBasket

In het ServiceAuthenticator element moeten de volgende XML elementen gevuld worden met de zelfde waarden als bij het starten van de webselectie.

  • Debiteurnummer: het debiteurnummer van de gebruiker;

  • Wachtwoord: het wachtwoord van de gebruiker;

  • Volgnummer: het volgnummer van de gebruiker;

XML SOAP request

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

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soap:Header>

<ServiceAuthenticator

xmlns="http://www.gafco.nl/">

<Debiteurnummer>[Debiteurnummer]</Debiteurnummer>

<Volgnummer>[Volgnummer]</Volgnummer>

<Wachtwoord>[Wachtwoord]</Wachtwoord>

</ServiceAuthenticator>

</soap:Header>

<soap:Body>

<DeleteBasket

xmlns="http://www.gafco.nl/" />

</soap:Body>

</soap:Envelope>