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 the TktDocAdmin 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 a remark, 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 in presentCardAction in the request. The presentCreditCard indicator must be set on the VCR when using the verification 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"
        }
    ]
}