AddisFly - Partner Portal Onboarding — SOP
Partner Portal Onboarding — SOP
Who this is for: Sales & Marketing, Sales Managers, Accounts, Booking Admins. What it covers: taking a B2B travel agency from first contact to booking live on the AddisFly Partner Portal — and how their access is reviewed and ended.
Golden rule: a partner never goes live half-configured. The system now blocks it — this SOP tells you how to complete it properly.
The stages at a glance
| Stage | What happens | Who does it |
|---|---|---|
| 0. Qualify | Collect documents + agree commercial terms | Sales & Marketing |
| 1. Prepare | Create the Partner Account (Pending Approval) | Sales & Marketing |
| 2. Approve | Access level, PCC, credit limit, dates | Sales Manager (+ Accounts) |
| 3. Go live | Grant portal login + supervised first booking | Sales Manager |
| 4. Operate | Partner manages their own staff; credit runs automatically | Partner / Accounts |
| 5. Review & offboard | Quarterly review; end-date revokes access | Sales Manager + Accounts |
Stage 0 — Qualify (before anything is created)
Do not create a Partner Account until you have:
- [ ] Trade licence number
- [ ] IATA number (if they are IATA-accredited — not all partners are)
- [ ] Signed partnership agreement
- [ ] Agreed credit terms (limit, payment terms, credit period)
- [ ] A named contact person + email — this becomes their portal login
Giving portal access means giving a company the ability to hold live airline inventory against your PCC. Treat it like opening a credit account, because that is what it is.
Stage 1 — Prepare the account (Sales & Marketing)
- Go to Partner Account → New.
- Fill in:
- Partner Name — the agency's legal name
- Contact Person / Contact Email / Contact Phone — the email is their login, so get it right
- Trade Licence Number, IATA Number
- Partnership Start Date (and End Date if the agreement is term-limited)
- Leave Status = Pending Approval. Do not set it Active yourself.
- Save, then tell the Sales Manager it is ready for approval.
The Customer record is created and linked automatically — you do not need to make one.
Stage 2 — Approve (Sales Manager, with Accounts)
The Sales Manager reviews the account and sets:
- Portal Access Level — see the table below. Default and recommended:
Booking + Cancel. - PCC — the partner's own Travelport PCC, i.e. the PCC they book under in their own GDS. It is required before the account can go Active. If they do not have one, enter the agency default (
593Y). > What the PCC does and does not do: it routes GDS requests on the uAPI path so their segments can count under their own plate with the airlines. It does not drive reporting in our system — AddisFly issues every ticket under593Y, and a booking is attributed to a partner by the Partner Account link on the Booking, not by this field. - Credit Limit, Payment Terms, Credit Period — set with Accounts.
- Auto-suspend on zero credit — leave enabled.
Credit approval: credit limits above 500,000 ETB require the owner's sign-off before the account goes Active. At or below 500,000, a Sales Manager + Accounts may approve.
Portal access levels
| Level | Partner can | Use when |
|---|---|---|
| Booking Only | Search + create held bookings | Very new / unproven partner |
| Booking + Cancel ✅ default | Search, book, cancel their own holds | Almost every partner |
| Self-Service (Funded) | Book, cancel and issue tickets | Only a funded, trusted partner — issuing commits money |
AddisFly issues the tickets. Partners at Booking + Cancel create a hold; our ticketing team issues it. This is deliberate — do not raise a partner to Self-Service without the owner's approval.
Credit & payment — how it really works
Booking never blocks on credit. Clients book unlimited. A booking is only a hold — no ticket, no money. Our agents decide credit at the moment of issuing, and if a client hasn't paid, the agent voids the hold before midnight. So a credit number never stops a client from booking; it is a guide for the agent at issuance.
Set the client's model with two fields on the Partner Account:
| Field | Meaning |
|---|---|
| Payment Terms | How they settle with us — Prepaid / Daily / Weekly / Monthly Settlement |
| Credit Period | How the limit resets — Total / Daily / Weekly / Monthly |
The three client types:
| Client type | Payment Terms | Credit Period | Credit Limit | Notes |
|---|---|---|---|---|
| Prepaid (e.g. GuangDong) | Prepaid | Total | = their advance | They top up in advance; they book against their wallet. Use Record Top-up / Payment to add funds. |
| Daily / same-day credit (most agencies) | Daily Settlement | Daily | e.g. 500,000 | Same-day limit that resets at midnight; they settle same day. |
| Cheque + agreement (guaranteed) | Weekly/Monthly Settlement | Weekly/Monthly | higher | Trusted, guarantee on file — if a bank daily-transfer cap holds them, they may pay next day. |
The limit is a guardrail for your agents, not a wall for the client. If a hold is over the guideline, the agent sees a note and decides whether to issue. Only a Self-Service (Funded) partner self-issuing is hard-stopped — they cannot spend more than their topped-up wallet, because at that moment they are spending, not us.
Stage 3 — Go live (Sales Manager)
- Work through the onboarding checklist auto-created with the account (Trade licence → IATA → Agreement → PCC → Credit → Portal user → Activate). Steps marked required for activation must be done first. > Checklists are auto-created for new accounts. Older partner accounts may not have one — in that case use the Go-live checklist at the end of this page.
- Click Actions → Approve (top-right). One step: it activates the partner AND emails their portal login to the Login Email. Only approvers (Access Approver / System Manager) see this button.
- If anything is missing, the system stops you and lists exactly what: PCC, Customer, Portal Access Level, Credit Limit, Login Email. Complete them and save again.
- Activating the partner automatically creates their portal login and emails the reset link — you usually do not need to click anything else.
- Create / Send Portal Login button — use this only to re-send the reset email or if the login needs recreating. It creates a portal-only (Website User) login and never touches a staff/desk user. (If you're a Sales User it will tell you this is a Sales Manager step — that's expected.)
- Supervised first booking — get the partner on a call or screen-share and have them do one real booking end-to-end:
- Search → select → passenger details → Confirm → a PNR appears
- Then cancel that booking together
- This is their training and your verification, on real fares, at no cost (a cancelled hold costs nothing).
Partner is now live.
Stage 4 — Operate
- The partner adds their own staff. Their admin user uses Agents in the portal to invite colleagues and set each one's role. You do not create these logins.
- Credit runs itself — they get alerts as they approach their limit, and the account auto-suspends at zero credit.
- Their bookings appear in our Pending Ticketing queue for our team to issue.
Partners who book in their own GDS (queue / "Partner Ticket")
Many agencies — especially those with their own PCC — do not book in our portal. They book in their own GDS and send us the PNR to plate. Handle it like this:
- The partner books in their own system and sends you the record locator (PNR) plus the fare they expect.
- In the GDS Terminal, click Partner Ticket and fill the dialog:
- PNR — their record locator
- Bill to Partner — pick their Partner Account (this is what bills their account and makes the booking attribute to them)
- Partner-stated fare — what they quoted
- The system captures it as a Booking in Pending Ticketing billed to that partner, then auto-retrieves the PNR.
- Verify the fare in the GDS (
*FF) before plating. The partner-stated fare is only a claim — the GDS is the truth. - Issue it (terminal
TKP, or the booking's Issue Ticket button). We plate on 593Y.
This does not auto-issue — an agent always verifies the fare first. If the partner has no Partner Account selected, the booking falls back to Walk-in and will not bill them — always set Bill to Partner.
Stage 5 — Review & offboard
- Quarterly: review active partners. Disable logins for anyone dormant or no longer trading with us.
- When a partnership ends: set the Partnership End Date, set Status to Inactive/Suspended, disable the portal logins, and settle any outstanding wallet balance with Accounts.
Access must never simply be left running after a relationship ends.
Who is allowed to do what
| Action | Allowed roles |
|---|---|
| Create / edit a Partner Account | Sales User (S&M), Booking Admin, System Manager |
| Grant portal access (Create Portal Login) | Sales Manager, Booking Admin, Accounts Manager, Access Approver, System Manager |
| Set PCC / ticketing config | Booking Admin, Booking Issuer, System Manager |
| Set credit limit / terms | Accounts Manager |
| Raise a partner to Self-Service (issuing) | Owner approval required |
Maker–checker: Sales & Marketing prepares the account; a Sales Manager approves it and grants access. HR does not grant partner access.
Troubleshooting
| Symptom | What it means / what to do |
|---|---|
| "You are not permitted to access this resource" when granting a login | Your role cannot provision logins. Ask a Sales Manager. |
| "Partner cannot go live — missing: …" | The account is incomplete. Fill the listed fields, then set Active. |
| Partner says booking spins and fails | Ask them to hard-refresh (Ctrl+Shift+R / reopen the portal) and retry. If it persists, raise an Issue with a screenshot. |
| Partner sees "Needs Attention — Contact AddisFly" with a PNR | The reservation exists at the GDS but did not save our side. Send us that PNR — do not let them rebook. |
| Partner cannot issue a ticket | Correct and by design — AddisFly issues. Only Self-Service (Funded) partners can issue. |
| Partner's bookings not showing under their name | The Booking is not linked to their Partner Account (attribution comes from that link, not from the PCC). Make sure the booking was made in the portal, or captured with Partner Ticket → Bill to Partner in the GDS Terminal. |
Go-live checklist (print this)
- [ ] Trade licence + IATA number recorded
- [ ] Signed agreement on file
- [ ] Customer linked (automatic)
- [ ] PCC set
- [ ] Portal Access Level set (
Booking + Cancelunless approved otherwise) - [ ] Credit limit, payment terms, credit period set (owner sign-off if above threshold)
- [ ] Partnership start date (and end date if applicable)
- [ ] Login email correct
- [ ] Status = Active
- [ ] Portal login created + reset email received
- [ ] Supervised first booking completed and cancelled