Skip to content

Genius Returns - API reference (1.0.0)

Documentação e referências da api Genius Retuns.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server

https://apidocs.geniusreturns.com.br/_mock/openapi/

Produção

https://integration.geniusreturns.com.br/

QA

https://integration-qa.geniusreturns.com.br/

Segurança

Operações de autenticação e segurança (obtenção do Bearer JWT).

Operations

Autenticar

Request

Autentica a integração usando cabeçalhos GeniusKey e GeniusToken e retorna um JWT. O token deve ser enviado nos endpoints protegidos usando o header Authorization: Bearer {token}.

Security
BearerAuth
Headers
GeniusKeystringrequired

Chave da integração fornecida pela Genius Returns.

GeniusTokenstringrequired

Token da integração fornecido pela Genius Returns.

curl --location --request POST 'https://integration.geniusreturns.com.br/v1/pvt/seguranca/autenticar'                 --header 'GeniusKey: denis@denis.com.br'                 --header 'GeniusToken: 1234'

Responses

Autenticado com sucesso.

Bodyapplication/json
ticketobject(AuthTicket)required
ticket.​bearerstringrequired

JWT a ser usado no header Authorization (Bearer).

ticket.​datastring(date-time)required

Data de criação do token.

ticket.​expirarEmstring(date-time)required

Data de expiração do token.

Response
application/json
{
  "ticket": {
    "bearer": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IkRlbmlzIiwiX0NsaWVudGVJZCI6IjIiLCJuYW1laWQiOiIyIiwicm9sZSI6ImNsaWVudCIsIm5iZiI6MTc1NTUxNzMyNSwiZXhwIjoxNzU1NTE4NTI1LCJpYXQiOjE3NTU1MTczMjV9.4_95wpCNfI4SUPKeT64A761hl-9Pd0AWrrvLGh2jM4I",
    "data": "2025-08-18T08:42:05.6720641-03:00",
    "expirarEm": "2025-08-18T09:02:05.6721142-03:00"
  }
}

Processos

Operações para obter, listar, filtrar e criar processos de troca ou devolução.

Operations

Produtos

Ações relativas aos produtos constantes em uma solicitação de troca ou devolução.

Operations

Notas de devolução

Operações com notas fiscais de devolução.

Operations