Partnerprogramma

Deze sectie is voor partners: bedrijven die fremforge voor hun eigen klanten doorverkopen of implementeren. Ze beschrijft het commerciële mechanisme: wat het registreren van een deal je oplevert, hoe een klant de jouwe wordt, hoe de marge wordt berekend en hoe je wordt betaald.

Alles hier is ook beschikbaar via de Partner-API, zodat de hele stroom vanuit je eigen CRM kan lopen in plaats van vanuit een browser.

Zoek je de platformdocumentatie die je klanten gebruiken, begin dan bij Aan de slag.

Zo ziet het eruit

register a deal  ->  we approve it  ->  you win it  ->  you create the customer
      |                                                        |
      +-- 90-day protection on that company                    +-- margin counts
                                                                   from their first
                                                                   invoice onward

Er gebeuren vier dingen na elkaar, en elk daarvan is een status die je in het portaal of via de API kunt zien.

1. Registreer de deal, en wel vroeg

Een dealregistratie legt vast dat je met een bepaald bedrijf bezig bent, en start daarop een beschermingsperiode van 90 dagen.

Registreer zodra er een kans is, niet pas als de deal bijna rond is. Bescherming is het doel van registreren, en die geldt pas vanaf het moment dat je registreert.

We mailen je 14 dagen en 3 dagen voordat de periode afloopt, zodat een trage deal niet ongemerkt zijn bescherming verliest.

Als twee partners hetzelfde bedrijf registreren

De tweede registratie krijgt de status flagged. Dat is geen fout en geen afwijzing: de deal is geregistreerd en ligt bij ons ter beoordeling.

We beslechten conflicten op basis van bewijs van verkoopactiviteit, nooit op basis van wie het eerst registreerde. Daarom loont het om sales_activity_evidence goed in te vullen: daar wordt de beslissing op genomen.

We vertellen je bewust niet wie de andere partner is.

Probeer een gemarkeerde registratie niet opnieuw. Opnieuw proberen verbruikt je dagelijkse registratietegoed en verandert niets: de deal is al geregistreerd. Er geldt een dagelijks maximum voor registraties; wie dat overschrijdt, krijgt 429 terug.

2. Breng de klant op het platform

Zodra een deal goedgekeurd of gewonnen is, kun je de klant zelf aanmaken: de organisatie van de klant wordt aangemaakt, de beheerder wordt per e-mail uitgenodigd en de klant wordt aan jou toegewezen.

De klant begint met een proefperiode, precies zoals bij elke registratie via selfservice.

Het abonnement is bewust geen parameter. Het kiezen ervan zou neerkomen op het toekennen van commerciële voorwaarden, en dat hoort een API-aanroep niet te doen. Het antwoord bevat een billing_setup_url waar de klant een betaalmethode toevoegt en overstapt naar een betaald abonnement; dezelfde link wordt de klant ook gemaild.

Als de deal enterprisevoorwaarden nodig heeft

Vraag het aan voordat je de klant aanmaakt, via het endpoint voor enterpriseaanvragen of via het portaal. Je partnermanager onderhandelt over de voorwaarden en zet de klant om.

Bestaat de klant eenmaal, dan is het omzetten een handeling van de beheerder van het platform. Een deal die duidelijk een uitonderhandelde prijs per gebruiker nodig heeft, is dus makkelijker af te handelen als je hem vroeg aankaart.

3. Zo wordt de marge berekend

De marge is een aandeel van wat de klant daadwerkelijk betaalt, opgeteld uit diens echte facturen.

Twee gevolgen die het waard zijn om te begrijpen, omdat ze allebei mensen verrassen:

De marge telt vanaf de toewijzingsdatum. Een klant die laat wordt toegewezen, levert je niets op over de maanden vóór de toewijzing. Daarom is het belangrijk de klant via je deal aan te maken: dat wijst hem in dezelfde handeling aan jou toe.
Er wordt niets naar maandgrenzen herberekend. Een klant die op de 17e wordt gefactureerd, wordt op de 17e gewaardeerd. Afrekeningen worden maandelijks samengevoegd; ze vormen geen grens van een boekhoudperiode.

