Skip Navigation

Registration and Management

Profiles Registration and Management

With the most recent enhancements to the Agency Portal feature, airlines have the ability to offer agency and agent registration for its customers. Agencies and agents also have an option to modify their accounts.

Scope of work in as for the 1st phase of Agency Portal implementation:

  • Agency creation – enhancement;
  • Agent account creation process done by an Agency:
    • For a standard user,
    • For superuser agent.

Superuser agent has more privileges comparing to a standard user. Superusers have access to managing reservations created by any agent within the same agency, while the standard users' access is limited to own reservations (an option to create and retrieve bookings provided in the 2nd phase of the implementation).

  • Manage Agency account – enhancement;
  • Manage Agent accounts:
    • By an Agent,
    • By an Agency:
      • Agency has privileges to create and manage its own account, as well as agents’ accounts;
      • Agency – apart from a standard account modification - can change the status of the agent’s account from inactive to active and vice versa.
  • Search for Agent accounts;
  • Login – Retrieve authenticated account details:
    • Agency,
    • Agent.

Prerequisites

  • Agreement with CI (Customer Insight) to offer an ability to store Agencies and Agents profiles.
  • Agreement with AMS (Agency Manager) to offer Agency Credit Limit as a form of payment in the web application (that information is kept in the profile).

Highlights

Creating and Managing Agencies

Agency profile can be created and modified with the following sequence of Digital Connect service calls (from the UI perspective):

On the Agency Login page, the airline Administrator clicks the Enroll Agency link and the Enroll Agency page opens (on the airline UI).

  1. The Administrator provides all the necessary agency information and clicks Enroll Now. Call to the /profile/agency POST is being sent (with in-line and after-submit validation to detect any errors).
    IATA number is being sent in the UniqueId field (if configured) during Agency creation in the ProfileCreateRq (CustomerInsight).
  2. If all the information is provided correctly, Digital Connect response shows a successful message in the /profile/agency POST response and sends a confirmation email to the Administrator, if enabled. The agency is created in the Customer Insight (CI), as inactive, and does not have any funds assigned to it in the Agency Manager (AMS). Airline Admin needs to change the market in AMS, Activate the account using STAN and assign ACL funds in AMS system.
  3. The Administrator accesses the Agency Management System from the Community Portal and changes the agency market to an active appropriate market.
    1. The airline Administrator logs in to an active STAN (active and editable) version, goes to Agencies tab and searches for the agency. He can search by agency name, IATA number, and state (active and inactive).
    2. From the search results, the Administrator selects the agency. The Agency Information window opens. The Administrator changes the agency status to active, assigns the password and saves the changes. The airline updates the agency’s profile information with a /profile/agency PUT request. In-line and after-submit validation is applied to the page.
      If the airline enabled confirmation email, after activating and updating the agency account, the agency Administrator receives two confirmation emails, one containing the user name, and another one containing a password
    3. The airline Administrator can retrieve all the agencies created and update the agency-related information such as Administrator information and agency information. The airline can decide what fields are available for editing.
    4. The Airline Administrator logs in to the Agency Management System. The Administrator can assign funds and credit limit to the agency.
    5. The Agency Administrator can log in to the Administrator Portal (with loginID and password). The airline logs the agency in with the /login/agency POST service.
      Digital Connect consumer can send a request to the Agency Management System to view balance and list of transactions of the Agency credit limit account.

      POST request has to be sent to externalLoginData.url with follow parameters:SIDEUSERNAME=externalLoginData.loginID
      • SIDEPASSWORD=externalLoginData.passwordHash
      • login=true
      • emailpass=false
  4. After successful login the airline retrieves the agency profile with the /profile/agency GET service and displays the agency profile information.
  5. When the Administrator clicks the logout link the airline calls /login/agency DELETE to remove from the session the agency information. If the agency is successfully logged out the response returns the result of the logout operation.

Creating Agents’ Profiles

The Agency Administrator can create an account for each of your their travel agents in the Agency Administrator portal. The Agency Administrator can grant agents a regular user or superuser rights and based on them decide what information is available to an agent.

Agency Administrator can add agent(s)’ profiles with the following sequence of Digital Connect service calls:

  1. The Agency Administrator logs in to the Administrator Portal (with loginID and password). The airline logs the agency in with the /login/agency POST service.
  2. After successful login the airline retrieves information of the authenticated agency like balance and credit limit with the /login/agency GET service (if the account is created in AMS).
  3. Logged in Administrator goes to the Add an agent tab. Digital Connect checks the configuration to determine which fields on that page are mandatory to be filled.
  4. After the Administrator provides the agent's information and clicks Create Account call to the /profile/agency/agents POST is being sent (with in-line and after-submit validation to detect any errors). Digital Connect sends the ProfileCreate request to the profile system. The profile system returns a ProfileCreate response.
  5. If all the information is provided correctly, Digital Connect response shows a successful message in the /profile/agency POST response and sends a confirmation email to the agent, if enabled. The agent profile is created.
  6. The agent himself can log in to the Agent Portal (with loginID and password). The airline logs the agent in with the /login/agency/agents POST service.
    Digital Connect consumer can send a request to Agency Management System to view balance and list of transactions of the Agency credit limit account.
    POST request has to be sent to externalLoginData.url with follow parameters:
    • SIDEUSERNAME=externalLoginData.loginID
    • SIDEPASSWORD=externalLoginData.passwordHash
    • login=true
    • emailpass=false
  7. After successful login the airline retrieves the agent profile with the /profile/agency/agents GET service and displays the agent profile information.
  8. When the travel agent clicks the logout link the airline calls /login/agency/agents DELETE to remove from the session the agent information. If the agent is successfully logged out the response returns the result of the logout operation.

