Partnerprogramm

Dieser Abschnitt richtet sich an Partner – Unternehmen, die fremforge an ihre eigenen Kunden weiterverkaufen oder dort einführen. Er beschreibt die kaufmännischen Abläufe: was dir die Registrierung eines Geschäfts bringt, wie ein Kunde zu deinem Kunden wird, wie die Marge berechnet wird und wie du bezahlt wirst.

Alles hier steht auch über die Partner-API zur Verfügung, sodass der gesamte Ablauf aus deinem eigenen CRM laufen kann statt im Browser.

Suchst du die Plattformdokumentation, die deine Kunden nutzen, beginne bei Erste Schritte.

Der Ablauf im Überblick

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

Vier Dinge geschehen nacheinander, und jedes davon ist ein Zustand, den du im Portal oder über die API sehen kannst.

1. Das Geschäft registrieren – früh

Eine Registrierung eines Geschäfts hält fest, dass du an einem namentlich genannten Unternehmen arbeitest, und startet dafür ein 90-tägiges Schutzfenster.

Registriere, sobald eine Verkaufschance besteht, nicht erst, wenn sie fast abgeschlossen ist. Der Schutz ist der Sinn der Registrierung, und er gilt erst ab dem Moment, in dem du registrierst.

Wir schreiben dir 14 Tage und 3 Tage vor Ablauf des Fensters eine E-Mail, damit ein zähes Geschäft seinen Schutz nicht unbemerkt verliert.

Wenn zwei Partner dasselbe Unternehmen registrieren

Die zweite Registrierung kommt als flagged zurück. Das ist weder ein Fehler noch eine Ablehnung – das Geschäft ist registriert und liegt bei uns.

Konflikte entscheiden wir anhand nachweisbarer Vertriebsaktivität, nie danach, wer zuerst registriert hat. Deshalb lohnt es sich, sales_activity_evidence sorgfältig auszufüllen: Genau darauf stützt sich die Entscheidung.

Wer der andere Partner ist, sagen wir dir bewusst nicht.

Wiederhole eine markierte Registrierung nicht. Eine Wiederholung verbraucht dein tägliches Registrierungskontingent und ändert nichts – das Geschäft ist bereits registriert. Für Registrierungen gibt es eine tägliche Obergrenze; wird sie überschritten, kommt 429 zurück.

2. Den Kunden auf die Plattform bringen

Sobald ein Geschäft genehmigt (approved) oder gewonnen (won) ist, kannst du den Kunden selbst anlegen: Seine Organisation wird erstellt, seine Administratorin oder sein Administrator wird per E-Mail eingeladen, und der Kunde wird dir zugeordnet.

Der Kunde startet mit einer Testphase, genau wie bei jeder Selbstregistrierung.

Der Tarif ist bewusst kein Parameter. Ihn zu wählen hieße, kaufmännische Konditionen zu gewähren, und das sollte kein API-Aufruf tun. Die Antwort enthält eine billing_setup_url, unter der der Kunde ein Zahlungsmittel hinterlegt und umstellt – denselben Link bekommt er per E-Mail.

Wenn das Geschäft Enterprise-Konditionen braucht

Frag bevor du den Kunden anlegst, über den Endpunkt für Enterprise-Anfragen oder im Portal. Deine Partnerbetreuung verhandelt die Konditionen und stellt den Kunden um.

Existiert der Kunde bereits, ist die Umstellung eine Aktion des Betreibers – ein Geschäft, das erkennbar verhandelte Nutzerpreise braucht, lässt sich also leichter abwickeln, wenn du es früh markierst.

3. Wie die Marge berechnet wird

Die Marge ist ein Anteil dessen, was der Kunde tatsächlich zahlt, zusammengerechnet aus seinen echten Rechnungen.

Zwei Folgen, die du verstehen solltest, weil beide immer wieder überraschen:

Die Marge zählt ab dem Datum der Zuordnung. Ein spät zugeordneter Kunde bringt dir für die Monate vor der Zuordnung nichts. Darum ist es wichtig, den Kunden über dein Geschäft anzulegen – damit wird er im selben Schritt zugeordnet.
Nichts wird anteilig auf Monatsgrenzen umgerechnet. Ein Kunde, der am 17. abgerechnet wird, wird am 17. bewertet. Abrechnungen werden monatlich zusammengefasst; sie sind keine Grenze einer Abrechnungsperiode.

