Programme partenaires

Cette section s’adresse aux partenaires, c’est-à-dire aux sociétés qui revendent ou intègrent fremforge pour leurs propres clients. Elle décrit les mécanismes commerciaux : ce que vous apporte l’enregistrement d’une affaire, comment un client devient le vôtre, comment la marge est calculée et comment vous êtes payé.

Tout ce qui est décrit ici est aussi disponible via l’API partenaires : l’ensemble du parcours peut donc s’exécuter depuis votre propre CRM plutôt que depuis un navigateur.

Si vous cherchez la documentation de la plateforme qu’utilisent vos clients, commencez par Prise en main.

Vue d’ensemble

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

Quatre étapes se succèdent, et chacune est un état que vous pouvez voir dans le portail ou via l’API.

1. Enregistrez l’affaire, tôt

Un enregistrement d’affaire atteste que vous travaillez une société nommément désignée, et ouvre sur celle-ci une période de protection de 90 jours.

Enregistrez dès qu’une opportunité existe, pas quand elle est sur le point d’être conclue. La protection est la raison d’être de l’enregistrement, et elle ne protège qu’à partir du moment où vous enregistrez.

Nous vous envoyons un e-mail 14 jours et 3 jours avant l’expiration de la période, pour qu’une affaire lente ne perde pas sa protection sans que vous le sachiez.

Quand deux partenaires enregistrent la même société

Le second enregistrement revient avec l’état flagged. Ce n’est ni une erreur ni un refus : l’affaire est enregistrée, et c’est à nous de trancher.

Nous résolvons les conflits sur la base des preuves d’activité commerciale, jamais selon qui a enregistré en premier. C’est pourquoi il vaut la peine de bien renseigner sales_activity_evidence : c’est sur ce champ que repose la décision.

Nous ne vous indiquons délibérément pas qui est l’autre partenaire.

Ne relancez pas un enregistrement signalé. Le relancer consomme votre quota quotidien d’enregistrements et ne change rien : l’affaire est déjà enregistrée. Le nombre d’enregistrements par jour est plafonné ; le dépasser renvoie 429.

2. Amenez le client sur la plateforme

Une fois qu’une affaire est approuvée ou gagnée, vous pouvez créer le client vous-même : son organisation est créée, son administrateur est invité par e-mail, et le client vous est attribué.

Le client démarre en période d’essai, exactement comme pour toute inscription en libre-service.

La formule n’est délibérément pas un paramètre. La choisir reviendrait à accorder des conditions commerciales, ce qu’un appel d’API ne doit pas faire. La réponse contient un billing_setup_url où le client ajoute un moyen de paiement et passe à une formule payante ; le même lien lui est envoyé par e-mail.

Si l’affaire nécessite des conditions entreprise

Faites la demande avant de créer le client, via le point de terminaison des demandes entreprise ou le portail. Votre responsable partenaire négocie les conditions et fait passer le client à la formule convenue.

Une fois le client créé, ce changement de formule est une action de l’opérateur : une affaire qui exige clairement une tarification négociée par utilisateur est donc plus simple à traiter si vous la signalez tôt.

3. Calcul de la marge

La marge est une part de ce que le client paie réellement, agrégée à partir de ses factures effectives.

Deux conséquences méritent d’être comprises, car toutes deux surprennent :

La marge court à partir de la date d’attribution. Un client attribué tardivement ne vous rapporte rien pour les mois antérieurs à l’attribution. C’est pourquoi il importe de créer le client à partir de votre affaire : il vous est attribué dans la même action.
Rien n’est calculé au prorata des fins de mois. Un client facturé le 17 est valorisé le 17. Les relevés sont consolidés chaque mois ; ce ne sont pas des limites de période comptable.

Le portail affiche un montant « En cours d’acquisition » pour la période en cours, pas encore facturée. Il est calculé par le même code que celui qui établit le relevé : l’aperçu ne peut donc pas contredire le relevé qui suit.

4. Relevés et paiement

Les relevés sont établis le 1er de chaque mois pour le mois calendaire précédent.

Le règlement suit un ordre fixe, et chaque étape vous est visible :

étape	signification
`sent_at`	Nous vous avons adressé le relevé
`partner_invoice_ref`	Vous nous avez facturé, sur votre propre document, et nous avons enregistré votre référence
`paid_at`	Nous l’avons payé

Le paiement intervient 30 jours après réception de votre facture. Nous ne payons pas tant qu’aucune référence de facture partenaire n’existe : votre facture est le document sur lequel porte le paiement.

Les champs monétaires sont des chaînes. Les montants des relevés sont renvoyés sous forme de chaînes décimales, exactement telles qu’elles sont stockées. Ne les arrondissez pas à nouveau et ne les convertissez pas en nombres à virgule flottante : votre rapprochement ne concorderait plus avec le relevé dont il provient.

Votre compte et votre accès

Connexion

Le portail partenaires se trouve à l’adresse frem.sh/_app/partner : ajoutez-le à vos favoris. Ouvrir frem.sh/<your-partner-slug> vous y mène également.

Les utilisateurs partenaires se connectent avec leur compte fremforge. Nous prenons en charge les comptes ordinaires, mais nous privilégions l’identité fédérée : si votre société dispose d’un fournisseur d’identité, demandez à votre responsable partenaire de le connecter, et votre équipe se connectera avec les comptes qu’elle possède déjà.

L’authentification multifacteur est obligatoire. Sur un compte non fédéré, vous êtes invité à la configurer lors de la première connexion ; avec une identité fédérée, c’est votre propre fournisseur qui l’impose.

Votre mot de passe, votre authentification à deux facteurs et votre adresse e-mail se gèrent depuis Votre accès → Connexion et sécurité dans le portail.

Suspendu ou résilié

Un agreement_status à paused est une mesure anti-abus qui porte uniquement sur l’enregistrement d’affaires. Un partenaire suspendu conserve un accès complet à ses clients, relevés et contrats : vous priver de vos propres données commerciales transformerait une limitation de débit en litige de facturation.

terminated met fin à l’accès.

Le contrat-cadre

Avant de pouvoir opérer, le contrat-cadre est signé électroniquement avec une eID nationale :

Pays	Moyen d’identification
Danemark	MitID Erhverv (lié à la société)
Suède	Freja Organisation (lié à la société)
Norvège	BankID (personnel)
Finlande	FTN (personnel)

Le moyen d’identification est déterminé par le pays d’immatriculation de votre société, et non par le territoire sur lequel vous vendez. Une société danoise qui vend en Suède signe avec MitID Erhverv.

La Norvège et la Finlande n’ont pas de moyen d’identification lié à la société : le pouvoir de signature y repose sur la fonction du signataire enregistrée et sur la garantie figurant dans le contrat lui-même.

Tout faire depuis vos propres systèmes

Chaque étape ci-dessus est un appel d’API. Enregistrer une affaire depuis votre CRM dès qu’une opportunité est créée est le mode d’utilisation prévu ; c’est aussi le meilleur moyen de garantir que la protection commence réellement en même temps que le travail.

Consultez la référence de l’API partenaires.