Evolução das métricas de lucratividade
Retorna uma série mensal com CAC, LTV, CPV, LTV/CAC, receita, pedidos, investimento, clientes novos e o bloco de CMV real de cada mês. O período é expandido para meses inteiros.
Use para acompanhar tendências. O ltv de cada mês é o dos clientes adquiridos naquele mês e é multiplicado pela margem de contribuição (marginPercent e marginConfigured vêm no nível da resposta). CAC e CPV não dependem da margem.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringIdentificador da organização (obrigatório)
startDate?stringPrimeiro dia do período, inclusivo (YYYY-MM-DD). Só é aplicado junto com endDate; sem os dois, a API considera todo o histórico.
dateendDate?stringÚltimo dia do período, inclusivo (YYYY-MM-DD). Só é aplicado junto com startDate; sem os dois, a API considera todo o histórico.
dateDados de evolução de métricas obtidos com sucesso
application/json- response
data*array<>Série temporal mensal de métricas de rentabilidade
marginPercent*numberPercentual de margem de contribuição aplicado. 100 quando nenhuma margem está configurada
marginConfigured*booleanIndica se uma margem de contribuição personalizada foi configurada para esta organização
marginCompleteness?MarginCompletenessCompletude da margem configurada item a item (gateway, imposto, frete e CMV): complete = todos os itens resolvidos; partial = algum item pendente, então a margem é parcial; none = não há composição por item (margem nunca configurada ou configurada como percentual único; diferencie pelos valores de marginConfigured).
"complete""partial""none"marginItemStatus?|Status por item da composição da margem (synced = vindo dos pedidos, configured = informado pelo usuário, pending = não configurado ou com dados ausentes). null quando a organização não tem composição.
curl -X GET "https://example.com/v1/profitability/metrics-evolution?organizationId=c0ad4763-173e-4a05-9cff-5208c8ea5f6a&startDate=2025-01-01&endDate=2025-12-31"{ "data": [ { "month": "2025-10-01", "cac": 125.5, "ltv": 680, "cpv": 68.18, "ltvCacRatio": 5.42, "totalRevenue": 480000, "totalOrders": 1100, "totalInvestment": 75000, "newCustomers": 598 } ], "marginPercent": 35, "marginConfigured": true, "marginCompleteness": "none", "marginItemStatus": null}