Ripartizione multiagente provvigione

Se le due percentuali sommano più del cento per cento, il motore rifiuta la richiesta con un errore invalid_input chiaro invece di inventare un pagamento negativo all’agente.

Input: provvigione totale, quota agenzia e compenso di referral

Entrambe le percentuali devono essere non negative e ciascuna è limitata a cento, così un solo campo non può da solo superare l’intero monte. Importi di provvigione negativi falliscono la validazione perché non descrivono una chiusura normale. Tutta la validazione avviene prima della matematica monetaria, così le richieste errate non producono mai righe di liquidazione a metà. Invii un corpo JSON con tre campi obbligatori. La provvigione totale è il monte lordo prima di qualsiasi ripartizione multiagente, come numero finito non negativo o stringa numerica; gli alias commission, total, amount e gross_commission sono accettati quando il Suo client nomina già il campo in altro modo. La percentuale di quota agenzia è la parte di casa espressa come percentuale di quel totale —ad esempio trenta significa trenta per cento—, non una frazione decimale; gli alias brokerage_percent, brokerage, broker_split e company_split mappano sullo stesso valore così i costruttori di form possono mantenere etichette familiari. La percentuale del compenso di referral è la parte del segnalatore sullo stesso totale, ancora come percentuale, ad esempio venticinque per venticinque per cento; sono supportati referral_percent, referral, referral_fee e referring_agent_percent. Se manca uno dei tre campi, la risposta è invalid_input con il nome della chiave assente. Quando la quota agenzia più il referral superano cento, il motore solleva invalid_input spiegando che le percentuali combinate non devono eccedere il cento per cento: la classica trappola di sovra-allocazione degli strumenti di provvigione multipartitica.

Come si calcolano i netti di referral, agenzia e agente

La risposta riecheggia la provvigione totale normalizzata e entrambe le percentuali di input, poi restituisce agent_percent, percent_sum, referral_amount, brokerage_amount e agent_net, più currency_decimals uguale a due e method uguale a commission_split_multi_agent per un branching stabile lato client. Input identici producono sempre JSON identico perché il percorso è aritmetica pura, senza rete, senza seme casuale e senza orologio di sistema.

Uso dell’API, prezzi, flussi e limiti pratici

Usi la calcolatrice gratuita di ripartizione multiagente nel browser quando forma nuovi agenti, rivede schede di offerta o ricontrolla un foglio del desk senza installare un’altra app. Mantenga le dimensioni di provvigione entro intervalli commerciali ordinari; importi estremamente grandi sono respinti così la matematica dell’isolato resta limitata. La promessa di prodotto è un’allocazione trasparente a tre parti di una provvigione lorda con un guardrail esplicito oltre il cento per cento —non la matematica di dual agency, né griglie aziendali per scaglione di produzione, né tabelle automatiche di fee MLS—, che appartengono a strumenti specializzati con diversa intenzione SEO. Usi l’API prepagata quando un CRM di agenzia, un bot di coordinamento transazioni, una dashboard di team o un export di conformità necessitano di un contratto KIT stabile a $0.002 per item riuscito; i fallimenti di validazione non consumano saldo dopo il rifiuto del motore. Abbini questo endpoint a strumenti ipotecari o di costi di chiusura solo se conosce già il monte provvigione in un’unica valuta: questa capacità non converte FX, non ripartisce imposte né applica fee di franchising oltre le due percentuali di input. Gli autori che rilasciano SDK possono mappare referral_amount, brokerage_amount e agent_net direttamente in UI di liquidazione e messaggi di pagamento.