# 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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.troqueedevolva.com.br/integracao-de-plataformas/integracao-feita-por-terceiros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.