READ

Method DestServicesReadV2

{YOUR.PROVIDER.DOMAIN}/destservices/destservices.asmx?op=DestServicesReadV2

Node definition Request

Node	Attribute	Data Type	Description	Value	Mandatory
DestServicesReadV2\objRequest	PrimaryLangID	String	Language code	LANGUAGE	Required
DestServicesReadV2\objRequest	TransactionIdentifier	String	This value is returned in the response of the method DestServicesBookV2 and represents the locator of the booking		Required

Node definition Response

Node	Attribute	Data Type	Description	Value	Mandatory
DestServicesReadV2Result	TransactionIdentifier	String	Locator of the booking		Required
DestServicesReadV2Result	ResResponseType	String	State of the booking	Commited / Cancelled / Pending / Rejected	Required
DestServicesReadV2Result\Products		Array	Array of products		Required
DestServicesReadV2Result\Products\BookResponseV2Product\Status		String	Status of the product booking	Commited / Cancelled / Pending / Rejected	Required
DestServicesReadV2Result\Products\BookResponseV2Product\ProductCode		String	Code of the product		Required
DestServicesReadV2Result\Products\BookResponseV2Product\ProductName		String	Name of the product		Required
DestServicesReadV2Result\Products\BookResponseV2Product\StayDateRange			Date information		Required
DestServicesReadV2Result\Products\BookResponseV2Product\StayDateRange	Start	Date	Date from	YYYY-MM-DD	Required
DestServicesReadV2Result\Products\BookResponseV2Product\StayDateRange	End	Date	Date to	YYYY-MM-DD	Required
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties		Array	Array of cancel penalties		Optional
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty	Start	Date	Start date of the application of this cancel penalty	YYYY-MM-DD	Required
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty	End	Date	End date of the application of this cancel penalty	YYYY-MM-DD	Required
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty\AmountPercent	Percent	Integer	Percentage of penalty over the amount of the product	YYYY-MM-DD	Optional
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty\AmountPercent	NmbrOfNights	Integer	Number of nights of penalty		Optional
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty\AmountPercent	Amount	Decimal	Amount of the penalty		Optional
DestServicesReadV2Result\Products\BookResponseV2Product\CancelPenalties\CancelPenalty\AmountPercent	CurrencyCode	String	Currency of the amount of the penalty		Optional
BookResponseV2Product\Concepts\BookResponseV2Concept\Total			Price information of the concept (more info)		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes	Amount	Decimal	Net amount of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes	CurrencyCode	String	Code of the currency of the price		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions			Node with the information about the commissions		Optional
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions\SellingPrice		Decimal	Selling amount of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions\CommissionableAmount		Decimal	Commissionable amount of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions\NotCommissionableAmount		Decimal	Not commissionable amount of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions\CommissionAmount		Decimal	Amount of the commission of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Total\Taxes\Commissions\NetAmount		Decimal	Net amount of the concept		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total			Price information detail (more info)		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes	Amount	Decimal	Total amount		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes	CurrencyCode	String	Currency code	CURRENCY	Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes	NumDecimals	Integer	Number of decimals		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions			Commission information		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions	SellingPrice	Decimal	Amount for selling		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions	CommissionableAmount	Decimal	Comisionable amount		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions	NotCommissionableAmount	Decimal	No commissionable amount		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions	CommissionAmount	Decimal	Commision amount		Required
BookResponseV2Product\Concepts\BookResponseV2Concept\Details\BookResponseV2Detail\Total\Taxes\Commissions	NetAmount	Decimal	Net amount		Required
BookResponseV2Product\ProviderLocator		String	External booking locator. This is not always returned, check with your provider if you need it.		Optional
BookResponseV2Product\Voucher			Node with the information about the voucher		Optional
BookResponseV2Product\Voucher	Type	String	Type of the voucher	BAR_CODE / QR_CODE	Required
BookResponseV2Product\Voucher	Value	String	Value of the voucher		Required
DestServicesReadV2Result\VoucherURL		String	Voucher URL		Optional

XML Examples

Booking read data REQUEST example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://xml.ineedtours.com/ws/">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:DestServicesReadV2>
         <ws:objCredentials>
            <ws:Source>
               <ws:RequestorID Type="DSP" ID="YOUR-USER" MessagePassword="YOUR-PASSWORD"/>
            </ws:Source>
         </ws:objCredentials>
         <ws:objRequest PrimaryLangID="IDLANGUAGE" TransactionIdentifier="D6JL8E"/>
      </ws:DestServicesReadV2>
   </soapenv:Body>
</soapenv:Envelope>

Booking read data RESPONSE example

