Sådan opretter du en affiliate med API adgang

En affiliate er en agent, som henviser kunder til dit bureau enten via links direkte til jeres website, eller ved at booke direkte i jeres system via en teknisk integration (API). Når en affiliate laver en booking, bliver denne booking markeret med den pågældende affiliate, således at man kan se, hvor bookingen kommer fra. Eksempelvis kan portalerne Fejø, Cofman og Feline nævnes som typiske affiliates.

For at oprette en affiliate skal du gøre tre ting:

1. Oprette en affiliate
2. Oprette en API bruger, som denne affiliate kan bruge til at opnå adgang til systemet via vores API
3. Konfigurere API'en
   
   

Step 1 - Opret affiliate 

• Gå til Kontrolpanel -> Affiliates
• Klik på knappen "Opret"
• Udfyld feltet med navnet på din affiliate, f.eks. Fejø
• Klik på knappen "Gem"
  
  

Step 2 - Opret bruger

• Gå til Kontrolpanel -> Brugere
  
  
• Klip på knappen "Opret bruger"

1 Vælg hvilken målgruppe denne affiliate skal benytte. Målgruppen er bestemmende for hvilke ferieboliger, varer og prisregler som affiliaten har adgang til

2 Udfyld feltet Navn med navnet på affiliaten

3 Udfyld feltet E-mail. Ønskes der ingen e-mail skriver man blot [e-mail]

4 Udfyld feltet Brugernavn. Bemærk at dette skal være på minimum 6 tegn.

5 Udfyld feltet Adgangskode og gentage i feltet nedenunder.

Vigtigt

• Du skal ikke sende brugernavn og adgangskode til en affiliate
• Du skal ikke vælge nogle roller til en bruger, der oprettes til en affiliate
• Du skal ikke give adgang til backend
• Spring over området vedr. API - det vender vi tilbage til lige om lidt

6 - Vælg hvilken debitor konto, der skal bogføres på, når salget kommer via denne affiliate

•  Spring over området vedr. profilbillede

7 - Tryk på knappen "Gem"

Nu har du fået oprette en bruger og mangler blot at få konfigureret API'en.

Step 3 - Konfigurer API

• Fra oversigten over brugere klikker du rediger ud for den du netop har oprettet
• I områder vedr. API (som vi sprang over lige før) sætter du flueben i "Tillad API login"
• Vigtigt: Du skal IKKE sætte hak i "Tillad også API Admin login" 
• Noter den "API nøgle" som fremkommer nederst i kassen vedr. API. Det er den, som skal sendes til din affilliate.
  
  
• Klik på fanen "Partner API"

1. Klik i affiliate ud for partnertype
2. Vælg den affiliate fra rullegardinet som du oprettede under "Opret affiliate" i starten af denne guide
3. Hvis affiliaten ikke skal kunne ignorere eller glemme obligatoriske varer, kan du sætte flueben ud for "Beskyt obligatoriske varer"
4. Strategi til håndtering af bookingpris.
   "Brug altid systemets aktuelle pris" = Standard
   Anden valgmulighed "Returner fejl hvis angivende pris er forskellig fra systemets aktuelle pris"
   Strategi til håndtering af bookingens betalingsrater
   "Brug systemets betalingsrater" = standard
   Anden valgmulighed "Brug de angivende betalingsrater med tilbagefald på systemets betalingsrater".
   Her skal de angivende rater overholde følgende for at blive anvendt:
   • Summen af rater skal være bookingens pris
   • Der må maks. være to rater og begge rater skal forfalde senest på ankomstdagen.
   Hvis ikke ovenstående er overholdt, eller hvis man ikke sender betalingsrater med, så anvendes systemets rater blot i stedet for.
5. Vælg om denne affiliate skal anvende bureautekster eller agenttekster (det er teksterne på dine ferieboliger)
6. Hvis affiliaten må læse alle jeres faciliteter, skal du sætte flueben i "Tillad alle faciliteter". Ønsker du at begrænse hvilke faciliteter affiliaten må vise, skal du sætte flueben ud for de faciliteter, du ønsker er tilgængelige
7. Hvis en affiliate må læse nogle af jeres rapportlister (fra listegeneratoren), så sæt flueben ud for dem, som de må læse i listen "Tilladte rapportlister"
   OBS Hvis I har oprettet en liste i listegeneratoren som affiliaten får adgang til, så vil affiliaten ikke kunne ændre i eventuelle filtre - de kan kun se listen med de filtre, den er oprettet med - dette gælder også filtrering på datoer - de kan heller ikke rettes
8. Hvis der er oprettet specialfelter i BookingStudio, er det muligt at give en API adgang til dem her.
9. Hvis der er oprettet distributionslister i BookingStudio, er det muligt at give en API adgang til dem her.

Klik på knappen "Gem"

Ofte stillede spørgsmål vedr. oprettelse af affiliates

Kan min affiliate logge på vores BookingStudio Administration?
Se svar her

Hvad skal jeg sende til min affiliate, for at de kan få adgang til API'en?
Se svar her

Hvad er vores installationsnavn?
Se svar her (sidste afsnit i artiklen)