Updating Agent’s Profile by Agency

Airline Administrator can search for an agent and updates their profile with the following sequence of Digital Connect service calls:

  1. The Administrator logs in to the Administrator Portal (with loginID and password). The airline logs the agency in with the /login/agency POST service.
  2. After successful login the airline retrieves information of the authenticated agency like balance and credit limit with the /login/agency GET service (if particular Airline has an agreement with AMS and Agency does have an account created in AMS).
  3. Logged in Administrator opens the Manage Agents tab and searches for the agent by providing required data (depending on the airline configuration it could be agent’s firstName and/or lastName, pageNumber and elementsPerPage) in the /profile/agency/agents/search GET request. That service validates user eligibility in order to search for agent's accounts and then allows to perform a search for the agent's account. For the search to return results, the agency must have existing agents assigned to it.
  4. Digital Connect sends the ProfileRead request, reads the ProfileRead response and remembers all the profiles returned by the profile system. Digital Connect shows the profiles (the number of results is defined in the pageNumber and elementsPerPage) together with information about the profile status.
  5. After the Administrator clicked Make Changes next to the selected agent call to /profile/agency/agents GET is being sent with selected agent’s id in the request. Digital Connect opens the Manage Agent page. The page contains agent information retrieved from the profile system.
  6. When the Administrator clicks Update airline sends a call to /profile/agency/agents PUT, Digital Connect remembers the changes made to the profile and sends the ProfileUpdate request to the profile system.
  7. If all the information is provided correctly, Digital Connect shows a successful message in the /profile/agency/agents PUT response and sends a confirmation email to the travel agent, if enabled. The agent profile is updated.
  8. When the travel agent clicks the logout link the airline calls /login/agency/agents DELETE to remove from the session the agent information. If the agent is successfully logged out the response returns the result of the logout operation.

Updating Agent’s Profile by Agent

The portal for travel agents makes it possible for agents to create and manage passenger's reservations (bookings are included in the following phase). Those reservations can then be made available to the passengers for viewing or modification. The Agent portal is also a useful tool for tracking agents’ activity.

Airline travel agent can retrieve and updates his/her profile(s) with the following sequence of Digital Connect service calls:

  1. The travel agent logs in to the Agent Portal (with loginID and password). The airline logs the agent in with the /login/agency/agents POST service.
  2. After successful login, the airline retrieves information of the authenticated agent’s agency like balance and credit limit (if applicable for particular airline and agency) with the /login/agency GET service.
  3. After successful login the airline retrieves the agency profile with the /profile/agency/agents GET service and displays the agency profile information.
  4. The travel agent can update the agent’s profile-related information. The airline can decide what fields are available for editing.
  5. When the Agency Administrator clicks Update, call to /profile/agency/agents PUT is being sent and if the response is successful Digital Connect remembers the changes made to the profile and sends the ProfileUpdate request to the profile system.
  6. If all the information is provided correctly, Digital Connect response shows a successful message in the /profile/agency/agents PUT response and sends a confirmation email to the travel agent, if enabled. The agent profile is updated.
  7. When the travel agent clicks the logout link the airline calls /login/agency/agents DELETE to remove from the session the agent information. If the agent is successfully logged out the response returns the result of the logout operation.

Agency Password Reset

Airlines can offer an option to reset the agency profile password with the following sequence of Digital Connect service calls:

  1. Airline displays a prompt for agency login (login data credentials).
  2. The Administrator supplies login (username) and clicks Forgot password link
  3. The airline sends /profile/agency/resetPasswordKey POST with the username as a parameter. The airline retrieves the agency profile and email address (if found). In the response, the airline gets "resetPasswordKey".
  4. The airline sends an email with a reset password link.
  5. The Administrator provides the new password. The airline calls /profile/agency/resetPassword POST with new password and "resetPasswordKey" (to match it with a proper profile).

Agent Password Reset

Airlines can offer an option to reset the agent profile password with the following sequence of Digital Connect service calls:

  1. Airline displays a prompt for agent login (login data credentials).
  2. The agent supplies login (username) and click Forgot password link
  3. The airline sends /profile/agency/agents/resetPasswordKey POST with the username as a parameter. The airline retrieves the agent profile and email address (if found). In the response the airline gets "resetPasswordKey".
  4. The airline sends an email with a reset password link.
  5. The travel agent provides the new password. The airline calls /profile/agency/agents/resetPassword POST with new password and "resetPasswordKey" (to match it with a proper profile).

Error Handling

Agency tries to modify an unassociated agent

/login/agency

“status": "NotProcessed",
"type": "Application",
"errorCode": "ERR.SSW.PROFILE.NOT_ALLOWED",
"timeStamp": "2017-05-17T12:41:54",
"message": "You cannot modify an agent account which is not associated to your agency."

Agent tries to modify another agent

/login/agency

“status": "NotProcessed",
"type": "Application",
"errorCode": "ERR.SSW.PROFILE.NOT_ALLOWED",
"timeStamp": "2017-05-17T12:41:22",
"message": "Modifying another agent account is not permitted."

Agent tries to modify fields allowed only for agency admin

/login/agency/agents

{
"status": "NotProcessed",
"type": "Validation",
"errorCode": "ERR.SSW.CLIENT.INVALID_REQUEST",
"timeStamp": "2017-05-16T17:20:38",
"message": "Validation error",
-
"details": {
-
"agentProfile.profileType": [
"field.allowed.only.for.agency.admin"
],
-
"agentProfile.profileStatusActive": [
"field.allowed.only.for.agency.admin"
],
-
"agentProfile.password": [
"validation.field.required"
]
}