Calculadora de prazo médio de recebimento

Vendas a prazo iguais a zero ou negativas deixam o quociente indefinido, então a tarefa falha com invalid_input e não é cobrada.

Como os dias de vendas em aberto e o prazo médio de recebimento são calculados

De forma equivalente, forme primeiro as vendas a prazo diárias médias como credit_sales dividido por days e depois divida accounts_receivable por esse ritmo diário; as duas rotas são algebricamente idênticas e esta capacidade usa a primeira. Quando você omite days, o endpoint assume 365, a convenção anual dos manuais. O giro de contas a receber, informado quando accounts_receivable é positivo, é vendas a prazo divididas pelas contas a receber, e o DSO é então days dividido por esse giro.

Contrato de entrada, forma da resposta e erros

Se days for informado e não for maior que zero, o pedido falha. Essas falhas não são cobradas. Exemplo: quarenta e cinco mil de contas a receber contra trezentos e sessenta e cinco mil de vendas a prazo anuais geram um prazo de recebimento de quarenta e cinco dias e mil de vendas a prazo diárias médias. Envie por POST um corpo JSON com dois números finitos obrigatórios e um comprimento de período opcional. accounts_receivable é o saldo a receber em aberto da janela (AR de encerramento, ou AR médio se essa for a convenção que você já usa internamente); os aliases ar e receivables apontam para o mesmo campo. credit_sales são as vendas a prazo totais — líquidas de devoluções se for assim que você fecha o livro — da mesma janela; os aliases sales, total_credit_sales e net_credit_sales são aceitos para os livros manterem o nome das colunas. days é o número de dias dessa janela e vale 365 quando omitido; os aliases period_days e days_in_period são aceitos. Cada campo numérico pode chegar como número JSON ou string numérica. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Se accounts_receivable for negativo, o pedido falha. Se a validação passar, o corpo ecoa accounts_receivable, credit_sales e days e informa average_daily_credit_sales, days_sales_outstanding e average_collection_period (as duas últimas são a mesma cifra arredondada, devolvida com os dois nomes para um painel DSO e uma planilha ACP compartilharem um contrato). Quando as contas a receber são positivas, o corpo também inclui receivables_turnover. Combine o JSON com os seus próprios intervalos de aging se precisar da história por cliente; este endpoint devolve a média do período, não um cronograma de faturas.

Onde uma calculadora de prazo médio de recebimento justifica o seu lugar

Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha credit_sales estritamente positivo, accounts_receivable não negativo, fixe nos testes a cifra de dias arredondada e você obtém prazos de recebimento reproduzíveis para checklists de fechamento, plugins LMS e workers de borda sem montar um motor de contas a receber próprio.