What is it?
The Fulfillment Document Update API is used to update Electronic Miscellaneous Documents (EMDs) and tickets.
Why use it?
With the Fulfillment Document Update API, you can mark documents (EMDs and tickets) locked in a historical database with an "active" status, allowing them to be updated as needed by Travel Agents.
This API also supports the Present Credit Card feature, which is currently avaible in host/PSS. Any hosted carrier can directly call the API and consume this capability.
Functionality
The following functionalities are included within Fulfillment Document Update:
EMDs and Tickets
The reactivate update function of this API takes a historical EMD, on which no updates can be made, and moves the document to an active database. Once complete, updates like changing coupon status can be made using other APIs.
Present Credit Card
- Enable and disable the Present Credit Card indicator on the host carrier's Virtual Coupon Record (VCR).
- Verify Present Credit Cards on the host carrier's VCR to reduce fraudulent credit card use when purchasing tickets.
Features
- Manage customer service issues; for example, a service was marked as
USED
, but the customer was not provided the service due to operational issues - Improved accuracy and revenue recognition
- Update document statuses in the event the initial consumption was inaccurate
- Reduce fraudulent credit card use in ticket purchases
How it works
Reactivate EMDs
The core function of Fulfillment Document Update is to reactivate Electronic Miscellaneous Documents (EMDs) and tickets by taking a historical document and placing it into an active database. In order to achieve this:
- Travel Agents must have the
ICCTL
keyword or theTktDocAdmin
attribute assigned to their Electronic Personal Record (EPR) - The EMD or ticket must be in the historical database
- Fulfillment Document Update will not update the coupon status or re-display the EMD once it has been moved to the active database. Separate API calls need to be made to update or display the EMD.
Present Credit Card Action
Fulfillment Document Update also supports the following features:
- Enable present credit card indicators on the Virtual Coupon Record (VCR) when a specified
enablePresentCard
is in the request - Disable present credit card indicators on the VCR when a specified
disablePresentCard
, along with aremark
, are present in the request
Note: To use this feature, Travel Agent must have the PCCAGT
keyword assigned to their EPR.
- Verify the present credit card indicator at the time of check-in.
verification
must be specified inpresentCardAction
in the request. ThepresentCreditCard
indicator must be set on the VCR when using theverification
action. - In order to utilize the Present Credit Card functionality, the
PRESENT CREDIT CARD
functionality must be enabled in the Ticketing Option Table for the Hosted carrier
How to use
Refer to the Help tab for full documentation.
Resources
Fulfillment Document Update
Reactivate Historical EMD
Sample Request
{
"apiVersion" : "1.0.0",
"context" : "Client.ID",
"ticketingProvider" : "AA",
"fetchDocumentDetails" : false,
"documents" : [
{
"documentId" : {
"type" : "EMD",
"number" : "0011503858106",
"localIssueDate" : "2020-03-31"
},
"updates" : [
{
"action" : "reactivate",
"subaction" : "HIST"
}
]
}
]
}
Sample Response
{
"apiVersion" : "1.0.0",
"context" : "Client.ID",
"id" : "CE4F78490DCE4588A221DCAB55DB121E",
"documents" : [
{
"documentId" : {
"type" : "EMD",
"number" : "0011503858106",
"localIssueDate" : "2020-03-31"
},
"actionStatuses" : [
{
"action" : "reactivate",
"subaction" : "HIST",
"status" : "Success"
}
],
"status" : "Success"
}
]
}