GETDevoluções & Disputas

Listar devoluções

Lista as devoluções/trocas (paginado + filtro ?status=). Requer permissão vendas.

GET/returns
AutenticaçãoPainel adminvendas.

Cookie de sessão do painel (ecom_token) + permissão RBAC.

Parâmetros de consulta

  • statusstringopcional

    Filtra por status.

Cabeçalhos

  • Cookiestringobrigatório

    Cookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).

Requisição

curl "https://api.ecomplataforma.com.br/returns?status=solicitado" -b cookies.txt

Resposta200

200 OK
{ "success": true, "data": [ { "id": "r_1", "orderId": "o_501", "status": "solicitado" } ] }

Respostas de erro

401Não autenticado
401 Não autenticado
{
  "success": false,
  "error": "Sessão ausente ou expirada."
}
403Sem permissão
403 Sem permissão
{
  "success": false,
  "error": "Você não tem permissão para acessar este recurso."
}