Reparto de comisión inmobiliaria multiagente

Si ambos porcentajes suman más de cien por ciento, el motor rechaza la solicitud con un error invalid_input explícito en lugar de inventar un pago negativo al agente. El algoritmo es plenamente determinista, de modo que el mismo JSON produce siempre el mismo resultado para herramientas de operaciones de agencia, bots de CRM, fichas de formación y pruebas de integración continua.

Entradas: comisión total, reparto de agencia y honorario de referido

Ambos porcentajes deben ser no negativos y cada uno está limitado a cien, de modo que un solo campo no pueda superar por sí solo el bote completo. Los importes de comisión negativos fallan la validación porque no describen un cierre normal. Toda la validación ocurre antes de la aritmética monetaria, así que las peticiones incorrectas nunca generan filas de liquidación a medias. Envíe un cuerpo JSON con tres campos obligatorios. La comisión total es el bote bruto antes de cualquier reparto multiagente, como número finito no negativo o cadena numérica; se aceptan los alias commission, total, amount y gross_commission cuando su cliente ya nombra el campo de otra forma. El porcentaje de reparto de la agencia es la parte de la casa expresada como porcentaje de ese total —por ejemplo treinta significa treinta por ciento—, no una fracción decimal; los alias brokerage_percent, brokerage, broker_split y company_split apuntan al mismo valor para que los constructores de formularios conserven etiquetas familiares. El porcentaje de honorario de referido es la parte del referente sobre el mismo total, también como porcentaje, por ejemplo veinticinco por veinticinco por ciento; se admiten referral_percent, referral, referral_fee y referring_agent_percent. Si falta cualquiera de los tres campos, la respuesta es invalid_input nombrando la clave ausente. Cuando el porcentaje de agencia más el de referido supera cien, el motor lanza invalid_input explicando que los porcentajes combinados no deben exceder el cien por ciento: la trampa clásica de sobreasignación en herramientas de comisión multipartita.

Cómo se calculan los netos de referido, agencia y agente

La respuesta repite la comisión total normalizada y ambos porcentajes de entrada, y devuelve agent_percent, percent_sum, referral_amount, brokerage_amount y agent_net, más currency_decimals igual a dos y method igual a commission_split_multi_agent para un ramificado estable en el cliente. Entradas idénticas siempre producen JSON idéntico porque el camino es aritmética pura, sin red, sin semilla aleatoria y sin reloj de sistema.

Uso de la API, precios, flujos y límites prácticos

Use la API prepago cuando un CRM de inmobiliaria, un bot de coordinación de transacciones, un panel de equipo o una exportación de cumplimiento necesiten un contrato KIT estable a $0.002 por ítem correcto; los fallos de validación no consumen saldo tras el rechazo del motor. Combine este endpoint con herramientas de hipoteca o de costes de cierre solo si ya conoce el bote de comisión en una sola moneda: esta capacidad no convierte FX, no prorratea impuestos ni aplica cuotas de franquicia más allá de los dos porcentajes de entrada. Quienes publiquen SDK pueden mapear referral_amount, brokerage_amount y agent_net directamente a interfaces de liquidación y mensajes de pago.