THIS PAGE ISN´T TRANSLATED YET.

Het uitlezen van de bestellingen kan gebruikt worden om bijv. in een eigen omgeving (bijv. boekhoudprogramma) de bestelling automatisch in te lezen, zodat de inkooporder niet meer handmatig ingevoerd hoeft te worden.

Een ander voorbeeld is het af- of opboeken van de eigen voorraad en daarmee een besteladvies op te stellen om de eigen voorraad weer boven de veiligheidsvoorraad te verkrijgen.

De functie kan tevens gebruikt worden om een bestelling op te vragen en te gebruiken als digitale pakbon.

LET OP! Alle parameters dienen gebruikt te worden in deze volgorde:

Type
TicID
Order
DateStart
DateEnd

Indien een parameter niet benodigd is, gebruik dan de waarde null

Parameter Type dient als waarde all, new, last of order te hebben:

Parameter	Omschrijving
All	Alle bestellingen binnen een tijdsperiode ophalen. Parameters DateStart en DateEnd zijn dan verplicht om te gebruiken.
~~New~~	~~Alleen de nieuwste bestellingen sinds de laatste request worden opgehaald.~~
Last	De laatste bestelling wordt opgehaald.
Order	Een specifieke bestelling ophalen. De parameter order is hierbij verplicht.

De parameter TicID is te gebruiken om bijv. binnen een holding specifiek toe te spitsen op één vestiging. Zonder gebruik van deze parameter zullen van alle mogelijke vestigingen de bestellingen opgehaald worden. Deze is niet verplicht.

De parameter Order kan gebruikt worden om één specifieke bestelling op te halen. Als er een bestelling is geplaatst in de (oude) TIC webservice (link) is via de response het TIC ordernummer te vinden om zo direct de bevestiging van de bestelling digitaal op te halen. Deze is verplicht bij Type = order.

Bij het gebruik van de parameter Type met de waarde all, zijn de parameters DateStart en DateEnd verplicht. Deze dienen als string voluit te worden geschreven met de opmaak ddmmyyyy.

DOC

getOrders

string/xml getOrders (
string Type,
(optional) int TicID,
(optional) int Order (mandatory when Type=order)
(optional) string DateStart (mandatory when Type=all)
(optional) string DateEnd (mandatory when Type=all)
)

Receive orders

string Type
Use Type of order [all/~~new~~/last/order]

int Order
Use only when Type = order (when Type is different, use null or leave empty)

string DateStart
Use only when Type = all [format: ddmmyyyy] (when Type is different, use null or leave empty)

string DateEnd
Use only when Type = all [format: ddmmyyyy] (when Type is different, use null or leave empty)

Optional:

int TicID
Use TicID (when not needed, use null or leave empty)

Return value string/xml: Orders

XSD

<wsdl:operation name="getOrders" parameterOrder="Type TicID Order DateEnd DateStart">
- <wsdl:input message="tns:getOrdersSoapIn"/>
- <wsdl:output message="tns:getOrdersSoapOut"/>
</wsdl:operation>

<wsdl:message name="getOrdersSoapIn">
- <wsdl:part name="Type" type="s:string"/>
- <wsdl:part name="TicID" type="s:int"/>
- <wsdl:part name="Order" type="s:int"/>
- <wsdl:part name="DateEnd" type="s:string"/>
- <wsdl:part name="DateStart" type="s:string"/>
</wsdl:message>
<wsdl:message name="getOrdersSoapOut">
- <wsdl:part name="return" type="s:string"/>
</wsdl:message>

XML

Request:

<AuthHeader>
- <API_KEY>************************************</API_KEY>
</AuthHeader>
<getOrders>
- <Type>****</Type>
- <TicID/>
- <Order/>
- <DateStart>ddmmyyyy</DateStart>
- <DateEnd>ddmmyyyy</DateEnd>
</getOrders>

Response:

<?xml version="1.0" ?>
<ResponseCode>
- <Response>
  - <Header>
    - <Started>HH:MM:SS</Started>
    - <Ended>HH:MM:SS</Ended>
    - <Company>
      - <TicID>XXXX</TicID>
      - <CompanyName>XXXXXXXXXXXXXXXX</CompanyName>
    - </Company>
  - </Header>
  - <Body>
    - <Orders>
      - <Order sequence="1">
        
        <Ordernumber>2018620092</Ordernumber>
        
        <OrderDate>2018-01-16 15:47:47.4700000</OrderDate>
        
        <OrderType>B2B</OrderType>
        
        <Company>
        
        <TicID>XXXX</TicID>
        
        <DealerCode></DealerCode>
        
        <CompanyName>XXXXXXXXXXXXXXXX</CompanyName>
        
        <DealType>N</DealType>
        
        <DealGroup>No deal</DealGroup>
        
        </Company>
        <OrderReference></OrderReference>
        
        <DeliveryTypeCode>X</DeliveryTypeCode>
        
        <DeliveryType>XXXXXXXXXXXXXXXX</DeliveryType>
        
        <DeliveryDate></DeliveryDate>
        
        <DeliveryTime></DeliveryTime>
        
        <Wholesaler>XXXXXXXXXXXXXXXX</Wholesaler>
        
        <OrderRemarks></OrderRemarks>
        
        <OrderLines>
        
        <OrderLine sequence="1">
        <ProductTypeCode>1</ProductTypeCode>
        
        <ProductType>Tyres</ProductType>
        
        <EAN>XXXXXXXXXXXXX</EAN>
        
        <CustomersCode></CustomersCode>
        
        <Size>XXX/XXRXX</Size>
        
        <Brand>XXXXXXXXXXXXXXXX</Brand>
        
        <Description>XXXXXXXXXXXXXXXX</Description>
        
        <ExtraDescription> </ExtraDescription>
        
        <LoadSpeedIndex>XXX</LoadSpeedIndex>
        
        <PriceGross>XX.XX</PriceGross>
        
        <PriceSelling>XX.XX</PriceSelling>
        
        <PricePurchase>XX.XX</PricePurchase>
        
        <QTY>X</QTY>
        
        <StockSameday>XX</StockSameday>
        
        <Stock24_48H>XX</Stock24_48H>
        
        </OrderLine>
        
        </OrderLines>
      - </Order>
    - </Orders>
  - </Body>
- </Response>
</ResponseCode>

PHP


	
		<?php
		
			$Type = 'all';
			$TicID = null;
			$Order = null;
			$DateStart = 'ddmmyyyy';
			$DateEnd = 'ddmmyyyy';



			$client = new SoapClient(
				'https://api.tyrenet.nl/mainservice/ticservices.php?WSDL',
				array(
					'trace' => 1,
					'exceptions' => 1
				
)
			
);


			
			$paramHeader = array();



			$paramHeader['API_KEY'] = '*********************************';


			
			$header = new SoapHeader(
				'http://api.tyrenet.nl/',
				'AuthHeader',
				$paramHeader
			
);


			
			$client->__setSoapHeaders($header);


			
			$xml = $client->getOrders($Type,$TicID,$Order,$DateStart,$DateEnd);
			echo $xml;
		
		?>

Tyrenet

API Docs

Retreive orders

Request:

Response: