Lista as transportadoras ativas para a logística reversa

Request

Lista as transportadoras habilitadas na conta, com as modalidades de coleta/postagem que cada uma aceita e, quando informado o CEP de origem, apenas as que atendem àquela região.

Para que serve

Define as opções de envio que podem ser apresentadas ao consumidor. Cada transportadora informa suas modalidades por meio de flags:

Campo	Modalidade
`agencia`	Postagem em agência (consumidor leva o pacote)
`coletaSimples`	Coleta no endereço do consumidor
`domicilio`	Coleta domiciliar/simultânea
`expresso`	Coleta expressa
`postoDePostagem`	Possui pontos de postagem (ver `postos`)

Os campos coletaSimplesTexto e coletaDomiciliarTexto trazem as instruções já redigidas para exibir ao consumidor (ex.: como embalar, o que imprimir), e prazoPostagem indica em quantos dias ele precisa postar.

Como o front Genius usa

Na etapa logística, o front lista as transportadoras retornadas e, para cada uma, exibe apenas as modalidades habilitadas. Ao selecionar uma que tenha postoDePostagem, busca os pontos próximos ao CEP e mostra no mapa. A escolha vira parte da solicitação enviada em /v1/pvt/processo/enviar-solicitacao.

Observações

Informe cepOrigem (CEP do consumidor) para aplicar as restrições por faixa de CEP. Sem ele, a lista volta sem esse filtro.
Retorna 204 quando nenhuma transportadora está habilitada — nesse caso, ofereça devolução em loja física, se houver.

Security

BearerAuth

Query

cepOrigemstring

CEP de origem da logística reversa, isto é, o CEP do consumidor de onde o produto sairá. Usado para filtrar transportadoras por área de atendimento. Ex.: 01310-100.

curl -i -X POST \
  'https://apidocs.geniusreturns.com.br/_mock/openapi/v1/pvt/logistica/obter-transportadoras?cepOrigem=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Transportadoras localizadas.

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

entidadeArray of objects(TransportadoraAtivaModel)

Response

{
  "dataHoraResposta": "2026-09-18T13:52:10.900Z",
  "registros": 2,
  "httpStatus": "200",
  "entidade": [
    { … },
    { … }
  ]
}