Prepared tickets are pre-filled tickets for customers to pick up in the Customer Portal. Prepared tickets contain at least a VIN, a reference to a vehicle model and should have at least one product-line to be usable for a customer.
A prepared ticket is a ticket with pre-filled data that can be picked up by a customer in the Customer Portal. Prepared tickets appear in the Customer Portal when a VIN, vehicle model and an associated product-line is present.
id | string <uuid> Ticket identifier. |
created_at | string <date-time> Date and time of creation. |
customer_id | string <uuid> Identifier of the customer for whom the ticket was created. |
ticket_number | integer <int64> Human-readable ticket identifier. |
vehicle_model_id | integer <int64> Identifier of the vehicle model on the ticket. |
vin | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "created_at": "2019-08-24T14:15:22Z",
- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "ticket_number": 7440303,
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
Retrieve a list of prepared tickets.
Successful response.
An error occurred - see status code and problem response for more information.
{- "query": {
- "limit": 25,
- "offset": 0
}, - "result": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "created_at": "2019-08-24T14:15:22Z",
- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "ticket_number": 7440303,
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
], - "total": 3255
}
Create a new prepared ticket.
The prepared ticket you wish to create.
customer_id required | string <uuid> Identifier of the customer for whom the ticket was created. |
vehicle_model_id required | integer <int64> Identifier of the vehicle model on the ticket. |
vin required | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference required | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
Created.
id | string <uuid> Ticket identifier. |
created_at | string <date-time> Date and time of creation. |
customer_id | string <uuid> Identifier of the customer for whom the ticket was created. |
ticket_number | integer <int64> Human-readable ticket identifier. |
vehicle_model_id | integer <int64> Identifier of the vehicle model on the ticket. |
vin | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
An error occurred - see status code and problem response for more information.
{- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "created_at": "2019-08-24T14:15:22Z",
- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "ticket_number": 7440303,
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
Retrieve a single prepared ticket by its identifier.
Successful response.
id | string <uuid> Ticket identifier. |
created_at | string <date-time> Date and time of creation. |
customer_id | string <uuid> Identifier of the customer for whom the ticket was created. |
ticket_number | integer <int64> Human-readable ticket identifier. |
vehicle_model_id | integer <int64> Identifier of the vehicle model on the ticket. |
vin | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
An error occurred - see status code and problem response for more information.
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "created_at": "2019-08-24T14:15:22Z",
- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "ticket_number": 7440303,
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
Update a single prepared ticket by its identifier.
The prepared ticket you wish to update.
vehicle_model_id required | integer <int64> Identifier of the vehicle model on the ticket. |
vin required | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code required | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference required | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
Successful response.
id | string <uuid> Ticket identifier. |
created_at | string <date-time> Date and time of creation. |
customer_id | string <uuid> Identifier of the customer for whom the ticket was created. |
ticket_number | integer <int64> Human-readable ticket identifier. |
vehicle_model_id | integer <int64> Identifier of the vehicle model on the ticket. |
vin | string or null = 17 characters Vehicle Identification Number (VIN) of the vehicle on the ticket. |
voucher_code | string or null [ 4 .. 8 ] characters [A-Z0-9] Voucher code. |
preparer_external_reference | string [ 0 .. 255 ] characters This custom external reference, provided by the ticket preparer, is used for the purpose of communicating with other applications. |
An error occurred - see status code and problem response for more information.
{- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "created_at": "2019-08-24T14:15:22Z",
- "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
- "ticket_number": 7440303,
- "vehicle_model_id": 0,
- "vin": "string",
- "voucher_code": "WQ4MM3",
- "preparer_external_reference": "DYNAMICS_ERP_3454662"
}
Delete a single prepared ticket by its identifier.
Successfully removed.
An error occurred - see status code and problem response for more information.
Returned when the request cannot be handled due to something that is perceived to be a client error.
{- "detail": "The request violates one or more constraints. Please resolve all of them and try again.",
- "status": 400,
- "title": "Bad request",
- "type": "/problems/violations",
- "violations": [
- {
- "property_path": "gross_price.amount",
- "in": "body",
- "detail": "Value must be greater than 0"
}, - {
- "property_path": "provider_id",
- "in": "query",
- "detail": "Provider with ID 3445 does not exist."
}
]
}
Transition a single prepared ticket by its identifier.
The changes you wish to make.
required | Queue for service (object) Transition this ticket to a different state. | ||||||||||||||||
One of: The ticket will be marked as pending in the ticket workspace, indicating it is ready to be picked up by an operator.
|
{- "transition": {
- "type": "queue-for-service",
- "confirmed_unattended_service": false,
- "connector_id": "9389ba6f-3696-4571-84d4-34d588c4b109",
- "customer_reference": "",
- "metadata": {
- "app_name": "string",
- "app_version": "string",
- "battery_state": "string",
- "device_manufacturer": "string",
- "device_model": "string",
- "latitude": "string",
- "locale": "string",
- "longitude": "string",
- "platform": "string",
- "platform_version": "string"
}, - "product_prerequisites": [
- {
- "prerequisite_id": 161,
- "value": "true"
}
]
}
}
{- "status": 400,
- "type": "about:blank",
- "title": "Some title for the error situation",
- "detail": "Some description for the error situation"
}