Entità Partner

Un Partner rappresenta un'agenzia esterna, un rivenditore o un affiliato che gestisce il proprio bacino di clienti. I Partner sono classificati in Gruppi (Groups) per gestire commissioni a scaglioni e segmentazione dei servizi.

Utilizzo

L'entità Partner viene utilizzata per:

Segmentare la base clienti per agenzia o rivenditore.
Gestire le strutture di commissione e lo storico dei pagamenti (payouts).
Distribuire report e capacità di gestione a terze parti.

Flusso Atteso

Segui questo flusso logico per stabilire un modello di rivendita basato sui partner:

Categorizzazione: Usa i Partner Groups per definire livelli di servizio o scaglioni di sconto.
Setup: Crea l'identità del Partner con i propri dettagli legali di fatturazione.
Attribuzione: Quando crei un nuovo cliente, includi il partner.id per collegarlo formalmente.
Monitoraggio: Traccia le performance e la condivisione dei ricavi tramite il modulo statistiche.

Presentazione di partner

Imposta referrer_partner_id quando crei il partner o una sola volta successivamente con PUT /partners/{partnerId}.json. Il presentante deve appartenere alla stessa azienda; non sono consentiti cicli né sostituzioni dopo l’assegnazione. Il partner presentato può comunque vendere ai propri clienti e ricevere provvigioni dirette.

La policy aziendale separata si legge e modifica con GET e PUT /partners/referral-policy.json (partner_groups:read e partner_groups:write). È disattivata per impostazione predefinita. Dopo l’assegnazione della provvigione diretta, le provvigioni dei livelli superiori vengono calcolate in differita sulla provvigione precedente, entro profondità e tetto complessivo configurati. Le fee compaiono nel registro partner e seguono il payout ordinario. Non è richiesto un abbonamento.

Schema Dati

I campi principali che definiscono un oggetto Partner:

Campo	Tipo	Descrizione
`id`	`eid`	Identificativo univoco esteso.
`name`	`string`	Ragione sociale del partner.
`email`	`string`	Indirizzo email principale per contatti e fatturazione.
`group_id`	`string`	ID del gruppo di classificazione assegnato.
`referrer_partner_id`	`string	null`
`external_id`	`string`	Identificativo di riferimento del tuo sistema interno.
`tags`	`array`	Etichette arbitrarie per filtri custom (es. 'gold', 'reseller').

Grafo delle Chiamate (Relationship)

Come i Partner interagiscono con il flusso di onboarding dei clienti: