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