Evolução diária do CMV
Retorna uma série diária com receita, pedidos, ticket médio e o custo real das mercadorias vendidas (CMV) de cada dia, com os mesmos campos de CMV de /cards e /metrics-evolution (cogs, revenueWithCmv, revenueWithoutCmv, marginBasis, blendedContribution).
- Um dia em que todos os pedidos têm custo real vem com
marginBasis = cmv_real. Dias com cobertura parcial de custo vêm comomixed, para você sinalizar que o valor não é completo. degraded: truecomdata: []indica que os dados de custo não estavam disponíveis no momento da consulta, e não que o período está vazio.
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.
dateEvolução diária do CMV obtida com sucesso
application/json- response
data*array<>Série temporal diária do CMV (COGS), ordenada por data
granularity*"daily"Sempre daily. Para a visão mensal, use /metrics-evolution.
"daily"degraded*booleantrue quando os dados de custo não estavam disponíveis no momento da consulta. Nesse caso data vem vazio porque a consulta não pôde ser feita, e não porque o período não tem dados.
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/cmv-evolution?organizationId=c0ad4763-173e-4a05-9cff-5208c8ea5f6a&startDate=2025-01-01&endDate=2025-12-31"{ "data": [ { "date": "2026-09-01", "revenue": 100000, "orders": 250, "averageTicket": 400, "cogs": 38000, "revenueWithCmv": 82000, "revenueWithoutCmv": 18000, "marginBasis": "mixed", "blendedContribution": 52100 } ], "granularity": "daily", "degraded": false, "marginPercent": 35, "marginConfigured": true, "marginCompleteness": "none", "marginItemStatus": null}