Retrieves detailed ticket information for a specific order item
GET/api/v1/order/tickets/:orderItemId
Fetches comprehensive ticket details for all tickets associated with a specific order item (order row). Returns ticket fields including barcode, seat information, event details, customer information, and venue information. Only returns tickets with status greater than 299 (PrintAttempt) and with a non-empty barcode. Used to display ticket details after order confirmation and printing.
SOAP Equivalent: AWSP_OrderGetTicketField
Examples
✅ Success (200)
{
"ticketFields": [
{
"eventSessionDate": "2024-06-15T20:00:00Z",
"orderId": 12345,
"orderCreationDate": "2024-05-10T14:30:00Z",
"amount": 45.50,
"fees": 2.50,
"barCode": "1234567890123",
"fiscalNumber": "FISCAL123",
"rank": "A",
"seat": "12",
"identityId": 1001,
"identityName": "Dupont",
"identityFirstname": "Jean",
"eventType": "Concert",
"categoryLabel": "Orchestre",
"designationLabel": "Place numérotée",
"rateLabel": "Plein tarif",
"rateSmallLabel": "PT",
"floorLabel": "Rez-de-chaussée",
"doorLabel": "Entrée principale",
"tribuneLabel": "",
"blockLabel": "Bloc A",
"accessLabel": "Accès normal",
"contingentLabel": "",
"eventLabel": "Concert de Jazz",
"eventSmallLabel": "JAZZ2024",
"venueLabel": "Salle Pleyel",
"eventGroupLabel": "Saison 2024",
"venueAdress1": "252 Rue du Faubourg Saint-Honoré",
"venueAdress2": "",
"venueAdress3": "",
"venueAdress4": "",
"venueCity": "Paris",
"venueZipCode": "75008",
"ticketInfo1": "Info supplémentaire 1",
"ticketInfo2": "Info supplémentaire 2",
"ticketInfo3": "",
"ticketInfo4": "",
"producerLicence": "LIC123",
"producerName": "Producteur XYZ",
"seatId": 5678
}
]
}
✅ Success (200) - Empty list
{
"ticketFields": []
}
❌ Error 400 - Missing x-tenant header
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "The x-tenant header is required"
}
❌ Error 400 - Validation failed
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "orderItemId must be greater than 0"
}
Error ❌ 403 - Forbidden
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.4",
"title": "Order item access denied",
"status": 403,
"detail": "You don't have permission to access this order item. It belongs to a different interface.",
"errorCode": 10117
}
Error ❌ 404 - Not Found
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Order item not found",
"status": 404,
"detail": "The specified order item ID is invalid or does not exist",
"errorCode": 10109
}
Error ❌ 500 - Server error
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
"title": "Internal Server Error",
"status": 500,
"detail": "An unexpected error occurred",
"traceId": "00-abc123-def456-00"
}
SOAP to REST Field Mapping
| REST Field | SOAP Field | Type | Notes |
|---|---|---|---|
orderItemId (path) | ID_OrderRow (param) | int | Identifiant de la ligne de commande |
eventSessionDate | DateSeance | DateTime | Date de la séance |
orderId | ID_Order | int | Identifiant de la commande |
orderCreationDate | DateCreation | DateTime | Date de création de la ligne de commande |
amount | Amount1 | decimal | Montant du ticket hors frais |
fees | Amount - Amount1 | decimal | Frais |
barCode | BarCode | string | Code-barres |
fiscalNumber | FiscalNumber | string | Numéro fiscal |
rank | Rank | string | Rang |
seat | Seat | string | Place |
seatId | ID_Seat | int | Identifiant de la place |
identityId | ID_Identity | int | Identifiant du client |
identityName | NomClient | string | Nom du client |
identityFirstname | PrenomClient | string | Prénom du client |
eventType | TypeEvent | string | Type d'événement |
categoryLabel | Categorie | string | Catégorie |
designationLabel | Libelle | string | Libellé |
rateLabel | Tarif | string | Tarif |
rateSmallLabel | Tarif_Code | string | Code tarif |
floorLabel | Etage | string | Étage |
doorLabel | Porte | string | Porte |
tribuneLabel | Tribune | string | Tribune |
blockLabel | Bloc | string | Bloc |
accessLabel | Acces | string | Accès |
contingentLabel | Reserve | string | Réserve/Contingent |
eventLabel | Manifestation | string | Manifestation |
eventSmallLabel | Manifestation_Code | string | Code manifestation |
venueLabel | Lieu | string | Lieu |
eventGroupLabel | Saison | string | Saison |
venueAdress1 | Lieu_Adresse_1 | string | Adresse lieu ligne 1 |
venueAdress2 | Lieu_Adresse_2 | string | Adresse lieu ligne 2 |
venueAdress3 | Lieu_Adresse_3 | string | Adresse lieu ligne 3 |
venueAdress4 | Lieu_Adresse_4 | string | Adresse lieu ligne 4 |
venueCity | Lieu_Ville | string | Ville |
venueZipCode | Lieu_CodePostal | string | Code postal |
ticketInfo1 | TicketInfo1 | string | Info ticket 1 |
ticketInfo2 | TicketInfo2 | string | Info ticket 2 |
ticketInfo3 | TicketInfo3 | string | Info ticket 3 |
ticketInfo4 | TicketInfo4 | string | Info ticket 4 |
producerLicence | LicenceProducteur | string | Licence producteur |
producerName | NomProducteur | string | Nom producteur |
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
OK
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error