API atual/Referência completa/App do vendedor (mobile)

Painel e gráfico

Os números do dia em uma chamada e a série diária de pedidos e receita dos últimos 7 ou 30 dias.

Painel resumido

Junta em uma resposta o que a tela inicial do app mostra: pedidos e receita de hoje, pedidos pendentes, total de produtos e mensagens não lidas. Se o cálculo de hoje ou das mensagens falhar, o campo volta 0 em vez de derrubar a tela.

GET/api/v1/vendor/mobile/dashboardSeller

Números do dia em uma chamada

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/mobile/dashboard" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Painel

json

{
  "today_orders": 4,
  "today_revenue": 21340,
  "pending_orders": 3,
  "total_products": 128,
  "unread_messages": 2,
  "currency": "BRL"
}

Campos da resposta

today_ordersinteger

Pedidos criados hoje no seu seller, de qualquer status.

today_revenueinteger

Soma dos totais desses pedidos, em centavos.

pending_ordersinteger

Pedidos no status O (recebido, aguardando pagamento ou confirmação), de qualquer data.

total_productsinteger

Produtos do seller que não foram excluídos, em qualquer situação.

unread_messagesinteger

Mensagens não lidas do usuário na caixa de seller.

currencystring

Sempre BRL.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` / `{"error":"invalid or expired token"}`
403	O token não é de um usuário seller (por exemplo, é de um administrador da loja).	`{"error":"insufficient permissions"}`
403	O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação).	`{"error":"vendor_pending_review","message":"..."}`
403	O usuário tem papel de seller, mas não está ligado a nenhum seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao carregar as estatísticas do seller.	`{"error":"failed to load vendor stats"}`

Gráfico de vendas

Devolve uma entrada por dia, em ordem crescente, incluindo os dias sem venda (com zeros), pronta para desenhar um gráfico.

GET/api/v1/vendor/mobile/statsSeller

Pedidos e receita por dia

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).

Parâmetros de consulta

periodstringpadrão: 7days

7days30days

Janela do gráfico. Qualquer valor diferente de 30days vira 7days.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/mobile/stats?period=7days" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Série diária

json

{
  "period": "7days",
  "days": [
    {
      "date": "2026-10-05",
      "orders": 3,
      "revenue": 15890
    },
    {
      "date": "2026-10-06",
      "orders": 0,
      "revenue": 0
    }
  ]
}

Campos da resposta

periodstring

Janela aplicada: 7days ou 30days.

daysarray

Uma entrada por dia, do mais antigo (hoje menos 6 ou 29 dias) até hoje.

days[].datestring

Dia AAAA-MM-DD no relógio do servidor.

days[].ordersinteger

Pedidos do dia, de qualquer status.

days[].revenueinteger

Soma dos totais do dia, em centavos.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` / `{"error":"invalid or expired token"}`
403	O token não é de um usuário seller (por exemplo, é de um administrador da loja).	`{"error":"insufficient permissions"}`
403	O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação).	`{"error":"vendor_pending_review","message":"..."}`
403	O usuário tem papel de seller, mas não está ligado a nenhum seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao consultar os pedidos.	`{"error":"failed to get stats"}`

API atual/Referência completa/App do vendedor (mobile)

Painel e gráfico

Os números do dia em uma chamada e a série diária de pedidos e receita dos últimos 7 ou 30 dias.

Painel resumido

GET/api/v1/vendor/mobile/dashboardSeller

Números do dia em uma chamada

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/mobile/dashboard" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Painel

json

{
  "today_orders": 4,
  "today_revenue": 21340,
  "pending_orders": 3,
  "total_products": 128,
  "unread_messages": 2,
  "currency": "BRL"
}

Campos da resposta

today_ordersinteger

Pedidos criados hoje no seu seller, de qualquer status.

today_revenueinteger

Soma dos totais desses pedidos, em centavos.

pending_ordersinteger

Pedidos no status O (recebido, aguardando pagamento ou confirmação), de qualquer data.

total_productsinteger

Produtos do seller que não foram excluídos, em qualquer situação.

unread_messagesinteger

Mensagens não lidas do usuário na caixa de seller.

currencystring

Sempre BRL.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` / `{"error":"invalid or expired token"}`
403	O token não é de um usuário seller (por exemplo, é de um administrador da loja).	`{"error":"insufficient permissions"}`
403	O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação).	`{"error":"vendor_pending_review","message":"..."}`
403	O usuário tem papel de seller, mas não está ligado a nenhum seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao carregar as estatísticas do seller.	`{"error":"failed to load vendor stats"}`

Gráfico de vendas

Devolve uma entrada por dia, em ordem crescente, incluindo os dias sem venda (com zeros), pronta para desenhar um gráfico.

GET/api/v1/vendor/mobile/statsSeller

Pedidos e receita por dia

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).

Parâmetros de consulta

periodstringpadrão: 7days

7days30days

Janela do gráfico. Qualquer valor diferente de 30days vira 7days.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/mobile/stats?period=7days" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Série diária

json

{
  "period": "7days",
  "days": [
    {
      "date": "2026-10-05",
      "orders": 3,
      "revenue": 15890
    },
    {
      "date": "2026-10-06",
      "orders": 0,
      "revenue": 0
    }
  ]
}

Campos da resposta

periodstring

Janela aplicada: 7days ou 30days.

daysarray

Uma entrada por dia, do mais antigo (hoje menos 6 ou 29 dias) até hoje.

days[].datestring

Dia AAAA-MM-DD no relógio do servidor.

days[].ordersinteger

Pedidos do dia, de qualquer status.

days[].revenueinteger

Soma dos totais do dia, em centavos.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` / `{"error":"invalid or expired token"}`
403	O token não é de um usuário seller (por exemplo, é de um administrador da loja).	`{"error":"insufficient permissions"}`
403	O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação).	`{"error":"vendor_pending_review","message":"..."}`
403	O usuário tem papel de seller, mas não está ligado a nenhum seller.	`{"error":"no vendor account associated with this user"}`
500	Falha ao consultar os pedidos.	`{"error":"failed to get stats"}`