> For the complete documentation index, see [llms.txt](https://docs.troqueedevolva.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.troqueedevolva.com.br/integracao-de-plataformas/integracao-feita-por-terceiros.md).

# Integração feita por terceiros

Nessa modalidade, a equipe da **Troque & Devolva** atua como suporte, oferecendo toda a ajuda necessária para que os desenvolvedores da sua plataforma realizem a integração com o nosso sistema

## Requisitos mínimos para integração

Sua equipe técnica deverá desenvolver e disponibilizar os seguintes endpoints:

* **Consulta de pedidos** por número, e-mail ou CPF
* **Criação e consulta de cupons de desconto**, utilizados como vale-trocas (opcional, mas recomendado)
* **Criação de reembolsos**, parciais ou totais (opcional)

Abaixo, explicamos como a integração funciona em detalhes.

## Instruções gerais

Utilizamos **JSON** como formato padrão nas integrações. Tanto o payload enviado quanto a resposta recebida devem estar estruturados em JSON.

**Códigos de status HTTP esperados:**

* **200** – Requisição processada com sucesso
* **201** – Vale-trocas criado com sucesso
* **400** – Erro na requisição (ex: dados inválidos)

Formato esperado da resposta:

```json
{
  "success": true,
  "message": "Mensagem opcional",
  "data": { /* conteúdo da resposta */ },
}

```

**Em caso de erro:**

```json
{
  "success": false,
  "message": "Descrição do erro"
}
```