Het portaal toont een bedrag “Loopt nu op” voor de huidige, nog niet gefactureerde periode. Het wordt berekend door dezelfde code die de afrekening opstelt, dus de voorvertoning kan niet afwijken van de afrekening die erop volgt.

4. Afrekeningen en betaling

Afrekeningen worden op de 1e opgesteld voor de vorige kalendermaand.

De vereffening verloopt in een vaste volgorde, en elke stap is voor jou zichtbaar:

stap	wat het betekent
`sent_at`	We hebben de afrekening aan je uitgegeven
`partner_invoice_ref`	Je hebt ons gefactureerd, op je eigen document, en wij hebben je referentie vastgelegd
`paid_at`	We hebben betaald

Betaling gebeurt 30 dagen na ontvangst van je factuur. We betalen niet voordat er een factuurreferentie van de partner is: je factuur is het document waartegen de betaling plaatsvindt.

Geldvelden zijn strings. Bedragen in afrekeningen worden teruggegeven als decimale strings, precies zoals ze zijn opgeslagen. Rond ze niet opnieuw af en lees ze niet in als floats: dan wijkt je reconciliatie af van de afrekening waar ze uit komt.

Je account en toegang

Inloggen

Het partnerportaal staat op frem.sh/_app/partner; maak er een bladwijzer van. Ook frem.sh/<your-partner-slug> brengt je daar.

Partnergebruikers loggen in met hun fremforge-account. We ondersteunen gewone accounts, maar we geven de voorkeur aan gefedereerde identiteit: heeft je bedrijf een identiteitsprovider, vraag je partnermanager dan om die te koppelen, zodat je team inlogt met de accounts die het al heeft.

Meervoudige authenticatie is verplicht. Bij een niet-gefedereerd account wordt je gevraagd die bij de eerste keer inloggen in te stellen; bij gefedereerde identiteit dwingt je eigen provider het af.

Je wachtwoord, tweestapsverificatie en e-mailadres beheer je in het portaal onder Jouw toegang → Inloggen en beveiliging.

Gepauzeerd of beëindigd

Een agreement_status van paused is een maatregel tegen misbruik die alleen voor dealregistratie geldt. Een gepauzeerde partner houdt volledige toegang tot zijn klanten, afrekeningen en overeenkomsten: je buitensluiten van je eigen commerciële gegevens zou van een snelheidslimiet een factuurgeschil maken.

terminated beëindigt de toegang.

De raamovereenkomst

Voordat je zaken kunt doen, wordt de raamovereenkomst elektronisch ondertekend met een nationale eID:

Land	Inlogmiddel
Denemarken	MitID Erhverv (gebonden aan het bedrijf)
Zweden	Freja Organisation (gebonden aan het bedrijf)
Noorwegen	BankID (persoonlijk)
Finland	FTN (persoonlijk)

Het inlogmiddel wordt bepaald door het land van inschrijving van je bedrijf, niet door het gebied waarin je verkoopt. Een Deens bedrijf dat in Zweden verkoopt, tekent met MitID Erhverv.

Noorwegen en Finland hebben geen inlogmiddel dat aan het bedrijf gebonden is, dus daar berust de tekenbevoegdheid op de vastgelegde functietitel van de ondertekenaar en de garantie in de overeenkomst zelf.

Dit alles vanuit je eigen systemen

Elke stap hierboven is een API-aanroep. Een deal vanuit je CRM registreren op het moment dat er een kans wordt aangemaakt, is de bedoelde werkwijze; het is ook de beste manier om te zorgen dat de bescherming echt begint wanneer het werk begint.

Zie de referentie van de Partner-API.