Das Portal zeigt für den laufenden, noch nicht abgerechneten Zeitraum einen Wert Läuft gerade auf. Er wird vom selben Code berechnet, der die Abrechnung erstellt, sodass die Vorschau der nachfolgenden Abrechnung nicht widersprechen kann.

4. Abrechnungen und Bezahlung

Abrechnungen werden am 1. für den vorangegangenen Kalendermonat erstellt.

Die Begleichung läuft in einer festen Reihenfolge ab, und jeden Schritt kannst du sehen:

Schritt	Bedeutung
`sent_at`	Wir haben dir die Abrechnung zugestellt
`partner_invoice_ref`	Du hast uns auf deinem eigenen Beleg eine Rechnung gestellt, und wir haben deine Referenz erfasst
`paid_at`	Wir haben sie bezahlt

Die Zahlung erfolgt 30 Tage nach Eingang deiner Rechnung. Bevor eine Rechnungsreferenz des Partners vorliegt, zahlen wir nicht – deine Rechnung ist der Beleg, auf den sich die Zahlung bezieht.

Geldfelder sind Strings. Beträge in Abrechnungen werden als Dezimal-Strings zurückgegeben, genau so, wie sie gespeichert sind. Runde sie nicht erneut und lies sie nicht als Gleitkommazahlen ein – sonst weicht dein Abgleich von der Abrechnung ab, aus der er stammt.

Dein Konto und dein Zugang

Anmelden

Das Partnerportal findest du unter frem.sh/_app/partner – setz dir ein Lesezeichen. Auch frem.sh/<your-partner-slug> führt dich dorthin.

Partner-Nutzer melden sich mit ihrem fremforge-Konto an. Wir unterstützen normale Konten und bevorzugen föderierte Identitäten: Hat dein Unternehmen einen Identitätsanbieter, bitte deine Partnerbetreuung, ihn anzubinden, dann meldet sich dein Team mit den Konten an, die es bereits hat.

Mehr-Faktor-Authentifizierung ist Pflicht. Bei einem nicht föderierten Konto wirst du bei der ersten Anmeldung aufgefordert, sie einzurichten; bei einer föderierten Identität erzwingt sie dein eigener Anbieter.

Passwort, Zwei-Faktor-Authentifizierung und E-Mail-Adresse verwaltest du im Portal unter Dein Zugang → Anmeldung und Sicherheit.

Pausiert oder beendet

Ein agreement_status von paused ist eine Missbrauchsschranke nur für die Registrierung von Geschäften. Ein pausierter Partner behält vollen Zugriff auf seine Kunden, Abrechnungen und Verträge – dich aus deinen eigenen kaufmännischen Unterlagen auszusperren, würde aus einer Mengenbegrenzung einen Abrechnungsstreit machen.

terminated beendet den Zugang.

Der Rahmenvertrag

Bevor du Geschäfte abwickeln kannst, wird der Rahmenvertrag elektronisch mit einer nationalen eID unterschrieben:

Land	Verfahren
Dänemark	MitID Erhverv (an das Unternehmen gebunden)
Schweden	Freja Organisation (an das Unternehmen gebunden)
Norwegen	BankID (persönlich)
Finnland	FTN (persönlich)

Das Verfahren richtet sich nach dem Land, in dem dein Unternehmen eingetragen ist – nicht nach dem Gebiet, in dem du verkaufst. Ein dänisches Unternehmen, das nach Schweden verkauft, unterschreibt mit MitID Erhverv.

Norwegen und Finnland haben kein an das Unternehmen gebundenes Verfahren; die Vertretungsbefugnis stützt sich dort auf die erfasste Funktion der unterzeichnenden Person und auf die Zusicherung im Vertrag selbst.

All das aus deinen eigenen Systemen

Jeder Schritt oben ist ein API-Aufruf. Ein Geschäft aus deinem CRM zu registrieren, sobald dort eine Verkaufschance angelegt wird, ist das vorgesehene Muster – und zugleich der beste Weg, damit der Schutz tatsächlich beginnt, wenn die Arbeit beginnt.

Siehe die Referenz der Partner-API.