Skip to content

Financeiro

Endpoints de cálculo e elegibilidade financeira de uma troca ou devolução: quanto será devolvido, em qual forma (estorno no meio de pagamento original ou vale-compra) e se o estorno pode ser feito automaticamente.

Todos são consultivos (read-only): nenhum deles movimenta dinheiro, gera vale-compra ou altera o processo. Servem para montar a tela/resposta que o consumidor vê antes de confirmar a solicitação. A execução financeira de fato acontece depois, no fluxo do processo.

Operations

Verifica se o consumidor pode "manter o item" em vez de devolvê-lo

Request

Informa se, para o e-mail consultado, a conta permite a modalidade "mantenha o item" — o consumidor recebe o reembolso e fica com o produto, sem precisar postá-lo de volta.

Por que existe

Para itens de baixo valor, o custo da logística reversa muitas vezes supera o valor do produto. Nesses casos, compensa reembolsar e não recolher. A liberação depende de regras da conta (valor do item, categoria, histórico e reputação do consumidor), que são avaliadas no servidor — por isso a consulta é por e-mail.

Como o front Genius usa

Antes de apresentar as opções de envio, o front chama este endpoint com o e-mail do comprador do pedido. Quando o retorno é true, a etapa logística é substituída pela mensagem "Você não precisa devolver o produto" e o processo segue direto para o reembolso — nenhuma transportadora, etiqueta ou loja física é oferecida.

Observações

  • Resultado é cacheado por 5 minutos por combinação conta + loja virtual + e-mail.
  • false não é erro: significa apenas que o fluxo normal de devolução física se aplica.
Security
BearerAuth
Query
emailstring, (email)required

E-mail do consumidor (o mesmo do comprador no pedido original).

lojaVirtualIdinteger or null, (int64)

Id da loja virtual (subconta), quando a conta opera múltiplas lojas.

curl -i -X GET \
  'https://apidocs.geniusreturns.com.br/_mock/openapi/v1/pvt/financeiro/verificar-elegibilidade-manter-item?email=user%40example.com&lojaVirtualId=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Verificação concluída.

Bodyapplication/json
dataHoraRespostastring, (date-time)

Data e hora da resposta, em UTC.

registrosinteger, (int32)

Quantidade de registros retornados em entidade.

httpStatusstring

Código HTTP da resposta, em texto.

erroCodigostring or null

Código do erro, quando houver.

erroDescricaostring or null

Mensagem do erro, quando houver.

erroDetalhadostring or null

Detalhamento técnico do erro, quando houver.

erroTipostring or null

Classificação do erro. Útil para distinguir falha de integração com a plataforma de e-commerce (04) de erro de domínio ou erro comum (00).

entidadeboolean

Resultado da verificação.

Response
{
  "dataHoraResposta": "2026-09-18T13:31:00.512Z",
  "registros": 1,
  "httpStatus": "200",
  "entidade": true
}