<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>
      <DestServicesReadV2Response xmlns="http://xml.ineedtours.com/ws/">
         <DestServicesReadV2Result EchoToken="262" PrimaryLangID="ES" TransactionIdentifier="D6JL8E" ResResponseType="Commited">
            <Header ResponseTimestamp="2019-01-14T17:34:47.8259233+01:00" MillisecondProcessingTime="1439" Endpoint="demo.xml.com"/>
            <Products>
               <BookResponseV2Product>
                  <Status>Commited</Status>
                  <ProductCode>1352</ProductCode>
                  <ProductName>Traslado XML (PRIVADO)</ProductName>
                  <ProductDays>1</ProductDays>
                  <ProductBookingCode>1</ProductBookingCode>
                  <StayDateRange Start="2019-01-19T00:00:00" End="2019-01-19T00:00:00"/>
                  <CancelPenaltiesStartDate xsi:nil="true"/>
                  <ProviderLocator>Z58X8D</ProviderLocator>
                  <Concepts>
                     <BookResponseV2Concept>
                        <ConceptCode>1398</ConceptCode>
                        <ConceptName>Coche Berlina Tipo A</ConceptName>
                        <Quantity>1</Quantity>
                        <ConceptBookingCode>42</ConceptBookingCode>
                        <AgeFrom>0</AgeFrom>
                        <AgeTo>99</AgeTo>
                        <IsChild>false</IsChild>
                        <PickUpTime>09:00</PickUpTime>
                        <Duration>0</Duration>
                        <Guests>
                           <Guest>
                              <GivenName>Jose</GivenName>
                              <Surname>Vicente</Surname>
                              <BirthDate xsi:nil="true"/>
                              <PhoneNumber/>
                              <Email/>
                              <DocumentID/>
                              <Age>0</Age>
                              <IsChild>false</IsChild>
                           </Guest>
                        </Guests>
                        <Details>
                           <BookResponseV2Detail>
                              <DetailName>Coche Berlina Tipo A</DetailName>
                              <DetailBookingCode/>
                              <Date xsi:nil="true"/>
                              <OnRequest>false</OnRequest>
                              <Total>
                                 <Taxes Amount="52.5000" CurrencyCode="EUR" NumDecimals="2">
                                    <Commissions>
                                       <SellingPrice>52.5000</SellingPrice>
                                       <CommissionableAmount>52.5000</CommissionableAmount>
                                       <NotCommissionableAmount>0.0000</NotCommissionableAmount>
                                       <CommissionAmount>0.0000</CommissionAmount>
                                       <NetAmount>52.5000</NetAmount>
                                    </Commissions>
                                 </Taxes>
                              </Total>
                              <Offer>false</Offer>
                           </BookResponseV2Detail>
                        </Details>
                     </BookResponseV2Concept>
                  </Concepts>
               </BookResponseV2Product>
               <BookResponseV2Product>
                  <Status>Cancelled</Status>
                  <ProductCode>1352</ProductCode>
                  <ProductName>Traslado XML (PRIVADO)</ProductName>
                  <ProductDays>1</ProductDays>
                  <ProductBookingCode>1</ProductBookingCode>
                  <StayDateRange Start="2019-01-19T00:00:00" End="2019-01-19T00:00:00"/>
                  <CancelPenaltiesStartDate xsi:nil="true"/>
                  <ProviderLocator>Z58X8D</ProviderLocator>
                  <Concepts>
                     <BookResponseV2Concept>
                        <ConceptCode>1398</ConceptCode>
                        <ConceptName>Coche Berlina Tipo A</ConceptName>
                        <Quantity>1</Quantity>
                        <ConceptBookingCode>43</ConceptBookingCode>
                        <AgeFrom>0</AgeFrom>
                        <AgeTo>99</AgeTo>
                        <IsChild>false</IsChild>
                        <DeliveryTime>15:30</DeliveryTime>
                        <Duration>0</Duration>
                        <Guests>
                           <Guest>
                              <GivenName>Jose V</GivenName>
                              <Surname>Ferrero</Surname>
                              <BirthDate xsi:nil="true"/>
                              <PhoneNumber/>
                              <Email/>
                              <DocumentID/>
                              <Age>0</Age>
                              <IsChild>false</IsChild>
                           </Guest>
                        </Guests>
                        <Details>
                           <BookResponseV2Detail>
                              <DetailName>Coche Berlina Tipo A</DetailName>
                              <DetailBookingCode/>
                              <Date xsi:nil="true"/>
                              <OnRequest>false</OnRequest>
                              <Total>
                                 <Taxes Amount="52.5000" CurrencyCode="EUR" NumDecimals="2">
                                    <Commissions>
                                       <SellingPrice>52.5000</SellingPrice>
                                       <CommissionableAmount>52.5000</CommissionableAmount>
                                       <NotCommissionableAmount>0.0000</NotCommissionableAmount>
                                       <CommissionAmount>0.0000</CommissionAmount>
                                       <NetAmount>52.5000</NetAmount>
                                    </Commissions>
                                 </Taxes>
                              </Total>
                              <Offer>false</Offer>
                           </BookResponseV2Detail>
                        </Details>
                     </BookResponseV2Concept>
                  </Concepts>
               </BookResponseV2Product>
            </Products>
         </DestServicesReadV2Result>
      </DestServicesReadV2Response>
   </soap:Body>
</soap:Envelope>