Divisão de comissão imobiliária multiagente

Se os dois percentuais somarem mais de cem por cento, o motor rejeita a solicitação com um erro invalid_input explícito em vez de inventar pagamento negativo ao corretor.

Entradas: comissão total, divisão da imobiliária e taxa de indicação

Ambos os percentuais devem ser não negativos e cada um tem teto de cem, de modo que um único campo não possa sozinho ultrapassar o pote inteiro. Valores negativos de comissão falham na validação porque não descrevem um fechamento normal. Toda a validação ocorre antes da matemática monetária, assim solicitações ruins nunca geram linhas de liquidação pela metade. Envie um corpo JSON com três campos obrigatórios. A comissão total é o pote bruto antes de qualquer alocação multiagente, como número finito não negativo ou string numérica; os aliases commission, total, amount e gross_commission são aceitos quando o seu cliente já nomeia o campo de outra forma. O percentual de divisão da imobiliária é a parte da casa expressa como percentual desse total —por exemplo trinta significa trinta por cento—, não uma fração decimal; os aliases brokerage_percent, brokerage, broker_split e company_split mapeiam para o mesmo valor para que construtores de formulário mantenham rótulos familiares. O percentual da taxa de indicação é a parte do indicador sobre o mesmo total, também como percentual, por exemplo vinte e cinco para vinte e cinco por cento; admitem-se referral_percent, referral, referral_fee e referring_agent_percent. Se faltar qualquer um dos três campos, a resposta é invalid_input nomeando a chave ausente. Quando o percentual da imobiliária mais o de indicação ultrapassa cem, o motor lança invalid_input explicando que os percentuais combinados não devem exceder cem por cento — a armadilha clássica de superalocação em ferramentas de comissão multipartes.

Como os líquidos de indicação, imobiliária e corretor são calculados

A resposta ecoa a comissão total normalizada e ambos os percentuais de entrada e devolve agent_percent, percent_sum, referral_amount, brokerage_amount e agent_net, além de currency_decimals igual a dois e method igual a commission_split_multi_agent para ramificação estável no cliente. Entradas idênticas sempre produzem JSON idêntico porque o caminho é aritmética pura, sem rede, sem semente aleatória e sem relógio de sistema.

Uso da API, preços, fluxos e limites práticos

Use a calculadora gratuita de divisão multiagente no navegador ao treinar novos corretores, revisar folhas de oferta ou conferir uma planilha da mesa sem instalar outro aplicativo. Mantenha os tamanhos de comissão dentro de faixas comerciais ordinárias; valores extremamente grandes são rejeitados para que a matemática do isolado permaneça limitada. A promessa do produto é uma alocação transparente a três partes de uma comissão bruta com proteção explícita acima de cem por cento — não a matemática de agência dual, nem grades de empresa por faixa de produção, nem tabelas automáticas de taxas MLS —, que pertencem a ferramentas especializadas com outra intenção de SEO. Use a API pré-paga quando um CRM de imobiliária, um bot de coordenação de transações, um painel de equipe ou uma exportação de conformidade precisar de um contrato KIT estável a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Combine este endpoint com ferramentas de hipoteca ou de custos de fechamento apenas se você já souber o pote de comissão em uma única moeda — esta capacidade não converte FX, não rateia impostos nem aplica taxas de franquia além dos dois percentuais de entrada. Autores que publicam SDKs podem mapear referral_amount, brokerage_amount e agent_net diretamente para UIs de liquidação e mensagens de pagamento.