# Bem-vindo à documentação da Troque e Devolva

A Troque e Devolva é uma solução completa para gerenciar de forma eficiente e prática as trocas e devoluções no seu e-commerce

<figure><img src="/files/zRHpifi3r9JieZxvwO0K" alt=""><figcaption><p>Logo Troque &#x26; Devolva</p></figcaption></figure>

Nossa missão é **transformar a gestão de trocas e devoluções em e-commerces**, oferecendo uma **solução completa** e **automatizada**.&#x20;

Nossa aplicação foi projetada para oferecer uma experiência simples e intuitiva, tanto para lojistas quanto para clientes, garantindo que cada etapa do processo seja clara e sem complicações.

De forma simples e intuitiva, o cliente acessará o seu site de trocas e devoluções, identificará o pedido e irá marcar quais produtos deseja trocar ou devolver. A solicitação entra em seu painel de administração e com poucos cliques sua equipe pode dar andamento ao pedido.

Visite nosso site [www.troqueedevolva.com.br](https://www.troqueedevolva.com.br) e conheça nossa solução para gerenciamento de reversas (trocas e devoluções) para e-commerce.

### Grupo Find My Pack

Fazemos parte do grupo **Find My Pack**, que há mais de 12 anos desenvolve ferramentas de automação logística para e-commerce. Somos um dos principais players do mercado, reconhecidos pela inovação e eficiência em nossas soluções.

Nossa tecnologia já automatizou mais de 18 milhões de entregas, movimentou mais de R$ 2,6 bilhões em transações e impactou mais de 16 milhões de consumidores.

Estamos dedicados a ajudar seu negócio a crescer, proporcionando ferramentas logísticas que otimizam operações e melhoram a satisfação do cliente.&#x20;

Nosso suporte especializado está sempre disponível para garantir que você aproveite ao máximo todas as funcionalidades da nossa plataforma.

Conheça nossas soluções:

[**Link de rastreio**](https://www.linkderastreio.com.br/), que cria um site de rastreamento para sua empresa.

[**Troque e Devolva**](https://www.troqueedevolva.com.br), que gerencia toda a logística reversa de seu e-commerce.

[**Find My Pack**](https://www.findmypack.com.br), que rastreia, classifica e automatiza todas as tarefas logísticas de todas as transportadoras.

{% hint style="info" %}
Esta documentação está em constante evolução, de acordo com as melhorias e atualizações que realizamos em nossas estruturas e funcionalidades.&#x20;
{% endhint %}


# Como funciona

Entenda o fluxo completo de uma troca ou devolução, do pedido do cliente até o encerramento no seu painel.

A **Troque & Devolva** é uma solução avançada para gerenciar trocas, devoluções e garantias de produtos em e-commerces, oferecendo um processo eficiente e transparente tanto para lojistas quanto para clientes.

### **Para o cliente:**

1. **Acesso pelo Cliente** 🛍️

   * O cliente visita o site personalizado da Troque & Devolva do seu e-commerce. De acordo com qual plataforma de e-commerce você utilizar, o cliente deve informar e-mail ou CPF, para iniciar a solicitação de troca ou devolução.

2. **Identificação do Pedido** 🔍

   * O sistema se conecta ao e-commerce para recuperar os detalhes do pedido, confirma se os prazos da política de troca e devolução foram atendidos e exibe os produtos comprados.

3. **Escolha do Motivo** 📝

   * O cliente seleciona o motivo da troca ou devolução a partir de opções pré-definidas, como "Produto com defeito" ou "Tamanho incorreto", configurados por você no painel administrador da Troque & Devolva.

4. **Método de Devolução** 📦

   * O lojista define os métodos de devolução disponíveis, como envio pelos Correios, coleta em casa ou entrega em um ponto de coleta. O sistema fornece todas as instruções necessárias para o cliente proceder com a devolução.

5. **Acompanhamento e Finalização** ✅
   * O cliente recebe atualizações por e-mail sobre o status da solicitação, desde a postagem até a chegada e verificação do produto. Após a aprovação, a loja pode liberar um novo produto, um cupom de desconto ou um reembolso, conforme a política definida.

De forma resumida, é desta maneira que a Troque & Devolva funciona para o cliente.

## Para sua empresa

Para seu time, a Troque & Devolva entrega a ferramenta mais avançada para gestão de trocas, devoluções e garantias.

Desde a aceitação até o encerramento, vocês poderão utilizar mais de 144 funcionalidades nativas para tornar seu processo de logística reversa ainda mais prático e eficiente.&#x20;


# Preços e assinatura

Tenha a melhor solução de logística reversa a partir de R$ 124,50 por mês

A **Troque & Devolva** automatiza toda a operação de trocas, devoluções e garantias do seu e-commerce. Você paga uma taxa única de ativação e uma mensalidade que acompanha o volume da sua operação.

### Consulte os planos atualizados:

👉 [troqueedevolva.com.br/planos](https://www.troqueedevolva.com.br/planos)

***

### Como funciona a mensalidade 🔄

* **Plano Essencial**:\
  R$ 124,50/mês com **50 solicitações** mensais inclusas.
* **Desconto Progressivo:**\
  A partir de **51 solicitações**, o preço unitário diminui automaticamente. [Simule na nossa página de preços.](https://www.troqueedevolva.com.br/planos)
* **Altos volumes**:\
  A partir de **1000 solicitações**, valor fixo unitário de **R$ 1,27**. Previsibilidade total.

💡 As integrações com transportadoras para logística reversa não possuem custo adicional.

***

#### Garantia Incondicional de 30 dias **🛡️**

Comece com taxa única de ativação de R$ 97. Se não ficar satisfeito, devolvemos 100% do valor. Sem perguntas.

#### Atualizações constantes 🚀

Você sempre terá acesso às melhorias da plataforma, sem custos extras.\
Caso haja reajuste de valores, você será avisado com antecedência e poderá garantir o valor atual com a assinatura anual.


# Garantia Incondicional de 30 dias

Experimente a Troque & Devolva por R$97 com garantia.

{% hint style="info" %}
**Atenção:** A oferta da taxa de ativação com garantia incondicional por R$97  é válida apenas para novos assinantes (que nunca criaram conta ou testaram a ferramenta antes).
{% endhint %}

## **Comece com total segurança**

Nossa solução permite que você use a plataforma completa, com todas as funcionalidades, como se já estivesse com a Troque & Devolva em plena operação.

Durante os primeiros 30 dias, caso você ainda não queira divulgar seu site Troque & Devolva aos consumidores, poderá fornecer o endereço apenas para seus colaboradores. Eles farão as solicitações como se fossem clientes reais.

Desta forma, sua operação poderá simular e ajustar tudo o que for necessário antes de liberar ao público, com a tranquilidade de saber que, se não fizer sentido pro seu negócio, devolvemos 100% do valor.

### Criando sua conta

Acesse o site [Troque & Devolva](https://www.troqueedevolva.com.br) e clique em "Crie sua conta".

Você será direcionado para o formulário de cadastro e pagamento da taxa única de ativação de R$ 97. Este processo é simples e rápido.&#x20;

Lembre-se: você tem 30 dias de garantia incondicional. Se não ficar satisfeito, devolvemos 100% da taxa de ativação.

#### Configure a integração

A primeira configuração que você precisará fazer após o cadastro, será configurar com qual plataforma de e-commerce a Troque & Devolva deverá se conectar.

A tela exibirá as plataformas integradas e, ao selecionar a sua, perguntaremos os dados necessários para a configuração (token, usuário, senha, etc).&#x20;

Com isso, estaremos prontos para identificar os pedidos e buscar os produtos da compra.

#### Treinamento inicial e configurações

Minutos depois de criar sua conta, um e-mail de boas vindas será enviado e nele você poderá acessar nossa agenda de implantação.

Vamos ajudá-lo(a) a configurar todas as informações necessárias, como a integração com a plataforma de e-commerce, seu contrato com os Correios, centros de retorno, prazos e tudo mais o que for necessário.

Ao fim da reunião, seu site Troque & Devolva estará pronto para funcionamento. Garantimos suporte total para que você aproveite ao máximo a plataforma.


# Termos e Condições de Uso

Ao utilizar nossos serviços, você declara concordar com estes termos e condições.

Este documento rege os direitos e deveres entre a **Troque e Devolva** e o **Contratante**. É denominado **Termos e Condições**, pois não necessita de assinatura formal.

{% hint style="success" %}
**Ao iniciar o uso da Troque e Devolva e continuar como usuário, realizando os pagamentos estipulados, você declara que leu e concorda com nossos termos e condições.**
{% endhint %}

## 1. Definições Gerais

1.1. **Troque e Devolva**: Marca registrada de propriedade de Andrews Tecnologia Ltda, inscrita no CNPJ 43.881.310/0001-75, com sede em Curitiba-PR, que fornece um software como serviço (SaaS).

1.2. **Software**: Conjunto de bancos de dados e aplicações que permitem a criação de autoatendimento para solicitações de trocas e devoluções.

1.3. **Backoffice**: Ferramenta fornecida pelo Software para que os e-commerces possam gerenciar solicitações com eficiência, incluindo todos os recursos necessários para atender às demandas de seus clientes.

1.4. **Contratação**: Para efetivar a contratação, o Contratante deve escolher o plano que melhor atenda às suas necessidades, de acordo com os recursos necessários e o preço mensal.

1.5. **Novas Funcionalidades**: Podem ser incluídas no Software, mediante pagamento adicional ou não, a critério da Troque e Devolva.

## 2. Do acesso ao Sofware e recursos disponibilizados

2.1. O Software é acessado via internet, com usuário e senha pessoal e intransferível, por intermédio do Painel de Controle Troque e Devolva, disponível no endereço **<https://app.troqueedevolva.com.br>**. Para melhor desempenho, o uso deve ser preferencialmente no computador, embora também seja possível usar no celular, com algumas limitações de funções.

2.2. As funcionalidades às quais o Contratante terá acesso estarão detalhadas no site oficial da Troque e Devolva e no momento da contratação.&#x20;

2.3 A Troque e Devolva reserva-se no direito de incluir ou remover funcionalidades dos planos a seu exclusivo critério. Em caso de remoção de recurso, o Contratante será avisado com antecedência mínima de 30 dias.

2.4 Outras funcionalidades, ainda que disponibilizadas a título gratuito ou em caráter de teste, podem não fazer parte do plano contratado e não constituem direito adquirido pelo Contratante.&#x20;

2.5 As sugestões apresentadas pelo Contratante que não se caracterizem como problemas estarão sujeitas à análise de viabilidade e custo para implementação, sendo a sua aceitação ou não avaliada a exclusivo critério da Troque e Devolva.

2.6 Personalizações poderão ser realizadas por meio de automações utilizando a plataforma N8N, cedida gratuitamente pela Troque e Devolva. Contudo, o desenvolvimento dessas automações pelo corpo técnico da Troque e Devolva estará sujeito a um custo técnico de R$ 120,00 por hora. Caso prefira, o Contratante poderá executar as automações desejadas por conta própria ou contratar um profissional especializado para realizar o serviço.

## 3. Das Integrações

3.1. O Software se integra à plataforma de e-commerce do Contratante para obter dados dos pedidos. A responsabilidade pela disponibilidade e precisão dos dados, assim como possíveis erros ou limitações de acesso, é exclusiva da plataforma de e-commerce do Contratante.

3.2. Todas as configurações necessárias são de responsabilidade do Contratante e estão detalhadas em nosso manual de ajuda em **<https://docs.troqueedevolva.com.br>**.

3.3. O Contratante é responsável por fornecer e manter atualizados todos os dados necessários para a configuração do Software, contando, sempre que precisar, com o apoio técnico de nossa equipe de satisfação do cliente, mediante abertura de chamado .

3.4. Se a plataforma de e-commerce utilizada pelo Contratante possuir limites de requisições e acessos, ao excedê-los, o Software pode não conseguir realizar as operações integradas necessárias. Se isso ocorrer, o Contratante deve contatar sua plataforma de e-commerce para esclarecimentos.

3.5. A Troque e Devolva não se responsabiliza por falhas de integração causadas por problemas na plataforma de e-commerce do Contratante, incluindo indisponibilidade, erros técnicos ou falhas de transmissão de dados.

3.6. Em situações de problemas técnicos restritos à plataforma de e-commerce, a Troque e Devolva prestará suporte na identificação do ocorrido, ficando a resolução sob responsabilidade da própria plataforma.

3.7. Da mesma forma, o Software integra-se às transportadoras e ERPs para realizar as automações disponíveis, estando sujeitos às mesmas condições sobre suas integrações, descritas neste tópico.

3.8 Em razão da constante evolução da solução, consulte o site da Troque e Devolva ou o nosso suporte técnico, para verificar quais as plataformas, ERP's e tranportadoras estão integradas e disponíveis no Software.&#x20;

## 4. Responsabilidades do Contratante

4.1. Manter o cadastro atualizado e as informações corretas no Software, garantindo assim o pleno funcionamento de todos os recursos.

4.2. Efetuar os pagamentos pontualmente, de acordo com o plano de assinatura escolhido, na data de aniversário da conta.

4.3. Respeitar os limites de acesso e regras estabelecidas pela plataforma de e-commerce utilizada.

4.4. Garantir que os dados provenientes de sua plataforma estejam corretos e atualizados, para que o Software seja capaz de operar em sua plenitude, inclusive quanto às automações que precisam de dados das transportadoras e datas de entrega dos pedidos.

4.5. Utilizar o Software de acordo com as leis aplicáveis e não para quaisquer fins ilegais ou não autorizados.

4.6. O Contratante deve incluir a Troque e Devolva em seus termos de LGPD, informando aos consumidores que seus dados serão acessados exclusivamente nos limites necessários para prestação do serviço de trocas e devoluções.

## 5. Pagamentos e cancelamento

5.1. A fatura será emitida cinco dias antes do próximo vencimento ou do fim do período de testes.

5.2. O pagamento implicará na renovação por mais 1 mês da licença de uso do Software.

5.3. A inadimplência sujeitará o Contratante ao pagamento de multa de 2% e juros de 1% ao mês, sobre o valor inadimplido.

5.4. Inadimplência superior a 5 dias resultará na suspensão completa dos serviços.

5.5. Inadimplência superior a 30 dias acarretará no encerramento do contrato e exclusão de todas as informações da conta do Contratante, sem possibilidade de restauração.

5.6. O Contratante pode resilir este contrato a qualquer momento, mediante contato com a Troque e Devolva. O sistema permanecerá disponível até o término do período já pago, data em que o serviço será encerrado, sem direito à reembolso.

5.7. A Troque e Devolva pode rescindir este contrato sem aviso prévio em caso de violação dos termos pelo Contratante ou uso indevido do Software.

5.8. É de inteira responsabilidade do Contratante realizar o backup de seus dados antes da suspensão ou encerramento dos serviços. A Troque e Devolva não se responsabiliza por qualquer perda de informações após o término do contrato.

## 6. Propriedade Intelectual

6.1. Todos os direitos relativos ao Software, incluindo propriedade intelectual, permanecem de propriedade exclusiva da Troque e Devolva.

6.2. O Contratante não adquire, por meio deste contrato, nenhum direito de propriedade intelectual ou licença sobre o Software, além da licença limitada de uso conforme os termos estabelecidos.

6.3. É vedado ao Contratante modificar, reproduzir, distribuir ou criar obras derivadas do Software sem autorização prévia e por escrito da Troque e Devolva.

## 7. Limitação de Responsabilidade

7.1. A Troque e Devolva não será responsável por danos indiretos, especiais, incidentais ou consequenciais, incluindo perda de lucros ou receitas, interrupção de negócios ou perda de dados, decorrentes ou relacionados ao uso do Software.

7.2. A responsabilidade total da Troque e Devolva, em qualquer caso, será limitada ao valor total pago pelo Contratante nos últimos 12 meses anteriores ao evento que deu origem à reclamação.

## 8. Indenização

8.1. O Contratante concorda em indenizar e isentar a Troque e Devolva de qualquer reivindicação, perda, dano, responsabilidade, custo ou despesa (incluindo honorários advocatícios) decorrentes de ou relacionados ao uso indevido do Software ou violação destes termos.

## 9. Nível de Serviço (SLA)

9.1. A Troque e Devolva envidará esforços comercialmente razoáveis para disponibilizar o Software 99% do tempo, exceto em casos de manutenção programada ou eventos fora do controle razoável da empresa.

9.2. Em caso de indisponibilidade que exceda os níveis acordados, o Contratante poderá solicitar crédito proporcional ao período de indisponibilidade, limitado ao valor mensal pago.

9.3 A Troque e Devolva oferecerá atendimento comercial e técnico ao Contratante, por meio do WhatsApp, cujo número está disponível no site, de segunda à sexta-feira, exceto feriados (incluindo os municipais na cidade-sede Curitiba-PR), das 10h às 17h.

9.4 A Troque e Devolva conta com um corpo técnico próprio e altamente qualificado, capacitado para solucionar qualquer demanda apresentada. O prazo para solução será avaliado com base na complexidade do problema informado pelo Contratante no chamado técnico, garantindo um tempo de resposta razoável e adequado.

## 10. Privacidade e Proteção de Dados

10.1. Os dados dos clientes e pedidos são usados apenas para operacionalizar as trocas e devoluções, em conformidade com a Lei Geral de Proteção de Dados (LGPD) e com nosso Termo de Uso de Dados.

10.2. A Troque e Devolva atua como Operadora de Dados, conforme definido na LGPD, tratando os dados pessoais de acordo com as instruções do Contratante, que é o Controlador de Dados.

10.3. A Troque e Devolva implementa medidas de segurança técnicas e organizacionais apropriadas para proteger os dados pessoais contra acesso não autorizado, perda ou destruição.

10.4. A Troque e Devolva não compartilhará dados com terceiros sem autorização expressa do Contratante, exceto aos inerentes à atividade prestada, tais como transportadoras, ERPs e à Prefeitura de Curitiba, para fins fiscais.

## 11. Atualizações dos Termos

11.1. Estes termos podem ser atualizados pela Troque e Devolva periodicamente. A Troque e Devolva notificará o Contratante sobre quaisquer alterações com pelo menos 30 dias de antecedência.

11.2. Se o Contratante não concordar com os termos atualizados, poderá rescindir o contrato antes que as alterações entrem em vigor. O uso continuado do Software após a data efetiva das alterações constituirá aceitação dos termos atualizados.

## 12. Força Maior

12.1. Nenhuma das partes será responsabilizada por falhas ou atrasos no cumprimento de suas obrigações decorrentes de eventos fora de seu controle razoável, incluindo, mas não se limitando a, desastres naturais, atos governamentais, guerras, ataques terroristas, tumultos, greves ou falhas em serviços de internet.

## 13. Resolução de Disputas

13.1. As partes não medirão esforços para resolver amigavelmente quaisquer controvérsias decorrentes deste contrato.

## 14. Disposições Gerais

14.1. Caso alguma cláusula destes termos seja considerada inválida ou inexequível, as demais disposições continuarão em pleno vigor.

14.2. Este contrato constitui o entendimento completo entre as partes, substituindo todos os acordos, entendimentos ou negociações anteriores, escritos ou orais, relativos ao seu objeto.

14.3. O Contratante autoriza a Troque e Devolva a utilizar seu nome, marca e/ou logo para fins de divulgação da parceria, incluindo a menção do Contratante como cliente em materiais promocionais,  site e comunicações externas.

14.3 Fica eleito o foro da Comarca de Curitiba, Estado do Paraná, ou o foro da cidade do contratante, para dirimir quaisquer questões oriundas deste contrato, renunciando-se a qualquer outro, por mais privilegiado que seja.


# LGPD - Uso de Dados

Como a Troque e Devolva trata os dados pessoais dos seus clientes em conformidade com a LGPD.

### 1. Introdução

Bem-vindo à Troque e Devolva. A sua privacidade é muito importante para nós.&#x20;

Esta Política de Privacidade e Termos de Uso de Dados descreve como coletamos, usamos, armazenamos, compartilhamos e protegemos suas informações pessoais.&#x20;

Este documento está em conformidade com a Lei Geral de Proteção de Dados (LGPD) - Lei nº 13.709/2018.

### 2. Coleta de Dados

Coletamos informações pessoais fornecidas diretamente pela plataforma de e-commerce do Contratante, quando ele utiliza nossos serviços. As informações que coletamos podem incluir:

* Nome completo
* Endereço de e-mail
* Número de telefone
* Endereço de entrega e faturamento
* Informações de pagamento
* Histórico de pedidos

### 3. Uso de Dados

As informações coletadas são utilizadas para os seguintes fins:

* Processamento de trocas e devoluções
* Comunicação com o cliente
* Melhoria dos nossos serviços e atendimento ao cliente
* Envio de ofertas, promoções e informações relevantes sobre nossos produtos
* Cumprimento de obrigações legais e regulatórias

### 4. Compartilhamento de Dados

Não compartilhamos suas informações pessoais com terceiros, exceto nos seguintes casos:

* Prestadores de serviços que atuam em nosso nome, como empresas de logística e pagamento
* Cumprimento de obrigações legais ou regulatórias
* Proteção de direitos, propriedade e segurança da Troque e Devolva, nossos clientes e outros

### 5. Armazenamento e Segurança de Dados

Armazenamos suas informações pessoais de forma segura e tomamos medidas apropriadas para protegê-las contra acesso, uso, alteração ou destruição não autorizados. Utilizamos tecnologias de segurança e procedimentos internos rigorosos para garantir a proteção de seus dados.

### 6. Seus Direitos

Você tem o direito de acessar, corrigir, atualizar e solicitar a exclusão de suas informações pessoais. Para exercer esses direitos, entre em contato conosco pelo e-mail <lgpd@troqueedevolva.com.br>.

### 7. Cookies e Tecnologias de Rastreamento

Utilizamos cookies e tecnologias de rastreamento para melhorar a funcionalidade do nosso site, personalizar sua experiência e analisar o uso do site. Você pode configurar seu navegador para recusar cookies, mas isso pode afetar a funcionalidade do site.

### 8. Alterações na Política de Privacidade

Reservamo-nos o direito de atualizar esta Política de Privacidade a qualquer momento.&#x20;

### 9. Contato

Se você tiver alguma dúvida ou preocupação sobre nossa Política de Privacidade e Termos de Uso de Dados, entre em contato conosco pelo e-mail <lgpd@troqueedevolva.com.br>.


# Proteção de Dados e Controles de Segurança

Apresentamos as medidas de segurança adotadas na Troque & Devolva incluindo criptografia, controles de acesso, monitoramento e práticas recomendadas de conformidade.

A **Troque & Devolva** adota modernos conceitos de segurança de dados e boas práticas de desenvolvimento, garantindo que cada recurso do sistema seja projetado com proteção em mente.

A proteção das informações e a segurança das aplicações não são apenas requisitos técnicos, mas parte da filosofia da Troque & Devolva. Desde a concepção até a operação diária, seguimos princípios reconhecidos de mercado para assegurar confiabilidade, integridade e tranquilidade aos nossos clientes.

## Infraestrutura técnica e de dados

A **Troque & Devolva** opera em ambiente de nuvem de alta confiabilidade, projetado para garantir escalabilidade, disponibilidade e resiliência. Toda a comunicação entre componentes do sistema ocorre em **redes privadas virtuais (VPCs)**, reduzindo a superfície de ataque e evitando exposição desnecessária à internet pública.

Os dados armazenados utilizam **criptografia em repouso (AES-256)**, assegurando proteção mesmo em caso de acesso físico indevido. Em **trânsito**, todas as conexões são protegidas com **TLS 1.2+**, garantindo confidencialidade e integridade de ponta a ponta. Dados utilizados em **cache** e em **ambientes temporários** também são criptografados, evitando vazamento de informações em processos intermediários.

A camada de rede é reforçada pelo uso do **Cloudflare**, que adiciona proteção contra **ataques DDoS**, inspeção de tráfego malicioso e bloqueio de IPs que apresentem comportamentos anômalos, como requisições inválidas ou tentativas de **brute force**. Firewalls adicionais garantem segmentação e isolamento de serviços críticos.

O acesso às infraestruturas segue o **princípio do menor privilégio**, sendo rigidamente controlado e auditado. Apenas permissões estritamente necessárias são concedidas a usuários e serviços, reduzindo riscos e fortalecendo a segurança em toda a operação.

Monitoramento ativo e alertas em tempo real permitem identificar e responder rapidamente a anomalias, assegurando a continuidade e confiabilidade do sistema.

### Controles de acesso e registro de atividades

O acesso às aplicações da **Troque & Devolva** é rigidamente controlado por políticas de autenticação e autorização. Cada usuário possui permissões específicas definidas de acordo com seu papel, respeitando sempre o princípio do menor privilégio.

Todas as ações realizadas no sistema são registradas em **logs de alta duração**, garantindo rastreabilidade completa das operações. Esses registros incluem **quem executou a ação, qual operação foi realizada, quando ocorreu e a partir de qual contexto**.

Não existe operação dentro da aplicação que não seja acompanhada de registro. Desde o simples acesso até transações críticas, tudo é armazenado de forma segura e imutável, permitindo auditoria e monitoramento detalhado.

### Segurança nas APIs públicas - do autoatendimento

As APIs da **Troque & Devolva** expõem apenas métodos estritamente necessários para o funcionamento da plataforma em ambiente público, como a **busca de pedidos**, a **identificação de pontos de devolução** e a **criação de solicitações**.

Essas rotas são isoladas e utilizam **mecanismos próprios de autenticação temporária**, com **tokens que expiram automaticamente** após o uso. Dessa forma, elimina-se o risco de acessos indevidos e garante-se que cada requisição tenha validade restrita no tempo.

Todos os dados retornados passam por processos de **normalização e proteção**, preservando informações de identificação pessoal (**PII**). Mesmo que o tráfego seja inspecionado no navegador ou no ambiente do consumidor, **nenhum dado sensível ou identificável é exposto**.

Essa arquitetura impede que usuários ou terceiros tentem acessar dados extras ou explorar informações confidenciais, tornando a aplicação segura e resiliente contra abusos.

### Segurança nas APIs gerais

As APIs disponibilizadas aos assinantes da **Troque & Devolva** seguem rígidos controles de acesso. Cada requisição é autenticada por **tokens exclusivos**, vinculados de forma única à conta e à aplicação que realiza o consumo.

Todo o tráfego é monitorado e **100% das chamadas são registradas em log**, garantindo rastreabilidade completa: desde a origem da requisição até os detalhes da operação realizada. Isso assegura transparência, auditoria e identificação imediata de usos irregulares ou não autorizados.

O modelo adotado segue práticas modernas de segurança em APIs, como:

* **Autenticação baseada em tokens temporários e renováveis**, reduzindo risco de reutilização indevida.
* **Escopo de acesso controlado**, limitando permissões ao estritamente necessário.
* **Segregação por conta e aplicação**, evitando cruzamento de dados e usos indevidos.
* **Registro centralizado de uso**, permitindo análise e monitoramento em tempo real.

Essa abordagem garante que somente aplicações devidamente autorizadas consigam interagir com a plataforma, preservando a segurança dos dados e fortalecendo a confiança no uso da API.

### Controle de permissões dos usuários no painel

O acesso dos usuários às funcionalidades da **Troque & Devolva** é validado em duas camadas: **Frontend** e **Backend**.

No **Frontend**, a interface exibe apenas as opções e recursos permitidos conforme o perfil do usuário, evitando acesso a funcionalidades fora do seu escopo. Já no **Backend**, cada requisição passa por validações adicionais, garantindo que os privilégios sejam respeitados mesmo em tentativas diretas de acesso à API.

Mesmo que um usuário com maior conhecimento técnico tente manipular chamadas ou atacar diretamente a API, o sistema aplica rigorosamente as regras de autorização, retornando erro sempre que a operação solicitada não corresponder às permissões atribuídas ao seu perfil.

Esse modelo de **defesa em profundidade** assegura que o controle de acesso não dependa apenas da interface, mas seja reforçado por validações centralizadas no servidor, tornando impossível a execução de operações além do nível de privilégio concedido.

### Conexões com sistemas externos

As integrações da **Troque & Devolva** com sistemas externos, como ERPs, marketplaces e transportadoras, são realizadas **exclusivamente em ambiente backend**. Isso significa que **nenhum tráfego de dados entre sistemas passa pelo Frontend**, eliminando riscos de exposição ou interceptação de informações sensíveis no ambiente do cliente.

Todas as conexões utilizam **protocolos seguros de comunicação (TLS 1.2+)**, assegurando criptografia ponta a ponta durante a transmissão. Além disso, chaves e credenciais de acesso são armazenadas de forma protegida e nunca trafegam em ambientes que possam ser inspecionados pelo usuário final.

Esse modelo garante que o Frontend opere apenas como camada de interface, enquanto a troca real de informações ocorre em canais restritos, criptografados e controlados pelo backend. Assim, reforçamos a confidencialidade, a integridade e a segurança em todas as integrações.

### Backup e gestão segura do ambiente

A **Troque & Devolva** realiza **backups automáticos três vezes ao dia**, garantindo que os dados possam ser restaurados em caso de incidentes. Todos os arquivos de backup são **armazenados de forma criptografada**, assegurando confidencialidade mesmo fora do ambiente de produção.

Nas aplicações, **todas as credenciais e chaves de acesso são mantidas exclusivamente em variáveis de ambiente protegidas e criptografadas**, nunca expostas no código ou em arquivos públicos. Essa prática elimina riscos de vazamento e reforça o isolamento de informações sensíveis.

Todo o ambiente tecnológico em nuvem segue políticas rígidas de segurança, com uso do **princípio do menor privilégio**e **autenticação multifatorial (MFA)** para acesso administrativo. Essas camadas adicionais reduzem significativamente a superfície de ataque e mitigam riscos de acessos indevidos.

Os **ambientes de desenvolvimento e repositórios no GitHub** também seguem critérios rígidos de acesso. Todo código passa por análises criteriosas e **rotinas de testes constantes** antes de ser promovido para produção, garantindo estabilidade e segurança em cada atualização.

### Alta disponibilidade e redundância

Todos os ambientes da **Troque & Devolva** são executados em **load balancers de alta disponibilidade**, distribuídos em pelo menos **três regiões distintas**. Essa arquitetura garante **redundância total** e continuidade da operação, mesmo que uma das regiões apresente falhas.

Esse modelo elimina pontos únicos de falha e assegura que os usuários tenham acesso ao sistema com estabilidade e desempenho consistentes em qualquer cenário.

Nos orgulhamos de manter **100% de disponibilidade**, sem registrar sequer um minuto de indisponibilidade desde o início da operação. A transparência desse compromisso pode ser acompanhada em tempo real pelo nosso painel público de status: [status.troqueedevolva.com.br](https://status.troqueedevolva.com.br/).

### Testes de segurança e compromisso

A **Troque & Devolva** mantém **verificações constantes** e realiza **testes de intrusão (PenTests)** para avaliar e certificar a segurança das aplicações. Esse processo contínuo garante que novas ameaças sejam identificadas e tratadas de forma proativa, mantendo o ambiente protegido.

Todo esse conjunto de **arquitetura, práticas e preocupação com a segurança** faz parte da qualidade que entregamos em nossa solução.

Se houver qualquer dúvida sobre os pontos apresentados, nossa equipe estará à disposição no **suporte**, e teremos prazer em esclarecer todos os detalhes.


# Programa de parceiros

Aprenda como se tornar um parceiro da Troque e Devolva

Nosso Programa de Parcerias é **simples, transparente e vantajoso**!\
A cada cliente indicado que se tornar pagante, você recebe uma **comissão mensal** sobre o valor do pagamento, válido por **12 meses consecutivos**.

E o melhor: quanto mais clientes indicar, **maior será a sua porcentagem de comissão**.

***

### &#x20;**Percentuais de Comissão**

* Até **10 contas indicadas pagantes** → **8%** da mensalidade de cada cliente
* De **11 a 50 contas indicadas pagantes** → **10%** da mensalidade de cada cliente
* **Acima de 50 contas indicadas pagantes** → **15%** da mensalidade de cada cliente

O cálculo é feito automaticamente no painel do parceiro, com **atualização em tempo real** conforme seus clientes realizam o pagamento das mensalidades.

***

### Dobrando o prazo de recebimento de comissão

Quando você for criar a sua conta, poderá escolher algumas ações opcionais que ajudam a potencializar a parceria e, em troca, ampliam o período em que você recebe comissões.

Funciona assim:

#### **Divulgação para a sua base de clientes → +2 meses de comissão**

Ao enviar para sua base de clientes um comunicado apresentando a parceria com a Troque & Devolva, seja por e-mail, WhatsApp ou qualquer outro canal de divulgação que você já utilize,  você recebe 2 meses extras de comissão. É simples: você divulga, fortalece a parceria e ganha mais tempo recebendo.

#### **Divulgar a parceria no seu site → +2 meses de comissão**

Se você criar e manter uma área dedicada no seu site falando da parceria com a Troque & Devolva, você também garante mais 2 meses de comissão. Pode ser uma página, uma seção ou até um banner. O importante é que seus visitantes vejam a parceria.

#### **Divulgar nas redes sociais → +2 meses de comissão**

Ao compartilhar a parceria nas suas redes sociais (Instagram, Facebook, LinkedIn etc.), você recebe mais 2 meses de comissão. Pode ser um post, story ou destaque fixo, desde que mostre a parceria.

#### **Exclusividade → +6 meses de comissão**

\
Se você optar pela exclusividade, ou seja, indicar apenas a Troque & Devolva como solução de trocas e devoluções para seus contatos, você recebe mais 6 meses de comissão como bônus

***

### &#x20;**Como funciona na prática**

1. **Crie sua conta** no [Portal de Parceiros](https://parceiros.troqueedevolva.com.br/cadastro).
2. Aguarde a verificação pela nossa equipe.
3. **Crie seus cupons com link exclusivo** de indicação.
4. **Compartilhe** o cupom com seus clientes e contatos.
5. Assim que um indicado criar uma conta usando o seu cupom e se tornar pagante, você **começa a receber comissão automaticamente** todos os meses.
6. Você pode **acompanhar suas indicações, cupons e comissões** diretamente no painel de parceiros.

***

### &#x20;**Quem pode participar**

Atualmente, aceitamos **parceiros aptos**, como:

* Agências de marketing ou tecnologia
* Consultores de e-commerce
* Empresas ou profissionais com base ativa de lojistas
* Criadores de conteúdo e influenciadores do segmento

Nosso objetivo é criar **parcerias duradouras e sustentáveis**, com ganhos reais para ambos os lados.

***

### &#x20;**Como se cadastrar**

Para fazer parte do nosso programa, acesse:\
<https://parceiros.troqueedevolva.com.br/>\
Clique em **“Virar parceiro”**, preencha seus dados e comece a indicar!

Em poucos minutos, você já estará com seu painel ativo e pronto para gerar renda com cada nova loja indicada.&#x20;


# Inscrevendo-se como parceiro

Aprenda a criar sua conta de forma simples e rápida

Para fazer parte do nosso programa de parceiros, acesse o link abaixo e cadastre-se:\
\
&#x20;Link: <https://parceiros.troqueedevolva.com.br/>\
\
Preencha todos os dados necessários para a criação da sua conta no painel de parceiros.<br>

<figure><img src="/files/QyZPWAh51OhoooctA2uQ" alt=""><figcaption></figcaption></figure>

### Ações não obrigatórias, mas recomendadas

Por padrão, você receberá comissão por 12 meses a contar do primeiro pagamento do cliente.&#x20;

Mas você pode aumentar esse prazo de comissão se realizar algumas ações que fortalecerão nossa parceria.

Selecione quais ações você deseja realizar. Quanto mais ações escolher, **maior será o período de comissão** que você receberá.

Após o cadastro, você terá 15 dias para iniciar o cumprimento dos requisitos para que possa garantir o seu prazo estendido de recebimento  de comissão.<br>

<figure><img src="/files/gClPh1x8fK6vYzA8SZ52" alt=""><figcaption></figcaption></figure>

### Aguarde a ativação pelo nosso time de parcerias

Após a realização do seu cadastro, nosso time fará uma avaliação da sua conta.\
Se estiver tudo de acordo com os nossos critérios, ela será aprovada e liberada para uso.

<figure><img src="/files/a9R4bSmC2UZVA10tf6wq" alt=""><figcaption></figcaption></figure>


# Apresentando o Dashboard

Você tem acesso completo a todas as informações da parceria

Na página inicial, você encontra uma **interface completa e intuitiva**, que mostra:

* **Clientes indicados**
* Valor total das **comissões**
* Seus **cupons ativos**
* E um painel com **gráficos informativos** sobre o desempenho das suas indicações

<figure><img src="/files/WqPryU8ETVVEKpdHpcZT" alt=""><figcaption></figcaption></figure>

## Verificando as lojas indicadas

Ao clicar em **“Lojas Integradas”**, você pode visualizar todas as lojas que foram criadas com o seu código de indicação, ou seja, cada cliente que você trouxe para a Troque & Devolva.

Você verá cada um dos indicados, com o total de pagamentos já realizados e a sua comissão, total e ainda a receber.

<figure><img src="/files/ImKFScUf8XIu3TKFvabQ" alt=""><figcaption></figcaption></figure>

## Verificando os cupons de indicação

Na aba **“Cupons”**, é possível **criar novos cupons** e também **acompanhar os cupons já ativos**, com todas as informações atualizadas.

<figure><img src="/files/Y1lVrlv150HSvcbfJz2u" alt=""><figcaption></figcaption></figure>

## Consultando as comissões

Em **“Comissões”**, você tem acesso a todos os **clientes pagantes** e aos **valores das suas comissões**.\
Assim, fica fácil acompanhar seus ganhos de forma transparente e organizada.

<figure><img src="/files/UY3Un7iCLi9W3mHeI2eF" alt=""><figcaption></figcaption></figure>

Ao clicar no pagamento, você verá os detalhes e poderá cumprir a exigência de enviar a nota fiscal:

<figure><img src="/files/a3VEpCpK5wkDyWfCeJXF" alt=""><figcaption></figcaption></figure>


# Criando cupons de indicação

Como criar o seu cupom

Para contabilizar quais foram suas indicações, você deverá informar o codigo de cupom aos seus clientes.&#x20;

Caso algum cliente realize o cadastro sem usar o seu cupom, não teremos como comissionado. Por isso é importante sempre indicar o seu cupom ao cliente.

### Benefícios para o cliente

Para que seja mais vantajoso para o cliente que crie a conta usando seu cupom, você poderá oferecer duas vantagens para ele:

1. Desconto de até 100 reais no primeiro pagamento
2. Até 28 dias de testes (sendo 14 dias extras).&#x20;

É você quem escolhe quais beneficios vai oferecer, garntindo que entregara cupons adequados para o se tipo de publico.&#x20;

### Criando seu primeiro cupom de indicação

No painel <https://parceiros.troqueedevolva.com.br/login>  acesse a aba **“Cupons”**.

<figure><img src="/files/5qTMij755dQXI4gfqapa" alt=""><figcaption></figcaption></figure>

Clique em **“Novo cupom”**.

<figure><img src="/files/RUZTFtDV3ErJ1BdV4eM8" alt=""><figcaption></figcaption></figure>

01 - Adicione um **nome** e uma **descrição** para o cupom.

02 - Escolha o **benefício** do cupom:

&#x20;               \- Arrastando a barra **para a direita**, você aumenta os **dias de teste grátis**.

&#x20;               \- Arrastando **para a esquerda**, concede **mais desconto na primeira fatura**.\
\
03 – Ative o campo “Cupom ativo” para que o seu cupom seja válido.<br>

<figure><img src="/files/rQZlbH9qbKtyEsC9NvkJ" alt=""><figcaption></figcaption></figure>

Opcional: adicione um limite de uso e também uma data de validade para o cupom.\
\
**Clique em “Salvar” e pronto! Seu cupom foi criado com sucesso.**

### Informações do cupom

Acessando a aba **“Cupons”**, você encontra todos os seus cupons organizados e com todas as informações necessárias.

Você pode:\
• Visualizar todos os detalhes de cada cupom.\
• Editar qualquer informação configurada anteriormente.\
• Excluir um cupom, caso não queira mais utilizá-lo.\
• Copiar o código com um clique.\
• Copiar o link direto para compartilhar com seus clientes.\
• Consultar a quantidade de usos do cupom.\
• Ver quanto de crédito ele ofereceu.\
• Ver quantos dias extras de teste grátis foram concedidos aos clientes.

<figure><img src="/files/bduNqjfY70CA0xH6FMv9" alt=""><figcaption></figcaption></figure>

Ao clicar em **“Ver mais”**, é possível visualizar todos os detalhes completos do seu cupom, incluindo benefícios, histórico de uso e dados das lojas que o utilizaram.

<figure><img src="/files/CeT7E7oJnJSlAZDSM7wj" alt=""><figcaption></figcaption></figure>

Você tem acesso a todas as informações completas do seu cupom, organizadas de forma clara:

**Informações gerais:**\
• Código do cupom\
• Status (ativo/inativo)\
• Data de expiração\
• Link direto do cupom\
• Data de início da validade\
• Data de criação

**Benefícios do cupom:**\
• Detalhamento dos benefícios oferecidos ao cliente (dias extras de teste ou desconto na primeira fatura)

**Dados de uso:**\
• Quantidade de utilizações\
• Histórico de performance do cupom

**Lojas que utilizaram o cupom:**\
• Lista das lojas que aplicaram o cupom\
• Histórico completo de mudanças e atualizações relacionadas ao cupom

<figure><img src="/files/6Gq4dWmlzWZBVBJkhoKj" alt=""><figcaption></figcaption></figure>

Clicando em **“Editar”**, você pode ajustar todas as configurações do cupom que foram definidas inicialmente, de forma rápida e simples.

<figure><img src="/files/AVU4vBKqDXqaO0mgqBjD" alt=""><figcaption></figcaption></figure>

Para excluir um cupom, basta clicar no ícone da lixeira.

Se o cupom estiver sendo utilizado por algum cliente, a exclusão não será permitida, nesse caso, você só poderá removê-lo quando não houver mais uso ativo.

<figure><img src="/files/VXEWtJbAtG2D0sXRP33O" alt=""><figcaption></figcaption></figure>

### Divulgando o seu cupom e link de parceiro

Para copiar o código, basta clicar sobre ele ou copiar o **link direto** gerado.<br>

<figure><img src="/files/DEUveKq8ClQegSlzHKja" alt=""><figcaption></figcaption></figure>

Pronto. Agora é só compartilhar seu cupom e começar a indicar novos clientes.


# Fornecendo o cupom aos clientes

Como o cliente indicado deve utilizar o seu cupom da forma correta

Para que o cliente possa utilizar o cupom, ele pode acessar o **link direto com o cupom aplicado** ou **inserir o código manualmente** no momento da criação da conta.

Ao usar o cupom direto, o cliente já cria a conta com ele aplicado automaticamente, sem precisar inserir nada manualmente.

<figure><img src="/files/pqfL3iiUpClG3xhDRuGQ" alt=""><figcaption></figcaption></figure>

\
Quando apenas o código do cupom é divulgado, o cliente precisa inseri-lo manualmente. \
\
Para isso, basta clicar no campo indicado e digitar o código do cupom.

<figure><img src="/files/vEEzyKj2fEx7OsTdj6xY" alt=""><figcaption></figcaption></figure>

Após digitar o código, aguarde a validação e clique em **“Aplicar”**.

<figure><img src="/files/myQnAPAU5X2HS003rPQT" alt=""><figcaption></figcaption></figure>

Pronto! Com o cupom aplicado, é só finalizar o cadastro e a conta será criada com o benefício automaticamente.


# Recebendo os pagamentos

Tudo o que você precisa saber sobre a sua comissão

Nossa aplicação realiza automaticamente o cálculo de comissões devidas todo dia 01 de cada mês.&#x20;

### O processo é **100% automatizado**

Não há qualquer intervenção manual, exceto a aprovação do PIX no internet banking.

O cálculo das comissões, o registro da nota fiscal, a inserção do PIX no banco para aprovação e a busca do comprovante de transferência são feitos de forma totalmente autônoma.

Por isso, **não é possível abrir exceções** quando o prazo de envio da nota fiscal é perdido. Nossos agentes de parceria não têm acesso para incluir ajustes manuais e isso é proposital.

Optamos por um fluxo completamente automatizado porque entendemos a urgência que os parceiros têm em receber seus valores. Processos manuais de cálculo e conferência poderiam gerar atrasos, especialmente em períodos de maior demanda.

Dessa forma, **mesmo durante recesso ou feriados**, as comissões continuam sendo processadas automaticamente nas datas acordadas, garantindo previsibilidade e segurança para todos.

### Consultando valores a receber

Acesse o Painel de Parceiros > Comissões.&#x20;

Você verá a lista de promessas de pagamentos e poderá verificar o status.&#x20;

<figure><img src="/files/9hChADZOhSoQq3AxI2So" alt=""><figcaption></figcaption></figure>

### Cumprindo a exigência da nota fiscal

{% hint style="danger" %}
**Atenção**: por se tratar de uma prestação de serviços (indicação), só aceitamos **Notas Fiscais de Prestação de Serviço** (sujeita ao ISS).&#x20;

**Você deve enviar a NFSE até dia 03 às 23h59.** Notas encaminhadas depois do prazo serão processadas e as comissões pagas somente no mês seguinte.
{% endhint %}

Nós precisamos prestar constas ao fisco dos valores que saem de nossa empresa. Para isso, **todo parceiro deve emitir uma nota fiscal contra a Troque & Devolva** no valor das comissões de indicação.

Clique no pagamento que está pendente de inserção da nota fiscal.&#x20;

Para saber que informações inserir na nota, você pode **consultar o espelho de emissão:**

<figure><img src="/files/Be4zn3kms3ZQZVePBFIE" alt="" width="321"><figcaption></figcaption></figure>

Ao clicar, você verá os dados e poderá clicar no botão copiar, para facilitar o preenchimento.

<figure><img src="/files/Mn4hO50fC8IN87V1THQw" alt="" width="563"><figcaption></figcaption></figure>

**Emita a nota fiscal de serviços** e faça o envio preenchendo as informações do formulario:

<figure><img src="/files/Jm0KtjgZ4i91cd99zLO2" alt=""><figcaption></figcaption></figure>

Após **enviar a nota fiscal**, sua solicitação ficará aguardando a **conferência da nota** e o pagamento.&#x20;

### Confirmando o pagamento

Quando analisarmos sua NFSE e realizarmos o PIX, vamos informá-lo por email e também anexar as informações dentro do pagamento:

<figure><img src="/files/aJrbUZOxMhA3sPX7kTbs" alt="" width="317"><figcaption></figcaption></figure>


# Criando sua conta

Crie sua conta na Troque e Devolva em poucos minutos e comece a receber solicitações de troca e devolução.

Para criar uma conta nova acesse: [**https://app.troqueedevolva.com.br/new-account**](https://app.troqueedevolva.com.br/new-account)

Informe os dados básicos de identificação e acesso:

1. Nome completo
2. Seu endereço de e-mail&#x20;
3. Número do seu celular com o código de área
4. Nome da sua loja
5. Site da sua loja
6. Senha e confirmação de senha

<figure><img src="/files/F5ELfMceOICya30Q1Zxu" alt=""><figcaption><p>Tela de cadastro na Troque &#x26; Devolva</p></figcaption></figure>

Se você recebeu um cupom de indicação de um parceiro da Troque e Devolva, clique em **"Tem um cupom de desconto? Clique aqui e insira o código"** e informe o código antes de finalizar o cadastro. O benefício é aplicado automaticamente na criação da conta.

Usaremos o nome da sua loja como endereço do site de autoatendimento. Se, por exemplo, sua loja se chamar "Maria Roupas", seu site de logística reversa será <https://mariaroupas.troqueedevolva.com.br>. Você consegue alterar esse endereço dentro das nossas configurações, depois de criar sua conta.

Ao prosseguir e criar a conta, você declara que leu e concordou com os nossos termos de uso e com a política de uso de dados (LGPD).

{% hint style="info" %}
A escolha do plano de assinatura desejado e a configuração do seu ambiente serão realizados nos próximos passos, após a criação da sua conta.
{% endhint %}


# Roteiro recomendado

A ordem sugerida para configurar sua conta e colocar a operação de trocas e devoluções no ar.

Embora não seja obrigatório seguir uma sequência específica, recomendamos que você configure todos os aspectos necessários para iniciar seus testes.

**Enquanto você não configurar a integração com seu e-commerce, seu site de autoatendimento Troque & Devolva não estará no ar.**

### Sugestão de sequência de configuração:

1. [Configure a integração com seu e-commerce](/integracao-conexao-de-dados/configurando-sua-integracao)
2. [Central do cliente (página de solicitações)](/configuracoes/central-do-cliente)
3. [Regras Gerais](/configuracoes/regras-gerais)
4. [Perguntas obrigatórias](/configuracoes/perguntas-obrigatorias)
5. [Centro de Retorno](/configuracoes/centros-de-retorno)
6. [Transportadoras](/configuracoes/transportadoras)

Configurando os itens acima, sua conta estará pronta para receber e atender solicitações.

{% hint style="danger" %}
Você só conseguirá atender uma solicitação se cadastrar pelo menos um Centro de Retorno e uma Transportadora.
{% endhint %}


# Configurando sua integração

É através da integração que a Troque & Devolva conseguirá identificar suas vendas.

Para vender online, você tem uma plataforma de e-commerce e um ERP (sistema de gestão). Precisamos saber qual é o sistema que você utiliza e obter as credenciais de integração, para que a Troque & Devolva consiga se comunicar com a sua plataforma e obter os dados dos pedidos.&#x20;

Acesse, dentro do painel da Troque & Devolva, o link "**Configurações**" > "**Integração**".

Na tela apresentada, selecione qual a sua plataforma. Apresentaremos quais os dados serão necessários que você obtenha na sua plataforma, para finalizar a integração:

<figure><img src="/files/Bo8ORrxjJ3xTOfiMV0kq" alt="" width="375"><figcaption><p>Tela de configuração de integração na Troque &#x26; Devolva</p></figcaption></figure>

{% hint style="info" %}
As credenciais de integração devem ser obtidas diretamente na sua plataforma de e-commerce ou ERP.
{% endhint %}

Após obter os dados necessários, preencha os campos em nosso painel e clique em salvar.

Pronto, a Troque & Devolva estará conectada ao seu e-commerce.


# Plataformas de e-commerce

Veja como conectar a Troque e Devolva à plataforma onde sua loja está hospedada.


# HostGator


# Configurando a integração HostGator

Configure a Troque e Devolva com a HostGator

## Acessando o painel HostGator

Acesse o painel da Hostgator

Faça login com seus dados de acesso.\ <br>

<figure><img src="/files/PAZhAtspYrLGFkO9WVfo" alt=""><figcaption><p>Tela de login do painel HostGator</p></figcaption></figure>

## Localizando o Token de integração

Após o login, vá até o canto superior direito da tela, onde aparece o **seu nome de usuário**.\
Clique sobre ele e você verá o campo chamado **APP KEY**.<br>

<figure><img src="/files/6BoJkgvrn5VgzOHQbhEm" alt=""><figcaption><p>Localização do APP KEY no menu do usuário</p></figcaption></figure>

Esse código é o **token de integração** necessário para conectar sua loja à Troque e Devolva. Copie esse dado com atenção.<br>

<figure><img src="/files/UVp5F4PCgi41whPLdyBX" alt=""><figcaption><p>Campo APP KEY exibido no painel HostGator</p></figcaption></figure>

## Configurando a HostGator no painel Troque & Devolva

Com o APP KEY em mãos, acesse o painel:\
👉 <https://app.troqueedevolva.com.br>

No menu lateral, clique em **Configurações > Integração**.\
Na tela apresentada, selecione **HostGator**.

Insira o **APP KEY** e a **URL do seu site**, no formato:\
`https://www.seusite.com.br/`

<figure><img src="/files/vSbJ3URSpes8yQoOJ9R1" alt=""><figcaption><p>Tela de configuração da integração HostGator na Troque e Devolva</p></figcaption></figure>

Clique em **salvar**.\
\
Pronto! A integração entre HostGator e Troque e Devolva foi concluída com sucesso.


# Criação integrada de vale-trocas na HostGator

A Troque & Devolva tem integração nativa com a Hostgator e emite o cupom de desconto automaticamente.

## Configurando as informações

Dentro do painel **Troque e Devolva**, na seção **Integração**, a tela da HostGator deve ser configurada com os dados necessários:<br>

<figure><img src="/files/Z9TJDZW9VxqFst851ePV" alt=""><figcaption><p>Tela de configuração da integração Hostgator na Troque e Devolva</p></figcaption></figure>

Informe se o frete será grátís ou não, e insira a validade do vale-trocas.

Depois de preencher as informações, clique em **salvar**.

### Finalizando no painel Troque e Devolva

Com a integração ativa entre **Troque e Devolva** e **HostGator**, o processo de reembolso por vale-trocas fica mais simples e rápido.

Agora, você não precisa mais acessar todo o painel da HostGator para gerar manualmente um cupom, o sistema Troque e Devolva facilita essa etapa.

Ao encerrar uma solicitação de troca ou devolução, você verá a opção de gerar um **vale-trocas** automaticamente.

* O **valor** do cupom, o **código**, o **frete grátis** e a **data de validade** já vêm preenchidos automaticamente, conforme as configurações da integração.
* Se precisar, você pode editar qualquer um desses campos antes de confirmar.
* Depois, basta clicar em **"Encerrar Agora"**.

<figure><img src="/files/tSIGXGfxyh6hlZtoQ1ML" alt="" width="515"><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

### **Consultando o cupom na HostGator**

Se preferir emitir o cupom manualmente ou quiser acompanhar o processo, siga os passos abaixo:

1. Acesse seu painel HostGator.
2. No canto superior esquerdo, clique em **Aplicativos**.<br>

   <figure><img src="/files/thZWWSy5VzVC1wyJNOb5" alt=""><figcaption><p>Menu Aplicativos no paínel HostGator</p></figcaption></figure>
3. Em seguida, vá para a opção **Marketing**.<br>

   <figure><img src="/files/xiOokl0cJOCqeqvIoJ3a" alt=""><figcaption><p>Opção Marketing dentro de Aplicativos</p></figcaption></figure>
4. Role a tela até encontrar **Cupom de Desconto** e clique em **Configurar**.<br>

   <figure><img src="/files/LvJHy7jClyzOMaG8DJs0" alt=""><figcaption><p>Cupom de Desconto na lista de configurações</p></figcaption></figure>
5. A lista de cupons será exibida e você poderá editar o cupom, se for necessário.<br>

   <figure><img src="/files/L1KIrrvfOYk6Qb5LJjmB" alt=""><figcaption><p>Lista de cupons de desconto na HostGator</p></figcaption></figure>
6. Ao editar você pode mudar os dados do cupom: valor, validade, condições de uso, entre outros.<br>

   <figure><img src="/files/HBxqAZ72ETbYLtXUdLJv" alt=""><figcaption><p>Tela de edição de um cupom</p></figcaption></figure>

Depois, clique no botão **salvar.**

Pronto, seu cupom de desconto foi criado.


# Fastcommerce


# Configurando a integração Fastcommerce

Conecte a Troque & Devolva na sua loja virtual da plataforma Fastcommerce

## Configurando um usuário para a Troque & Devolva

Dentro do painel administrativo da Fastcommerce, acesse **Usuários** e depois em **Incluir Usuário**.&#x20;

<figure><img src="/files/K1dnhXXNJkS58plwpUKW" alt="" width="365"><figcaption><p>Exemplo de tela de usuário da Fastcommerce</p></figcaption></figure>

Preencha as informações de nome de usuário, e-mail e a senha. Depois, libere em relatórios as opções:

* Produtos
* Pedidos
* Clientes
* Cupom de desconto

## Inserindo os dados de integração no painel Troque & Devolva

Com o usuário cadastrado, acesse nosso Painel e acesse a opção **Integração**. Selecionando a **Fastcommerce** na lista, preencha:

* **nome\_da\_loja** e **id\_da\_loja**: identificadores da sua loja na Fastcommerce
* **usuario** e **senha**: as credenciais do usuário que você acabou de criar

<figure><img src="/files/5iFV4LyNVscn3vUUm3zY" alt=""><figcaption><p>Tela da Troque &#x26; Devolva de integração com a Fastcommerce</p></figcaption></figure>

Depois, clique no botão **salvar.**

Pronto, a Troque & Devolva estará integrada à sua loja Fastcommerce.&#x20;


# Criação integrada de vale-trocas na Fastcommerce

A Troque & Devolva emite o cupom diretamente na sua loja Fastcommerce, sem que você precise fazer manualmente.

## Configurando as informações

Dentro do Painel Troque & Devolva, em **Integração**, a tela da Fastcommerce solicita as informações padrão da emissão do vale-trocas (cupom).&#x20;

Configure conforme as regras da sua empresa:

<figure><img src="/files/IEenYsXAqcYRDRVjMQbZ" alt="" width="563"><figcaption><p>Exemplo da tela na Troque &#x26; Devolva das configurações do cupom da Fastcommerce.</p></figcaption></figure>

Depois, clique no botão **salvar.**

## Encerrando a solicitação com a criação do cupom de desconto

O processo de [reembolso por vale-trocas](/atendendo-uma-solicitacao/pagando-uma-solicitacao-encerrando/reembolso-em-vale-trocas) permanece o mesmo, sem mudanças operacionais.&#x20;

&#x20;Com a integração na Fastcommerce, **não é mais necessário acessar o dashboard para gerar o cupom manualmente**, a Troque & Devolva faz isso automaticamente para você.

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/eM7EFCGfD7szcMmiVp81" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.&#x20;

## O cupom será automaticamente criado na Fastcommerce

Após o encerramento, você poderá consultar o cupom gerado dentro do painel da Fastcommerce e seu cliente já poderá utilizá-lo para fazer uma nova compra.&#x20;

<figure><img src="/files/R1KlOeWjionjjrUlAOvi" alt=""><figcaption><p>Tela da Fastcommerce com o cupom gerado pela Troque &#x26; Devolva</p></figcaption></figure>

O cliente receberá o cupom pelo e-mail e também na página de acompanhamento da solicitação.


# Olist VNDA

Integração Olist VNDA e Troque e Devolva


# Configurando a integração Olist VNDA

Integração Olist VNDA e Troque e Devolva

Para integrar a Olist VNDA  com a Troque e Devolva, você precisará seguir os passos para criar o token.

## Criando o token de integração

Acesse o seu Admin VNDA da Olist e siga os passos:

1. Acesse o Admin;
2. Clique no ícone **⚙** de **Configurações** no canto inferior esquerdo;
3. Clique em **API** na seção **Integrações;**
4. Clique em **+**;
5. Preencha o **Nome** e **E-mail** do responsável pelo uso do *token*;
6. Clique em **Continuar**;
7. Selecione a caixa de seleção **☑ as seguintes permissoes:**&#x20;
   1. **Pedidos**
   2. **Produtos**
   3. **Clientes**
   4. **Cupons de Desconto**
8. Clique em **Salvar.**

> ### 🚧
>
> O *token* é enviado pelo e-mail cadastrado no passo 5. Veja sua caixa de entrada e spam, mas caso você não tenha recebido o e-mail entre em contato pelo e-mail <ajuda@vnda.com.br>.

## Configurando VNDA Olist dentro da Troque e Devolva

Se você seguiu o passo acima, você já possui o token necessário.&#x20;

1. Acesse o [**Painel Troque e Devolva** ](https://app.troqueedevolva.com.br)e clique em **Configurações** > **Integração**
2. Selecione a **VNDA** na lista.&#x20;
3. Insira o **token** e clique em **salvar**.

<figure><img src="/files/MLohZeeYYdSVR8Mv4kqx" alt=""><figcaption><p>Credenciais da VNDA Olist</p></figcaption></figure>

Pronto! A Troque e Devolva está integrada à sua VNDA Olist.&#x20;


# Criação integrada de vale-trocas na Olist VNDA

A Troque e Devolva emite o cupom diretamente na sua loja Olist VNDA, sem que você precise fazer manualmente.

A integração com a Olist VNDA emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o Admin da Olist para gerar o cupom manualmente.

Para que isso funcione, a permissão **Cupons de Desconto** precisa estar marcada no token de integração. [Veja como criar o token.](https://docs.troqueedevolva.com.br/integracao-conexao-de-dados/plataformas-de-e-commerce/olist-vnda/integrando-a-olist-vnda)

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

<figure><img src="/files/Co80uEUHsKIDB9wBAiXL" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Shopify

Integração Shopify e Troque e Devolva


# Configurando a integração Shopify

Integração Shopify e Troque e Devolva

{% hint style="warning" %}
**Atenção:** Assinantes da Shopify pagam um valor diferente do praticado no site da Troque e Devolva.\
Isso acontece porque a Shopify exige que a cobrança seja feita diretamente por eles, o que gera custos adicionais.

**Por isso, a assinatura é cobrada em dólar, junto com a sua fatura mensal da Shopify, e o plano inicial é de USD 24,90.**
{% endhint %}

Para integrar a Shopify com a Troque e Devolva, você precisará acessar a loja de Apps da Shopify e instalar nosso aplicativo.&#x20;

O procedimento é bem simples.

## Instalando o aplicativo Troque e Devolva na Shopify

**É importante que você já tenha criado a sua conta na Troque e Devolva antes de iniciar a integração.**

1. Acesse nosso aplicativo na Shopify: <https://apps.shopify.com/troque-e-devolva>\
   Se preferir, busque diretamente na Loja de Apps.
2. Clique em instalar:

<figure><img src="/files/wiht1XLDJEyFwLHJjadw" alt=""><figcaption><p>Tela do aplicativo Troque e Devolva na loja de Apps da Shopify</p></figcaption></figure>

3. Você será redirecionado para a página de instalação do nosso App. Clique em Instalar:

<figure><img src="/files/2Qhm2CmDaoMvecbiqeif" alt=""><figcaption><p>Página de instalação do aplicativo</p></figcaption></figure>

4. Faça o login na sua conta Troque e Devolva.&#x20;
5. A Shopify irá pedir que você confirme a assinatura e o período de testes. Lembre-se que **a cobrança da Troque e Devolva para clientes Shopify é realizada em dólar e acontece juntamente com a fatura mensal da plataforma.**

<figure><img src="/files/oueJWLG1oVi7EmMPXJeM" alt=""><figcaption><p>Confirmação da assinatura na Shopify</p></figcaption></figure>

Pronto. Você será redirecionado novamente para sua conta Troque e Devolva, que já estará integrada corretamente à Shopify.

A integração com a Shopify também permite o estorno automático do reembolso. [Veja como ativar e utilizar.](https://docs.troqueedevolva.com.br/atendendo-uma-solicitacao/pagando-uma-solicitacao-encerrando/reembolso-na-plataforma-de-ecommerce)


# Criação integrada de vale-trocas na Shopify

A Troque e Devolva emite o cupom diretamente na sua loja Shopify, sem que você precise fazer manualmente.

A integração com a Shopify emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o Admin da Shopify para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Integrações**, selecione a **Shopify** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/gymkaqq48DptdQGQM4HN" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

Depois, clique no botão **salvar**.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque e Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a validade, conforme as configurações definidas acima.

<figure><img src="/files/umxSUNOnwT8QnQb18iJq" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Integrando a Shopify (Não oficial)

Integração Shopify e Troque e Devolva

Para integrar a Shopify com a Troque e Devolva, você precisará seguir os passos para criar a integração com o nosso aplicativo.&#x20;

## Criando o aplicativo e obtendo os tokens

1. Faça login no seu dashboard Shopify, o painel de controle de sua loja.
2. No menu, clique em **Configurações:**

<figure><img src="/files/N2e4KSIPz8VqVvWL0oMU" alt=""><figcaption><p>Dashboard Shopify, clicar em Configurações</p></figcaption></figure>

3. Acesse **Apps e canais de vendas:**

<figure><img src="/files/O3HDwMfFLt5LAmsQHMh7" alt=""><figcaption><p>Acesse Apps e canais de vendas</p></figcaption></figure>

4. Localize o botão na parte superior **Desenvolver apps:**

<figure><img src="/files/Ch2heHHKsY1Tpm1TSbD5" alt=""><figcaption><p>Clique em Desenvolver Apps</p></figcaption></figure>

5. Na tela seguinte, clique em **Criar um app:**

<figure><img src="/files/OVMVWHJgByVPX09uvF2L" alt=""><figcaption><p>Clique em criar um app</p></figcaption></figure>

6. Preencha o **Nome do app** como Troque e Devolva, depois, clique em **Criar app**.

<figure><img src="/files/4NUdVrG4h1MBb9rrvRkK" alt=""><figcaption><p>Preencha o nome do App e clique em criar app</p></figcaption></figure>

7. Clique em **Configurar escopos da API Admin:**

<figure><img src="/files/BixZjOtGdv1XCRbr4A3v" alt=""><figcaption><p>Clique em Configurar escopos da API Admin</p></figcaption></figure>

8. Selecione os scopos **Cartões-presente**, **Clientes, Pedidos e Produtos**, **com as mesmas permissõe do print abaixo**. Depois, clique em **salvar:**

<figure><img src="/files/SdT4PrkJWdXAjsr1KKLa" alt=""><figcaption><p>Selecine os scopos de permissões</p></figcaption></figure>

8. Depois, clique em **Instalar App e confirme a instalação:**

<figure><img src="/files/eenpmygIw312EC2p9mmc" alt=""><figcaption><p>Clique em <strong>Instalar App</strong></p></figcaption></figure>

<figure><img src="/files/BAgwd0pls8IDNPBoZ7Oc" alt=""><figcaption><p>Confirme a instalação</p></figcaption></figure>

10. **Copie as três credenciais que serão mostradas em tela:**

<figure><img src="/files/RDmNvOafAMmDIBTxDaX8" alt=""><figcaption><p>Clique em Revelar token uma vez</p></figcaption></figure>

<figure><img src="/files/mqA7rQBWvjZZMrCdgaVc" alt=""><figcaption><p>Copie as credenciais</p></figcaption></figure>

11. Confirme e anote a versão da API (webhook), clicando em **Configurações**:

<figure><img src="/files/5KqSA1zmcZ0faJOk8EuH" alt=""><figcaption><p>Anote o numero da versão</p></figcaption></figure>

## Configurando a integração dentro do painel Troque e Devolva

Se você seguiu o passo acima, você já possuí os dados necessários:

* Token de acesso da API Admin > **access\_token**
* Chave de API > **api\_key**
* Chave secreta de API > **api\_secret\_key**
* Versão do webhook (ou API) > **api\_version**

1. Acesse o [**Painel Troque e Devolva** ](https://app.troqueedevolva.com.br)e clique em **Configurações** > **Integrações**
2. Selecione a **Shopify** na lista. **Preencha cada um dos campos com os dados que você obteve criando nosso App dentro do Admin Shopify:**

<figure><img src="/files/tO3IfhqLEU5aOHiaNZ1x" alt=""><figcaption><p>Preencha as informações de integração</p></figcaption></figure>

O campo **shop\_domain** é o site da sua loja, ex: **<https://www.sualoja.com.br>**

3. Clique em **Salvar** e pronto. A Troque e Devolva está integrada à sua Shopify.&#x20;


# Shoppub


# Integrando a Shoppub

Configure a Troque e Devolva com a Shoppub

Para integrar a Shoppub com a Troque e Devolva, você precisará criar um Token para nossa integração.

### Criando o token de acesso na Shoppub

Acesse o admin da sua loja Shoppub. **No menu lateral**, selecione **Integrações > "API's e Webhooks":**

<figure><img src="/files/u5vffPPMtAxWlORvOnOE" alt=""><figcaption><p>Menu Shoppub</p></figcaption></figure>

Depois, acesse **Tokens API**:

<figure><img src="/files/E3BJFPfr8Z6NbzvY9mFB" alt=""><figcaption><p>Opção Tokens API</p></figcaption></figure>

Na tela de Tokens API, clique em **Adicionar:**

<figure><img src="/files/Mn4JD8ni3Rmtun1Lt9nM" alt=""><figcaption><p>Botão Adicionar na tela de Tokens API</p></figcaption></figure>

Insira o nome **Troque e Devolva** e selecione sua loja e seller (se aplicável):

<figure><img src="/files/bsPz64brRitJrgKpe3WZ" alt=""><figcaption><p>Nome do token e seleção da loja</p></figcaption></figure>

Forneça ainda **as permissões necessárias** para: **pedidos,  produtos, clientes e cupons de desconto.**

<figure><img src="/files/2tg7lu6fNGrJMOW2gAup" alt=""><figcaption><p>Permissões necessárias para o token</p></figcaption></figure>

<figure><img src="/files/tgD5Z3BmoiWvGngwUdOy" alt=""><figcaption><p>Permissões necessárias para o token (continuação)</p></figcaption></figure>

Clique em **salvar e voltar à lista** e você vai visualizar o **token de integração**. Copie esse dado.&#x20;

### Configurando a Shoppub dentro do painel Troque e Devolva

Com o token criado e com as permissões corretas, acesse o painel <https://app.troqueedevolva.com.br>

Acesse **Configurações > Integração.** Na tela apresentada, selecione **Shoppub**.&#x20;

Insira o **token** e a url do seu site, algo como <https://www.seusite.com.br/>

<figure><img src="/files/xaL3roa21HjrQvhXKEzv" alt=""><figcaption><p>Preenchendo dados da integração no painel Troque e Devolva.</p></figcaption></figure>

Pront&#x6F;**. A integração está realizada.**


# Criação integrada de vale-trocas na Shoppub

A Troque e Devolva emite o cupom diretamente na sua loja Shoppub, sem que você precise fazer manualmente.

## Criação integrada de vale-trocas na Shoppub

A integração com a Shoppub emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o admin da Shoppub para gerar o cupom manualmente.

Para que isso funcione, a permissão de **cupons de desconto** precisa estar marcada no token de integração. [Veja como criar o token.](https://docs.troqueedevolva.com.br/integracao-conexao-de-dados/plataformas-de-e-commerce/shoppub/integrando-a-shoppub)

### Configurando as informações

No painel da Troque e Devolva, em **Integração**, selecione a **Shoppub** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/qCI2LUXPqbrQNaMkVbgP" alt=""><figcaption></figcaption></figure>

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque e Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a validade, conforme as configurações definidas acima.

<figure><img src="/files/eR2WgudvltklZJw1yQIS" alt=""><figcaption></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Tray


# Configurando a integração Tray

Conecte a Troque & Devolva na sua loja virtual da plataforma Tray

### Instalando o aplicativo Troque & Devolva na Tray

Acesse o admin da sua loja Tray. Depois, clique em Aplicativos:

<figure><img src="/files/c2GPisJlrApvIWj5KmeE" alt=""><figcaption><p>Menu de Aplicativos Tray</p></figcaption></figure>

Na tela de busca, pesquise por Troque & Devolva. Ao aparecer o nosso aplicativo, clique em acessar:

<figure><img src="/files/1PnC5tIrjemKwL5yN70u" alt=""><figcaption><p>Localizando o aplicativo da Troque &#x26; Devolva</p></figcaption></figure>

Depois, copie a URL e o Código que aparecerá em tela e insira dentro da sua integração, no painel Troque & Devolva:

<figure><img src="/files/xLKJxnLUG7UJK3UtaTAC" alt=""><figcaption><p>Tela de integração com a Tray, dentro do painel Troque &#x26; Devolva</p></figcaption></figure>

Depois, clique no botão **salvar.**

Pronto, a Troque & Devolva estará integrada à sua loja Tray.&#x20;


# Criação integrada de vale-trocas na Tray

A Troque & Devolva tem integração nativa com a Tray e emite o cupom de desconto automaticamente.

### Código dos serviços de frete grátis

Para localizar os ID's de frete grátis: \
• Acesse o painel da Tray.\
• Observe a URL no navegador.\
• Identifique o código numérico presente na URL — esse é o ID.

<figure><img src="/files/4FsDx3b8xPxOx0Tny4bP" alt=""><figcaption><p>"Identificação do ID do serviço de frete na URL da Tray</p></figcaption></figure>

### Configurando as informações

Dentro do Painel Troque & Devolva, em **Integrações**, a tela da Tray precisa ser configurada com alguns dados:

<figure><img src="/files/LNju1LexiQ4yMRUd1hyG" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

{% hint style="info" %}
**Os códigos dos serviços de frete grátis** correspondem aos ids das formas de envio que você configurou em sua loja Tray. Se tiver dificuldade para obter os ids, nós poderemos apoiar nisso.
{% endhint %}

Caso exista mais de uma opção de frete, cadastre separando por vírgulas.

Depois, clique no botão **salvar.**

### Encerrando a solicitação com a criação do cupom de desconto

O processo de [reembolso por vale-trocas](/atendendo-uma-solicitacao/pagando-uma-solicitacao-encerrando/reembolso-em-vale-trocas) permanece igual.

&#x20;Com a integração Troque & Devolva e Tray, **não é mais necessário acessar o dashboard da Tray para gerar o cupom manualmente** — a Troque & Devolva faz isso  para você.

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/wJFq4uQoEnDB20bNBFbN" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

### O cupom será automaticamente criado na Tray

Após o encerramento, você poderá consultar o cupom gerado dentro do painel da Tray e seu cliente já poderá utilizá-lo para fazer uma nova compra.&#x20;

<figure><img src="/files/Xm2uBqTeYR17cvEizj1W" alt=""><figcaption><p>Cupom de desconto gerado na Tray.</p></figcaption></figure>

O cliente receberá o cupom pelo e-mail e também na página de acompanhamento da solicitação.


# Yampi


# Configurando a integração Yampi

Passo a passo da integração da Yampi com a Troque & Devolva

### Obtendo as credenciais Yampi

Acesse o painel de controle Yampi, pelo endereço <https://app.yampi.com.br>

Localize o **ícone do seu usuário**.  Clique sobre ele e depois em "**Credenciais de API**":

<figure><img src="/files/ZQTGyrlj6KI7Ltpgi6pA" alt=""><figcaption><p>Print da Yampi, localizando as credenciais de API</p></figcaption></figure>

A Yampi mostrará em tela as credenciais com as informações que você vai precisar cadastrar no painel da Troque & Devolva:

<figure><img src="/files/ZIxskkGXYP5zOkh9f7Fa" alt=""><figcaption><p>Tela de credenciais Yampi</p></figcaption></figure>

### Configurando a integração dentro do painel Troque & Devolva

Acesse nosso painel em [https://app.troqueedevolva.com.br](https://app.troqueedevolva.com.br/)

Após logar, clique em "**Configurações**", "**Integração**".&#x20;

Localize a **Yampi** e clique sobre ela:

<figure><img src="/files/FlevWw5U9w4rP3r8yV2o" alt="" width="375"><figcaption><p>Tela da Troque &#x26; Devolva preenchendo os dados da Yampi</p></figcaption></figure>

Copie e cole os dados das credenciais da Yampi. Depois, clique em salvar.

Pronto, sua loja Yampi está pronta para funcionar com a Troque & Devolva.

### Se você trocar sua senha do painel, a Yampi renova as credenciais de integração

Por questão de segurança interna da Yampi, sempre que você troca sua senha de acesso ao Admin Yampi, eles também trocam todas as chaves de integração. Neste caso, você precisa seguir o processo novamente e atualizar a chave no painel Troque & Devolva.

<figure><img src="/files/oYnzybZW35NAqSOdbYBG" alt=""><figcaption><p>Aviso de credenciais desatualizadas no painel</p></figcaption></figure>


# Criação integrada de vale-trocas na Yampi

A Troque & Devolva oferece a geração automática de cupons de desconto na Yampi, sem que você precise acessar manualmente a plataforma para realizar essa tarefa.

### **Como configurar a emissão automática de cupons:**

Foi desenvolvida para ser extremamente simples de usar, sem alterar seu fluxo de trabalho. O sistema reconhece automaticamente a integração com a Yampi e ajusta seu funcionamento, criando o cupom de desconto antes de finalizar a solicitação, sem que você precise fazer ajustes manuais.

### Definindo as opções da Yampi

Na tela de [integração com a Yampi](/integracao-conexao-de-dados/plataformas-de-e-commerce/yampi#obtendo-as-credenciais-yampi), siga os passos para configurar a geração de cupons:

1. Acesse o menu **Configurações** > **Integração** e selecione a **Yampi**.
2. Defina se o cupom será de **frete grátis** e ajuste a **validade em dias** para uso do cliente.

A validade é calculada automaticamente a partir da data de finalização da solicitação, somando os dias configurados.

<figure><img src="/files/KTobnCuAjhlC6LPM0m0r" alt=""><figcaption><p>Tela de configuração da criação do cupom Yampi</p></figcaption></figure>

### Finalizando uma solicitação com vale-trocas integrado na Yampi

O processo de [reembolso por vale-trocas](/atendendo-uma-solicitacao/pagando-uma-solicitacao-encerrando/reembolso-em-vale-trocas) permanece o mesmo para você, sem mudanças operacionais.&#x20;

&#x20;Com a integração na Yampi, **não é mais necessário acessar o dashboard para gerar o cupom manualmente,** a Troque & Devolva faz isso automaticamente para você.

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/aU2Pcr0Teybic2X695Ib" alt=""><figcaption><p>Tela de encerramento com cupom integrado Yampi</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

### O cupom será automaticamente gerado na Yampi

Na Yampi, você pode encontrar o cupom gerado pela Troque & Devolva acessando o menu **Dashboard Yampi > Marketing > Cupons**, e procurar pelo código de cupom gerado:

<figure><img src="/files/f1jDhT6N1dwLuHI3JCcU" alt="" width="360"><figcaption><p>Tela de cupom no Dashboard Yampi</p></figcaption></figure>

Pronto, a solicitação foi encerrada e seu cliente já poderá realizar um novo pedido. Ele receberá o cupom pelo e-mail e também na página de acompanhamento da solicitação.


# Nuvemshop


# Configurando a integração Nuvemshop

Passo a passo da integração da Nuvemshop com a Troque & Devolva

Configurar a integração da plataforma de e-commerce Nuvemshop com a Troque & Devolva é bem\
simples.

### Instalando o aplicativo Troque e Devolva na Nuvemshop

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Nuvemshop**. A tela exibe o link para instalar o nosso aplicativo no painel da sua loja.

Você também pode acessar a URL do aplicativo diretamente, inserindo /admin/apps/12436/authorize ao final do endereço do seu admin, por exemplo: <https://www.minhaloja.com.br/admin/apps/12436/authorize>

Clique em **Avançar** e você será redirecionado ao painel da Troque e Devolva:

<figure><img src="/files/3Rpe3c5uAYlZbuFIIKu6" alt=""><figcaption><p>Autorizando o aplicativo Troque e Devolva na Nuvem Shop</p></figcaption></figure>

Faça login em sua conta Troque e Devolva e aguarde a conclusão do procedimento.

Pronto, sua conta Troque e Devolva está conectada à Nuvemshop e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Nuvemshop

A Troque & Devolva oferece a geração automática de cupons de desconto na Nuvemshop, sem que você precise acessar manualmente a plataforma para realizar essa tarefa.

### **Como configurar a emissão automática de cupons:**

A emissão automática de cupons foi desenvolvida para ser extremamente simples de usar, sem alterar seu fluxo de trabalho. O sistema reconhece automaticamente a integração com a Nuvemshop e ajusta seu funcionamento, criando o cupom de desconto antes de finalizar a solicitação, sem que você precise fazer ajustes manuais.

### Definindo as opções da Nuvemshop

Na tela de [integração com a Nuvemshop](/integracao-conexao-de-dados/plataformas-de-e-commerce/nuvemshop/configurando-a-integracao-nuvemshop) dentro do Painel Troque e Devolva, siga os passos para configurar a geração de cupons:

1. Acesse o menu **Configurações** > **Integração** e selecione a Nuvemshop.
2. Defina se o cupom será de **frete grátis** e ajuste a **validade em dias** para uso do cliente.

A validade é calculada automaticamente a partir da data de finalização da solicitação, somando os dias configurados.

<figure><img src="/files/KTobnCuAjhlC6LPM0m0r" alt=""><figcaption><p>Tela de configuração da criação do cupom Nuvemshop</p></figcaption></figure>

### Finalizando uma solicitação com vale-trocas integrado na Nuvemshop

O processo de [reembolso por vale-trocas](/atendendo-uma-solicitacao/pagando-uma-solicitacao-encerrando/reembolso-em-vale-trocas) permanece o mesmo para você, sem mudanças operacionais.&#x20;

&#x20;Com a integração na Nuvemshop, **não é mais necessário acessar o dashboard para gerar o cupom manualmente,** a Troque & Devolva faz isso automaticamente para você.

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do\
vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações\
definidas acima.

<figure><img src="/files/M0mOjK3R9LqaibvbpJ66" alt=""><figcaption><p>Geração de cupom automático na Nuvemshop</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

### O cupom será automaticamente gerado na Nuvemshop

Na Nuvemshop, você pode encontrar o cupom gerado pela Troque & Devolva acessando o menu **Dashboard Nuvemshop > Marketing > Cupons**, e procurar pelo código de cupom gerado:

<figure><img src="/files/fLnNlNu0mLxzjQpBItgV" alt=""><figcaption><p>Exemplo de cupom na Nuvemshop</p></figcaption></figure>

Pronto, a solicitação foi encerrada e seu cliente já poderá realizar um novo pedido. Ele receberá o cupom pelo e-mail e também na página de acompanhamento da solicitação.


# Bagy


# Configurando a integração Bagy

Passo a passo da integração da Bagy com a Troque & Devolva

Para criar o Token de integração na Bagy é bem simples.

### Criando o Token na Bagy

No painel da Bagy, acesse **Configurações** e vá até **APIs e Webhooks**.

<figure><img src="/files/dGSvpqOQvfiKEdNeI9kr" alt=""><figcaption><p>Menu APIs e Webhooks no painel da Bagy</p></figcaption></figure>

\
No menu à esquerda, você verá todas as APIs disponíveis. Clique em **Adicionar API**.

<figure><img src="/files/BQ2CDVQClYcHalDwPiQD" alt=""><figcaption><p>Botão Adicionar API</p></figcaption></figure>

Dê um nome à sua API, por exemplo: **LogisticaReversa-TroqueeDevolva**, e clique em **Adicionar**.

<figure><img src="/files/Dab0ldXOTdt5BDSpiDJl" alt=""><figcaption><p>Nomeando a nova API</p></figcaption></figure>

Aceite os termos e condições para concluir a criação da API.

<figure><img src="/files/uFZaCTJmJ0RVBdTFGzi4" alt=""><figcaption><p>Aceite dos termos de uso da API</p></figcaption></figure>

\
Após a criação, você receberá o **token de acesso**. Copie esse código.

<figure><img src="/files/DRlaRn6BF4EvZ1DMtVF3" alt=""><figcaption><p>Token de acesso gerado pela Bagy</p></figcaption></figure>

\
No painel da **Troque & Devolva**, vá em **Configurações > Integração**, selecione **Bagy** e cole o token no campo solicitado.

<figure><img src="/files/zyzIkyiUu44pNIKX0W3i" alt=""><figcaption><p>Campo de token na tela de integração da Troque e Devolva</p></figcaption></figure>

Pronto! Sua conta da Troque & Devolva agora está integrada à Bagy.


# Criação integrada de vale-trocas na Bagy

A Troque e Devolva emite o cupom diretamente na sua loja Bagy, sem que você precise fazer manualmente.

A integração com a Bagy emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Bagy para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione a **Bagy** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/wkEZuvOyIxgF0cY3E8Js" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque e Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/uLz2I8aGXJdUKIQnew3n" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# WooCommerce

Integrando sua loja WooCommerce com a Troque & Devolva

Para integrar, é importante que você tenha **acesso administrador ao admin do** WordPres&#x73;**,** para conseguir realizar as configurações.&#x20;

## Criando as credenciais de acesso

Dentro do painel **WordPress** acesse: **WooCommerce > Configurações > Avançado > API REST**

<figure><img src="/files/qwkhCpuyiyJzwV2AwUH2" alt=""><figcaption><p>Menu API REST no painel do WooCommerce</p></figcaption></figure>

Depois, clique no botão: **Adicionar Chave**

<figure><img src="/files/rPkpGtspnTUkE0SQkSZB" alt="" width="563"><figcaption><p>Botão Adicionar Chave</p></figcaption></figure>

Preencha a descrição e dê as permissões: **Ler/Escrever**

<figure><img src="/files/YOyICkbO0EFwYpIyPPxu" alt="" width="548"><figcaption><p>Definindo descrição e permissões da chave</p></figcaption></figure>

Anote os dados que vamos precisar: **Consumer key** e **Consumer secret**. Você também vai informar o domínio da sua loja no campo **shop\_domain**.

<figure><img src="/files/hDwlv7wzkK9dyrpO1g7x" alt="" width="563"><figcaption><p>Consumer key e Consumer secret gerados</p></figcaption></figure>

Agora, **acesse o Painel da Troque & Devolva > Configurações > Integração.** Na lista de plataformas, selecione: **Woo**

**Preencha os dados** solicitados e clique em **salvar.**

<figure><img src="/files/ddBYU52jL8qGfpqaB2SZ" alt="" width="563"><figcaption><p>Campos de credenciais na tela de integração da Troque e Devolva</p></figcaption></figure>

Pronto, a Troque & Devolva está integrada na sua loja WooCommerce.


# Configurando a integração WooCommerce

Configure a Troque e Devolva com a WooCommerce

Para integrar, é importante que você tenha **acesso administrador ao admin do** WordPres&#x73;**,** para conseguir realizar as configurações.&#x20;

## Criando as credenciais de acesso

Dentro do painel **WordPress** acesse: **WooCommerce > Configurações > Avançado > API REST**

<figure><img src="/files/qwkhCpuyiyJzwV2AwUH2" alt=""><figcaption><p>Menu API REST no painel do WooCommerce</p></figcaption></figure>

Depois, clique no botão: **Adicionar Chave**

<figure><img src="/files/rPkpGtspnTUkE0SQkSZB" alt="" width="563"><figcaption><p>Botão Adicionar Chave</p></figcaption></figure>

Preencha a descrição e dê as permissões: **Ler/Escrever**

<figure><img src="/files/YOyICkbO0EFwYpIyPPxu" alt="" width="548"><figcaption><p>Definindo descrição e permissões da chave</p></figcaption></figure>

Anote os dados que vamos precisar: **Consumer key** e **Consumer secret**. Você também vai informar o domínio da sua loja no campo **shop\_domain**.

<figure><img src="/files/hDwlv7wzkK9dyrpO1g7x" alt="" width="563"><figcaption><p>Consumer key e Consumer secret gerados</p></figcaption></figure>

Agora, **acesse o Painel da Troque & Devolva > Configurações > Integração.** Na lista de plataformas, selecione: **Woo**

**Preencha os dados** solicitados e clique em **salvar.**

<figure><img src="/files/ddBYU52jL8qGfpqaB2SZ" alt="" width="563"><figcaption><p>Campos de credenciais na tela de integração da Troque e Devolva</p></figcaption></figure>

Pronto, a Troque & Devolva está integrada na sua loja WooCommerce.


# Criação integrada de vale-trocas na WooCommerce

A Troque e Devolva emite o cupom diretamente na sua loja WooCommerce, sem que você precise fazer manualmente.

A integração com a WooCommerce emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel do WordPress para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione a **Woo** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/uMsLO8KYVcugXps5yTBB" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque e Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/ZQlITINJ6Y6ijp3O7slP" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Azata

Passo a passo da integração da Azata com a Troque & Devolva


# Configurando a Integração Azata

Configure a Troque e Devolva com a Azata

Para conectar sua loja Azata à Troque & Devolva, você precisa de duas informações: o **token** de integração e o **endpoint** da sua loja.

### Obtendo as credenciais

O token e o endpoint são gerados no painel da Azata. Caso não localize essas informações, entre em contato com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Azata**.

Preencha os campos:

* **token:** o token de integração fornecido pela Azata
* **endpoint:** o endereço de acesso da sua loja

<figure><img src="/files/R4QREO1hi22HUCFwirhL" alt=""><figcaption><p>Campos de credenciais da integração Azata</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Azata e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Azata

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Azata, sem que você precise fazer manualmente.

A integração com a Azata emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Azata para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione a **Azata** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/zBDO8hS2HqNSoydYswFF" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

Depois, clique no botão **salvar**.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/JlpTxutkG0qiIIiNk0Iq" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Betalabs

Passo a passo da integração da Betalabs com a Troque & Devolva


# Configurando a Integração Betalabs

Configure a Troque e Devolva com a Betalabs

Para conectar sua loja Betalabs à Troque & Devolva, você precisa de duas informações: a **api\_url** e o **access\_token** da sua loja.

### Obtendo as credenciais

A api\_url e o access\_token são gerados no painel da Betalabs. Caso não localize essas informações, entre em contato com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Betalabs**.

Preencha os campos:

* **api\_url:** o endereço de acesso da API da sua loja
* **access\_token:** o token de integração fornecido pela Betalabs

<figure><img src="/files/39Um8srNToBoN4ZoOopY" alt=""><figcaption><p>Campos de credenciais da integração Betalabs</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Betalabs e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Betalabs

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Betalabs, sem que você precise fazer manualmente.

A integração com a Betalabs emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Betalabs para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione a **Betalabs** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/zBDO8hS2HqNSoydYswFF" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

Depois, clique no botão **salvar**.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, a Troque & Devolva já preenche o valor do vale-trocas, o código, o frete grátis e a data de validade, conforme as configurações definidas acima.

<figure><img src="/files/JlpTxutkG0qiIIiNk0Iq" alt=""><figcaption><p>Dados do vale-trocas preenchidos automaticamente no encerramento</p></figcaption></figure>

Se precisar, você pode editar qualquer um desses campos antes de confirmar. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Loja Integrada

Configure a Troque e Devolva com a Loja Integrada


# Configurando a Integração Loja Integrada

Configure a Troque e Devolva com a Loja Integrada

Para conectar sua loja à Troque & Devolva, você precisa da **chave de API** da Loja Integrada.

### Obtendo a chave de API

A chave de API é gerada no painel da Loja Integrada. Caso não localize essa informação, entre em contato com o suporte da plataforma para solicitá-la.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Loja Integrada**.

Preencha o campo **chave\_api** com a chave gerada na sua loja.

<figure><img src="/files/oS1Qznsc5wCpkvPLPrz0" alt=""><figcaption><p>Campo de credencial da integração Loja Integrada</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Loja Integrada e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Loja Integrada

A Troque e Devolva emite o cupom de desconto diretamente na sua Loja Integrada, sem que você precise fazer manualmente.

A integração com a Loja Integrada emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Loja Integrada para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Loicomm

Configure a Troque e Devolva com a Loicomm


# Configurando a Integração Loicomm

Configure a Troque e Devolva com a Loicomm

Para conectar sua loja Loicomm à Troque & Devolva, você precisa do **token** de integração.

### Obtendo o token

O token é gerado no painel da Loicomm. Caso não localize essa informação, entre em contato com o suporte da plataforma para solicitá-la.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Loicomm**.

Preencha o campo **token** com o token gerado na sua loja.

<figure><img src="/files/7Zy1A0VKqKEo3pZ6pBmd" alt=""><figcaption><p>Campo de credencial da integração Loicomm</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Loicomm e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Loicomm

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Loicomm, sem que você precise fazer manualmente.

A integração com a Loicomm emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Loicomm para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Magazord

Configure a Troque e Devolva com a Magazord


# Configurando a Integração Magazord

Configure a Troque e Devolva com a Magazord

Para conectar sua loja Magazord à Troque & Devolva, você precisa de três informações: **usuário da API**, **senha da API** e **URL da API**.

### Obtendo as credenciais

As credenciais são geradas no painel da Magazord. Caso não localize essas informações, entre em contato com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Magazord**.

Preencha os campos:

* **usuario\_api:** o usuário de acesso à API da sua loja
* **senha\_api:** a senha correspondente a esse usuário
* **url\_api:** o endereço de acesso da API da sua loja

<figure><img src="/files/WJH5El7wqjBEyFDEdew5" alt=""><figcaption><p>Campos de credenciais da integração Magazord</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Magazord e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Magazord

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Magazord, sem que você precise fazer manualmente.

A integração com a Magazord emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da Magazord para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Magento 1.9

Configure a Troque e Devolva com Magento 1.9


# Configurando a Integração Magento 1.9

Configure a Troque e Devolva com Magento 1.9

Para conectar sua loja Magento 1.9 à Troque & Devolva, você precisa de três informações: **apiUrl**, **apiUser** e **apiKey**.

### Obtendo as credenciais

As credenciais são geradas no painel administrativo do Magento. Caso não localize essas informações, entre em contato com o seu desenvolvedor ou com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione o **Magento 1.9**.

Preencha os campos:

* **apiUrl:** o endereço de acesso da API da sua loja
* **apiUser:** o usuário de acesso à API
* **apiKey:** a chave correspondente a esse usuário

<figure><img src="/files/8V5jvaA5UVEocptm1y9A" alt=""><figcaption><p>Campos de credenciais da integração Magento 1.9</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Magento 1.9 e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Magento 1.9

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Magento 1.9, sem que você precise fazer manualmente.

A integração com o Magento 1.9 emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel do Magento para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Magento 2

Configure a Troque e Devolva com Magento 2


# Configurando a Integração Magento 2

Configure a Troque e Devolva com Magento 2

Para conectar sua loja Magento 2 à Troque & Devolva, você precisa de cinco informações: o endereço da API e as quatro credenciais de autenticação OAuth.

### Obtendo as credenciais

As credenciais são geradas no painel administrativo do Magento, ao criar uma integração. Caso não localize essas informações, entre em contato com o seu desenvolvedor ou com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione o **Magento 2**.

Preencha os campos:

* **api\_endpoint:** o endereço de acesso da API da sua loja
* **consumer\_key** e **consumer\_secret:** as credenciais da integração criada no Magento
* **access\_token** e **access\_token\_secret:** os tokens de acesso gerados para essa integração

<figure><img src="/files/RUn1V5qt0zn81QNJO5zo" alt=""><figcaption><p>Campos de credenciais da integração Magento 2</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Magento 2 e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Magento 2

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Magento 2, sem que você precise fazer manualmente.

A integração com o Magento 2 emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel do Magento para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione o **Magento 2** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/LOT4IcqYcTZ3eDMdiwVH" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

Depois, clique no botão **salvar**.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# VTEX

Configure a Troque e Devolva com a VTEX


# Configurando a Integração VTEX

Configure a Troque e Devolva com a VTEX

Para conectar sua loja VTEX à Troque & Devolva, você precisa de três informações: **app\_key**, **app\_token** e a **URL** da sua loja.

### Obtendo as credenciais

A app\_key e o app\_token são gerados no admin da VTEX, na área de chaves de aplicação. Caso não localize essas informações, entre em contato com o seu desenvolvedor ou com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **VTEX**.

Preencha os campos:

* **app\_key:** a chave de aplicação gerada no admin da VTEX
* **app\_token:** o token correspondente a essa chave
* **url:** o endereço da sua loja

<figure><img src="/files/Yqo8EZRpuuUO3wlIvKTr" alt=""><figcaption><p>Campos de credenciais da integração VTEX</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à VTEX e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na VTEX

A Troque e Devolva emite o cupom de desconto diretamente na sua loja VTEX, sem que você precise fazer manualmente.

A integração com a VTEX emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o admin da VTEX para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# Wake

Configure a Troque e Devolva com a Wake


# Configurando a Integração Wake

Configure a Troque e Devolva com a Wake

Para conectar sua loja Wake à Troque & Devolva, você precisa do **token** de integração.

### Obtendo o token

O token é gerado no painel da Wake. Caso não localize essa informação, entre em contato com o suporte da plataforma para solicitá-la.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **Wake**.

Preencha o campo **token** com o token gerado na sua loja.

<figure><img src="/files/9wzhZA44vKOWWBRoTGy0" alt=""><figcaption><p>Campo de credencial da integração Wake</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à Wake e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na Wake

A Troque e Devolva emite o cupom de desconto diretamente na sua loja Wake, sem que você precise fazer manualmente.

A integração com a Wake emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o admin da Wake para gerar o cupom manualmente.

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# WBuy

Configure a Troque e Devolva com a WBuy


# Configurando a Integração WBuy

Configure a Troque e Devolva com a WBuy

Para conectar sua loja WBuy à Troque & Devolva, você precisa de **usuário** e **senha** de integração.

### Obtendo as credenciais

As credenciais são geradas no painel da WBuy. Caso não localize essas informações, entre em contato com o suporte da plataforma para solicitá-las.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração**, e selecione a **WBuy**.

Preencha os campos:

* **usuario:** o usuário de acesso à API da sua loja
* **senha:** a senha correspondente a esse usuário

<figure><img src="/files/ECtT4VeYUYyCx5lh3f1q" alt=""><figcaption><p>Campos de credenciais da integração WBuy</p></figcaption></figure>

Depois, clique no botão **salvar**.

Pronto, sua conta Troque & Devolva está conectada à WBuy e pronta para receber trocas e devoluções.


# Criação integrada de vale-trocas na WBuy

A Troque e Devolva emite o cupom de desconto diretamente na sua loja WBuy, sem que você precise fazer manualmente.

A integração com a WBuy emite o vale-trocas (cupom) automaticamente na sua loja quando uma solicitação é encerrada nessa modalidade, sem que você precise acessar o painel da WBuy para gerar o cupom manualmente.

### Configurando as informações

No painel da Troque e Devolva, em **Configurações > Integração**, selecione a **WBuy** e configure as opções da geração integrada de vale-trocas:

* **Frete grátis:** define se o cupom concede frete grátis na nova compra
* **Validade (dias):** prazo em que o cliente pode utilizar o cupom

<figure><img src="/files/KF4Lwnneij5u9I2vU5yb" alt=""><figcaption><p>Configuração do vale-trocas na tela de integração</p></figcaption></figure>

### Encerrando a solicitação

Ao encerrar a solicitação com crédito na loja, os dados do vale-trocas são exibidos na tela.

<figure><img src="/files/4R1zuJvgekJbuTUGJJid" alt=""><figcaption><p>Dados do vale-trocas na tela de encerramento</p></figcaption></figure>

Confira o valor, o código, o frete grátis e a data de validade antes de confirmar. Todos os campos podem ser editados. Depois, clique em **Encerrar Agora**.

O cliente recebe o vale-trocas por e-mail e na página de acompanhamento da solicitação.


# ERP's e sistemas de gestão


# Bling

Configurando a integração da Troque & Devolva com a Bling.

Você precisa ter uma conta na Troque & Devolva antes de prosseguir. [Se ainda não tiver, crie sua conta.](https://app.troqueedevolva.com.br/new-account)

### Instalando o aplicativo na Bling

Acesse o **Painel Troque e Devolva > Configurações > Integração ERP.** Depois, clique na logo da **Bling.**

Para instalar, clique sobre o botão **"Instalar na Bling"** que vamos redirecionar para nosso aplicativo:

<figure><img src="/files/2m0E09YBVKuSRl2O3mfK" alt=""><figcaption><p>Instalando a Bling na Troque e Devolva</p></figcaption></figure>

Alternativamente, você pode acessar sua conta Bling, visitar a "Central de Extensões" e pesquisar pela **Troque e Devolva:**

<figure><img src="/files/71IifOLbWoCh8xJyMEtS" alt=""><figcaption><p>Localizando a Troque e Devolva na Central de Extensões da Bling</p></figcaption></figure>

Na página do nosso aplicativo Troque e Devolva, clicar em "**Instalar Aplicativo**".

<figure><img src="/files/8AOCr6r4l3Hr95IRi681" alt=""><figcaption><p>Instalar aplicativo Troque e Devolva na Bling</p></figcaption></figure>

Depois, a Bling irá solicitar as permissões necessárias. Clique em "Autorizar".&#x20;

<figure><img src="/files/eaaB0EelLu4aYCElG6Qg" alt=""><figcaption><p>Autorização para instalar a Troque e Devolva</p></figcaption></figure>

### Finalizando no painel Troque & Devolva

Após a instalação e concessão das permissões na Bling, você será redirecionado para o painel Troque & Devolva.&#x20;

Realize o login e aguarde a finalização. Pronto, sua integração foi finalizada.

### Reautenticando a integração

Em alguns casos, a autenticação entre a Bling e a Troque & Devolva pode se perder. Quando isso acontecer, você pode reautenticar facilmente:

Acesse sua conta Bling, vá até a **"Central de Extensões"**, localize o aplicativo **Troque e Devolva**, clique no menu de opções (três pontinhos) e selecione **"Reautenticar"**.<br>

<figure><img src="/files/ukf0zqb73CxJj7n18wIP" alt=""><figcaption><p>Reautenticando o aplicativo na Central de Extensões</p></figcaption></figure>


# Nota fiscal de devolução na Bling

Configure a busca e emissão de NFD na Bling

### Configurando o template do número de pedido

Para que a integração Troque e Devolva possa capturar os dados da nota fiscal na Bling, é necessário que nossa equipe configure o *script* de normalização de dados.

Você precisa consultar um dado importante: como sua integração cadastra o **número loja virtual**, dentro de uma nota fiscal da Bling:

{% hint style="info" %}
**Importante**: Verifique os dados de uma nota em que exista uma solicitação dentro da Troque e Devolva, para que nossa equipe possa localizar os dados informados.
{% endhint %}

Acesse os detalhes da nota fiscal e nos encaminhe o print que mostre a seguinte area:&#x20;

<figure><img src="/files/XEEop4VqQF0ZAaeh8sw9" alt=""><figcaption><p>Print da nota fiscal na bling</p></figcaption></figure>

Com o print, nossa equipe irá configurar o script necessário para que a Troque e Devolva possa buscar a nota fiscal (NFE) de cada uma das solicitações.

### Emitindo a nota fiscal de devolução (NFD)

Nas **Configurações > Integração ERP >  Bling**, você pode ativar a emissão automática. O sistema fará a emissão automaticamente que pode ocorrer em dois momentos:

* Após a verificação do estoque
* Após a autorização da solicitação

<figure><img src="/files/7gwmz4SJUFhKXsrRzdHc" alt=""><figcaption><p>Configuração automática de emissão de NFD</p></figcaption></figure>

Após emitida, a NFD (XML e PDF) serão anexadas na solicitação e disponibilizadas para consulta.


# Olist Tiny

Configure a Troque e Devolva com o Olist Tiny

Para conectar sua conta Olist Tiny à Troque & Devolva, você precisa do **token** de integração.

### Obtendo o token

O token é gerado no painel do Olist Tiny. Caso não localize essa informação, entre em contato com o suporte da plataforma para solicitá-la.

### Configurando no painel da Troque e Devolva

Acesse o painel da Troque e Devolva, em **Configurações > Integração ERP**, e selecione o **Olist Tiny**. Preencha o campo **token** com o token gerado na sua conta.

<figure><img src="/files/sl98fcmk898WHhFGV0Kt" alt=""><figcaption><p>Tela de configuração da integração Olist Tiny</p></figcaption></figure>

### Buscar pedido pelo ERP

Buscar pedido pelo ERP

Ative essa opção para que a Troque & Devolva também busque os dados dos pedidos no Olist Tiny, além da sua plataforma de e-commerce.

<figure><img src="/files/qegFRpe6Xbbg56JLJsae" alt=""><figcaption><p>Tela de configuração busca por pedidos Olist Tiny</p></figcaption></figure>

É útil quando o ERP tem informações que não vêm da plataforma, como a nota fiscal de venda ou dados complementares do pedido.

### Emissão automática da Nota Fiscal de Devolução

Ative a emissão automática da NFD para que a nota seja gerada em todas as solicitações, sem intervenção manual. Ao ativar, defina também em qual momento do fluxo a nota deve ser emitida. [Saiba mais sobre a emissão da NFD.](https://docs.troqueedevolva.com.br/atendendo-uma-solicitacao/emitindo-a-nfd-nota-fiscal-de-entrada)

<figure><img src="/files/ltZs0OMe2AYDbji5Bi7e" alt=""><figcaption><p>Tela de configuração emissão NFD Olist Tiny</p></figcaption></figure>

Depois, clique no botão **salvar**.


# Nota fiscal de devolução no Olist Tiny

Configure a emissão de NFD no Olist Tiny

Com a emissão automática ativada, a Troque & Devolva gera a Nota Fiscal de Devolução no Olist Tiny a cada solicitação, no momento que você definir.

### Configurações específicas da nota

Os campos abaixo definem como a nota será emitida. Preencha exatamente como estão cadastrados no seu Olist Tiny, porque a emissão utiliza esses valores diretamente.

* **Forma de pagamento (Tiny):** o código da forma de pagamento cadastrada no Olist Tiny
* **Natureza da operação (devolução):** a natureza de operação de devolução, igual à cadastrada no Olist Tiny
* **CFOP de devolução:** o CFOP correspondente à devolução
*

```
<figure><img src="/files/naqlR6feW8cmLmEiCucX" alt=""><figcaption><p>Configurações específicas da nota fiscal de devolução</p></figcaption></figure>
```

{% hint style="warning" %}
Se algum desses valores não corresponder ao que está cadastrado no Olist Tiny, a emissão da nota será recusada. Em caso de dúvida, confirme os dados com o seu contador ou com o suporte do Olist Tiny.
{% endhint %}

Depois, clique no botão **salvar**.

### Scripts personalizados

Os campos **Script pre.getNfe** e **Script pre.createReturnInvoice** permitem ajustes na normalização dos dados enviados ao Olist Tiny, para operações que exigem tratamento específico.

{% hint style="danger" %}
Esses campos vêm configurados de acordo com o padrão da integração. Consulte o nosso suporte antes de alterar qualquer um deles, porque uma alteração incorreta pode impedir a emissão da nota.
{% endhint %}

<figure><img src="/files/ZwOBfcMQtAMX35WK1Mpq" alt=""><figcaption><p>Campos de scripts personalizados da integração</p></figcaption></figure>


# Página de solicitações

É o seusite.troqueedevolva.com.br por onde o cliente fará o pedido de troca ou devolução.

{% embed url="<https://www.youtube.com/watch?v=PFuXZYRqBck>" %}
Instruções em vídeo de como personaliar o seu site Troque & Devolva
{% endembed %}

### Visitando seu site Troque & Devolva

Agora que você já criou sua loja dentro do nosso painel de administração, seu site Troque & Devolva está criado.

Para acessá-lo, basta você abrir o site que você criou **subdomínio**.troqueedevolva.com.br. Não esqueça de substituir o **subdomínio** pelo seu.

<figure><img src="/files/GDI1fQ2QJwjVjPcDHjI4" alt="" width="375"><figcaption><p>Exemplo de página de trocas e devoluções</p></figcaption></figure>

### Configurando a aparência do site

A tela de troca e devolução será a porta de entrada para seu cliente que deseja solicitar a logística reversa. É importante configurá-la para deixar com a aparência de seu e-commerce.

Para configurá-la, acesse: **Configurações > Página de solicitações**, dentro do painel administrador da Troque & Devolva.

{% hint style="info" %}
Nosso painel está acessível em: [**https://app.troqueedevolva.com.br**](https://app.troqueedevolva.com.br)
{% endhint %}

#### Simulação em tempo real

Sempre que você alterar algo na tela de solicitações, a simulação, que fica à direita da tela,  será atualizada, mostrando exatamente o que seu cliente verá ao acessar o site.&#x20;

Ao alterar, clique em **salvar** para atualizar a simulação.

<figure><img src="/files/oXpdW1Qmcr3IAh7WPf2J" alt="" width="375"><figcaption><p>Tela de configurações da página de solicitações</p></figcaption></figure>

#### Descrição dos campos&#x20;

São diversos os campos que você pode editar. Abaixo descrevemos cada um deles.

1. **Nome da loja**: é o nome do seu e-commerce.&#x20;
2. **Site da sua loja**: url do endereço do seu e-commerce.
3. **Domínio Troque & Devolva**: o subdomínio.troqueedevolva.com.br para seu site de trocas e devoluções.
4. **Título no navegador**: qual a frase vai aparecer no navegador e nos sites de busca.
5. **Url da logo**: o endereço da imagem da logo da sua empresa.
6. **Url do favicon**: o endereço da imagem do icone de favoritos para o navegador.
7. **Título principal**: o texto de título principal de sua pagina de trocas.
8. **Cor do título**: a cor desse titulo, selecionado na palheta de cores.
9. **Cor de fundo da página**: cor do background geral do site
10. **Cor do botão principal**: toda ação principal vai adotar esta cor no botão.
11. **Tela de apresentação**: se deve exibir uma tela antes da identificação do pedido.
12. **Conteúdo da tela de apresentação**: o texto da tela de apresentação.
13. **Conteúdo da tela de identificação**: as instruções para o cliente sobre quais dados precisa para identificar o pedido.
14. **Link dos termos de troca e devolução**: link da página no seu site que contém toda as condições para a solicitação.
15. **CSS personalizado**: seu desenvolvedor poderá personalizar os estilos visuais da página, utilizando código CSS.

#### URL das imagens

Nós não hospedamos as imagens da logo e o ícone de sua empresa. No seu site de e-commerce, você já possui essas imagens hospedadas.

Você deve então capturar a URL dessas imagens e colar em nosso painel. Caso você tenha dificuldade para obter esses dados, o desenvolvedor do seu e-commerce poderá ajudá-lo(a).&#x20;

#### Tela de apresentação

É uma tela opcional que você pode exibir antes da tela de identificação de pedidos.  Você poderá utilizá-la para informações gerais que o cliente precisará ler antes de iniciar a sua solicitação.&#x20;

<figure><img src="/files/501l24YzBfE7MOVUH58J" alt="" width="375"><figcaption><p>Exemplo de tela e apresentação</p></figcaption></figure>

### Ocultando os preços do site

Se não quiser exibir os valores dos produtos nesso autoatendimento, ative a opção **“Ocultar preços”**:

<figure><img src="/files/rfSDpxTy9sBfs1Gjno19" alt="" width="563"><figcaption><p>Ocultar os preços do site de autoatendimento</p></figcaption></figure>

Quando ativada, a opção faz com que o autoatendimento não exiba os valores dos itens:

<figure><img src="/files/m7DhmPY57i7iAc6XJcnM" alt="" width="563"><figcaption><p>Tela de autoatendimento sem valores</p></figcaption></figure>

Os preços continuam visíveis no Painel Troque e Devolva, apenas o cliente não os verá.


# Central do Cliente

Portal de autoatendimento onde o cliente visualiza pedidos, rastreia entregas e solicita trocas, devoluções ou reembolsos.

Faça sua simulação de autoatendimento para ver como é moderno e rápido. [Simulador](https://lojinhadetestes.troqueedevolva.com.br/v2/)

O acesso é feito sem login ou cadastro. O cliente informa CPF ou e-mail para visualizar o histórico completo de compras.

<figure><img src="/files/uMbtEYSYmi8KhQfdE6AJ" alt=""><figcaption><p>Exemplo Central do Cliente</p></figcaption></figure>

### Configurando a Central do Cliente

Configure a aparência da Central para manter a identidade visual da sua marca.

Para configurá-la, acesse: **Configurações > Central do Cliente**, dentro do painel administrador da Troque & Devolva.

{% hint style="info" %}
Nosso painel está acessível em: [**https://app.troqueedevolva.com.br**](https://app.troqueedevolva.com.br)
{% endhint %}

#### Simulação em tempo real

Ao alterar os campos, a simulação à direita será atualizada automaticamente. Clique em **salvar** para confirmar as alterações.

Use o botão "**Live Preview**" no canto superior direito para visualizar a Central em uma nova janela.

#### Descrição dos campos&#x20;

1. **Nome e Link do seu e-commerce:**

<figure><img src="/files/rin1PCe90Sq7Ms9kazOi" alt=""><figcaption><p>Campos de nome e link do e-commerce</p></figcaption></figure>

**Nome da loja**: é o nome do seu e-commerce que será exibido no portal.

**Site da sua loja**: url do endereço do seu e-commerce (ex: <https://www.minhaloja.com.br>).

**Domínio seusite.troqueedevolva.com.br**: o subdomínio.troqueedevolva.com.br que seus clientes usarão para acessar a Central.

**Título no navegador**: texto que aparecerá na aba do navegador quando o cliente acessar o portal.

**Favicon**: faça upload ou insira a URL da imagem do ícone de favoritos para o navegador.

2. **Logo:**

<figure><img src="/files/L2ZXDnprHr2RjY550fEU" alt=""><figcaption><p>Campos de logo para modo claro e escuro</p></figcaption></figure>

**Logo (modo claro):** URL ou upload da logo para o modo claro.

**Logo (modo escuro):** URL ou upload da logo para o modo escuro. Deixe vazio se não tiver.

3. **Tela Inicial:**

<figure><img src="/files/A2RizsgY3HpwS5UvxUoB" alt=""><figcaption><p>Configuração da tela inicial da Central do Cliente</p></figcaption></figure>

**Título principal:** texto de título principal da Central do Cliente.

**Conteúdo descritivo:** instruções para o cliente (ex: "Informe o CPF utilizado na compra"). Use as ferramentas de edição (negrito, itálico, listas).

**Cor do botão principal:** cor do botão "Procurar pedidos" conforme identidade visual da marca.

4. **Política resumida de trocas e devoluções:**

<figure><img src="/files/9NYcdRoU2bPAWE8y7V5r" alt=""><figcaption><p>Configuração da política resumida de trocas e devoluções</p></figcaption></figure>

**Exibir política resumida:** marque para exibir resumo da política de trocas antes da solicitação.

5. **Configurações:**

<figure><img src="/files/eTWfJgXwNF1Ya6XThyiN" alt=""><figcaption><p>Configurações gerais da Central do Cliente</p></figcaption></figure>

**Ocultar os preços no autoatendimento:** marque para não exibir valores dos produtos no processo.

6. **Popup de incentivo à trocas:**

<figure><img src="/files/3xWbe6ZVF3ZsHaqCywNz" alt=""><figcaption><p>Configuração do popup de incentivo à troca</p></figcaption></figure>

**Título do modal:** pergunta no topo do popup (ex: "Tem certeza que prefere reembolso?").

**Título do card (Reembolso):** texto no card de reembolso (ex: "Reembolso").

**Subtítulo (Reembolso):** texto explicando desvantagens (ex: "Com reembolso você perde:").

**Prejuízos:** itens que o cliente perde ao escolher reembolso (um por linha).

**Texto do botão (Reembolso):** texto do botão (ex: "Não quero crédito, quero reembolso.").

**Título do card (Crédito):** texto no card de crédito (ex: "Crédito para a próxima compra").

**Subtítulo (Crédito):** texto explicando vantagens (ex: "Você ganha:").

**Vantagens:** benefícios de escolher crédito (um por linha).

**Texto do botão (Crédito):** texto do botão (ex: "Sim, quero crédito").

#### **Como o cliente usa a Central**

O cliente acessa a Central por:

1. Link direto: **seudominio.troqueedevolva.com.br**
2. E-mails automáticos da Troque & Devolva
3. Link de rastreamento de pedidos

#### **Identificação**

O cliente informa CPF ou e-mail para visualizar todos os pedidos.

#### Lista de pedidos

Visualiza todos os pedidos com:

<figure><img src="/files/gkvfzjt1zrsLrrl1qoUT" alt=""><figcaption><p>Lista de pedidos na Central do Cliente</p></figcaption></figure>

* Número do pedido
* Data da compra
* Status (Em trânsito, Entregue, etc.)
* Miniatura dos produtos
* Previsão de entrega (quando disponível)

#### **Rastreamento**

Ao selecionar um pedido, visualiza:

<figure><img src="/files/Kk55jwBeGF1j7CfQimJW" alt=""><figcaption><p>Rastreamento do pedido na Central do Cliente</p></figcaption></figure>

* Timeline visual de todas as movimentações
* Código de rastreio copiável
* Previsão de entrega
* Dados da transportadora

{% hint style="info" %}
Para que o rastreamento apareça na Central do Cliente, o status, o código de rastreio e a data de entrega precisam vir da sua plataforma de e-commerce.

Se a sua plataforma não envia essas informações, entre em contato com o nosso suporte. Em alguns casos, conseguimos capturar o rastreamento diretamente pela transportadora utilizada, sem depender da plataforma.
{% endhint %}

#### **Solicitando troca ou devolução**

O cliente clica em "**Solicitar troca**", seleciona os produtos, responde às perguntas configuradas em **Configurações > Perguntas obrigatórias** e escolhe entre reembolso ou crédito.

As perguntas são unificadas. A Central oferece troca direta de tamanho e cor quando disponível.

#### **Funcionalidades da Central do Cliente**

* **Lista completa de pedidos:** Todos os pedidos em uma única visualização
* **Rastreamento integrado:** Timeline visual com todas as etapas
* **Modo escuro/claro:** Escolha do tema ou modo automático
* **Design responsivo:** Funciona em qualquer dispositivo
* **Fluxo simplificado:** Processo em apenas 4 etapas
* **Sem necessidade de login:** Acesso rápido com CPF ou e-mail
* **Troca direta:** Troca de tamanho e cor diretamente
* **Perguntas unificadas:** Sistema único de perguntas


# Regras gerais

São regras gerais da configuração da sua conta usadas para aprimorar a sua experiência.

Você acessa as regras gerais no menu **Configurações** > **Regras gerais**.

### Permitir mais de uma solicitação por pedido

Por padrão, a Troque e Devolva permite apenas uma solicitação por pedido. Tentativas posteriores são bloqueadas automaticamente.

Se necessário, você pode abrir [**exceções manuais** ](/recebendo-solicitacoes/estendendo-o-prazo-para-trocas-excecao)diretamente pelo painel, autorizando solicitações adicionais caso a caso.

No entanto, se seu modelo de negócio exige essa flexibilidade com frequência, como em vendas consignadas, reposição de peças ou envios parciais, é mais prático **desativar o bloqueio**. Assim, o cliente poderá abrir várias solicitações para o mesmo pedido, sempre que precisar.

Para isso, basta desmarcar a opção **"Impedir duplicidade de solicitações"** nas configurações da conta:

<figure><img src="/files/BROcnp9eMIIc2qTq5uq9" alt="" width="554"><figcaption><p>Configuração de impedir duplicidade</p></figcaption></figure>

### Status de pedido que deve aceitar solicitações

Caso você queira, poderá restringir quais status de pedidos devem permitir que o cliente prossiga com a solução. Você pode marcar apenas pedidos entregues, por exemplo:

<figure><img src="/files/KzuILu3HL1edNWFXhfI9" alt="" width="563"><figcaption><p>Seleção dos status de pedido que aceitam solicitações</p></figcaption></figure>

Você pode informar mais de um status, separando-os por vírgula. Assim, pedidos em qualquer um dos status listados poderão gerar solicitações.

Para qualquer pedido que não se enquadre nesta situação, um aviso será exibido no momento da solicitação, informando que o status do pedido não permite a continuação da solicitação.

### Dias úteis para análise inicial

Defina em quantos dias úteis a sua equipe se compromete a analisar uma solicitação recebida.
\
O prazo é informado ao cliente e serve como referência da sua operação, ajudando a reduzir contatos de acompanhamento enquanto a análise não é concluída.

<figure><img src="/files/0pz8InfmQObUWsjgqREa" alt=""><figcaption><p>Inserindo dias para análise</p></figcaption></figure>

### Análise prévia de solicitações com fixação de centro de retorno

Se sua operação envolve Ship From Store ou Compra Online com Retirada em Loja, ou se você deseja controlar qual centro de retorno será responsável por cada atendimento, é possível ativar a opção **Análise prévia para atribuição do Centro de Retorno**.

{% hint style="warning" %}
&#x20;**Importante**: cada operador visualizará apenas as solicitações do centro ao qual está vinculado, mantendo o controle e a organização das operações.
{% endhint %}

<figure><img src="/files/YgOZULiPIEp7l4BrZoVi" alt="" width="548"><figcaption><p>Ativação da análise prévia do Centro de Retorno</p></figcaption></figure>

Ao ativar essa opção, um novo menu chamado **Análise Prévia** será exibido. Nele, você poderá indicar manualmente qual centro de retorno ficará responsável por cada solicitação antes que os operadores tenham acesso.

Enquanto a atribuição não for feita, a solicitação ficará oculta para os operadores. Ela só será exibida após a definição do centro de retorno responsável.

### Isolamento de transportadoras e centros de retorno ao usuário que criou

Para ativar, acesse **Configurações > Regras Gerais > Visibilidade de Centros de Retorno e Transportadoras > Recursos vinculados ao usuário que criou > Sim**:

<figure><img src="/files/3DqrzZjE0iJerPMS9LFJ" alt=""><figcaption><p>Configuração de visibilidade de centros de retorno e transportadoras</p></figcaption></figure>

Com a configuração ativa, cada usuário vê e gerencia apenas as transportadoras e centros de retorno que ele mesmo criou.

Isso é útil para quando você opera com terceiros, como, por exemplo, situações em que o **atendimento da troca é realizado diretamente por um fabricante terceirizado** e ele precisa ter acesso para dar andamento à solicitação **sem acessar demais dados da operação**.&#x20;

O isolamento se aplica a todo o fluxo:&#x20;

* listagem de transportadoras
* cotações de frete reverso
* sugestões de frete
* autorização de postagem e listagem de solicitações

Isso significa que um operador nunca verá cotações ou solicitações de transportadoras que não pertencem a ele.

Transportadoras e centros de retorno já existentes ou que forem criados pelo administrador da conta continuam visíveis para todos.

### Configuração da recomendação KeepIt

Em alguns casos, o custo do frete pode ser maior do que o valor do produto ou até do valor de revenda dele. Para evitar prejuízo com esses retornos, você pode configurar o sistema para **recomendar a autorização sem envio**, permitindo que o cliente **fique com o item como cortesia**.

Basta ativar o recurso e definir o **percentual de comparação** entre o valor do frete e o valor total dos produtos. Quando esse percentual for atingido, a recomendação será exibida automaticamente.

<figure><img src="/files/XKPCBZ5T2aD4sPPn98TW" alt="" width="552"><figcaption><p>Configuração da recomendação KeepIt</p></figcaption></figure>

### Unidades de medida da integração

Cada plataforma de e-commerce envia o peso e as dimensões dos produtos em uma unidade diferente. Algumas trabalham com gramas, outras com quilogramas. O mesmo vale para as dimensões, que podem vir em centímetros ou em metros.

Para que a Troque e Devolva interprete esses dados corretamente, informe qual unidade a sua integração utiliza:

* **Unidade de peso:** gramas (g) ou quilogramas (kg)
* **Unidade de dimensão:** centímetros (cm) ou metros (m)

<figure><img src="/files/hcXlL95SPRELFADCattW" alt="" width="503"><figcaption><p>Definição das unidades de peso e dimensão</p></figcaption></figure>

{% hint style="warning" %}
Essa configuração afeta diretamente a cotação de frete reverso. Se a unidade estiver incorreta, um produto de 500 gramas pode ser interpretado como 500 quilos, gerando valores de frete muito acima do real ou impedindo a emissão da autorização de postagem.
{% endhint %}

Em caso de dúvida sobre qual unidade a sua plataforma utiliza, consulte o cadastro de um produto na própria plataforma e compare com o valor exibido nos detalhes da solicitação. Se você preenche as medidas manualmente, use a unidade que corresponde ao que você digita. [Veja como inserir as medidas dos itens.](https://docs.troqueedevolva.com.br/atendendo-uma-solicitacao/recursos-essenciais/inserir-as-medidas-dos-itens)

### E-mail para resposta

Por padrão, os e-mails transacionais são enviados de nosso remetente **<atendimento@troqueedevolva.com.br>.**

Caso os clientes respondam aos e-mails, essas respostas não estarão acessíveis, a menos que você configure um e-mail de resposta. Nesse caso, todos os e-mails enviados pelos clientes serão encaminhados para o endereço configurado.

<figure><img src="/files/SSr9UwIYLOcyLbw9kpgK" alt="" width="545"><figcaption><p>Tela de cadastramento de e-mail de resposta</p></figcaption></figure>

{% hint style="info" %}
**Você pode usar seu próprio e-mail como remetente.** A configuração é feita diretamente no painel, em Configurações > Remetente de E-mail.\
\
Aprenda como: [Remetente de e-mail](https://docs.troqueedevolva.com.br/configuracoes/remetente-de-e-mail)
{% endhint %}

### E-mails transacionais

Você pode escolher se deseja ou não receber os e-mails transacionais:

* Notificação de nova solicitação
* Notificação de solicitação postada na transportadora
* Notificação de entregue no centro de retorno

Caso opte por não recebê-los, todas as notificações estarão disponíveis apenas no seu painel Troque & Devolva.

**Se quiser receber as notificações em e-mails diferentes ao do cadastro da conta**, insira os e-mails desejados, separados por vírgula.&#x20;

<figure><img src="/files/6cXPcTdj83Wot2YbY2xf" alt="" width="563"><figcaption><p>Configuração das notificações por e-mail</p></figcaption></figure>


# Regras de Troca

Personalize as configurações da opção de troca em seu ambiente

Você acessa as regras de troca no menu **Configurações** > **Regras de Troca**.

## Configurações essenciais para Trocas

Caso sua operação permita que o cliente solicite uma troca, seja para receber um crédito para a próxima compra ou reenvio de produto, ative a função e estabeleça quantos dias o cliente terá antes do prazo expirar:

<figure><img src="/files/tZCG0CBZzZLUSzDxw9v6" alt=""><figcaption><p>Ativação das trocas e prazo para solicitação</p></figcaption></figure>

* **Ativar trocas**: escolha se deseja permitir solicitações de troca.
* **Prazo máximo para troca**: defina em quantos dias, **a partir da data de entrega**, o cliente poderá solicitar a troca.

Importante destacar que **a validação de prazo para trocar só funciona se seu e-commerce for atualizado com a data de entrega real do pedido**. Caso não exista essa data, todas as solicitações são aceitas e você precisará analisar a procedência ou não manualmente.&#x20;

Depois, você precisa confirmar as formas de pagamento que o cliente poderá escolher na [Central do Cliente](/configuracoes/central-do-cliente).

### Crédito para a próxima compra

É o método de pagamento mais comum. Você gera um cupom (vale-trocas, crédito interno) para que o cliente utilize em uma nova compra, obtendo o desconto no pagamento.

<figure><img src="/files/hu2ScxSR732x10SdBQTM" alt="" width="563"><figcaption><p>Configuração da forma de pagamento crédito para a próxima compra</p></figcaption></figure>

* **Ativar**: determine se sua operação trabalha oferecendo cupons aos clientes
* **Nome no Painel (interno)**: é o nome que ficará dentro do painel Troque & Devolva, para facilitar o entendimento da sua equipe. Alguns chamam de "Cupom", outros de "Vale-Trocas" ou "Crédito para próxima compra".&#x20;
* **Titulo da opção no autoatendimento:** é o nome que aparecerá para o seu cliente na Central do Cliente
* **Descrição no autoatendimento:** são os bullets de "vantagens" para seu cliente. Cada ponto final será considerado uma quebra de linha.&#x20;
* **Badge**: o balãozinho visual indicando a "melhor escolha".&#x20;

No autoatendimento, ficará assim:

<figure><img src="/files/w14RjEiclS7olPs2Q5B8" alt="" width="563"><figcaption><p>Exibição do crédito na Central do Cliente</p></figcaption></figure>

### Forma de Pagamento - Reenvio de produto

Para quando sua operação trabalha com a troca direta de produtos e faz o envio de ítens, sem a necessidade de disponibilizar um cupom ao cliente.

<figure><img src="/files/HWzU5rpihnGPzqLyqxf5" alt="" width="563"><figcaption><p>Configuração da forma de pagamento reenvio de produto</p></figcaption></figure>

* **Ativar**: determine se sua operação trabalha com reenvio de produtos
* **Nome no Painel (interno)**: é o nome que ficará dentro do painel Troque & Devolva, para facilitar o entendimento da sua equipe.&#x20;
* **Titulo da opção no autoatendimento:** é o nome que aparecerá para o seu cliente na Central do Cliente
* **Descrição no autoatendimento:** são os bullets de "vantagens" para seu cliente. Cada ponto final será considerado uma quebra de linha.&#x20;

No autoatendimento ficará assim:

<figure><img src="/files/Dh2ObiWkZgmo90M3rWzj" alt="" width="563"><figcaption><p>Exibição do reenvio de produto na Central do Cliente</p></figcaption></figure>

Quando a sua plataforma disponibiliza as variações do produto, o cliente também indica a cor ou o tamanho que deseja receber. [Veja como funciona a troca por variação.](https://docs.troqueedevolva.com.br/atendendo-uma-solicitacao/novas-solicitacoes/troca-por-variacao-checkout-de-trocas)

### Configurações de Marketplace

Dependendo da sua integração, as compras realizadas em marketplaces também podem ser elegíveis para trocas, se sua plataforma / ERP importar esses pedidos.

Você pode definir se deseja permitir que seus clientes troquem pedidos feitos no marketplace diretamente pelo autoatendimento.

Além disso, é possível limitar em quais marketplaces essa opção estará disponível.  Se deixar o campo em branco, todas as solicitações de todos os marketplaces serão aceitas.

<figure><img src="/files/gryA69HkOZvrkcgkuYLZ" alt=""><figcaption><p>Configuração de trocas em marketplaces</p></figcaption></figure>

Quando o cliente tentar abrir uma solicitação de troca que **não estiver permitida** para aquele marketplace, ele verá um aviso claro e objetivo, como este exemplo:

<figure><img src="/files/nl4BNXiAsphQwP07ZL24" alt=""><figcaption><p>Aviso exibido quando o marketplace não permite troca</p></figcaption></figure>

### Configurando as proibições

Dependendo do seu ramo de atuação, alguns produtos ou categorias inteiras podem não ser elegíveis para trocas, como é o caso de itens de uso pessoal, por exemplo.

Quando um pedido contiver produtos com troca proibida, a opção de "Trocar" simplesmente não será exibida ao cliente no autoatendimento.

Para configurar essas restrições, clique no botão **Proibições.** Nesta tela você pode criar regras específicas e visualizar a lista completa de produtos ou categorias com trocas desabilitadas:

<figure><img src="/files/kNrgLdA3hxdtyyhW7O2u" alt=""><figcaption><p>Lista de proibições de troca cadastradas</p></figcaption></figure>

<figure><img src="/files/u9b1Qbgzx63xKDFL2P6E" alt=""><figcaption><p>Cadastro de uma nova proibição de troca</p></figcaption></figure>

### Emissão automática de vale-trocas

A Troque e Devolva pode emitir automaticamente o vale-trocas, cupom de desconto ou cartão presente (dependendo de como sua plataforma lida com descontos) para solicitações autorizadas. Isso elimina trabalho manual, deixando a criação totalmente sob responsabilidade da nossa plataforma.&#x20;

Para isso, basta definir o momento da geração e as regras de cálculo:

<figure><img src="/files/cAIotlgKhPzxwbjSG8Fh" alt=""><figcaption><p>Configuração da emissão automática de vale-trocas</p></figcaption></figure>

### **Emissão antecipada (após a postagem)**

Se você deseja liberar o vale assim que o cliente postar os produtos, selecione a opção **Após a postagem**.&#x20;

Assim que a Troque e Devolva identificar a postagem, o código do vale será emitido automaticamente e o cliente será notificado.

### Emitindo após a checagem de estoque

Se preferir aguardar a conferência dos itens, a geração ocorrerá após o recebimento e checagem dos produtos.&#x20;

**A solicitação será automaticamente encerrada, desde que todos os itens sejam para troca.**

{% hint style="info" %}
**Importante**: se houver ao menos um item para devolução, a solicitação permanecerá no menu Aguardando Pagamento, pois será necessário o reembolso.
{% endhint %}

### Regras de cálculo do valor do vale-trocas

Você pode configurar se o valor do cupom incluirá o frete e os descontos.

Por padrão, o frete proporcional não é somado, pois normalmente o vale já oferece frete grátis.&#x20;

O desconto, no entanto, costuma ser incluído. Isso evita que o cliente fique impossibilitado de comprar o mesmo produto caso tenha usado, por exemplo, um cupom de primeira compra.

Tanto o frete quanto o desconto são calculados proporcionalmente: se a troca for apenas de parte do pedido, será considerado apenas o valor referente aos itens selecionados.

### Regras de negócio da emissão de vale-trocas automático

A emissão automática de vale-trocas pela Troque e Devolva segue as seguintes regras, com base na escolha de reembolso ou troca e nos itens selecionados:

#### **Cliente escolheu receber por vale-trocas**:&#x20;

Será emitido um cupom com o valor total da solicitação.

#### **Cliente escolheu reembolso, mas incluiu itens para troca**

Será emitido vale-trocas apenas para os itens marcados como troca.

#### **Troca incentivada**:&#x20;

O valor do incentivo será somado ao total do cupom.

**Autorização sem devolução dos itens**:&#x20;

Será emitido cupom com o valor dos itens descartados que forem trocas e a solicitação será encerrada automaticamente, caso possua apenas produtos de troca.\
\
Caso existam produtos de devolução, a solicitação permanecerá aguardando encerramento da diferença.&#x20;

<figure><img src="/files/dJ18cqS9HxS7vNa5xtCj" alt=""><figcaption><p>Vale-trocas emitido em autorização sem devolução dos itens</p></figcaption></figure>

#### **Emissão automática de vale-trocas na postagem com recebimento de todos os itens**:

**A solicitação será encerrada automaticamente** após a conferência dos itens sem comunicação do cliente. Como o cliente já recebeu a comunicação da disponibilização do cupom antes, não faria sentido enviar a mesma comunicação novamente.

#### **Emissão automática de vale-trocas na postagem com itens faltando no recebimento**:&#x20;

A solicitação permanecerá para encerramento manual pois nem todos os itens foram enviados pelo cliente (o valor do voucher ficou a maior).

Você poderá ver qual foi a diferença em tela, **para que possa entrar em contato com o cliente e resolver a situação** de como proceder com o valor a mais que ele recebeu no cupom (caso já tenha utilizado e você não possa cancelar):

<figure><img src="/files/vZOjnSur8RSQ9e9ZjnL2" alt=""><figcaption><p>Diferença exibida quando faltam itens no recebimento</p></figcaption></figure>

### Autorização ou negativa automática de troca

{% hint style="info" %}
**Para a automação funcionar, é obrigatório que os pedidos recebam a atualização com a data de entrega.**
{% endhint %}

O sistema irá verificar a data de entrega do pedido e irá calcular, de acordo com os critérios de prazo que você informou nos passos anteriores.

<figure><img src="/files/k0sRYg04D5UVxQY7njRy" alt="" width="554"><figcaption><p>Configuração da autorização automática de trocas</p></figcaption></figure>

Ao selecionar **Sim** em "Autorizar automaticamente trocas", os campos abaixo são exibidos para você definir os critérios da automação.

### Transportadora preferencial

Defina quais transportadoras estarão disponíveis para autorizar os envios de pedidos.

Se a opção de **entrega pessoal em Centro de Retorno** estiver ativada e houver uma unidade próxima ao endereço do cliente, essa será a forma de envio escolhida automaticamente. Isso também ocorrerá caso o cliente tenha **retirado na loja**.

Caso não esteja disponível, o sistema calculará os fretes das transportadoras selecionadas em segundo plano e autorizará o envio com a opção de **menor custo**.

### **Centro de retorno preferencial**

Selecione os centros de retorno para onde os produtos devolvidos deverão ser enviados.

Caso haja centros com **opção de devolução pessoal ou retirada em loja**, o sistema priorizará automaticamente essas opções, desde que o endereço do cliente esteja dentro do raio de atendimento.

Se não houver devolução presencial disponível, o sistema escolherá o centro de retorno mais próximo com base na geolocalização e autorizará o envio via **transportadora preferencial**.

#### Respostas para a autorização automática

Para cada pergunta obrigatória de múltipla escolha cadastrada, é exibido um bloco com as respostas possíveis. Marque quais respostas devem gerar autorização automática.

Se todas as perguntas forem de texto livre, o sistema autorizará automaticamente qualquer resposta do cliente.

### Autorizar automaticamente sem envio

{% hint style="info" %}
Para utilizar este recurso, configure antes o [Recurso KeepIt](https://docs.troqueedevolva.com.br/configuracoes/regras-gerais#configuracao-da-recomendacao-keepit) em **Configurações > Regras Gerais**, definindo o percentual máximo aceitável que o valor do frete pode representar em relação ao valor dos produtos.
{% endhint %}

A autorização automática identifica quando o valor do frete ultrapassa o percentual configurado.

Por exemplo, se o frete custar R$ 20,00 e o produto também R$ 20,00, não faz sentido autorizar o envio, pois isso geraria prejuízo. Nesse caso, é mais vantajoso emitir um **vale-trocas** no valor de R$ 20,00 diretamente.

**Nos detalhes da solicitação**, você poderá ver a decisão que o algoritmo tomou:

<figure><img src="/files/Opl9AuG1VLsgFLAfT9FF" alt=""><figcaption><p>Decisão da análise automática nos detalhes da solicitação</p></figcaption></figure>


# Regras de Devolução

Personalize as configurações da opção de devolução em seu ambiente

Você acessa as regras de devolução no menu **Configurações** > **Regras de Devolução**.

#### Habilitar as devoluções

* **Permitir devolução:** escolha se deseja permitir solicitações de devolução
* **Prazo para Devolução:** defina em quantos dias, a partir da data de entrega, o cliente poderá solicitar a devolução

<figure><img src="/files/gIEQ6gqlt6BojpJSrDAe" alt=""><figcaption><p>Ativação das devoluções e prazo para solicitação</p></figcaption></figure>

#### Textos no autoatendimento

* **Título da opção no autoatendimento:** o nome que aparecerá para o seu cliente na Central do Cliente
* **Sufixo do botão no autoatendimento:** a palavra que complementa o botão de confirmação
* **Descrição no autoatendimento:** o texto explicativo exibido ao cliente durante a solicitação

<figure><img src="/files/6WTrswB9X8W28it3eDVB" alt=""><figcaption><p>Configuração dos textos exibidos no autoatendimento</p></figcaption></figure>

O título, o sufixo do botão e a descrição aparecem no autoatendimento, na tela onde seu cliente vai solicitar a devolução, nesta área:

<figure><img src="/files/hGphSnpwN9VHtBqnfBYw" alt=""><figcaption><p>Exibição da devolução na Central do Cliente</p></figcaption></figure>

### Configurações de Marketplace

Dependendo da sua integração, as compras realizadas em marketplaces também podem ser elegíveis para devoluções, se sua plataforma / ERP importar esses pedidos.

Você pode definir se deseja permitir que seus clientes devolvam pedidos feitos no marketplace diretamente pelo autoatendimento.

Além disso, é possível limitar em quais marketplaces essa opção estará disponível.  Se deixar o campo em branco, todas as solicitações de todos os marketplaces serão aceitas.

<figure><img src="/files/egjhKQ6zlWyLnYbo6Be9" alt=""><figcaption><p><strong>Configuração de devoluções em marketplaces</strong></p></figcaption></figure>

Quando o cliente tentar abrir uma solicitação de devolução que **não estiver permitida** para aquele marketplace, ele verá um aviso claro e objetivo, como este exemplo:

<figure><img src="/files/nl4BNXiAsphQwP07ZL24" alt=""><figcaption><p>Aviso exibido quando o marketplace não permite devolução</p></figcaption></figure>

### Configurando as proibições

Dependendo do seu ramo de atuação, alguns produtos ou categorias inteiras podem não ser elegíveis para devoluções — como é o caso de itens de uso pessoal, por exemplo.

Quando um pedido contiver produtos com devolução proibida, a opção de "Devolver" simplesmente não será exibida ao cliente no autoatendimento.

Para configurar essas restrições, clique no botão **Proibições.** Nesta tela você pode criar regras específicas e visualizar a lista completa de produtos ou categorias com devoluções desabilitadas:

<figure><img src="/files/xMYyWxDKNCyltwrUysvg" alt=""><figcaption><p>Tela de proibições cadastradas</p></figcaption></figure>

<figure><img src="/files/P7iSLm0ZBOdbCBjXLy1t" alt=""><figcaption><p>Tela de cadastramento de proibições de devolução</p></figcaption></figure>

### Autorização ou negativa automática de devolução

{% hint style="info" %}
**Para a automação funcionar, é obrigatório que os pedidos recebam a atualização com a data de entrega.**
{% endhint %}

O sistema irá verificar a data de entrega do pedido e irá calcular, de acordo com os critérios de prazo que você informou nos passos anteriores.

<figure><img src="/files/hAvo9sdMyzc7jeGE9c9L" alt=""><figcaption><p>Configuração da autorização automática de devoluções</p></figcaption></figure>

Ao selecionar **Sim** em "Autorizar automaticamente devoluções", os campos abaixo são exibidos para você definir os critérios da automação.

#### Transportadora preferencial

Defina quais transportadoras estarão disponíveis para autorizar os envios de pedidos.

Se a opção de **entrega pessoal em Centro de Retorno** estiver ativada e houver uma unidade próxima ao endereço do cliente, essa será a forma de envio escolhida automaticamente. Isso também ocorrerá caso o cliente tenha **retirado na loja**.

Caso não esteja disponível, o sistema calculará os fretes das transportadoras selecionadas em segundo plano e autorizará o envio com a opção de **menor custo**.

### **Centro de retorno preferencial**

Selecione os centros de retorno para onde os produtos devolvidos deverão ser enviados.

Caso haja centros com **opção de devolução pessoal ou retirada em loja**, o sistema priorizará automaticamente essas opções — desde que o endereço do cliente esteja dentro do raio de atendimento.

Se não houver devolução presencial disponível, o sistema escolherá o centro de retorno mais próximo com base na geolocalização e autorizará o envio via **transportadora preferencial**.

### Respostas para a autorização automática

Para cada pergunta obrigatória de múltipla escolha cadastrada, é exibido um bloco com as respostas possíveis. Marque quais respostas devem gerar autorização automática.

Se todas as perguntas forem de texto livre, o sistema autorizará automaticamente qualquer resposta do cliente.

### Autorizar automaticamente sem envio

{% hint style="info" %}
Para utilizar este recurso, configure antes o [**Recurso KeepIt**](#analise-automatica-keepit-para-autorizar-sem-envio) em [**Configurações > Regras Gerais**](https://docs.troqueedevolva.com.br/configuracoes/regras-gerais#configuracao-da-recomendacao-keepit), definindo o percentual máximo aceitável que o valor do frete pode representar em relação ao valor dos produtos.
{% endhint %}

A autorização automática identifica quando o valor do frete ultrapassa o percentual configurado.

Por exemplo, se o frete custar R$ 20,00 e o produto também R$ 20,00, não faz sentido autorizar o envio, pois isso geraria prejuízo. Nesse caso, é mais vantajoso realizar o **reembolso** no valor de R$ 20,00 diretamente.

**Nos detalhes da solicitação**, você poderá ver a decisão que o algoritmo tomou:

<figure><img src="/files/Opl9AuG1VLsgFLAfT9FF" alt=""><figcaption><p>Decisão da análise automática nos detalhes da solicitação</p></figcaption></figure>


# Regras de Garantia

Personalize as configurações da opção de garantia em seu ambiente

Se sua empresa é fabricante ou assume a garantia diretamente, é possível definir prazos personalizados de garantia para produtos ou categorias específicas.

Você acessa as regras de Garantia no menu **Configurações** > **Regras de Garantia**.

#### Habilitar as garantias

* **Permitir garantia:** escolha se deseja permitir solicitações de garantia
* **Prazo para Garantia:** defina em quantos dias, a partir da data de entrega, o cliente poderá solicitar a garantia. Você também pode configurar prazos especiais, explicados abaixo
* **Disponibilizar garantia para:** define se a garantia vale para todos os produtos ou apenas para os produtos selecionados. Neste segundo caso, você precisa [determinar os prazos para os produtos e categorias](https://docs.troqueedevolva.com.br/configuracoes/regras-de-garantia#configurando-os-prazos-de-garantia)

<figure><img src="/files/dhoVBdHXz4TsOOpLXbhk" alt=""><figcaption><p>Ativação das garantias e prazo para solicitação</p></figcaption></figure>

#### Textos no autoatendimento

* **Título da opção no autoatendimento:** o nome que aparecerá para o seu cliente na Central do Cliente
* **Sufixo do botão no autoatendimento:** a palavra que complementa o botão de confirmação
* **Descrição no autoatendimento:** personalize o texto explicativo que será exibido

<figure><img src="/files/7iDrMdIDbjEHvZLaXymP" alt=""><figcaption><p>Configuração dos textos exibidos no autoatendimento</p></figcaption></figure>

## Quando o botão de garantia aparecerá

O botão “Garantia” será exibido **apenas quando as opções de troca ou devolução não estiverem mais disponíveis**.

Isso ocorre porque os prazos para troca e devolução geralmente são mais curtos (ex: 7 dias), enquanto o prazo legal de garantia costuma ser maior (ex: 90 dias).

Dessa forma, tomando como exemplo que você configurou troca e devolução com prazo de 7 dias:

* **Até o 7º dia**: o cliente verá apenas as opções **Trocar** ou **Devolver**.
* **Do 8º ao 90º dia**: aparecerá apenas a opção **Garantia**.

O **título e a descrição** do botão de garantia são exibidos no autoatendimento, na tela onde o cliente inicia a solicitação.&#x20;

<figure><img src="/files/uuMu3X2LLAS2P1jaln13" alt=""><figcaption></figcaption></figure>

## Configurações de Marketplace

Dependendo da sua integração, as compras realizadas em marketplaces também podem ser elegíveis para acionamento de garantia, se sua plataforma / ERP importar esses pedidos.

Você pode definir se deseja permitir que seus clientes acionem garantia de pedidos feitos no marketplace diretamente pelo autoatendimento.

Além disso, é possível limitar em quais marketplaces essa opção estará disponível.  Se deixar o campo em branco, todas as solicitações de todos os marketplaces serão aceitas.

<figure><img src="/files/90aCVvj6ezWA3RNgsyIZ" alt=""><figcaption></figcaption></figure>

Quando o cliente tentar abrir uma solicitação de garantia que **não estiver permitida** para aquele marketplace, ele verá um aviso claro e objetivo, como este exemplo:

<figure><img src="/files/nl4BNXiAsphQwP07ZL24" alt=""><figcaption></figcaption></figure>

## Configurando os prazos de garantia

Você já definiu no passo anterior se a garantia **será aplicada a todos os produtos ou apenas aos determinados**.&#x20;

Se você definiu que será para todos os produtos, usamos o **prazo geral de garantia**.&#x20;

Agora, se quiser aplicar prazos diferentes para itens específicos ou **garantia apenas para estes itens**, siga estas etapas:

1. Clique no botão **Prazos de Garantia,** depois em  **Adicionar Primeiro Período** ou **+ Novo Período** na tela que se abriu, a depender se você já possui prazos ou se será o primeiro.&#x20;
2. Escolha se deseja configurar por **categoria** ou por **SKU**.
3. Preencha o **ID da categoria ou do produto**.
4. Informe o **novo prazo de garantia em dias** (ex: `365` para um ano).
5. Clique em **Salvar**.

Para os itens com essa configuração, o sistema **ignora o prazo geral** e aplica o **prazo personalizado** definido por você.

Caso você tenha determinado que aplicará garantia apenas para estes produtos, a opção garantia não aparecerá para os demais itens da sua loja.

<figure><img src="/files/ZJFKKy5MKSDaadkB1TdK" alt=""><figcaption><p>Lista de ítens de garantia</p></figcaption></figure>

<figure><img src="/files/U1eOUZYK9VZAC58ag1Q2" alt=""><figcaption><p>Detalhamento de ítens de garantia</p></figcaption></figure>

## Autorização ou negativa automática de garantia

{% hint style="danger" %}
As solicitações de garantia **não podem ser autorizadas automaticamente**.
{% endhint %}

Por questões legais e operacionais, é necessário realizar uma análise prévia, que pode incluir a verificação de documentos, solicitação de fotos e comprovação do vício ou defeito do produto.

**Esse procedimento deve ser realizado caso a caso, de forma manual.**


# Regras de Item Faltante

Personalize as configurações da opção de item faltante da sua conta

### Configurações essenciais

Você acessa as regras de item faltante no menu **Configurações** > **Regras de Item Faltante**.

Configure as opções abaixo para ativar a funcionalidade de itens faltantes no autoatendimento:

* **Permitir item faltante:** escolha se deseja permitir solicitações de item faltante
* **Prazo para Item Faltante:** defina em quantos dias, a partir da data de entrega, o cliente poderá informar que não recebeu um item
* **Título da opção no autoatendimento:** o nome que aparecerá para o seu cliente na Central do Cliente
* **Sufixo do botão no autoatendimento:** a palavra que complementa o botão de confirmação
* **Descrição no autoatendimento:** o texto explicativo exibido ao cliente durante a solicitação

<figure><img src="/files/TMHJICUC8gJLdhjzUoki" alt=""><figcaption><p>Configuração das regras de item faltante</p></figcaption></figure>

## Como aparece no autoatendimento para o cliente

## Configurações essenciais

Você acessa as regras de item faltante no menu **Configurações** > **Regras de Item Faltante.**

Configure as opções abaixo para ativar a funcionalidade de item faltante no autoatendimento:

* **Permitir item faltante:** escolha se deseja permitir solicitações de item faltante
* **Prazo para Item Faltante:** defina em quantos dias, a partir da data de entrega, o cliente poderá informar que não recebeu um item
* **Título da opção no autoatendimento:** o nome que aparecerá para o seu cliente na Central do Cliente
* **Sufixo do botão no autoatendimento:** a palavra que complementa o botão de confirmação
* **Descrição no autoatendimento:** o texto explicativo exibido ao cliente durante a solicitação

<figure><img src="/files/UhnXDH6VJMcfuzELe5FI" alt=""><figcaption><p>Configuração das regras de item faltante</p></figcaption></figure>

O **título da opção, o sufixo do botão e a descrição** aparecem no autoatendimento, na tela onde seu cliente vai informar que não recebeu o item, nesta área:

<figure><img src="/files/Fs7Vz5jxhn6r8QSGSXC3" alt=""><figcaption><p>Exibição do item faltante na Central do Cliente</p></figcaption></figure>

## Como aparece no autoatendimento para o cliente

Para que o cliente consiga informar um item faltante, é necessário ter uma pergunta obrigatória com a resposta **Não recebi este item** ou alguma descrição nesse sentido. Sem ela, o motivo não aparece no autoatendimento. [Veja como configurar as perguntas obrigatórias.](https://docs.troqueedevolva.com.br/configuracoes/perguntas-obrigatorias)

Com a pergunta cadastrada, o cliente seleciona o motivo assim:

<figure><img src="/files/k9Mrq04lsKQAAxAsE07j" alt=""><figcaption><p><strong>Seleção do motivo de item faltante no autoatendimento</strong></p></figcaption></figure>

## Como verificar qual forma de pagamento o cliente escolheu

Dentro da solicitação, é **importante observar sempre a forma de pagamento**. Ela reflete qual foi a escolha do cliente, se ele solicitou **receber o produto**, **receber um vale-trocas** ou **reembolso:**

<figure><img src="/files/EdSi8nkKRUyZ0WpKyiNS" alt=""><figcaption><p>Forma de pagamento escolhida pelo cliente na solicitação</p></figcaption></figure>

Já nos detalhes do item, você pode confirmar o motivo:

<figure><img src="/files/u9P7Hq1nhTNRUoM4Ka1O" alt="" width="287"><figcaption><p>Motivo exibido nos detalhes do item</p></figcaption></figure>


# Incentivo para Trocas

Quer aumentar sua lucratividade e manter o dinheiro em caixa? Incentive a troca em vez da devolução.

Cada devolução representa a perda total da venda e de todo o investimento feito para realizá-la: anúncios, SEO, UX, plataforma, taxas, ERP, estoque, embalagem, frete e muito mais. Ao estimular a troca, você mantém o valor dentro da sua empresa e reduz prejuízos.

### Como aparece para o cliente

Será exibido apenas quando o cliente informar que quer devolver um produto e selecionar a opção de "reembolso".

Primeiro, mostramos ao cliente uma espera de 2.2s como se estivéssemos buscando **um presente:**

<figure><img src="/files/cPoCSeSsP7LZgSsSEtXC" alt="" width="563"><figcaption><p>Tela de espera exibida antes do incentivo</p></figcaption></figure>

**Depois,** o incentivo é mostrado assim:

<figure><img src="/files/MkpoOqPjDNimXjqKi9zr" alt="" width="563"><figcaption><p>Popup de incentivo exibido ao cliente</p></figcaption></figure>

O cliente precisará confirmar se quer manter o reembolso ou optar por um "vale-trocas" incentivado. Mostramos o valor total já com o percentual somado e uma mensagem de incentivo.

Os textos exibidos nesse popup, como o título, os cards de reembolso e crédito e o texto do botão, são personalizados em **Configurações > Central do Cliente**. [Veja como configurar.](https://docs.troqueedevolva.com.br/configuracoes/central-do-cliente)

Existe ciência por trás desses elementos. Se quiser saber mais, confira nosso artigo no blog: \
[Como a economia comportamental transforma reembolsos em fidelização](https://www.troqueedevolva.com.br/blog/como-a-economia-comportamental-transforma-reembolsos-em-fidelizacao).

### Configurando um incentivo

No Painel Troque & Devolva, acesse **Configurações** > **Incentivo para Trocas**.

Primeiro, você deve ativar o oferecimento de incentivo.&#x20;

Em seguida, determine o **percentual extra sobre o valor de produtos** que deseja oferecer.

> Por exemplo, se os produtos a serem devolvidos somam R$ 150,00, você pode oferecer 10% de incentivo, resultando em um vale-trocas de R$ 165,00 para o cliente, caso ele aceite o incentivo.

Além disso, você pode preencher o campo **Limitar incentivo ao máximo de R$** para definir um teto. Se não quiser limite, deixe o campo em branco.

> Se o pedido devolvido é de R$ 1.000,00, 10% seriam R$ 100,00, mas você pode achar esse valor muito alto. Nesse caso, é possível limitar o incentivo a um valor fixo, como R$ 50,00. Assim, mesmo que o percentual de incentivo ultrapasse R$ 50,00, o valor oferecido será limitado a esse teto.

Por fim, escolha em quais momentos o incentivo será oferecido:

* **Oferecer no momento da solicitação:** o popup aparece para o cliente assim que ele seleciona o reembolso no autoatendimento
* **Oferecer por e-mail após a solicitação:** o incentivo é enviado por e-mail depois que a solicitação já foi criada, dando ao cliente uma segunda chance de trocar o reembolso por vale-trocas

<figure><img src="/files/PWJTjNwouIitpbtKnvlx" alt=""><figcaption><p>Configuração do incentivo para trocas</p></figcaption></figure>

### Por que o valor exibido no reembolso não inclui o frete?

O objetivo do incentivo para trocas é garantir que a venda seja mantida. Se somarmos o valor do frete ao total, o reembolso poderia ficar maior do que o crédito oferecido com o vale-troca incentivado.

{% hint style="info" %}
Por exemplo, em um pedido de R$ 87 em produtos com frete de R$ 18, um vale-troca com 10% de incentivo resultaria em um crédito de R$ 95,70. No entanto, se somássemos o frete ao reembolso, o valor total seria de R$ 105, o que faria o estorno parecer mais vantajoso, desestimulando o cliente a optar pela troca.
{% endhint %}

Essa abordagem não é visualmente interessante, pois o cliente tenderia a preferir o estorno total em vez do vale-troca.

### Solicitação com incentivo aceito

Se o cliente aceitar o incentivo, essa informação será exibida dentro da solicitação no painel Troque & Devolva:

<figure><img src="/files/bVWh3wD8BtqNa8UpmwKt" alt=""><figcaption><p><strong>Solicitação com incentivo aceito</strong></p></figcaption></figure>

### Pagamento de uma solicitação com incentivo para troca

No momento do encerramento da solicitação, mostraremos a informação dos valores já com o incentivo:

<figure><img src="/files/RUypn3CXQD9d2GjZxOyQ" alt=""><figcaption><p>Valores com incentivo no encerramento da solicitação</p></figcaption></figure>


# Perguntas obrigatórias

Questões para coletar feedback dos motivos das trocas e devoluções

Por motivos gerenciais, é indispensável coletar informações sobre as logísticas reversas solicitadas em seu e-commerce. Com isso, você poderá melhorar seus processos e entender quais são os produtos que apresentam mais solicitações.

### Como escrever boas perguntas e respostas

A forma como você escreve as respostas determina o que o cliente consegue fazer em seguida. Duas regras resolvem a maior parte das dúvidas.

#### A resposta indica uma ação, não um estado

Pense na sua loja física: o que a vendedora perguntaria ao cliente? E o que ela precisa saber para resolver o atendimento?

O cliente não precisa descrever o problema, precisa dizer o que quer que aconteça.

| Evite             | Prefira                               |
| ----------------- | ------------------------------------- |
| Ficou pequeno     | Quero um tamanho maior                |
| Ficou grande      | Quero um tamanho menor                |
| Não gostei da cor | Quero outra cor                       |
| Veio com defeito  | Apresentou defeito, quero outro igual |

Respostas como "ficou pequeno" descrevem uma situação, mas não dizem o que o cliente espera. Já "quero um tamanho maior" indica a ação, e é isso que orienta a próxima etapa da solicitação.

#### Cada resposta leva a um caminho só

A escolha de variação e a escolha da forma de pagamento acontecem em etapas diferentes e não podem estar na mesma resposta.

* Se a resposta permite **envio do produto** e o item tem variações cadastradas, o cliente escolhe a cor ou o tamanho ali mesmo, e a etapa de crédito é pulada
* Se a resposta permite **crédito na loja** ou **reembolso**, o cliente segue para a etapa de crédito e escolhe entre as opções que você liberou

Quando o mesmo motivo pode terminar de duas formas, você tem duas saídas:

1. **Criar duas respostas separadas**, cada uma com o seu caminho:
   * Apresentou defeito, quero outro igual
   * Apresentou defeito, quero reembolso
2. **Usar perguntas condicionais**: a primeira pergunta identifica o motivo e a segunda, exibida conforme a resposta, define o que o cliente deseja receber

### Formas de pagamento

Você deve definir quais formas de pagamento o cliente poderá escolher, a depender das respostas das perguntas que você cadastrar.&#x20;

#### **Crédito na loja**

O cliente receberá um cupom para realizar uma nova compra.

#### **Envio do produto**

Você vai reenviar o produto para o cliente diretamente.

#### **Reembolso**

Você fará o estorno do pagamento.

#### Solicitar escolha de variação do produto

Para as plataformas com integração, o cliente já informa qual nova variação deseja (tamanho, cor, etc) no ato da solicitação.&#x20;

A apresentação verifica a existência de estoque no momento da solicitação da troca, evitando que o cliente solicite um produto que não está disponível.

Para o cliente, na [Central do Cliente](/configuracoes/central-do-cliente), aparecerá assim:

<figure><img src="/files/wtXweebXKGHemqslINA2" alt="" width="563"><figcaption><p>Escolha da variação na Central do Cliente</p></figcaption></figure>

{% hint style="warning" %}
A escolha de variação não está disponível na Fastcommerce, que não retorna esses dados na integração.
{% endhint %}

### Onde aparecem as formas de pagamento

Aparecem na Central do Cliente, na etapa de **Crédito**. É depois que o cliente seleciona os itens e responde as perguntas que você determinar.&#x20;

As formas de pagamento exibidas dependem de como você selecionou as opções que explicamos anteriormente:

<figure><img src="/files/3NjZ6NBJXFE5fAwpyC4Y" alt="" width="563"><figcaption><p>Formas de pagamento exibidas na etapa de Crédito</p></figcaption></figure>

Se o cliente selecionou uma nova variação (cor, tamanho), nós pulamos a etapa de crédito, já que você fará o envio do item:

<figure><img src="/files/zPPJ68zBs2km8L6N3UJv" alt="" width="563"><figcaption><p>Etapa de crédito pulada quando o cliente escolhe a variação</p></figcaption></figure>

### Incentivos para troca

Nossa Central do Cliente é preparada para induzir os clientes de forma visual **a aceitarem** trocar em vez de reembolso. Isso mantém o dinheiro no seu caixa.&#x20;

Para isso, quando o cliente selecionar **Reembolso**, primeiro mostramos um popup tentando convencê-lo **a optar** por trocar:

<figure><img src="/files/Z1XLEsjfwlOXui50Vykn" alt="" width="563"><figcaption><p><strong>Popup de incentivo exibido ao selecionar reembolso</strong></p></figcaption></figure>

Se você quiser tentar uma alternativa ainda mais agressiva de convencimento, poderá oferecer crédito extra para quem desistir do reembolso. Para isso, configure o [**Incentivo para Trocas**](/configuracoes/incentivo-para-trocas)**.**

## Tipos de pergunta

### Perguntas de resposta livre

São questões livres em que o cliente deverá escrever um texto para responder a questão.  Um campo de texto é exibido ao consumidor, dessa maneira:

<figure><img src="/files/5KwzzcIxTkkx9q5AQ3kW" alt="" width="563"><figcaption><p>Cadastro de uma pergunta de resposta livre</p></figcaption></figure>

<figure><img src="/files/q8OLIrugthPsmnHoGExv" alt="" width="563"><figcaption><p>Campo de texto exibido ao cliente</p></figcaption></figure>

### Perguntas com respostas pré-definidas e anexos

{% hint style="info" %}
Somente respostas de escolhas pré-definidas permitem realizar [automação](/configuracoes/automacoes).&#x20;
{% endhint %}

Você pré-define quais opções o cliente poderá responder. Ele terá que escolher uma entre as opções cadastradas.&#x20;

**Para cada opção, você pode exigir que o cliente anexe fotos ou documentos**. Para isso, basta marcar a opção "anexo" e incluir as instruções detalhadas sobre o que deve ser enviado (fotos, documentos, nota fiscal, etc):

<figure><img src="/files/ePJ34Wvujjd1s821sd0u" alt="" width="563"><figcaption><p>Cadastro de respostas pré-definidas com exigência de anexo</p></figcaption></figure>

#### Perguntas condicionais

Você pode determinar quando uma pergunta será exibida, de acordo com a resposta anterior. Isso é útil para quando você deseja criar uma sequência de respostas:

<figure><img src="/files/qtxmeL7ayIsctY9qFBN4" alt="" width="563"><figcaption><p>Cadastro de uma pergunta condicional</p></figcaption></figure>

## Exibição das perguntas no site Troque & Devolva

As perguntas serão exibidas para cada um dos produtos que o cliente selecionar:

<figure><img src="/files/bYNpzUbaGw30LI9cl3TU" alt="" width="563"><figcaption><p>Perguntas exibidas para cada produto selecionado</p></figcaption></figure>

## Exibição dos anexos enviados pelo cliente, no detalhe da solicitação

Ao acessar uma solicitação que exigiu anexo, você poderá observar os arquivos enviados **junto com a resposta, no produto:**

<figure><img src="/files/otpbhMxEtdxNZxtkvXTJ" alt="" width="333"><figcaption><p>Anexos enviados pelo cliente no detalhe do produto</p></figcaption></figure>

Você pode visualizar **fotos e vídeos** em tela:

<figure><img src="/files/JGO7BdkVPuQp2U4fJ4Eb" alt=""><figcaption><p>Visualização de fotos e vídeos em tela</p></figcaption></figure>

Demais tipos de arquivo você pode baixar clicando sobre eles.


# E-mails automáticos

Templates dos e-mails transacionais enviados aos seus clientes.

### E-mail usado como remetente

Por padrão, os e-mails transacionais são enviados de nosso remetente **<atendimento@troqueedevolva.com.br>.**

{% hint style="info" %}
**Você pode usar seu próprio e-mail como remetente.** A configuração é feita diretamente no painel, em Configurações > Remetente de E-mail.\
\
Aprenda como: [Remetente de e-mail](https://docs.troqueedevolva.com.br/configuracoes/remetente-de-e-mail)
{% endhint %}

### E-mails permitidos

Você pode personalizar os e-mails de:

* **Nova solicitação**: quando o cliente fez a solicitação.
* **Solicitação negada**: pedido improcedente.
* **Solicitação autorizada**: pedido procedente e autorização de postagem emitida para que o cliente compareça até a agência.
* **Solicitação autorizada sem envio**: quando a devolução dos itens não é necessária.
* **Solicitação autorizada com devolução pessoal**: quando o cliente precisa levar os itens até o centro de retorno indicado na autorização.
* **Solicitação autorizada com coleta**: pedido procedente e autorização de coleta emitida, para que a transportadora compareça ao endereço do cliente buscar o pacote.
* **Solicitação autorizada com etiqueta impressa**: quando a etiqueta é enviada ao cliente para que ele imprima, cole no pacote e faça a postagem.
* **Autorização com envio por conta do cliente**: pedido procedente em que o custo do frete de retorno fica com o consumidor, que recebe o endereço de destino e posta por onde preferir.
* **Etiqueta pronta para o cliente**: quando a etiqueta é emitida em uma segunda tentativa, após a autorização. Acontece, por exemplo, quando a emissão inicial falha por falta de saldo e o sistema segue tentando até conseguir.
* **Confirmação de postagem**: o cliente fez a postagem ou a transportadora realizou a coleta.
* **Confirmação de recebimento**: a devolução foi entregue no centro de retorno.
* **Perguntar dados bancários**: para que o cliente acesse a página da solicitação e informe os dados para o reembolso.
* **Perguntar ao cliente**: para perguntar algo ao cliente, com a opção de exigir anexos (fotos, documentos, etc).
* **Novo comentário na solicitação**: quando um comentário é adicionado à solicitação.
* **Reembolso por PIX realizado**: quando o reembolso por PIX já foi efetivado.
* **Reembolso por Vale-Trocas realizado**: quando o vale-trocas já foi emitido no e-commerce.
* **Reembolso por forma de pagamento personalizada**: quando o reembolso é feito por uma forma de pagamento cadastrada por você.
* **Troca por produto realizada**: quando for uma troca direta e o novo produto já tiver sido despachado.
* **Encerramento agendado**: quando a solicitação está pronta para ser paga, mas será concluída em uma data futura.
* **Transportadora - E-mail de solicitação**: enviado para o e-mail cadastrado na transportadora, solicitando a coleta.

### Formulário de edição

A personalização pode ser completa, **que deve ser feita pelo programador da sua loja.**

É possível editar o **titulo do e-mail** e o **conteúdo**, utilizando texto simples ou formatação HTML e EJS. Você pode usar *emoji* livremente.

O campo **Template ativo** define se aquele e-mail será disparado. Ao selecionar **Não**, o template deixa de ser enviado, sem perder a personalização já feita.

Ao editar um novo e-mail, já aparecerá o modelo pronto e configurado:

<figure><img src="/files/4rCNBTTFfstH2nwYnRcT" alt=""><figcaption><p>Formulário de edição de um template de e-mail</p></figcaption></figure>

Observe que temos uma caixa de texto, local onde seu desenvolvedor irá colar o HTML.&#x20;

**Depois, mostramos um simulador de como o e-mail ficará com dados fictícios.**&#x20;

Após terminar a edição, clique em **salvar**. O template passará a ser disparado de acordo com as configurações visuais que você editou.

### E-mails para cópia oculta (BCC)

Você pode enviar uma cópia oculta de cada e-mail transacional para endereços internos da sua operação. É útil quando um setor precisa acompanhar as comunicações enviadas aos clientes sem depender do painel, como logística, financeiro ou atendimento.

No campo **E-mails para cópia oculta (BCC)**, informe os endereços separados por vírgula:

<logistica@sualoja.com.br>, <financeiro@sualoja.com.br>

<figure><img src="/files/XTtnEcfNYekLKCcshs8v" alt=""><figcaption><p>Campo de e-mails para cópia oculta</p></figcaption></figure>

A configuração é feita por template, então cada e-mail transacional pode ter destinatários diferentes. O e-mail de solicitação autorizada pode ir para a logística, enquanto o de reembolso vai para o financeiro.

{% hint style="info" %}
A cópia é oculta: o cliente não vê os endereços internos que receberam a mensagem.
{% endhint %}

### Entendendo o código de personalização

Por padrão, utilizamos [EJS](https://ejs.co/) como linguagem de marcação para os templates. Isso permite que seu **desenvolvedor** possa *programar* dentro dos e-mails.&#x20;

Além de personalizar a parte visual, é possível criar programação em *javascript* e utilizar qualquer dado do *json* de solicitações dentro do conteúdo do e-mail.

Como pode parecer um pouco complicado para usuários comuns, recomendamos que seu desenvolvedor realize os ajustes necessários.&#x20;

#### Exemplo de *json* da solicitação

```json
{
    "_id": "6679a3721de31a0011825094",
    "order": {
        "buyer": {
            "document": {
                "number": "00000000000",
                "type": "cpf"
            },
            "address": {
                "country": "brasil",
                "address": "Rua Do Endereço",
                "number": "88",
                "address2": "apto 101",
                "postal_code": 81250280,
                "neighborhood": "CIC",
                "city": "Curitiba",
                "state": "PR"
            },
            "id": "38011876",
            "name": "Cliente de Teste",
            "email": "email@docliente.com.br",
            "mobile": "41999999999"
        },
        "shippment": {
            "destination": {
                 "country": "brasil",
                "address": "Rua Do Endereço",
                "number": "88",
                "address2": "apto 101",
                "postal_code": 81250280,
                "neighborhood": "CIC",
                "city": "Curitiba",
                "state": "PR"
            },
            "last_delivered": true,
            "last_delivered_at": "2021-07-22",
            "packages": [
                {
                    "delivered": false,
                    "_id": "6679a3721de31a0011825096",
                    "carrier": "pac - Frete Grátis",
                    "tracking_number": "QF651787795BR",
                    "tracking_url": "",
                    "cost": 0,
                    "shipped_at": "2021-07-15T11:05:40.000Z",
                    "delivered_at": "2021-07-22"
                }
            ]
        },
        "created_at": "2021-06-22T22:41:46.000Z",
        "order_id": "654654333",
        "order_number": "654654333",
        "payment": [
            {
                "_id": "6679a3721de31a0011825095",
                "amount": 355.96,
                "detail": "Parcelas: 4"
            }
        ],
        "cart": [
            {
                "_id": "6679a3721de31a0011825097",
                "sku": "SKU1",
                "image": "https://troqueedevolva.com.br/test-store/sandalia.webp",
                "link": "link",
                "name": "Sandália de salto Anabela 36",
                "quantity": 1,
                "price": 199.9
            },
            {
                "_id": "6679a3721de31a0011825098",
                "sku": "SKU2",
                "image": "https://troqueedevolva.com.br/test-store/vestido.webp",
                "link": "link",
                "name": "Vestido com cinto elegante",
                "quantity": 1,
                "price": 129
            },
            {
                "_id": "6679a3721de31a0011825099",
                "sku": "SKU3",
                "image": "https://troqueedevolva.com.br/test-store/blazer.webp",
                "link": "link",
                "name": "Blazer longo alfaiataria bege",
                "quantity": 1,
                "price": 219
            }
        ]
    },
    "request": {
        "items": [
            {
                "pictures": [],
                "_id": "6679a3721de31a001182509a",
                "sku": "SKU1",
                "image": "https://troqueedevolva.com.br/test-store/sandalia.webp",
                "link": "link",
                "name": "Sandália de salto Anabela 36",
                "quantity": 1,
                "price": 199.9,
                "questions": [
                    {
                        "options": [],
                        "_id": "661180a35c83aa0011378701",
                        "required": true,
                        "area": "refund",
                        "question": "Qual o motivo da devolução?",
                        "value": "Não serviu"
                    }
                ],
                "type": "refund"
            }
        ]
    },
    "process": {
        "status": 0,
        "status_history": [
            {
                "_id": "6679a5cf1de31a00118489c7",
                "to": 0,
                "user": "customer",
                "from": 0,
                "message": "solicitação criada",
                "updated_at": "2024-06-24T16:58:55.860Z"
            }
        ],
        "shippment_authorization": []
    },
   
    "createdAt": "2024-06-24T16:48:50.483Z",
    "updatedAt": "2024-06-27T13:23:20.696Z",
  }
```


# Remetente de e-mail

Use o seu próprio domínio e e-mail como remetente dos e-mails de trocas e devoluções.

### O que é

Por padrão, os e-mails de trocas e devoluções são enviados pelo remetente padrão da Troque e Devolva. Ao configurar o remetente próprio, esses e-mails passam a sair do e-mail da sua loja, com o nome da sua marca na caixa de entrada do consumidor.

Além da identidade visual, isso melhora a entrega das mensagens e reduz a chance de os e-mails caírem em spam, porque o domínio passa a ser autenticado.

A configuração é opcional. Enquanto ela não for concluída, ou enquanto o domínio não estiver verificado, os e-mails continuam sendo disparados normalmente pelo remetente padrão.

{% hint style="warning" %}
**Requer conhecimento técnico (DNS).** Para ativar, é preciso adicionar registros no painel do seu provedor de domínio. Se você não tem acesso ou não sabe editar o DNS, encaminhe esta etapa ao responsável técnico ou de TI do seu domínio antes de continuar.
{% endhint %}

### Antes de começar

Você vai precisar de:

* **Acesso ao painel DNS do domínio**, no provedor onde ele foi registrado (Registro.br, Cloudflare, GoDaddy, entre outros)
* **Um e-mail real e monitorado**, pertencente ao domínio informado. As respostas dos consumidores aos e-mails de troca e devolução chegam nesse endereço

### Passo 1: informe o domínio e o e-mail

Acesse **Configurações > Remetente de E-mail** e preencha:

* **Domínio:** apenas o domínio, sem `http://` e sem `www`
* **E-mail do remetente:** precisa pertencer ao domínio informado no campo acima
* **Nome do remetente** (opcional): nome exibido para o consumidor na caixa de entrada

Depois, clique em **Configurar domínio**.

<figure><img src="/files/aeTR9G1ZiKUgLnQaDMWf" alt="" width="533"><figcaption><p>Preenchimento do domínio, e-mail e nome do remetente</p></figcaption></figure>

O sistema cria o domínio na Amazon Web Services em segundo plano, gera os registros DNS necessários e exibe todos eles na tela.

### Passo 2: cadastre os registros DNS

São **três registros do tipo CNAME**. Cadastre os três no painel DNS do seu provedor, exatamente como aparecem na tela, usando os botões **copiar** de cada campo para evitar erros de digitação.

O campo **Nome** é relativo ao seu domínio. A maioria dos provedores completa o restante automaticamente, então não acrescente o domínio manualmente ao final.

<figure><img src="/files/LQbjF2JySfmKgyHZDZL8" alt="" width="563"><figcaption><p>Os três registros CNAME que devem ser cadastrados no provedor de domínio</p></figcaption></figure>

{% hint style="info" %}
Se quem cuida do domínio é outra pessoa, envie esta tela ao seu programador ou responsável técnico. Os três registros devem ser cadastrados sem nenhuma alteração nos valores.
{% endhint %}

### Passo 3: aguarde a verificação

Enquanto os registros não são reconhecidos, o status permanece como **Aguardando verificação** e cada registro aparece como **Pendente**.

A propagação do DNS pode levar de alguns minutos até 72 horas. O sistema verifica automaticamente, mas você também pode clicar em **Verificar agora** para checar na hora.

Assim que os três registros forem verificados, o sistema passa a usar o e-mail configurado como remetente automaticamente. Nenhuma ação adicional é necessária.

### Removendo o domínio

Para voltar a usar o remetente padrão da Troque e Devolva, clique em **Remover domínio**. Os disparos seguem normalmente, apenas com o remetente padrão.

### Erros comuns

* **Domínio informado com `www` ou `https://`**: preencha apenas o domínio, como `sualoja.com.br`
* **E-mail de outro domínio**: um e-mail Gmail, Hotmail ou de qualquer domínio diferente do informado não é aceito
* **Domínio duplicado no registro**: se o provedor completa o domínio automaticamente e ele também for digitado, o registro fica inválido. Confira como o nome ficou salvo no painel do provedor antes de solicitar a verificação
* **E-mail que ninguém acompanha**: as respostas dos consumidores chegam nesse endereço, então use um e-mail monitorado pela equipe


# WhatsApp Automático

Envie o andamento das solicitações no Whats dos clientes.

As mensagens no WhatsApp são enviadas para os consumidores sempre que alguma ação é realizada na plataforma, **quando ele realiza uma solicitação**, quando ela é **autorizada** ou **negada**, etc.

## Configurando a integração com o WhatsApp

{% hint style="warning" %}
**Serviço com custo extra:** O serviço é cobrado à parte: R$ 19,90 por mês, utilizando seu número próprio do WhatsApp e sem limite de mensagens.
{% endhint %}

{% hint style="info" %}
**A integração funciona com o WhatsApp convencional e com o WhatsApp Business,** instalados no celular.\
\
Não funciona com a  API Oficial da Meta. Caso você queira utilizar a API Oficial da Meta, deverá contratar um fornecedor oficial e realizar a integração via Webhook.
{% endhint %}

### Conectando o seu WhatsApp

1. Acesse Configurações > Integração WhatsApp.
2. Mude a opção **Ativo = Sim.**
3. **Escolha entre dividir ou não as mensagens**.. Se ativado, o sistema irá quebrar cada parágrafo em uma mensagem. Caso contrário, enviará todo o template em uma mensagem só.
4. **Informe o número do WhatsApp** que você irá utilizar, com o DDD. Ex: 41984008718

<figure><img src="/files/ZZNaoi4UJwgzMlCTyakL" alt="" width="563"><figcaption><p>Tela de cadastro de WhatsApp</p></figcaption></figure>

5. Ao salvar, iniciaremos a configuração da sua conta. Se o QrCode não aparecer automaticamente, clique em "Conectar WhatsApp":

<figure><img src="/files/rmL9G9da53rgw6G9Qut7" alt="" width="563"><figcaption><p>Botão de conexão com o WhatsApp.</p></figcaption></figure>

6. No celular que possui o WhatsApp instalado, clique em Configurações > Dispositivos Conectados e escaneie o QrCode na tela:

<figure><img src="/files/TOFeTWCQupmGHaFNvIax" alt="" width="563"><figcaption><p>QrCode Whatsapp</p></figcaption></figure>

7. Após a leitura do QrCode, seu WhatsApp estará conectado na conta Troque e Devolva, para envio de mensagens automáticas.

### Configurando os templates de WhatsApp a serem disparados

Para ativar ou desativar templates, acesse **Configurações > Templates WhatsApp.**

## Templates permitidos

Você pode personalizar as mensagens de:

* **Nova solicitação**: quando o cliente fez a solicitação.
* **Solicitação negada**: pedido improcedente.
* **Solicitação autorizada**: pedido procedente e autorização de postagem emitida para que o cliente compareça até a agência.
* **Solicitação autorizada sem envio**: quando a devolução dos itens não é necessária.
* **Solicitação autorizada com devolução pessoal**: quando o cliente precisa levar os itens até o centro de retorno indicado na autorização.
* **Solicitação autorizada com coleta**: pedido procedente e autorização de coleta emitida, para que a transportadora compareça ao endereço do cliente buscar o pacote.
* **Confirmação de postagem**: o cliente fez a postagem ou a transportadora realizou a coleta.
* **Confirmação de recebimento**: a devolução foi entregue no centro de retorno.
* **Perguntar dados bancários**: para que o cliente acesse a página da solicitação e informe os dados para o reembolso.
* **Perguntar ao cliente**: para perguntar algo ao cliente, com a opção de exigir anexos (fotos, documentos, etc).
* **Reembolso por PIX realizado**: quando o reembolso por PIX já foi efetivado.
* **Reembolso por cartão de crédito realizado**: quando o estorno no cartão já foi efetivado.
* **Reembolso por vale-trocas realizado**: quando o vale-trocas já foi emitido no e-commerce.
* **Reembolso por forma de pagamento personalizada**: quando o reembolso é feito por uma forma de pagamento cadastrada por você.
* **Troca por produto realizada**: quando for uma troca direta e o novo produto já tiver sido despachado.
* **Encerramento agendado**: quando a solicitação está pronta para ser paga, mas será concluída em uma data futura.

## Editando os templates das mensagens (código)

Nós já definimos modelos padrão para todas as mensagens, mas você poderá editá-las como quiser.&#x20;

Ao editar um novo template WhatsApp, já aparecerá o modelo pronto e configurado.&#x20;

#### Quando a divisão de mensagens estiver ativa:

O sistema irá mostrar já com as mensagens separadas, exatamente como o cliente receberá no WhatsApp. Cada parágrafo é enviado como uma mensagem individual.

<figure><img src="/files/3xVehGgfG3O32iO0fjdk" alt=""><figcaption><p>Mensagem enviada com múltiplas mensagens</p></figcaption></figure>

#### Quando a divisão de mensagens estiver desabilitada:

Todo o conteúdo é enviado como uma mensagem única.

<figure><img src="/files/YYYUHnqACtHvn5TnE2rd" alt=""><figcaption><p>Mensagem enviada como texto único</p></figcaption></figure>

#### Editando o template (programação EJS)

Na esquerda, você verá o código fonte e, na direita, como o cliente receberá as mensagens. **Note que cada parágrafo é enviado como uma mensagem**, deixando o envio mais natural.

A pré-visualização atualiza automaticamente, sempre que você muda algo no código fonte. Isso te permite ver exatamente como o cliente receberá a mensagem, ao mesmo tempo que ajusta e edita.

Após terminar a edição, clique em **salvar**. O template passará a ser disparado de acordo com as configurações visuais que você editou.

### Formatando as mensagens

O WhatsApp permite uma formatação limitada das mensagens:

> * Para deixar o texto em negrito, coloque um asterisco antes e depois da palavra
> * Para deixar o texto em itálico, coloque um underline antes e depois da palavra
> * Para tachado, coloque um til antes e depois da palavra

Para que um texto fique em **negrito**, você deve \*deixar o texto entre asteriscos\*, dessa maneira mesmo. O WhatsApp então entende que o texto em negrito será: **deixar o texto entre asteriscos**

Para saber todas as possibilidades de formatação, visite o [Guia Oficial da WhatsApp](https://faq.whatsapp.com/539178204879377/?cms_platform=web\&helpref=platform_switcher\&locale=pt_PT).

### Entendendo o código de personalização programática

Por padrão, utilizamos [EJS](https://ejs.co/) como linguagem de marcação para os templates. Isso permite que seu **desenvolvedor** possa *programar* dentro dos templates de WhatsApp.

Além de personalizar a parte visual, é possível criar programação em *javascript* e utilizar qualquer dado do *json* de solicitações dentro do conteúdo do e-mail.

Como pode parecer um pouco complicado para usuários comuns, recomendamos que seu desenvolvedor realize os ajustes necessários.&#x20;

#### Exemplo de *json* da solicitação

```json
{
    "_id": "6679a3721de31a0011825094",
    "order": {
        "buyer": {
            "document": {
                "number": "00000000000",
                "type": "cpf"
            },
            "address": {
                "country": "brasil",
                "address": "Rua Do Endereço",
                "number": "88",
                "address2": "apto 101",
                "postal_code": 81250280,
                "neighborhood": "CIC",
                "city": "Curitiba",
                "state": "PR"
            },
            "id": "38011876",
            "name": "Cliente de Teste",
            "email": "email@docliente.com.br",
            "mobile": "41999999999"
        },
        "shippment": {
            "destination": {
                 "country": "brasil",
                "address": "Rua Do Endereço",
                "number": "88",
                "address2": "apto 101",
                "postal_code": 81250280,
                "neighborhood": "CIC",
                "city": "Curitiba",
                "state": "PR"
            },
            "last_delivered": true,
            "last_delivered_at": "2021-07-22",
            "packages": [
                {
                    "delivered": false,
                    "_id": "6679a3721de31a0011825096",
                    "carrier": "pac - Frete Grátis",
                    "tracking_number": "QF651787795BR",
                    "tracking_url": "",
                    "cost": 0,
                    "shipped_at": "2021-07-15T11:05:40.000Z",
                    "delivered_at": "2021-07-22"
                }
            ]
        },
        "created_at": "2021-06-22T22:41:46.000Z",
        "order_id": "654654333",
        "order_number": "654654333",
        "payment": [
            {
                "_id": "6679a3721de31a0011825095",
                "amount": 355.96,
                "detail": "Parcelas: 4"
            }
        ],
        "cart": [
            {
                "_id": "6679a3721de31a0011825097",
                "sku": "SKU1",
                "image": "https://troqueedevolva.com.br/test-store/sandalia.webp",
                "link": "link",
                "name": "Sandália de salto Anabela 36",
                "quantity": 1,
                "price": 199.9
            },
            {
                "_id": "6679a3721de31a0011825098",
                "sku": "SKU2",
                "image": "https://troqueedevolva.com.br/test-store/vestido.webp",
                "link": "link",
                "name": "Vestido com cinto elegante",
                "quantity": 1,
                "price": 129
            },
            {
                "_id": "6679a3721de31a0011825099",
                "sku": "SKU3",
                "image": "https://troqueedevolva.com.br/test-store/blazer.webp",
                "link": "link",
                "name": "Blazer longo alfaiataria bege",
                "quantity": 1,
                "price": 219
            }
        ]
    },
    "request": {
        "items": [
            {
                "pictures": [],
                "_id": "6679a3721de31a001182509a",
                "sku": "SKU1",
                "image": "https://troqueedevolva.com.br/test-store/sandalia.webp",
                "link": "link",
                "name": "Sandália de salto Anabela 36",
                "quantity": 1,
                "price": 199.9,
                "questions": [
                    {
                        "options": [],
                        "_id": "661180a35c83aa0011378701",
                        "required": true,
                        "area": "refund",
                        "question": "Qual o motivo da devolução?",
                        "value": "Não serviu"
                    }
                ],
                "type": "refund"
            }
        ]
    },
    "process": {
        "status": 0,
        "status_history": [
            {
                "_id": "6679a5cf1de31a00118489c7",
                "to": 0,
                "user": "customer",
                "from": 0,
                "message": "solicitação criada",
                "updated_at": "2024-06-24T16:58:55.860Z"
            }
        ],
        "shippment_authorization": []
    },
   
    "createdAt": "2024-06-24T16:48:50.483Z",
    "updatedAt": "2024-06-27T13:23:20.696Z",
  }
```

## Verificando as mensagens enviadas para o cliente

Você poderá acompanhar as mensagens enviadas pelo histórico da solicitação. Ao acessar os detalhes de uma troca ou devolução, mostraremos todas as mensagens enviadas no WhatsApp do cliente em ordem cronológica:

<figure><img src="/files/2G337RFl5hKDLzHSogBN" alt=""><figcaption><p>Histórico de mensagens enviadas no WhatsApp</p></figcaption></figure>


# Respostas pré-definidas

Crie respostas prontas para agilizar o atendimento aos seus clientes.

Quando sua equipe for negar solicitações, deverá preencher o motivo.

<figure><img src="/files/kBRD7TElfscx05igEG11" alt="" width="262"><figcaption><p>Tela de negativa de solicitação</p></figcaption></figure>

### Cadastramento de respostas pré-definidas

Para facilitar o trabalho e evitar a necessidade de escrever manualmente o conteúdo que geralmente se repete em todas as situações, é possível pré-definir essas informações.

<figure><img src="/files/Gw0y8QbiTf6g0YLovO87" alt="" width="261"><figcaption><p>Tela de cadastramento de respostas pré-definidas</p></figcaption></figure>

Em **todas as telas** que precisem de uma resposta, você poderá selecionar entre as cadastradas ou preencher uma nova.


# Transportadoras

Configurando as transportadoras da sua logística reversa.

Para autorizar as solicitações de trocas ou devoluções, sua conta Troque e Devolva precisa ter transportadoras configuradas.

{% embed url="<https://www.youtube.com/watch?v=Yn103RO_4eU>" %}
Instruções em vídeo de como configurar sua transportadora
{% endembed %}

## Escolhendo o serviço de envio desejado

### 1. Utilizando Envie+ Troque e Devolva

Não possui contrato com os Correios? Sem problema. Com o **Envie+**, você pode utilizar o nosso contrato para emitir autorizações de postagem com praticidade e agilidade, com pagamentos pré-pagos.

**Para ativar o serviço, habilite-o no Painel Troque e Devolve na opção Envie+.**&#x20;

Antes de começar,[ **leia os termos e condições de uso**](https://docs.troqueedevolva.com.br/troque-e-devolva-envie/termos-e-condicoes-do-servico-envie+-troque-and-devolva) do nosso serviço de frete.

### 2. Configurando seu contrato próprio dos Correios

A maneira mais simples de permitir a logística reversa hoje, é através dos próprios Correios.

Seu cliente só precisa ir até uma agência com o código de autorização de postagem, sem necessidade de imprimir etiquetas, pois elas são geradas pelos Correios no momento da postagem.

O envio será feito utilizando o seu contrato com os Correios, e os custos serão cobrados normalmente na sua fatura.

👉 [Para habilitar essa opção, clique aqui e siga as instruções.](https://docs.troqueedevolva.com.br/configuracoes/transportadoras/integrando-correios)

### 3. Configurando uma transportadora personalizada

Se a transportadora desejada ainda não possui integração com a Troque & Devolva, você pode utilizá-la mesmo assim.\
Enviaremos automaticamente um e-mail para a transportadora solicitando a coleta e anexando a **Nota Fiscal de Devolução**.

👉 [Para saber mais e configurar essa opção, clique aqui.](https://docs.troqueedevolva.com.br/configuracoes/transportadoras/configurando-uma-transportadora-personalizada)

## Configurando uma transportadora no painel Troque e Devolva

Acesse as **Configurações > Transportadoras**. Ao clicar no botão **criar transportadora**, exibiremos o formulário de cadastramento.

Você vai informar o **nome da transportadora**, as **instruções de postagem** e selecionar qual a transportadora que deseja integrar, nformando os dados de credenciais que forem solicitados na tela.

<figure><img src="/files/gWqSBqFetKzkXwnVMmcp" alt="" width="270"><figcaption><p>Tela de cadastramento de transportadora</p></figcaption></figure>

O sistema irá validar os dados de credenciamento e, em caso de falha, alertará qual o dado incorreto diretamente na tela.

## Configure os valores padrão da transportadora

Você também deve definir quais as opções que devem estar pré-selecionadas. Cada transportadora possui suas próprias opções.&#x20;

Esses campos aparecerão logo abaixo das credenciais da transportadora:

<figure><img src="/files/3mdjfm5ErVwewdiIv5cc" alt=""><figcaption><p>Tela de configuração de valores pré-definidos</p></figcaption></figure>

Esses valores serão usados para a tela de [autorização manual](https://docs.troqueedevolva.com.br/atendendo-uma-solicitacao/autorizando-solicitacoes/autorizando-solicitacao-com-envio) e também na[ automação de autorização automática](https://docs.troqueedevolva.com.br/configuracoes/regras-de-troca#autorizacao-ou-negativa-automatica-de-troca).


# Integrando Correios

A Troque e Devolva emite a autorização de postagem integrada aos Correios.

A **logística reversa dos Correios** é uma solução prática para devolução de produtos.\
Com a autorização de postagem, o cliente não precisa imprimir etiquetas: basta levar o pacote a uma agência própria ou franqueada, informar o código e pronto. Medição, pesagem e impressão da etiqueta são feitas pelos Correios.

Como a autorização é emitida via contrato empresarial, não há custo na hora da postagem. O valor do frete é cobrado posteriormente, junto com os envios mensais do contrato.

### 1. Como o cliente recebe o código de autorização

Quando você emitir uma autorização, vamos disponibilizar o **Código de Rastreamento** ao seu cliente. Com ele, o cliente irá em uma das agências dos Correios e informará esse código no guichê.&#x20;

O código ficará disponível no histórico da solicitação:

<figure><img src="/files/l0USCYJhfaJqvhhAATQO" alt=""><figcaption><p>Código de rastreamento no histórico da solicitação</p></figcaption></figure>

Além disso, seu cliente receberá um e-mail dos Correios com a etiqueta de postagem para uso em **Lockers**. Nesse caso, será necessário imprimir e colar a etiqueta na embalagem antes da postagem.

<figure><img src="/files/0KOeTt2IpKPEqH66KnMX" alt=""><figcaption><p>E-mail dos Correios com a etiqueta para postagem em Locker</p></figcaption></figure>

### 2. Dados necessários

Existem **duas maneiras** de integrar os Correios na Troque & Devolva.

A primeira é fornecendo o **Código de Acesso às API's**, uma senha geral que dá acesso às API's de forma genérica. Como é uma senha única, talvez seja difícil você conseguir obtê-la. É o modo legado (antigo) de concessão de acesso.

E a segunda forma é através de **Chaves de Acesso**, senhas geradas exclusivamente para uso na Troque & Devolva, muito mais fáceis de configurar, mas **com a ressalva de que expiram em 180 dias**. A cada 6 meses você precisa gerar novas chaves e atualizar no nosso paine

#### 2.1 Dados básicos comuns:

| Dado                                | Descrição                           | Onde conseguir                                                                                           |
| ----------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Usuário de API**                  | Usuário do portal dos Correios      | [https://cws.correios.com.br/](https://cws.correios.com.br)                                              |
| **Código Administrativo**           | Número do seu código administrativo | [sfe.correios.com.br](https://sfe.correios.com.br) → Você pode consultar o passo a passo completo abaixo |
| **Cartão de Postagem**              | Número do cartão de postagem        | Fornecido pelos Correios                                                                                 |
| **Código do Serviço PAC Reverso**   | Geralmente: `03301`                 | Disponível na consulta do seu Cartão de Postagem                                                         |
| **Código do Serviço SEDEX Reverso** | Geralmente: `03247`                 | Disponível na consulta do seu Cartão de Postagem                                                         |

#### 2.2 Acesso ao site CWS – Gestão de APIs dos Correios

Acesse o site de gestão de APIs dos Correios por meio do seguinte link [**https://cws.correios.com.br**](https://cws.correios.com.br)

Insira seu **usuário** e **senha** cadastrados nos Correios:

<figure><img src="/files/0w39B9TNtj7kzQpH3TKJ" alt=""><figcaption><p><br>Tela de login dos Correios</p></figcaption></figure>

### 3. Gerando as credenciais de integração

#### 3.1 Integrando pela senha padrão - Código de acesso às API's

| Dado                                          | Descrição                     | Onde conseguir                                                                       |
| --------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------ |
| **Código de Acesso às API\`s (senha de API)** | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Gerar código de acesso às API's* |

Além dos dados comuns, você precisará da senha, que ensinamos como gerar abaixo.

#### 3.1.1 Gerando a Senha de API\`s

{% hint style="danger" %} <mark style="color:red;">**Atenção: Esta senha será utilizada em todos os sistemas integrados com os Correios.**</mark>\
\ <mark style="color:red;">Antes de gerar uma nova senha, recomenda-se verificar se é possível obtê-la em outro sistema onde já esteja em uso. Caso você faça a geração de uma nova senha, não se esqueça de atualizar em todos os demais sistemas integrados às API's dos Correios.</mark>
{% endhint %}

Para gerar uma nova senha, insira a senha utilizada no portal **Meus Correios,** a mesma utilizada para acessar o Portal Correios.  Em seguida, clique em **"Regerar Código":**

<figure><img src="/files/NYbkGWBbc6KIcSCKAaiB" alt=""><figcaption><p>Geração de um novo código de acesso às APIs</p></figcaption></figure>

Anote a senha gerada, pois este será seu **novo Código de Acesso às APIs Correios**.

#### 3.2 Integrando pela Chave de Acesso&#x20;

{% hint style="warning" %}
Atenção: **São duas chaves que você vai precisar gerar**.&#x20;
{% endhint %}

| Dado                                       | Descrição                     | Onde conseguir                                                        |
| ------------------------------------------ | ----------------------------- | --------------------------------------------------------------------- |
| **Chave de acesso por Contrato**           | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Chaves de Acesso* |
| **Chave de acesso por Cartão de Postagem** | Gerada no portal dos Correios | <https://cws.correios.com.br/acesso-componentes> → *Chaves de Acesso* |

Os Correios não permitem gerar uma única chave com as permissões por contrato e por cartão de postagem que precisamos. Por isso, você terá que gerar duas chaves para inserir em nosso painel.

Acesse o link **Chaves de acesso:**

<img src="/files/XkKGWOkCneH3pC6TicUH" alt="" data-size="original">

Depois clique em **Criar chave de acesso:**

<figure><img src="/files/471IOzsqsLu0NsIBP4oV" alt=""><figcaption></figcaption></figure>

Preencha os dados básicos, como nome, descrição e **insira a validade para 180 dias:**

<figure><img src="/files/2uAymRRzLZByWR4TtGGd" alt=""><figcaption><p>Preenchimento do nome, descrição e validade da chave</p></figcaption></figure>

#### 3.2.1 Chave de acesso por Contrato

Para o contrato, **informe o seu número do contrato** habilite as seguintes APIs:

<figure><img src="/files/MIJ8PiKLFpsXMPKgkP08" alt=""><figcaption><p>APIs habilitadas na chave de acesso por contrato</p></figcaption></figure>

Depois clique em **Criar nova chave**. Copie o código fornecido que você usará para cadastrar dentro do painel.&#x20;

Agora, faça o próximo passo e gere a chave por cartão. Precisamos das duas.

#### 3.2.2 Chave de acesso por Cartão

Para o cartão, **informe o seu número do cartão de postagem** e habilite a seguinte API:

<figure><img src="/files/l7O0UIKOlKdEOWwOmqjk" alt=""><figcaption><p>API habilitada na chave de acesso por cartão de postagem</p></figcaption></figure>

Não esqueça de ativar o **Acesso Total** para que o sistema seja capaz de criar etiquetas no seu contrato.&#x20;

### 4. Como consultar o Código Administrativo

Acesse o site [sfe.correios.com.br](https://sfe.correios.com.br) e faça login com sua conta dos Correios.\
\
Após acessar o painel, vá até a seção **“Contratos”**

<figure><img src="/files/qWa9ucWISSDaWDImYWuc" alt=""><figcaption><p>Seção Contratos no portal SFE dos Correios</p></figcaption></figure>

Clique no campo **“Pesquisar”** para localizar o contrato desejado.

<figure><img src="/files/4l6ORJR8ELr8ojZFErET" alt=""><figcaption><p>Pesquisa do contrato no portal SFE</p></figcaption></figure>

\
Em seguida, clique no ícone de **três pontos (•••)** ao lado do contrato listado.

<figure><img src="/files/RTqHcvyepjdcRipBkN0A" alt=""><figcaption><p>Menu de opções do contrato</p></figcaption></figure>

Isso abrirá a tela de detalhamento do contrato, onde estará disponível o **número do Código Administrativo**.

<figure><img src="/files/jat0bQSuBspPUnkCmUZw" alt=""><figcaption><p>Código administrativo no detalhamento do contrato</p></figcaption></figure>

\
**Verifique o código e confirme se ele está corretamente cadastrado no painel da Troque e Devolva.**

## Integrando os Correios na Troque e Devolva

Dentro do **Painel Troque e Devolva,** clique em **Configurações** -> **Transportadoras**. Depois, clique no botão **Criar Transportadora**.

### 1.Preenchendo o nome e instruções de postagem

Preencha o nome da transportadora **Correios** e as **instruções de postagem.** Na lista de transportadoras, selecione **Correios:**

<figure><img src="/files/6ZRS0r55BuPK87fV3ZvW" alt=""><figcaption><p>Configurando os Correios</p></figcaption></figure>

### 2. Preenchendo as credenciais de integração Correios

Aqui depende de como você escolheu integrar, se será por Código de Acesso ou Chave de acesso (que explicamos acima).

Se você vai integrar por **Código de Acesso às APIs**:

<figure><img src="/files/hy07vuzYQXHsyD6L9AZS" alt=""><figcaption><p>Dados de integração com os Correios</p></figcaption></figure>

Se você vai integrar por **Chaves de Acesso**:

<figure><img src="/files/6WdiJzuBbVJOWZQEu2O5" alt="" width="375"><figcaption><p>Credenciais de integração por chaves de acesso</p></figcaption></figure>

### 3. Configurando os valores padrão

Em seguida, escolha quais os valores padrão para a emissão da etiqueta: método de postagem, modalidade (PAC é o mais barato) e o prazo que o cliente terá para postar nos Correios.

Você pode desabilitar o e-mail automático enviado pelos Correios. Como a Troque & Devolva já notifica o cliente sobre o status da devolução, o e-mail dos Correios acaba sendo redundante. Se preferir uma comunicação mais limpa, basta manter apenas o nosso e-mail ativado.

<figure><img src="/files/aHwnELZ2zQkg3GctmrFJ" alt="" width="563"><figcaption><p>Configuração dos valores padrão da transportadora</p></figcaption></figure>

Depois disso, clique em **Salvar**.&#x20;

### 4. Aguardando a autenticação

O sistema irá verificar as credenciais informadas e exibirá detalhes, caso encontre algum erro.

#### **Em caso de usuário ou senha errada, um aviso como:**

<figure><img src="/files/cSn6S0UuRG0Lu5THNhgv" alt=""><figcaption><p>Aviso de código de acesso incorreto</p></figcaption></figure>

**Componente Logística Reversa:**

<figure><img src="/files/OPwHMJ0tRijTMCKBhLTA" alt=""><figcaption><p>Aviso de ccmponente Logítica Reversa</p></figcaption></figure>

Acesse a seção **"Gestão de acesso a API's"** e verifique se o módulo **250 – Logística Reversa** está disponível.

Caso o módulo não esteja presente, você precisa solicitar a habilitação do módulo **Logística Reversa (250)** ao gestor do seu contrato nos Correios.

\
Se não aparecer nenhum aviso, **os Correios estarão integrados em sua conta.**


# Copy of Integrando Correios

A Troque e Devolva emite a autorização de postagem integrada aos Correios.

A logística reversa dos Correios é uma solução prática para devolução de produtos.

Com a autorização de postagem, o cliente não precisa imprimir etiquetas. Basta levar o pacote até uma agência própria ou franqueada dos Correios, informar o número da autorização e pronto. A medição, pesagem e impressão da etiqueta ficam por conta dos Correios.

Como a autorização é emitida via contrato empresarial, o cliente não paga nada na hora da postagem. A cobrança dos fretes é feita depois, junto com os envios mensais do seu contrato.

## Dados necessários

| Dado                                          | Descrição                           | Onde conseguir                                                                                           |
| --------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Usuário de API**                            | Usuário do portal dos Correios      | [https://cws.correios.com.br/](https://cws.correios.com.br)                                              |
| **Código de Acesso às API\`s (senha de API)** | Gerada no portal dos Correios       | <https://cws.correios.com.br/acesso-componentes> → *Gerar código de acesso às API's*                     |
| **Código Administrativo**                     | Número do seu código administrativo | [sfe.correios.com.br](https://sfe.correios.com.br) → Você pode consultar o passo a passo completo abaixo |
| **Cartão de Postagem**                        | Número do cartão de postagem        | Fornecido pelos Correios                                                                                 |
| **Código do Serviço PAC Reverso**             | Geralmente: `03301`                 | Disponível na consulta do seu Cartão de Postagem                                                         |
| **Código do Serviço SEDEX Reverso**           | Geralmente: `03247`                 | Disponível na consulta do seu Cartão de Postagem                                                         |

## Passo a passo para geração de Senha de API

### 1. Acesso ao site CWS – Gestão de APIs dos Correios

Acesse o site de gestão de APIs dos Correios por meio do seguinte link [**https://cws.correios.com.br**](https://cws.correios.com.br)

Insira seu **usuário** e **senha** cadastrados nos Correios:

<figure><img src="/files/0w39B9TNtj7kzQpH3TKJ" alt=""><figcaption><p><br>Tela de login dos Corrieos</p></figcaption></figure>

### 2. Verifique se o módulo de Logística Reversa está liberado em sua conta

Acesse a seção **"Gestão de acesso a API\`s"** e verifique se o módulo **250 – Logística Reversa** está disponível:

<figure><img src="/files/I78UsqpFKWYCeW3RQlxU" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Caso o módulo não esteja presente:** Você precisa solicitar a habilitação do módulo **Logística Reversa (250)** ao gestor do seu contrato nos Correios.
{% endhint %}

### 3. Gerando a Senha de API\`s

{% hint style="danger" %} <mark style="color:red;">**Atenção: Esta senha será utilizada em todos os sistemas integrados com os Correios.**</mark>\
\ <mark style="color:red;">Antes de gerar uma nova senha, recomenda-se verificar se é possível obtê-la em outro sistema onde já esteja em uso. Caso você faça a geração de uma nova senha, não se esqueça de atualizar em todos os demais sistemas integrados às API's dos Correios.</mark>
{% endhint %}

Para gerar uma nova senha, insira a senha utilizada no portal **Meus Correios,** a mesma utilizada para acessar o Portal Correios.  Em seguida, clique em **"Regerar Código":**

<figure><img src="/files/NYbkGWBbc6KIcSCKAaiB" alt=""><figcaption><p>Gerando um novo Código de acesso às API's (senha de API) Correios</p></figcaption></figure>

Anote a senha gerada, pois este será seu **novo Código de Acesso às APIs Correios**.

### 4. Como consultar o Código Administrativo

Acesse o site [sfe.correios.com.br](https://sfe.correios.com.br) e faça login com sua conta dos Correios.\
\
Após acessar o painel, vá até a seção **“Contratos”**

<figure><img src="/files/qWa9ucWISSDaWDImYWuc" alt=""><figcaption></figcaption></figure>

Clique no campo **“Pesquisar”** para localizar o contrato desejado.

<figure><img src="/files/4l6ORJR8ELr8ojZFErET" alt=""><figcaption></figcaption></figure>

\
Em seguida, clique no ícone de **três pontos (•••)** ao lado do contrato listado.

<figure><img src="/files/RTqHcvyepjdcRipBkN0A" alt=""><figcaption></figcaption></figure>

Isso abrirá a tela de detalhamento do contrato, onde estará disponível o **número do Código Administrativo**.

<figure><img src="/files/jat0bQSuBspPUnkCmUZw" alt=""><figcaption></figcaption></figure>

\
**Verifique o código e confirme se ele está corretamente cadastrado no painel da Troque e Devolva.**

## Integrando os Correios na Troque e Devolva

Dentro do **Painel Troque e Devolva,** clique em **Configurações** -> **Transportadoras**. Depois, clique no botão **Criar Transportadora**.

### 1.Preenchendo o nome e instruções de postagem

Prencha o nome da transportadora **Correios** e as **instruções de postagem.** Na lista de transportadoras, selecione **Correios:**

<figure><img src="/files/6ZRS0r55BuPK87fV3ZvW" alt=""><figcaption><p>Configurando os Correios</p></figcaption></figure>

### 2. Preenchendo as credenciais de integração Correios

Desça mais a tela e ensira os [dados necessários](#dados-necessarios):&#x20;

<figure><img src="/files/hy07vuzYQXHsyD6L9AZS" alt=""><figcaption><p>Dados de integração com os Correios</p></figcaption></figure>

### 3. Configurando os valores padrão

Em seguida, escolha quais os valores padrão para a emissão da etiqueta: método de postagem, modalidade (PAC é o mais barato) e o prazo que o cliente terá para postar nos Correios:

<figure><img src="/files/pXH47wD8vcT1ZPMaemJ7" alt=""><figcaption><p>Configuração padrão dos Correios</p></figcaption></figure>

Depois disso, clique em **Salvar**.&#x20;

### 4. Aguardando a autenticação

O sistema irá verificar as credenciais informadas e exibirá detalhes, caso encontre algum erro.

#### **Em caso de usuário ou senha errada, um aviso como:**

<figure><img src="/files/cSn6S0UuRG0Lu5THNhgv" alt=""><figcaption></figcaption></figure>

Para esta situação, por favor, verifique se os dados estão corretos ou [gere uma nova senha. ](#id-3.-gerando-a-senha-de-api-s)

#### Para casos de falta de habilitação do componente "Logística Reversa (250)":

<figure><img src="/files/RuCOgMUY3t6d6rKdpUEw" alt=""><figcaption></figcaption></figure>

Você precisará entrar em contato com o Gestor da sua conta dos Correios e pedir a habilitação do componente. \
\
Se não aparecer nenhum aviso, **os Correios estarão integrados em sua conta.**


# Configurando uma transportadora personalizada

Para transportadoras sem integração, você pode automatizar o pedido de coleta.

Quando você precisar utilizar transportadoras que não estão integradas ou não possuem API para integração, é possível configurá-las no **Troque & Devolva** para receberem pedidos de coleta via e-mail.

### Cadastrando uma transportadora personalizada

No menu **Configurações > Transportadoras**, clique no botão **Criar Transportadora**. Você verá um formulário onde deve preencher os dados da transportadora.

Na caixa de seleção **Transportadora**, escolha a opção **Transportadora Personalizada**. Logo abaixo, informe o nome do contato, e-mail e telefone da pessoa responsável por receber o pedido de coleta.

<figure><img src="/files/rfQMG5Y1dkHYXtjT0yD7" alt=""><figcaption><p>Tela de cadastro de transportadoras personalizadas</p></figcaption></figure>

### Habilitando e configurando o template de e-mail

Para que a transportadora seja avisada automaticamente,é necessário que você habilite e configure o e-mail **Transportadora - E-mail de solicitação**.

Acesse **Configurações > E-mails Automáticos** e depois clique em "Configurar Novo". Ao escolher o título **Transportadora - E-mail de solicitação**, mostraremos o template padrão, que você pode editar livremente:

<figure><img src="/files/d1wElyyI7q6NcecAtTqy" alt=""><figcaption><p>Edição do template de e-mail para solicitação de coleta.</p></figcaption></figure>

### Autorizando uma solicitação com a transportadora personalizada

Quando for autorizar uma solicitação, você verá a transportadora personalizada listada entre as opções. Basta selecioná-la para continuar o processo.

<figure><img src="/files/7soP2iXVrCWlPKxSP0Cr" alt=""><figcaption><p>Tela de autorização de transportadora personalizada</p></figcaption></figure>

Ao selecionar a transportadora personalizada, você terá acesso a dois campos adicionais:

* **Código de Autorização**: Onde você pode informar o código de postagem gerado pela transportadora
* **Local de Coleta**: Onde você pode informar o endereço do ponto de coleta para o cliente realizar a postagem

<figure><img src="/files/xqQs153nkAhOhzm7KrZy" alt=""><figcaption><p>Campos de código de autorização e local de coleta</p></figcaption></figure>

Esses campos são úteis quando você utiliza transportadoras não integradas ao sistema, como marketplaces, onde você gera o código de postagem e obtém o endereço do ponto de coleta diretamente na plataforma.

<figure><img src="/files/yEZJm4iQ3Q4y1ZCKGFs6" alt=""><figcaption><p>Instruções exibidas ao cliente na solicitação</p></figcaption></figure>

**Importante**: Caso você não visualize esses campos ao autorizar, edite a transportadora personalizada cadastrada e clique em **Salvar** (mesmo sem alterar nada). Isso habilitará os campos na tela de autorização.

#### Método de postagem e e-mails enviados

O campo **Método de postagem** define qual e-mail será enviado ao cliente:

* **Postagem em agência**: Será enviado o e-mail "Solicitação autorizada"
* **Coleta em domicílio**: Será enviado o e-mail "Solicitação autorizada com coleta"

Após a autorização, o responsável pela transportadora receberá automaticamente um e-mail solicitando a coleta.

<figure><img src="/files/wq4PxGDW1waruWvS7ZN5" alt=""><figcaption><p>Template exemplo de e-mail para transportadora</p></figcaption></figure>




---

[Next Page](/llms-full.txt/1)