Herramientas de usuario

Herramientas del sitio


public:bookmodify

¡Esta es una revisión vieja del documento!


Modificación de reservas

Modificación de reservas.

Verbo HTTP: PATCH
Recurso:    /tour
Método:     /book

—————————————————————————————————————————————————

Parámetros obligatorios:
  * bookingID: Identificador de la reserva
Parámetros opcionales:
  * departure: Fecha nueva de salida del tour (para cambios en salidas del mismo tour)
  * pax: Número actual de personas en la reserva (para añadir personas)
  * bookingInfo: Información de los viajeros y habitaciones de la reserva
  * completeTour: Controla si se desea cambiar de tour completo a paricconsulta es sobre el tour completo o
    parcial (días en concreto). Por defecto: true
  * entryDate: Fecha de entrada al tour (para rutas parciales) -> yyyy-MM-dd
  * exitDate: Fecha de salida del tour (para rutas parciales) -> yyyy-MM-dd
  * output: Formato de salida de la consulta (XML o JSON)

—————————————————————————————————————————————————

Esquema de la petición

El elemento “bookingInfo” tiene la siguiente estructura:

  • BookingInfo → Root
    • Paxes → Contenedor de información sobre las personas
      • Pax → Elemento con la información sobre una persona
        • Id → Identificador de la persona en la información de la reserva
        • Name → Nombre
        • SurName → Apellidos
        • Passport → Pasaporte
        • Email → Email
        • Address → Dirección
        • Telephone1 → Teléfono 1
        • Telpehone2 → Teléfono 2
        • Child → Controla si la persona es un niño (menor de 8 años)
        • Age → Si la persona es un niño es obligatorio especificar su edad
        • DepartureFlight → Código del vuelo de ida
        • ReturnFlight → Código del vuelo de vuelta
    • Rooms → Contenedor de información sobre las habitaciones

Nota: La información sobre las personas, excepto el identificador, nombre y apellidos, podrá ser completada con posterioridad al momento de la reserva.

A continuación tenemos ejemplos del elemento “BookingInfo”:

Example.xml
<BookingInfo>
  <Paxes>
    <Pax Id="0" Name="string" SurName="string" Passport="string"  Email="string" Address="string" Telephone1="string" Telephone2="string" Child="false" Age="0" DepartureFlight="string" ReturnFlight="string" />
    <Pax Id="1" Name="string" SurName="string" Passport="string"  Email="string" Address="string" Telephone1="string" Telephone2="string" Child="false" Age="0" DepartureFlight="string" ReturnFlight="string" />
  </Paxes>
  <Rooms>
    <Room Type="Double" Category="Turista" Price="150.10">
      <PaxIds>
        <PaxId>0</PaxId>
   	<PaxId>1</PaxId>
      </PaxIds>		
    </Room>
  </Rooms>
</BookingInfo>
Example.json
{
  "Paxes": [
    {
      "Id": 0,
      "Name": "string",
      "SurName": "string",
      "Passport": "string",
      "Email": "string",
      "Address": "string",
      "Telephone1": "string",
      "Telephone2": "string",
      "Child": false,
      "Age": 0,
      "DepartureFlight": "string",
      "ReturnFlight": "string"
    },
    {
      "Id": 1,
      "Name": "string",
      "SurName": "string",
      "Passport": "string",
      "Email": "string",
      "Address": "string",
      "Telephone1": "string",
      "Telephone2": "string",
      "Child": false,
      "Age": 0,
      "DepartureFlight": "string",
      "ReturnFlight": "string"
    }
  ],
  "Rooms": [
    {
      "Type": 1,
      "Category": 0,
      "PaxIds": [
        0,1
      ],
      "Price": 150
    }
  ]
}

Esquema de la respuesta

  • TourList → Root
    • Tours → Contenedor
      • Tour → Elemento
        • Id → Identificador del tour
        • Name → Nombre del tour
        • Image → URL a la imagen del tour
        • URLURL a la descripción del tour

—————————————————————————————————————————————————

Respuestas de ejemplo

Example.xml
<TourList>
  <Tours>
    <Tour Id="1" Name="Esencia Europea 2017" Image="" URL="" />
    <Tour Id="2" Name="Europa Preferente 2017" Image="" URL="" />
    <Tour Id="3" Name="Ronda Europea 2017" Image="" URL="" />
    <Tour Id="4" Name="Viva Europa 2017" Image="" URL="" />
    <Tour Id="5" Name="Encanto de Europa 2017" Image="" URL="" />
    <Tour Id="6" Name="Europa Emocionante 2017" Image="" URL="" />
    <Tour Id="7" Name="Europa de Gala 2017" Image="" URL="" />
    <Tour Id="8" Name="Rutas de Europa 2017" Image="" URL="" />
    <Tour Id="9" Name="Europa Bella 2017" Image="" URL="" />
    <Tour Id="10" Name="Magia Europea 2017" Image="" URL="" />
  </Tours>
</TourList>

Example.json
{
  "Tours": [
    {
      "Id": 1,
      "Name": "Esencia Europea 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 2,
      "Name": "Europa Preferente 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 3,
      "Name": "Ronda Europea 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 4,
      "Name": "Viva Europa 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 5,
      "Name": "Encanto de Europa 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 6,
      "Name": "Europa Emocionante 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 7,
      "Name": "Europa de Gala 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 8,
      "Name": "Rutas de Europa 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 9,
      "Name": "Europa Bella 2017",
      "Image": "",
      "URL": ""
    },
    {
      "Id": 10,
      "Name": "Magia Europea 2017",
      "Image": "",
      "URL": ""
    }
  ]
}
public/bookmodify.1478782884.txt.gz · Última modificación: 2017/01/20 13:16 (editor externo)