Skip to main content

Add Attendant data

Note: This guide begins from the Add Client Data step of our Purchase Flow Guide , you can review it to have the necessary information about the previous steps.

Attendant fields (event with attendant tickets)#

For some events it will be necessary to add information regarding the event attendant.

Let's get started with the examples

Step-by-step examples#

This guide shows how to implement a complete booking flow step by step.

Prerequisites!
  • You will need a valid OAuth access_token to be able to make each call! Please refer to our Authentication Guide to obtain one.

  • To know if you should request this information from the user, you must verify that the attribute nominal has the value true, you can check it in the session-info response.

    Link to session-info Specification
  1. To obtain the necessary fields for the assistant, you must make a call to /event/{idEvent}/eventField?fieldGroup=EVENT_ATTENDANT. These fields must be requested from the client just before creating the order.Link to Get Event Attendants Fields Specification
  2. An example of what a call would be like to add the assistant fields to the shopping cart is detailed below.
  • seat-id: The identifier of the selected seat
  • session-id The id of the session this seat belongs to.
curl --location --request POST 'http://gateway-pre.oneboxtickets.net/onebox-rest2/rest/shoppingCart/addAttendant' \--data-urlencode 'attendants=<?xml version="1.0" encoding="UTF-8"?><attendantList xmlns="http://www.oneboxtm.es/ns/input-data/shopping/cart"><attendantSeat><attendant><field name="ATTENDANT_NAME" value="carles"/><field name="ATTENDANT_SURNAME" value="colom"/><field name="ATTENDANT_ID_NUMBER" value="79808197Z"/></attendant><seat id="{{seat-id}}" sessionId="{{session-id}}"/></attendantSeat></attendantList>' \--header 'Authorization: Bearer {{access_token}}' \--header 'Accept: text/xml' \--header 'Content-Type: application/x-www-form-urlencoded'

In addition to the postman Curl above, in the example below you can see the attendantList XML structure more clearly:

<attendantList xmlns="http://www.oneboxtm.es/ns/input-data/shopping/cart">  <attendantSeat>      <attendant>          <field name="ATTENDANT_NAME" value="carles"/>          <field name="ATTENDANT_SURNAME" value="colom"/>          <field name="ATTENDANT_ID_NUMBER" value="79808197Z"/>      </attendant>      <seat id="135848798" sessionId="610897"/>  </attendantSeat></attendantList>
Link to Add Attendant Specification