# Genius Returns - API reference

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

Version: 1.0.0

## Servers

Produção
```
https://integration.geniusreturns.com.br
```

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

## Security

### GeniusKey

Chave da integração fornecida pela Genius Returns.

Type: apiKey
In: header
Name: GeniusKey

### GeniusToken

Token da integração fornecido pela Genius Returns.

Type: apiKey
In: header
Name: GeniusToken

### BearerAuth

Use o valor retornado em `ticket.bearer` como Bearer Token nos demais endpoints.

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Genius Returns - API reference](https://apidocs.geniusreturns.com.br/_spec/openapi.yaml)

## Segurança

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

### Autenticar

 - [POST /v1/pvt/seguranca/autenticar](https://apidocs.geniusreturns.com.br/openapi/seguranca/autenticar.md): Autentica a integração usando cabeçalhos  e  e retorna um JWT. O token deve ser enviado nos endpoints protegidos usando o header .

## Processos

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

### Obtém um processo por ID

 - [GET /v3/pvt/processo/{id-processo}](https://apidocs.geniusreturns.com.br/openapi/processos/getprocessobyid.md)

### Listar processos

 - [GET /v3/pvt/processo](https://apidocs.geniusreturns.com.br/openapi/processos/listarprocessos.md): Retorna uma lista paginada de processos conforme filtros informados.  os filtros também podem ser enviados no corpo (JSON), conforme exemplo de curl, caso seu cliente HTTP suporte body em requisições GET.

### Integração do pedido ao fluxo de devolução

 - [POST /v3/pvt/processo/integrar/fluxo](https://apidocs.geniusreturns.com.br/openapi/processos/integrateflow.md): Endpoint utilizado para integrar um pedido da loja virtual à plataforma Genius Returns. Um link será disponibilizado pela API e poderá ser utilizado para redirecionar o usuário solicitante à interface Genius Returns de solicitação de troca ou devolução, diretamente ao estágio de seleção itens.

### Importa uma solicitação de troca ou devolução

 - [POST /v1/pvt/processo/enviar-solicitacao](https://apidocs.geniusreturns.com.br/openapi/processos/processos_enviarsolicitacao.md)

## Produtos

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

### Informar o rating de um ou mais produtos de uma solicitação de troca ou devolução

 - [POST /v3/pvt/Produto/rating](https://apidocs.geniusreturns.com.br/openapi/produtos/informarratingproduto.md)

## Notas de devolução

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

### Adiciona uma nota fiscal de devolução

 - [POST /v3/pvt/Fiscal/{processoId}](https://apidocs.geniusreturns.com.br/openapi/notas-de-devolucao/addnotadevolucao.md): Adiciona uma nota fiscal de devolução ao processo informado. Retorna BadRequest caso o processo não seja encontrado ou já exista uma nota com o mesmo número.

### Atualiza uma nota fiscal de devolução

 - [PUT /v3/pvt/Fiscal/{processoId}/{notaFiscalId}](https://apidocs.geniusreturns.com.br/openapi/notas-de-devolucao/updatenotadevolucao.md): Atualiza uma nota fiscal de devolução. Retorna BadRequest caso não sejam encontrados o processo ou a nota, ou já exista outra nota com o mesmo número. A nota atualizada será automaticamente ativada, caso esteja inativa.

### Inativa uma nota fiscal de devolução

 - [PATCH /v3/pvt/Fiscal/{processoId}/{notaFiscalId}](https://apidocs.geniusreturns.com.br/openapi/notas-de-devolucao/inativarnotadevolucao.md): Inativa uma nota fiscal de devolução. Retorna BadRequest caso o processo ou a nota não sejam encontrados pelos identificadores informados.

### Lista as notas fiscais de devolução por processo

 - [GET /v3/pvt/fiscal](https://apidocs.geniusreturns.com.br/openapi/notas-de-devolucao/listarnotasdevolucaoporprocesso.md)

### Obtém uma nota de devolução por ID

 - [GET /v3/pvt/fiscal/{id}](https://apidocs.geniusreturns.com.br/openapi/notas-de-devolucao/getnotadevolucaoporid.md)