Skip to content

Calcula a rota de entrega expressa mais barata até uma loja física

Request

A partir do endereço do consumidor, calcula qual das lojas físicas da conta resulta na rota de entrega expressa mais barata, retornando o valor e o endereço de destino.

Para que serve

Entrega expressa é a modalidade em que um parceiro logístico retira o produto na casa do consumidor no mesmo dia e leva até a loja mais próxima — normalmente cobrada do consumidor. Como o custo varia conforme a distância até cada loja, é preciso avaliar as rotas e escolher a mais barata antes de apresentar o preço.

Como o front Genius usa

Quando a conta oferece entrega expressa, o front chama este endpoint com o endereço do consumidor e exibe a opção "Retirada expressa hoje — R$ 24,90". Se o consumidor aceitar, o valor é cobrado no cartão e a rota retornada acompanha a solicitação enviada em /v1/pvt/processo/enviar-solicitacao (campo RotaEntregaExpressa).

Observações

  • Consultivo: não reserva coleta nem gera cobrança.
  • Se nenhuma rota for viável, entidade volta null com registros: 0 — não ofereça a modalidade.
  • Informe CEP, cidade e estado no mínimo; quanto mais completo o endereço, mais preciso o cálculo.
Security
BearerAuth
Bodyapplication/jsonrequired

Endereço de origem da reversa, isto é, o endereço do consumidor.

logradourostring

Logradouro

numerostring

Número

complementostring

Complemento

bairrostring

Bairro

cidadestring

Cidade

estadostring

Estado

cepstring

CEP

latitudestring or null

Latitude

longitudestring or null

Longitude

obsstring or null

Observações gerais

curl -i -X POST \
  https://apidocs.geniusreturns.com.br/_mock/openapi/v1/pvt/logistica/obter-entrega-expressa-mais-barata \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "logradouro": "Rua Augusta",
    "numero": "500",
    "complemento": "Apto 51",
    "bairro": "Consolação",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01305-000"
  }'

Responses

Rota calculada (ou entidade nula quando não há rota viável).

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).

entidadeobject(RotaExpressaMaisBarataModel)

Rota de entrega expressa de menor custo entre o consumidor e uma loja física.

Response
{
  "dataHoraResposta": "2026-09-18T13:58:02.447Z",
  "registros": 1,
  "httpStatus": "200",
  "entidade": {
    "valor": 24.9,
    "enderecoOrigem": { … },
    "endereco": { … }
  }
}