Partnerprogrammet

Det här avsnittet är till för partner – företag som säljer vidare eller implementerar fremforge för sina egna kunder. Det beskriver den kommersiella mekaniken: vad en registrerad affär ger dig, hur en kund blir din, hur marginalen beräknas och hur du får betalt.

Allt här finns också tillgängligt via Partner-API:et, så hela flödet kan köras från ditt eget CRM i stället för från en webbläsare.

Letar du efter plattformsdokumentationen som dina kunder använder, börja på Kom igång.

Översikt

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

Fyra saker sker i tur och ordning, och var och en är ett tillstånd som du kan se i portalen eller via API:et.

1. Registrera affären – tidigt

En affärsregistrering visar att du bearbetar ett namngivet företag, och startar ett skyddsfönster på 90 dagar för det.

Registrera så snart en affärsmöjlighet finns, inte när affären nästan är klar. Skyddet är hela poängen med att registrera, och det gäller först från det ögonblick du registrerar.

Vi mejlar dig 14 dagar och 3 dagar innan fönstret löper ut, så att en långsam affär inte tyst förlorar sitt skydd.

När två partner registrerar samma företag

Den andra registreringen får statusen flagged. Det är varken ett fel eller ett avslag – affären är registrerad och ligger hos oss.

Vi löser konflikter utifrån belägg för säljaktivitet, aldrig utifrån vem som registrerade först. Därför lönar det sig att fylla i sales_activity_evidence ordentligt: det är det beslutet fattas på.

Vi berättar medvetet inte vem den andra partnern är.

Försök inte registrera en flaggad affär igen. Ett nytt försök förbrukar din dagliga registreringskvot och ändrar ingenting – affären är redan registrerad. Det finns ett dagligt tak för registreringar; överskrids det returneras 429.

2. Ta in kunden på plattformen

När en affär är godkänd eller vunnen kan du själv skapa kunden: kundens organisation skapas, kundens administratör bjuds in via mejl och kunden tilldelas dig.

Kunden börjar med en provperiod, precis som vid vilken självbetjäningsregistrering som helst.

Planen är medvetet inte en parameter. Att välja den vore att bevilja kommersiella villkor, och det är inget ett API-anrop ska göra. Svaret innehåller en billing_setup_url där kunden lägger till en betalningsmetod och konverterar – samma länk mejlas till kunden.

Om affären kräver enterprise-villkor

Fråga innan du skapar kunden, via endpointen för enterprise-förfrågningar eller i portalen. Din partneransvarige förhandlar villkoren och konverterar kunden.

När kunden väl finns är konverteringen en operatörsåtgärd – så en affär som uppenbart behöver förhandlad prissättning per användare är lättare att hantera om du flaggar den tidigt.

3. Så beräknas marginalen

Marginalen är en andel av det kunden faktiskt betalar, summerat från kundens verkliga fakturor.

Två konsekvenser som är värda att förstå, eftersom båda brukar överraska:

Marginalen räknas från tilldelningsdatumet. En kund som tilldelas sent ger dig ingenting för månaderna före tilldelningen. Därför spelar det roll att du skapar kunden via din affär – det tilldelar kunden i samma åtgärd.
Ingenting periodiseras till månadsgränser. En kund som faktureras den 17:e värderas den 17:e. Avräkningarna samlas månadsvis; de är inte en gräns för en redovisningsperiod.

Portalen visar en siffra för ”Tjänas in nu” för den aktuella, ännu inte fakturerade perioden. Den beräknas av samma kod som bygger avräkningen, så förhandsvisningen kan inte avvika från avräkningen som följer.

4. Avräkningar och utbetalning

Avräkningar tas fram den 1:a för föregående kalendermånad.

Regleringen sker i en fast ordning, och varje steg är synligt för dig:

steg	vad det betyder
`sent_at`	Vi har skickat avräkningen till dig
`partner_invoice_ref`	Du har fakturerat oss, på ditt eget dokument, och vi har registrerat din referens
`paid_at`	Vi har betalat

Betalning sker 30 dagar efter att vi tagit emot din faktura. Vi betalar inte innan det finns en referens till en partnerfaktura – din faktura är det dokument som betalningen görs mot.

Beloppsfält är strängar. Belopp i avräkningar returneras som decimala strängar, exakt som de lagras. Avrunda dem inte på nytt och tolka dem inte som flyttal – då stämmer din avstämning inte längre med avräkningen den kommer från.

Ditt konto och din åtkomst

Logga in

Partnerportalen finns på frem.sh/_app/partner – spara den som bokmärke. Du kommer också dit om du öppnar frem.sh/<your-partner-slug>.

Partneranvändare loggar in med sitt fremforge-konto. Vi stöder vanliga konton, och vi föredrar federerad identitet – om ditt företag har en identitetsleverantör, be din partneransvarige att ansluta den, så loggar ditt team in med de konton de redan har.

Flerfaktorsautentisering krävs. På ett icke-federerat konto ombeds du konfigurera den vid första inloggningen; med federerad identitet upprätthåller din egen leverantör kravet.

Ditt lösenord, din tvåfaktorsautentisering och din mejladress hanteras under Din åtkomst → Inloggning och säkerhet i portalen.

Pausad eller avslutad

agreement_status med värdet paused är en spärr mot missbruk som bara gäller affärsregistrering. En pausad partner behåller full åtkomst till sina kunder, avräkningar och avtal – att stänga ute dig från dina egna kommersiella uppgifter skulle göra en hastighetsbegränsning till en faktureringstvist.

terminated avslutar åtkomsten.

Ramavtalet

Innan du kan göra affärer signeras ramavtalet elektroniskt med en nationell e-legitimation:

Land	Legitimation
Danmark	MitID Erhverv (företagsbunden)
Sverige	Freja Organisation (företagsbunden)
Norge	BankID (personlig)
Finland	FTN (personlig)

Legitimationen avgörs av ditt företags registreringsland – inte av det område du säljer till. Ett danskt företag som säljer i Sverige signerar med MitID Erhverv.

Norge och Finland har ingen företagsbunden legitimation, så behörigheten vilar där på den registrerade titeln för den som signerar och på garantin i själva avtalet.

Allt det här från dina egna system

Varje steg ovan är ett API-anrop. Att registrera en affär från ditt CRM i samma ögonblick som en affärsmöjlighet skapas är det avsedda mönstret – det är också det bästa sättet att se till att skyddet faktiskt börjar när arbetet gör det.

Se referensen för Partner-API:et.