# Troquecommerce

> Plataforma de trocas e devoluções para e-commerce. O consumidor abre a solicitação de troca ou devolução sozinho na Central de Trocas da loja, e a loja acompanha e aprova as reversas no painel, com regras e prazos configuráveis, logística reversa automática, estratégia de retenção, troca por produto com reserva de estoque, reembolso integrado, relatórios, API pública e webhooks, e um servidor MCP para assistentes de IA. Conteúdo em português do Brasil.

Este arquivo reúne, em Markdown, o texto das páginas públicas de www.troquecommerce.com.br e a parte textual da documentação da API pública e do servidor MCP. Índice curto: https://www.troquecommerce.com.br/llms.txt. Esquemas, parâmetros e exemplos da API e do MCP ficam nos arquivos JSON indicados em cada seção. Os valores dos planos não estão neste arquivo: os preços atuais ficam em https://www.troquecommerce.com.br/pricing. Conteúdo conferido em outubro de 2026.

## Página inicial

Fonte: https://www.troquecommerce.com.br/home

### Transforme suas trocas e devoluções em uma experiência incrível

**A maioria das suas trocas são de tamanho?**

Somos a única plataforma que possui o recurso de troca de produto com reserva de estoque, permitindo seu cliente ter a melhor experiência do mundo, garantindo a peça que ele deseja no ato da solicitação

### Use a TECNOLOGIA das principais marcas de MODA

**+ de 2.000 lojas aprovam**

### A mais segura e confiável

A Troquecommerce tem padrão de excelência no sigilo e proteção dos seus dados. Veja nossas conquistas:

- Auditoria SOC 2: Única plataforma auditada no mais alto padrão de segurança da tecnologia mundial, com a certificação SOC2.
- VTEX IO: Única plataforma homologada na tecnologia VTEX IO. Nossa integração com a VTEX é a mais robusta e completa do mercado, provendo a melhor experiência para sua loja
- Shopify App Store: Única plataforma homologada na Shopify App Store. Os padrões de homologação de um app na Shopify são robustos e mostram a confiança da plataforma em nosso sistema.
- Testes de Segurança: Realizamos Pentests (testes de penetração) regularmente, buscando por vulnerabilidades para que possam ser corrigidas em pouco espaço de tempo

Confira nosso Compliance (https://www.troquecommerce.com.br/compliance) e Segurança em Tempo Real (https://security.troquecommerce.com.br/)

### A suas conquistas com a Troquecommerce

- Aumento da taxa de conversão
- Aumento da satisfação do cliente
- Aumento da recompra e fidelização
- Redução do tempo gasto com SAC
- Elimina planilhas e trabalhos manuais
- Dados e gráficos para tomada de decisão
- Redução do tempo para reembolsos

### Plataforma de trocas e devoluções para e-commerce

A página inicial traz um simulador da Central de Trocas.

### Dados ao seu alcance

Dashboard completo, com gráficos, BI e informações relevantes para você reduzir suas reversas e melhorar seus produtos

### Principais funcionalidades

Caso deseje recursos ou outras funcionalidades que não estejam descritas aqui no site, ou não façam parte do pacote do seu interesse, solicite um orçamento personalizado descrevendo as necessidades do seu projeto.

- Regras e prazos configuráveis: Configure suas regras e prazos como preferir, nosso sistema fará a identificação dos motivos e validação da solicitação do seu cliente se estiver dentro do prazo
- Logística Reversa automática: Geramos autorização de postagem nos Correios de forma automática ou manual, como você preferir, e pode inclusive utilizar o nosso Contrato dos Correios.
- Estratégia de Retenção: Reduza suas devoluções oferecendo um vale compra ao cliente que optar pela devolução, se desejar, ofereça um bônus para convencê-lo e manter esse dinheiro em caixa
- Troca por vale compras: Ofereça uma troca por vale compras, direcionando o seu cliente a voltar ao seu site e adquirir mais produtos, criando uma receita adicional
- Troca por produto: Ative a troca de tamanho e cor, permitindo seu cliente selecionar a peça que deseja, criando um pedido na sua plataforma e reservando para este cliente.
- Reembolso integrado: Oferecemos reembolso integrado, evitando trabalhos manuais da equipe financeira
- Pesquisa NPS: Nossa pesquisa NPS é a mais completa do mercado, acontecendo em dois níveis. A primeira ao término da solicitação e a segunda após o cliente receber o reembolso ou vale compras.
- Banco antifraude: Nosso banco antifraude conta com milhares de CPFs que já foram registrados como fraudulentos em nosso ecossistema, você será notificado para tomar cuidado e não antecipar vales para estes clientes.
- Omnichannel e Marketplaces: Permita reversas em loja física, lockers inteligentes, retorno para origem, reversas de sellers e marketplaces e muito mais com nossas regras avançadas
- Nota Fiscal de Devolução: Utilize nossos recursos integrados ao seu ERP para realizar NFD de forma integrada, automatizando o fluxo fiscal da sua operação. Integrações Fiscais: Sintese, E-Milenium, Tiny, Bling, LINX OMS
- Conta Bancária Digital: Crie uma conta bancária digital e a utilize para realizar reembolsos via PIX para seus clientes com apenas um clique. Os serviços financeiros são prestados pelo Asaas, instituição de pagamento autorizada pelo Banco Central do Brasil.
- API e Webhook: Possuímos uma collection de APIs e Webhooks completa para que você possa integrar suas soluções e não perder nenhuma visibilidade dos dados

### Especiais Troquecommerce

#### Troca por tamanho e cor

Somos a única plataforma que permite a criação automática de um novo pedido, com reserva de estoque, quando o cliente solicita uma troca por produto. Ao selecionar um novo tamanho ou cor, o sistema gera automaticamente o pedido de substituição, garantindo uma experiência de troca rápida e sem complicações, você define quando esse pedido de reserva será aprovado e enviado para o seu cliente.

#### Estratégia de Retenção

Nossa estratégia de Retenção em dois níveis é a mais completa do mercado, com a maior eficiência e transparência para você e seu cliente final. Ofereça um vale compras quando o cliente optar por uma devolução com nossa retenção, se desejar, oferte bônus de valor fixo ou percentual sobre este vale para reduzir os seus estornos.

#### Crossborder

A Troquecommerce é a única plataforma que oferece suporte a operações crossborder. Facilitamos o processo de devoluções internacionais, garantindo que seus clientes possam realizar trocas e devoluções de maneira eficiente e sem complicações, independentemente da localização.

### Pague por uso

Zero mensalidade fixa, zero fidelidade, zero multa, zero setup.

A cobrança é por reversa utilizada, com um valor mínimo mensal. Quanto mais você usa, mais barato fica. Grátis enquanto não houver solicitações de troca postadas.

Valores atuais na página de preços: https://www.troquecommerce.com.br/pricing

### Empresas Enterprise

Agende uma reunião para apresentarmos possíveis customizações, automações e proposta para a sua empresa Enterprise

### Integrações

#### Plataformas

VTEX, Shopify, Wake, Oracle, Salesforce, Linx Commerce, Magento 2, Loja Integrada, Tray, Nuvemshop, Magazord, Irroba, iSET, Dooca, Bagy, Uoou Solutions, WooCommerce, Wbuy, Webstore, Betalabs, Olist, Yampi, Braavo, Uappi, Commerceplus, DLoja Virtual, Climba Commerce, Shoppub, Moovin, Panorama Sistemas, Convertr, Jet, GoDeep, MKX Ecommerce, Cartpanda, BW Commerce

#### ERPs

SAP by b1Soft, Emillennium, Bling, Tiny, Omie, Eccosys, Softvar, Sisplan, Sankhya

#### OMS

Síntese, Linx OMS, Neomode

#### Atendimento e CRM

Zendesk, Omnichat, VTEX CX / Weni, Notificações Inteligentes, E-vendas, CRMBonus, BonifiQ, Reportana, Open Cashback, Venda.ai

#### Transportes

Correios, Jadlog, Loggi, Devoluxe, Clique Retire, Recoli, USPS, Coordinadora, Ícaro, Transtac

### História de Sucesso

> Troquecommerce são mais que fornecedores: são parceiros que agregam tanto à experiência dos nossos clientes quanto à eficiência dos nossos times. Além de prestar um suporte diferenciado e de muita qualidade, estão sempre dispostos a ouvir e implementar novos projetos, buscando estar sempre à frente com fluidez e muita tecnologia.

Cargo: Gerente CX

> Trabalhar com o time da Troquecommerce, sem sombra de dúvidas, foi uma das melhores decisões para a melhoria em nosso processo de trocas e devoluções. Em poucos meses, evoluímos em tecnologia e suporte, proporcionando uma experiência cada vez melhor, com mais agilidade e facilidade na abertura das solicitações. O time tem uma excelente sinergia e suporte voltado para o negócio, sempre auxiliando e ajustando os processos da melhor forma.

Cargo: Gerente CX

> Faz um ano que iniciamos a parceria com Troquecomerce e foi a melhor decisão, tanto para a parte de tecnologia, suporte e a facilidade para nosso cliente. A ferramenta faz toda a gestão de reversas de forma simples, rápida e totalmente automatizada. Logo após a migração já sentimos os resultados positivos, tanto para nossa operação interna quanto para nosso cliente. Além da facilidade na usabilidade a troquecommerce ainda fornece um painel onde podemos acompanhar todas as estatísticas das trocas e entender de perto cada produto do nosso ecommerce. Sem contar em todo o suporte que a empresa presta desde a integração até hoje, tudo é resolvido muito rápido. Sem dúvidas a melhor solução para logística reversa do mercado.

Cargo: Diretora de Operações

### Rodapé

Simplifique trocas e devoluções.

- Contato: comercial@troquecommerce.com.br
- Blog: https://troquecommerce.blog/
- Políticas e diretrizes: https://www.troquecommerce.com.br/compliance
- Canal de denúncias: https://troquecommerce.factorialhr.com.br/complaints/
- Selos: Shopify Partner e VTEX Partner

## Preços

Fonte: https://www.troquecommerce.com.br/pricing

**Para equipes de todos os tamanhos**

Explore todos os recursos para o seu e-commerce e aproveite todas as nossas funcionalidades. Oferecendo soluções desde omnichannel, marketplace, trocas e devoluções automatizadas, integração com múltiplos métodos de envio e ERPs, até relatórios detalhados e suporte dedicado.

Modelo de cobrança: pague por uso, com cobrança por reversa utilizada e um valor mínimo mensal nos períodos com reversas postadas. Zero mensalidade fixa, zero fidelidade, zero multa, zero setup. Os valores atuais de cada plano, inclusive o mínimo, ficam em https://www.troquecommerce.com.br/pricing

### Planos

- Mínimo (valor mínimo mensal): Para pequenos e-commerces começarem com trocas e devoluções. Não haverá cobrança enquanto não houver reversas postadas no período.
- Padrão (cobrança por reversa): Para e-commerces em crescimento com necessidades intermediárias.
- Enterprise (valor negociado): Para grandes e-commerces com necessidades avançadas.

### Comparação de planos

#### Funcionalidades

| Funcionalidade | Mínimo | Padrão | Enterprise | Detalhe |
|---|---|---|---|---|
| Aprovação Automática | Sim | Sim | Sim | Automaticamente aprovar solicitações que atendem a certos critérios. O código de postagem reverso já aparece na hora da solicitação na central de trocas. |
| Disparo de email usando domínio a loja | Sim | Sim | Sim | Escolha o email que preferir para comuniação via email com o seu cliente. |
| Cadastro de múltiplos usuários | Ilimitado | Ilimitado | Ilimitado | Cadastre quantos usuários optar em vários tipos de perfis diferentes |
| Múltiplos pontos de devolução | Sim | Sim | Sim | Gerencie onde suas devoluções são recebidas e compare rótulos de frete |
| Cupom vale-troca | Sim | Sim | Sim | Emissão de cupom vale-compra em caso de troca para que seu cliente faça uma nova compra no site |
| Crédito na loja | Sim | Sim | Sim | Permita que o crédito de devolução seja emitido na forma de um gift-card, dependendo se a plataforma possuir o recurso |
| Estratégia de Retenção | Sim, com comissão sobre o valor retido | Sim, com comissão sobre o valor retido | Sim, com comissão sobre o valor retido | Ofereça vale-compras quando o cliente optar por reembolso e retenha até 30% das devoluções dependendo de quanto de bonificação será fornecido. Comissão em extrato de crédito/débito. Comissão negociável para produtos high ticket. |
| Reembolso Integrado | Sim | Sim | Sim | Reembolsos integrados ou usando conta digital cadastrada sem custo adicional. |
| Troca direta com reserva de estoque | Sim, com cobrança por pedido criado na plataforma | Sim, com cobrança por pedido criado na plataforma | Sim, com cobrança por pedido criado na plataforma | Permita trocas por um tamanho ou cor diferente |
| Múltiplos métodos de envio | Sim | Sim | Sim | Postagem ou coleta domiciliar, locker ou motoboy |
| Gráficos estatísticos | Sim | Sim | Sim | Entenda como suas devoluções estão sendo realizadas com gráficos de trocas, devoluções, produtos, performance, logísticos e retenção |
| Nota Fiscal de Devolução integrada | Sim, com cobrança por reversa | Sim, com cobrança por reversa | Sim, com cobrança por reversa | Emmissão da NFD integrada para os principais ERPs do mercado: Bling, Tiny, Emillenium, etc. Para WMS específicos integramos com LinxOMS, Síntese ou Softvar para um workflow customizado. |
| URL personalizada | Sim | Sim | Sim | Combine a URL da central de trocas com a sua marca. Opção de usar URL direta sem necessida de preenchimento do Nr do pedido/email |
| Reversa sem etiqueta (correios) | Sim | Sim | Sim | Com o seu contrato ou o contrato da Troquecommerce, emitimos e-ticket nos correios usando um código de autorização de postagem. Sem necessidade de impressão de etiqueta pelo cliente. |
| Transportadora personalizada/motoboy | Sim | Sim | Sim | Cadastre a transportadora da sua preferência aprovando as reversas no modo offline. |
| Aprovação com envio pelo cliente | Sim | Sim | Sim | Em casos de segunda troca ou troca da troca, pode-se aprovar com cliente pagando frete. Nesse caso não haverá o tracking reverso |
| Aprovação sem envio | Sim | Sim | Sim | Permita que os compradores recebam um reembolso total ou parcial sem enviar o item. |
| Valor mínimo para aprovação automática | Sim | Sim | Sim | Permita que a reversa caia em análise se a soma dos produtos exceder o valor mínimo. |
| Módulo Anti Fraude | Sim | Sim | Sim | Marque como fraude produtos enviados de má fé. Clientes marcados como fraude não receberão opção de retenção nem reembolso antecipado |
| Módulo NPS | Sim | Sim | Sim | Monitore nos gráficos de NPS a satisfação do seu cliente na experiência de trocas e devoluções em tempo real |
| Motivos de troca/devolução customizados | Ilimitado | Ilimitado | Ilimitado | Cadastre quantos motivos de troca/devolução quiser. Com opção de exigir upload de foto por motivo, prazo por motivo e/ou comentário obrigatório por motivo |
| Coleta domiciliar por motivo | Sim | Sim | Sim | Ative a coleta domiciliar por motivo. Lojas optam por habilitar a coleta domiciliar em motivos onde a loja erro, exemplo: 'Produto com defeito' ou 'Recebi um produto errado'. |
| Importação e exportação | Sim | Sim | Sim | Importe e exporte dados facilmente. Reversas, produtos, recebimentos diários, produtos recebidos, produtos por motivo, NPS e cobranças. |
| Entrega em loja física (API do Google Maps) | Sim | Sim | Sim | Permita que os compradores iniciem uma devolução online e a finalizem na loja. Usamos API do Google Maps para verificar se o cliente encontra-se dentro do raio de alguma loja física cadastrada. |
| Envio da NFD automáticamente para a transportadora | Não incluído | Ativação via suporte | Ativação via suporte | Aprove as reversas anexando a nota fiscal de devolução. Enviamos email para a transportadora solicitando a coleta domiciliar automaticamente na aprovação da reversa. |
| Emissão de vale-compras antecipado/automatizado | Não incluído | Ativação via suporte | Ativação via suporte | Automatize a emissão de vale-compras quando desejar: Na postagem, No recebimento dos produtos ou Na emissão da NFD. |
| API Pública | Não incluído | Ativação via suporte | Ativação via suporte | Acesso à API Troquecommerce, webhooks e integrações pré-construídas. |
| Cross Border (inglês/espanhol) | Não incluído | Ativação via suporte | Ativação via suporte | Habilite o envio de devoluções entre diferentes países traduzindo a sua central de trocas (motivos, prazos, descrições, endereços, moeda, timezone) para inglês/espanhol e aprovando as reversas anexando etiquetas da transportadora da sua escolha |
| Integrações Customizadas | Não incluído | Não incluído | Sim | Integramos com Zendesk, Síntese, Softvar, LinxOMS, TODO Cartões, CRM&Bonus, bot de WhatsApp ou o sistema de seu ecossistema |
| Módulo Omnichannel | Não incluído | Não incluído | Sim | Para operações Omni, caso cliente opte para devolver em loja, seu usuário de loja física terá visibilidade única das reversas que serão entregues apenas na sua loja. Segregando responsabilidades. Em caso de pedidos split, por padrão cada produto volta para sua origem, podendo também ser configurável |
| Módulo Marketplace in/out | Não incluído | Não incluído | Sim | Habilite ou desabilite Sellers que vendem no seu ecommerce (marketplace in) usando cartões de postagens específicos ou o contrato do seller. Criamos uma conta de marketplace out para emissão de código de postagem reverso para as reversas de marketplace out. |
| Módulo grupamento de pedido split para devolução centralizada | Não incluído | Não incluído | Sim | Um adicional ao módulo omnichannel, em situações de lojas próprias ou grupo de sellers desejados e agrupamos itens de pedidos split para unificarmos em uma única reversa para o cliente. Economizando no frete reverso e trazendo uma melhor experiência para o cliente em casos de split de pedidos. |

#### Relatórios

| Funcionalidade | Mínimo | Padrão | Enterprise | Detalhe |
|---|---|---|---|---|
| Relatório de reversas e produtos | Sim | Sim | Sim | Análises detalhadas dos seus dados. Relatórios de reversas, produtos, recebimentos diários, produtos recebidos e produtos por motivo |
| Relatórios de NPS | Sim | Sim | Sim | Relatórios simples e eficientes de NPS exportável no menu estatísticas (NPS) |
| Relatórios de cobrança | Sim | Sim | Sim | Exporte no menu cobranças as reversas cobradas por período para facilitar sua conciliação contábil |
| Relatórios de logística reversa | Sim | Sim | Sim | Faça a conciliação de frete reverso você mesmo exportando o frete cobrado por período. |
| Relatórios de retenção | Sim | Sim | Sim | Compare o quão eficiente está a sua estratégia de retenção através de nossos gráficos. |

#### Suporte

| Funcionalidade | Mínimo | Padrão | Enterprise | Detalhe |
|---|---|---|---|---|
| Suporte online horário comercial | Sim | Sim | Sim | Suporte disponível entre 08:30 - 12:00 / 13:30 - 17:30 |
| Central de ajuda | Sim | Sim | Sim | Acesso a nossa base de conteúdo (central de ajuda) |
| Treinamento gratuito com time de CS | Sim | Sim | Sim | Treinamento e reciclagem do time gratuito via agendamento |
| Onboarding individual | Não incluído | Não incluído | Sim | Time de implementação fará o cadastro, configuração e onboarding |
| Grupo WhatsApp exclusivo | Não incluído | Não incluído | Sim | Criamos um grupo de WhatsApp com o time fundador, time de CS e suporte técnico |

Valores das cobranças citadas na tabela: https://www.troquecommerce.com.br/pricing

## Compliance e segurança

Fonte: https://www.troquecommerce.com.br/compliance

### Segurança e Conformidade na Troquecommerce

A Troquecommerce possui certificação SOC 2 Type 2. Nosso monitoramento de controles em tempo real está disponível em nosso Relatório de Confiança.

Selos: A-LIGN SOC 2 e AICPA SOC

Trust Center: https://security.troquecommerce.com.br/

### Políticas de Compliance

Garantindo Conformidade Legal e Ética nas Operações

- Trust Center: Nós, como organização, compreendemos a importância crítica da segurança e da confiança em todas as nossas operações e interações. Por isso, estabelecemos o Trust Center, uma iniciativa dedicada a assegurar que nossos clientes, parceiros e colaboradores tenham total confiança em nossa capacidade de proteger dados sensíveis, cumprir com regulamentações rigorosas e manter práticas de segurança de alto nível. Acesso: https://security.troquecommerce.com.br/
- ROPA: Nosso Registro de Atividades de Processamento (ROPA) é um pilar central na gestão da privacidade e proteção de dados dentro de nossa empresa, servindo como um mapeamento detalhado de como os dados pessoais são tratados em nossas operações. Este documento não só evidencia nosso compromisso com a conformidade às regulamentações de proteção de dados, como a LGPD, mas também nos permite ter uma visão clara das atividades de processamento de dados, identificando quem tem acesso aos dados, para quais propósitos são utilizados e como e onde são armazenados ou transferidos. Documento: https://www.troquecommerce.com.br/compliance/ropa.pdf
- Política de Privacidade: Nossa Política de Privacidade, alinhada com a LGPD, define como protegemos as informações pessoais dos nossos clientes e colaboradores. Priorizamos a segurança e o respeito à privacidade, cumprindo rigorosamente as leis e regulamentações de proteção de dados. Documento: https://www.troquecommerce.com.br/compliance/privacy-policy.pdf
- Termos de Uso: Nossos Termos de Uso são regras e diretrizes essenciais que os clientes devem seguir ao utilizar nossos serviços ou produtos. Este documento estabelece nossa relação com os clientes, detalhando seus direitos e responsabilidades, bem como os nossos. Documento: https://www.troquecommerce.com.br/compliance/terms-of-use.pdf
- Código de Ética: Nosso Código de Ética reflete os valores fundamentais da nossa empresa, orientando nossas ações e as relações internas e externas que estabelecemos. Este documento serve como bússola para nossos colaboradores, definindo padrões de conduta profissional, integridade, transparência e respeito mútuo. Documento: https://www.troquecommerce.com.br/compliance/code-of-ethics.pdf
- KYC: Nosso processo de Know Your Customer (KYC) é essencial para assegurar a transparência e a segurança nas operações, permitindo-nos identificar e entender melhor nossos clientes. Através deste processo, coletamos e analisamos informações vitais sobre quem são nossos clientes, suas atividades e a origem de seus fundos, cumprindo com regulamentações legais e combatendo fraudes e lavagem de dinheiro. Documento: https://www.troquecommerce.com.br/compliance/kyc.pdf
- Política Anti Corrupção: Nossas políticas anti corrupção estabelecem diretrizes rigorosas para promover uma cultura de integridade e ética em todas as operações da empresa. Implementamos medidas de prevenção, detecção e combate a práticas ilícitas. Documento: https://www.troquecommerce.com.br/compliance/anti-corruption.pdf

### Nossas políticas são baseadas nos seguintes princípios fundamentais

1. O acesso deve ser limitado apenas àqueles com uma necessidade legítima de negócios e concedido com base no princípio do menor privilégio.
2. Controles de segurança devem ser implementados e segregados de acordo com o princípio da defesa em profundidade.
3. Controles de segurança devem ser aplicados de forma consistente em todas as áreas da empresa.
4. A implementação de controles deve ser iterativa, amadurecendo continuamente nas dimensões de eficácia aprimorada, auditabilidade aumentada e atrito reduzido.
5. Avaliações de risco devem ser realizadas regularmente para identificar vulnerabilidades e atualizar as medidas de segurança conforme necessário, garantindo que a proteção esteja alinhada com as ameaças emergentes e as mudanças no ambiente de negócios.
6. Treinamento e conscientização em segurança da informação devem ser proporcionados a todos os funcionários e partes interessadas, assegurando que compreendam suas responsabilidades na proteção de dados e recursos da empresa, além de estarem preparados para reconhecer e responder a incidentes de segurança de forma eficaz.

### Proteção de Dados

#### Dados em repouso

Todos os repositórios com dados de clientes, além dos buckets S3, são criptografados em repouso. Os bancos de dados também usam criptografia, restrições de rede e filtragem de tráfego indesejado.

Isso significa que os dados são criptografados antes mesmo de chegarem ao banco de dados, de modo que nem o acesso físico, nem o acesso lógico ao banco de dados, são suficientes para ler as informações mais sensíveis.

#### Dados em trânsito

Os dados são criptografados em repouso (AES-256) e em trânsito (HTTPS / TLS), incluindo informações sensíveis como tokens de acesso e segredos. Também usamos recursos como HSTS (HTTP Strict Transport Security) para maximizar a segurança de nossos dados em trânsito.

#### Mitigação de DDoS

A Troquecommerce mitiga ataques DDoS de L3, L4 e L7. O Firewall usa centenas de sinais e fatores de detecção para identificar padrões de solicitação, determinando se parecem ser um ataque, e desafiando ou bloqueando solicitações se parecerem ilegítimas. Também temos uma camada extra para monitorar o IP rate limits.

#### Varredura de Vulnerabilidades

Além de nossa varredura de vulnerabilidades, realizamos avaliações direcionadas de forma consistente e contínua. Também implementamos revisões diárias de código, regras de proteção de branches, verificações de análise estática e varredura de dependências maliciosas para prevenir a introdução de malware em nossa cadeia de suprimentos de software no nível do código.

### Canal de Denúncias

Garantimos total confidencialidade e segurança na denúncia.

Enviar denúncia: https://troquecommerce.factorialhr.com.br/complaints/

### Segurança Empresarial

#### Proteção de Pontos Finais

Todos os dispositivos corporativos são gerenciados centralmente e estão equipados com software de gerenciamento de dispositivos móveis (MDM) e proteção antimalware. Os alertas de segurança dos pontos finais são monitorados com cobertura 24/7/365. Utilizamos software MDM para impor a configuração segura dos pontos finais, como criptografia de disco, configuração de bloqueio de tela e atualizações de software.

#### Gerenciamento de acesso

Aos funcionários da Troquecommerce é concedido acesso às aplicações baseado em seu papel, e automaticamente desprovisionado após o término de seu emprego. Acessos adicionais devem ser aprovados de acordo com as políticas estabelecidas para cada aplicação.

#### Educação em Segurança

A Troquecommerce oferece treinamento de segurança abrangente para todos os funcionários no momento da integração e anualmente através de módulos educacionais usando uma plataforma online.

Além disso, todos os novos funcionários participam de uma sessão de integração ao vivo obrigatória centrada em princípios de segurança chave.

Todos os novos engenheiros também participam de uma sessão de integração ao vivo obrigatória focada em princípios e práticas de codificação segura.

A equipe de segurança da Troquecommerce compartilha regularmente briefings de ameaças com os funcionários para informá-los sobre atualizações importantes relacionadas à segurança e segurança que requerem atenção ou ação especial.

#### Segurança de Fornecedores

A Troquecommerce utiliza uma abordagem baseada em risco para a segurança dos fornecedores. Os fatores que influenciam a classificação de risco inerente de um fornecedor incluem:

- Acesso a dados de clientes e corporativos
- Integração com ambientes de produção
- Potencial dano à marca Troquecommerce

Uma vez que a classificação de risco inerente tenha sido determinada, a segurança do fornecedor é avaliada a fim de determinar uma classificação de risco residual e uma decisão de aprovação para o fornecedor.

## Política de privacidade

Fonte: https://www.troquecommerce.com.br/privacy-policy

**POLÍTICA DE PRIVACIDADE**

A TROQUECOMMERCE LTDA, pessoa jurídica de direito privado, inscrita no CNPJ/MF sob n. 42.962.556/0001-09, estabelecida na para Rua Frei Beda Koch, 182, CEP 89036-420, bairro Velha, na cidade de Blumenau, Santa Catarina (a “TROQUECOMMERCE”) possui a propriedade exclusiva da TROQUECOMMERCE, que é uma plataforma online que permite ao Consumidor de E-commerce (o “Usuário”) se auto atender em questões ligadas ao pós-vendas, como trocas e devoluções de produtos adquiridos em lojas virtuais (o “E-commerce”), de forma autônoma, rápida e fácil.

Este documento (a “Política de Privacidade”) estabelece as regras sobre a obtenção, o acesso, o armazenamento, a transferência, o uso e o enriquecimento de bases dos dados coletados dos USUÁRIOS, (as “Informações Pessoais”), por meio da adesão e da utilização dos serviços, site e sistema TROQUECOMMERCE, bem como pelas transações realizadas com as lojas virtuais e Parceiros de negócios do SISTEMA , além do registro de suas atividades, de acordo com as leis em vigor no Brasil.

**O ACESSO, CADASTRO E USO DO SISTEMA, MEDIANTE ACEITAÇÃO EXPRESSA DESTA POLÍTICA DE PRIVACIDADE, IMPLICAM A ACEITAÇÃO TOTAL DE SUAS DISPOSIÇÕES.**

### 1. OBTENÇÃO DOS DADOS

1.1. Ao aceitar a Política de Privacidade, o USUÁRIO manifesta seu livre, expresso e informado consentimento com os termos aqui estipulados, a fim de permitir a obtenção, a utilização, o acesso, o uso, o compartilhamento, o armazenamento, a transferência e o enriquecimento das bases de dados da TROQUECOMMERCE LTDA, e das empresas que pertencem ao mesmo grupo econômico, de acordo com as finalidades específicas descritas nesta Política.

1.2. Os dados pessoais dos USUÁRIOS serão obtidos das seguintes maneiras:

(i) Por meio dos acessos e das transações feitas pelos USUÁRIOS com as Lojas de E-commerce e com os Parceiros de negócios da TROQUECOMMERCE LTDA. Tais Informações Pessoais são imprescindíveis ao funcionamento do Sistema, sem as quais esta não poderá promover a demandas ligadas ao pós-vendas da compra realizada pelo Usuário ao E-commerce.

(ii) Quando inseridos ou submetidos voluntariamente pelo USUÁRIO ao utilizarem o SISTEMA ;

1.3. A TROQUECOMMERCE LTDA utiliza diversas tecnologias, próprias e de terceiros, que coletam automaticamente informações sobre a navegação do USUÁRIO no Sistema. Esses dados são coletados através de tecnologias conhecidas como cookies, cabendo ao USUÁRIO configurar seu navegador de Internet caso deseje bloqueá-los. Nesta hipótese, o Sistema não funcionará.

1.4. A TROQUECOMMERCE LTDA também poderá utilizar tecnologias para coletar dados de comportamento dos USUÁRIOS visitando as páginas, sendo que nesse caso a instalação de arquivos nos equipamentos poderá não ser necessária.

1.5. Outras tecnologias poderão ser utilizadas para a obtenção de dados de navegação do USUÁRIO, respeitando sempre os termos desta Política e as opções do USUÁRIO a respeito de sua coleta e armazenamento.

1.6. A TROQUECOMMERCE LTDA não é responsável pela veracidade das informações prestadas pelo USUÁRIO ou pela sua desatualização, sendo de responsabilidade do USUÁRIO prestá-las com exatidão ou atualizá-las.

1.7. As informações que a TROQUECOMMERCE LTDA coletará incluem, mas não se limitam, a:

- CPF;
- nome;
- data de nascimento;
- país;
- nacionalidade;
- sexo;
- endereço de e-mail;
- endereço físico, incluindo CEP;
- número de telefone;
- data das transações realizadas pelo USUÁRIO;
- valor total das transações realizadas pelo USUÁRIO;
- itens dos pedidos realizados pelo USUÁRIO;
- descrição dos itens dos pedidos realizados pelo USUÁRIO;
- tipo da entrega solicitada pelo USUÁRIO;
- data e hora do acesso;
- sistema operacional;
- tipo de dispositivo;
- aplicação de acesso à internet, navegador (browser);
- tempo de acesso nas plataformas;
- Número do pedido;
- Número do rastreio do pedido;
- Dados da transportadora do pedido;

Obtemos os dados dos USUÁRIOS nos exatos termos descritos nesta Política de privacidade e para as finalidades nele indicadas.

### 2. UTILIZAÇÃO DOS DADOS

A TROQUECOMMERCE. automatiza o autoatendimento de demandas ligadas ao pós-vendas dos e-commerces, com o objetivo de permitir ao consumidor monitorar suas compras, efetuar de forma autônoma solicitações ligadas a processo de trocas e devoluções de produtos adquiridos nas lojas cadastradas na TROQUECOMMERCE LTDA.

A TROQUECOMMERCE LTDA, utiliza ferramentas próprias e de terceiros para obter estatísticas e métricas a respeito dos perfis dos Usuários do Sistema e da forma como a Plataforma vem sendo utilizada. Tais dados são aplicados no aprimoramento do software e do conteúdo da Plataforma, bem como na identificação de erros de programação que possam afetar a sua utilização;

Para a execução da finalidade do Sistema, ou seja, permitir que o USUÁRIO devolva mercadorias adquiridas em lojas virtuais, as Informações Pessoais destinadas à identificação pessoal do Usuário, além das informações do endereço escolhido para a entrega, coleta e/ou retirada de mercadorias, serão compartilhadas com as respectivas empresas transportadoras, com as lojas virtuais e com os pontos de retirada.

2.1. Ao utilizar o Sistema, ainda, para a execução das finalidades previstas acima, as Informações Pessoais podem ser processadas através de ferramentas de tecnologia de titularidade de empresas terceiras, incluindo, mas não se limitando a: Amazon Web Services, Google Analytics, SendGrid, dentre outros.

2.1.1 Ao utilizar o Sistema, o USUÁRIO está de acordo em receber comunicações, alertas importantes, status do transporte da mercadoria adquirida, resposta de questionamentos dos USUÁRIOS e pesquisas, através de: (i) e-mail de cadastro, (ii) App (notificações push), (iii) SMS e (iv) aplicações de mensagens instantâneas, como por exemplo WhatsApp. Tais informações têm como finalidade monitorar, devolver, trocar e avaliar compras/produtos das lojas virtuais, aperfeiçoando e simplificando o processo de atendimento pós-vendas de consumidores online, bem como colaborando para melhorar a experiência de compras na Internet. O USUÁRIO está de acordo, ainda, em receber comunicações, mensagens promocionais e pesquisas sazonais. Tais informações têm o objetivo de entender o comportamento de compra do USUÁRIO em datas sazonais da TROQUECOMMERCE LTDA, parceiros de negócios e das empresas pertencentes ao mesmo grupo econômico.

2.2. Os dados coletados dos USUÁRIOS poderão, também, ser utilizados para as seguintes finalidades:

- Aperfeiçoar o uso, experiência e serviços prestados pela TROQUECOMMERCE LTDA e pelas empresas pertencentes ao mesmo grupo econômico;
- Criar e manter a base de dados dos USUÁRIOS para as finalidades descritas nesta Política, podendo ser compartilhada com as empresas do mesmo grupo econômico;
- Atender adequadamente às solicitações e dúvidas dos USUÁRIOS;
- Manter atualizados os cadastros dos USUÁRIOS para fins de contato por telefone, correio eletrônico (e-mail), SMS, aplicações de mensagens instantâneas, mala direta ou por outros meios de comunicação;
- Efetuar, de forma anonimizada, levantamentos estatísticos, estudos, pesquisas e demais levantamentos pertinentes às atividades e aos comportamentos dos USUÁRIOS;
- Promover os serviços da TROQUECOMMERCE LTDA e das empresas pertencentes ao mesmo grupo econômico, além de informar sobre novidades, funcionalidades, conteúdos, notícias e demais informações relevantes;
- Resguardar a TROQUECOMMERCE LTDA de direitos e obrigações relacionadas ao uso das plataformas e/ou sites;
- Colaborar e/ou cumprir ordem judicial ou requisição por autoridade administrativa;
- Compartilhar e ceder os dados coletados de forma anonimizada para as Lojas Cadastradas e Parceiros de negócios da TROQUECOMMERCE LTDA, para a finalidade específica de realizar estudos adicionais;

2.3. A base de dados formada por meio da coleta de dados pessoais informada na cláusula 1.2 é de propriedade e responsabilidade da TROQUECOMMERCE LTDA., e não será comercializada e/ou alugada para terceiros, podendo ser compartilhada com as empresas pertencentes ao mesmo grupo econômico, prestadores de serviços, transportadoras, lojas virtuais e parceiros de negócios, nos limites previstos nesta Política.

2.3.1. O USUÁRIO é corresponsável pelo sigilo de suas informações, e não poderá compartilhar suas senhas e demais informações de acesso.

2.4. Desde já o USUÁRIO está ciente que a TROQUECOMMERCE LTDA poderá realizar o enriquecimento de sua base de dados, adicionando informações oriundas de outras fontes, manifestando seu consentimento livre, expresso e informado com essa atividade ao concordar com os termos da presente Política de Privacidade.

2.5. Internamente os dados somente serão acessados por profissionais devidamente autorizados pela TROQUECOMMERCE LTDA e, se necessário, pelos profissionais autorizados de empresas do mesmo grupo econômico, dentro dos limites legais e respeitando os princípios de proporcionalidade, necessidade e relevância para os objetivos da TROQUECOMMERCE LTDA., além do compromisso de confidencialidade e preservação da privacidade nos termos desta Política de Privacidade.

### REGISTRO DE ATIVIDADES

3.1. A TROQUECOMMERCE LTDA., poderá registrar as atividades efetuadas pelo USUÁRIO criando, quando possível e aplicável, logs que poderão conter:

1. Endereço IP do USUÁRIO;
2. Ações efetuadas pelo USUÁRIO;
3. Páginas acessadas pelo USUÁRIO;
4. Datas e horários de cada ação do USUÁRIO, além do acesso que fizer às páginas e telas das ferramentas e funcionalidades que utilizar;
5. Informações sobre o dispositivo utilizado pelo USUÁRIO, versão de sistema operacional, localização do dispositivo, navegador, dentre outros aplicativos e softwares instalados;
6. Session e User ID, quando disponível.

3.2. Outras tecnologias poderão ser utilizadas para a obtenção de dados de navegação do USUÁRIO, no entanto, respeitarão sempre os termos desta Política de Privacidade e as opções do USUÁRIO a respeito de sua coleta e armazenamento.

### ARMAZENAMENTO DOS DADOS

4.1. Os dados coletados serão armazenados em ambiente seguro e controlado. A TROQUECOMMERCE LTDA se exime de quaisquer responsabilidades por eventuais danos e/ou prejuízos decorrentes de acessos não autorizados ocasionados por falhas, vírus ou quaisquer outras técnicas de invasão do banco de dados do Sistema , salvo nos casos em que tiver dolo ou culpa, observado o estado da técnica disponível.

4.2. Os dados obtidos do USUÁRIO poderão ser armazenados em servidor próprio da TROQUECOMMERCE LTDA ou de terceiro contratado para esse fim, sejam eles alocados no Brasil ou no exterior, podendo ainda ser armazenados em nuvem (cloud computing) e/ou outras que surjam futuramente, visando sempre a melhoria e aperfeiçoamento das atividades da TROQUECOMMERCE LTDA.

4.3. Quando os dados forem armazenados em servidores localizados no exterior, a TROQUECOMMERCE LTDA se compromete a respeitar todos os requisitos de transferência internacional de dados pessoais previstos na Lei Geral de Proteção de Dados e demais legislações vigentes.

4.4. A TROQUECOMMERCE LTDA poderá, para fins de auditoria e preservação de direitos, permanecer com o histórico de registro dos dados do USUÁRIO por períodos superiores a 5 (cinco) anos, podendo excluí-los definitivamente segundo sua conveniência em prazo menor. Este prazo poderá ser estendido nas hipóteses em que a lei ou norma regulatória assim estabelecer, para atendimento a ordens judiciais ou para preservação de direitos.

### DISPOSIÇÕES GERAIS

5.1. O teor desta Política de Privacidade poderá ser atualizado ou modificado a qualquer momento, para esclarecer qualquer alteração nas regras da TROQUECOMMERCE LTDA. , ou para adequação e conformidade legal de disposição de lei ou norma que tenha força jurídica equivalente. Nestes casos, o USUÁRIO será notificado a respeito das mudanças para demonstrar seu consentimento com as alterações.

5.2. O USUÁRIO deverá entrar em contato em caso de qualquer dúvida com relação às disposições constantes desta Política de Privacidade por meio da Central de Suporte disponível no comercial@troquecommerce.com.br

5.3. Visando oferecer maior segurança aos dados dos USUÁRIOS, as empresas terceirizadas que porventura vierem a tratar quaisquer dados pessoais coletados pela TROQUECOMMERCE LTDA deverão obrigatoriamente respeitar as condições aqui estipuladas, a Lei Geral de Proteção de Dados Pessoais e as normas de segurança da informação da TROQUECOMMERCE LTDA

5.4. Caso alguma disposição desta Política de Privacidade seja considerada ilegal ou ilegítima por autoridade da localidade em que o USUÁRIO resida (ou da localidade de sua conexão à Internet), as demais condições permanecerão em pleno vigor e efeito.

### SEGURANÇA DA INFORMAÇÃO

6.1. Nós utilizamos medidas razoáveis, organizacionais, técnicas e administrativas para proteger informações sob nosso controle. Vale ressaltar que nenhuma transmissão de dados através da internet ou sistema de armazenamento de dados pode ser garantida como 100% segura. Se o USUÁRIO identificar razões para acreditar que sua interação conosco não é mais segura (por exemplo, sinais de que a segurança de qualquer conta conosco esteja comprometida), por favor, nos notifique imediatamente a respeito do problema.

### SITES DE TERCEIRO

7.1. Esta Política de Privacidade não contempla sites de terceiros. Não somos responsáveis pela privacidade, informações ou outras práticas de qualquer terceiro, incluindo qualquer terceiro operando qualquer site, ainda que acessível via link em nosso Site. A inclusão de um link no Site não implica endosso desse site por nós ou por nossas afiliadas.

### LEI APLICÁVEL E JURISDIÇÃO

8.1. A presente Política de Privacidade será interpretada segundo a legislação brasileira, no idioma português, sendo eleito o foro do domicílio do USUÁRIO para dirimir qualquer litígio ou controvérsia envolvendo o presente documento, salvo ressalva específica de competência pessoal, territorial ou funcional pela legislação aplicável.

Data da última atualização: 09/05/2022.

## API pública

Fonte: https://www.troquecommerce.com.br/docs

API - Troquecommerce, versão 1.0.0.
Base da API: https://www.troquecommerce.com.br/api/public

Token no header `token` em todas as chamadas (ex.: `token: 99999z99-aaaa-bbbb-cccc-999999999999`). Gere em **Painel > Automações > Tokens de API**. Níveis: **READ** (GETs) · **WRITE** (POSTs/PUTs/DELETEs) · **CREATE_REVERSE** (POST `/order/create`: solicite a habilitação ao time de suporte da Troquecommerce).

### Fluxo típico de uma reversa

| # | Ação | Endpoint |
|---|---|---|
| 1 | Listar pendentes | `GET /order/list` |
| 2 | Buscar detalhes | `GET /order` |
| 3 | Registrar rastreio | `POST /order/tracking` |
| 4 | Receber itens | `POST /order/receive` |
| 5 | Registrar NFD | `POST /order/invoice` |
| 6 | Estorno/cupom | `POST /order/return` |
| 7 | Comprovante (opcional) | `POST /order/refund/proof/url` ou `/file` |
| 8 | Marcar como processada (opcional) | `POST /order/check` |

### Rate limit

**40 requisições a cada 10 segundos**, contadas **por token de API** (não por IP e não por endpoint). Todos os endpoints compartilham o mesmo contador do token; tokens diferentes têm contadores independentes.

Ao estourar o limite a API responde `429 Too Many Requests` com o corpo `{"error": {"message": "API rate limit exceeded for ..."}}`.

A resposta `429` traz os headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset` (timestamp Unix, em segundos, de quando a janela zera). Esses headers não são enviados nas respostas de sucesso.

A janela é fixa de 10 segundos e o contador zera por completo ao virar. Recomendamos manter até ~4 req/s e, ao receber `429`, aguardar até o `X-RateLimit-Reset` antes de repetir a chamada. Para um limite maior, fale com o suporte da Troquecommerce.

Datas em ISO 8601 · IDs em UUID v4 · valores monetários como `number` decimal · documentos/CEP só dígitos.

### Grupos

- Reversas: Endpoints para gerenciar o ciclo de vida de reversas (trocas/devoluções): consulta, recebimento de itens, registro de rastreio, emissão/registro de NFD, registro de estornos e comprovantes.
- Pontos de Devolução: Endpoints para gerenciar endereços de Pontos de Devolução da loja (Centro de Distribuição, lojas físicas, endereço de cobrança). Usados como destino das reversas.
- Exceções: Endpoints para cadastrar exceções de pedido. A exceção libera o cliente a abrir uma reversa de um pedido que as regras da loja barrariam, como o prazo de troca expirado.

### Reversas

#### GET /order

**Busca os detalhes de uma reversa pelo ID**

Retorna o objeto completo de uma reversa: itens, cliente, rastreamento, faturas, histórico de eventos, cupons e detalhes do estorno. O ID é o UUID v4 da reversa na Troquecommerce.

#### POST /order/create

**Cria uma nova reversa para um pedido**

**Permissão obrigatória:** este endpoint exige um token com nível de acesso `CREATE_REVERSE`. Solicite a habilitação ao time de suporte da Troquecommerce (`suporte@troquecommerce.com.br`).

Cria uma reversa (troca ou devolução) a partir de um pedido já existente no e-commerce.

##### Como funciona

- O pedido é localizado pelo `ecommerce_number`. O sistema busca os dados (cliente, endereço, itens) na plataforma do e-commerce vinculada ao token.
- `items[]` é obrigatório e define quais SKUs entram na reversa. Cada SKU deve existir no pedido original. Itens omitidos no array não fazem parte da reversa (suporta reversa parcial).
- A aprovação automática segue as regras configuradas no painel da loja (Painel > Regras). Itens com defeito/foto, restrições por seller, valor mínimo, etc., podem deixar a reversa em análise.
- `client_tracking_request` é opcional. Quando omitido, a Troquecommerce cota a logística reversa automaticamente. Quando informado, respeita a escolha do cliente.
- Dados pessoais (`client`, `address`, `payment_bill`) também são opcionais: usados apenas quando você quer sobrescrever os dados vindos do pedido (ex.: PIX diferente, endereço de coleta alternativo).

##### Erros de validação

Payloads inválidos retornam `400` com `errors[]` listando TODOS os problemas detectados (motivo não cadastrado nas regras da loja, prazo expirado, quantidade que excede o disponível, foto obrigatória ausente, dados bancários incompletos, etc.). Veja o schema da resposta `400` abaixo.

#### POST /order/approve

**Aprova uma reversa que está em análise**

Aprova uma reversa no status `Em Análise`: cria a logística reversa, atualiza o status e envia ao cliente o e-mail de aprovação. O `shipping_company_id` do corpo escolhe o modo, como os botões do painel:
- `2`, `3`, `5`, `6`, `7`, `10`, `11` ou `12` (Aprovar pedido): usa a opção de envio que o cliente escolheu ao abrir a solicitação; o número enviado não troca a transportadora. Em loja cuja transportadora padrão é a personalizada, use o modo `1`: sem opção do cliente, esses valores respondem `500`. A reversa vai para `Aguardando Envio` (ou `Aguardando Recebimento`, se a logística for Loja física ou Envio pelo cliente).
- `4` (Aprovar sem envio): a reversa vai para `Aguardando Pagamento`, ou `Aguardando NF Devolução` se a loja usa NFD. Diferente do botão do painel, não marca os itens como recebidos; depois disso, o `POST /order/receive` só aceita a reversa quando ela fica em `Aguardando NF Devolução` (loja com NFD).
- `9` (Aprovar cliente pagando o frete): a reversa vai para `Aguardando Recebimento`. Aceita `delivery_address_id` para escolher o ponto de devolução.
- `1` (transportadora personalizada): exige transportadora personalizada cadastrada e ativa na loja e aceita `posting_address`, `posting_code` e `delivery_address_id`.

`shipping_company_name` é opcional: sem ele, a API usa o nome padrão do modo. Outros valores de `shipping_company_id` (ex.: `13` Loggi) respondem `400`. Sem corpo, a aprovação usa o modo da transportadora padrão da loja (padrão fora da lista, como Loggi ou Jadlog, responde `400`); `Content-Type: application/json` com corpo vazio também responde `400`. Reversa fora de `Em Análise` retorna `403`.

#### GET /order/list

**Lista reversas com paginação e filtros**

Retorna uma lista paginada de reversas, com filtros por status, intervalo de datas, cliente, código de rastreio e mais. Use `unchecked_by_integration=true` para polling incremental (recupera apenas reversas ainda não processadas pela sua integração). A página começa em 1.

#### POST /order/receive

**Registra o recebimento físico dos itens de uma reversa**

Marca os itens de uma reversa como recebidos no destino (CD/loja), opcionalmente notificando o cliente e registrando a NFD no mesmo payload. Forneça `id` (UUID da reversa) **OU** `order_number` (número do pedido na plataforma): se ambos forem enviados, `id` tem prioridade.

#### POST /order/tracking

**Registra eventos de rastreio da reversa**

Registra um evento de rastreamento da reversa (coleta no cliente ou entrega no destino). Use `event.status=COLLECTED` quando a transportadora coletou ou o cliente postou; use `event.status=DELIVERED` quando o pacote chegou ao destino (CD/loja). Opcionalmente envie dados do pacote (transportadora, código de rastreio, data prevista, NFD).

#### POST /order/invoice

**Registra ou gera uma Nota Fiscal de Devolução (NFD)**

Esta API tem dois modos de operação controlados pelo parâmetro `integrated`:

- **`integrated=false` (ou omitido)**: apenas registra uma NFD já emitida no ERP da loja. Use `invoice_list` (array de números/DANFE) **OU** `invoices` (array de objetos com `reference`, `date`, `serie`, `danfe`).
- **`integrated=true`**: a Troquecommerce solicita ao ERP da loja a emissão da NFD. Use `sales_invoice` (objeto OrderSalesInvoice com dados da NF original) **e** `devolution_items` (array com os itens a serem devolvidos).

#### GET /order/invoice

**Consulta a Nota Fiscal de Venda do pedido original**

Consulta no ERP da loja os detalhes da NF de Venda associada a um pedido. Útil para obter a NF original que servirá de base para uma NFD. Forneça pelo menos um dos parâmetros: `ecommerce_number`, `invoice_number`, `customer_email` ou `customer_document`.

#### POST /order/return

**Registra estorno e/ou cupom gerados externamente**

Registra na Troquecommerce o resultado de um estorno financeiro (`REFUND`) e/ou de um cupom de troca (`EXCHANGE`) gerados externamente pelo sistema da loja. Aceita múltiplos retornos no mesmo payload (ex.: parte do valor como cupom, parte como estorno).

#### POST /order/refund/proof/file

**Envia o arquivo de um comprovante de estorno**

Faz upload do arquivo de um comprovante de estorno (PDF ou imagem, até 4 MB) para uma reversa que já tenha um estorno registrado (`reverse_payment`). O arquivo é armazenado no S3 da Troquecommerce; para recuperá-lo depois use `GET /order/refund/proof/url`, que devolve uma URL pré-assinada válida por 15 minutos (`source: "s3"`). Alternativa a este endpoint: `POST /order/refund/proof/url`, que registra uma URL externa em vez de subir o arquivo. Cada reversa aceita apenas um comprovante; se já houver um registrado, a requisição é rejeitada.

#### GET /order/refund/proof/url

**Obtém a URL do comprovante de estorno**

Retorna a URL do comprovante de estorno vinculado à reversa. Se o comprovante foi enviado como arquivo (`POST /order/refund/proof/file`), a Troquecommerce gera uma URL pré-assinada do S3 válida por **15 minutos** (`source: "s3"`, `expires_at` preenchido). Se foi registrada uma URL externa (`POST /order/refund/proof/url`), ela é devolvida como está (`source: "external"`, `expires_at: null`).

#### POST /order/refund/proof/url

**Registra a URL de um comprovante de estorno**

Anexa a URL pública de um comprovante de estorno (PDF, imagem) a uma reversa que já tenha um estorno registrado (`reverse_payment`). A URL deve ser publicamente acessível pela equipe Troquecommerce e pelo cliente (sem autenticação obrigatória): recomenda-se um link de armazenamento próprio da loja (S3, GCS, etc.).

#### POST /order/check

**Marca reversas como verificadas pela integração**

Marca um conjunto de reversas como já processadas pela sua integração (`integration_checked = true`). Funciona em conjunto com o filtro `unchecked_by_integration` do `GET /order/list`: após processar uma página de reversas pendentes, chame este endpoint com os IDs delas para que não voltem na próxima consulta.

#### POST /order/comment

**Adiciona um comentário a uma reversa**

Adiciona um comentário interno a uma reversa existente. Opcionalmente, anexa um arquivo informando a URL pública completa do arquivo já hospedado pela loja (`attach_file_url`).

Com `is_pending: true` o comentário é registrado como **pendência interna** da reversa, o mesmo recurso do painel: a reversa passa a aparecer no filtro de pendência interna da listagem até a pendência ser encerrada pelo painel (a API não encerra pendência). Só é aceita uma pendência interna em aberto por reversa; comentário comum continua permitido com pendência aberta. `pending_type_id` classifica a pendência; os tipos aceitos variam por loja e, em caso de id inválido, a resposta 400 lista os ids disponíveis. O comentário criado pela API aparece com autor `Sistema` (`created_by.email`); quando ele abre uma pendência interna, `pending.opened_by` vem `null`.

#### POST /order/return-point

**Altera o ponto de devolução de uma reversa**

Troca a loja física de destino de uma reversa já aprovada, útil quando o cliente escolheu entregar em uma loja e acabou entregando em outra. Atualiza o ponto retornado em `tracking.organisation_address` (incluindo o `seller_id`) e o texto em `tracking.posting_address`.

**Restrições:**

- Só vale para reversas com devolução em loja física. Reversas com etiqueta de transportadora (Correios, Loggi, Jadlog, etc.) retornam `400`.
- Só é permitido enquanto a reversa não tiver NFD registrada. Depois da nota, retorna `400`.
- Reversas canceladas retornam `400`.
- O `organisation_address_id` precisa ser uma loja física da própria loja. Consulte as opções em `GET /organisation/address?physical_store_options=true`.

A alteração fica registrada no histórico da reversa como "Ponto de devolução alterado" e dispara o webhook da loja, quando configurado.

#### POST /email/resend

**Reenvia ao consumidor o e-mail com as instruções de envio**

Reenvia ao consumidor o último e-mail com as instruções de envio do produto (postagem ou coleta) que a reversa recebeu, montado com os dados atuais do rastreio. Só funciona enquanto a reversa aguarda o envio do produto (status `Aguardando Envio` ou `Aguardando Recebimento`). O reenvio fica registrado no histórico da reversa em nome do token.

### Pontos de Devolução

#### GET /organisation/address

**Lista ou consulta endereços de pontos de devolução**

Retorna os endereços cadastrados pela loja. Sem filtros, retorna um array com todos os endereços. Com `address_type=Cobrança` ou `use_default_address=true`, retorna um único objeto (não array).

#### POST /organisation/address

**Cria um endereço de ponto de devolução**

Cadastra um novo endereço para receber reversas (CD, loja física, ou outro tipo). Use `same_address=true` para reaproveitar o endereço principal da loja sem cadastrar um novo. Use `auto_setup=true` para marcar o setup de endereço como concluído após o cadastro.

#### PUT /organisation/address

**Atualiza um endereço de ponto de devolução**

Atualiza um endereço existente. Envie o `id` do endereço no body junto com os campos a serem atualizados. Requer token com nível de acesso WRITE.

#### DELETE /organisation/address

**Remove um endereço de ponto de devolução**

Remove o endereço de ponto de devolução identificado por `address_id`. Requer token com nível de acesso WRITE.

### Exceções

#### POST /exception/create

**Cria uma exceção para um pedido**

Cria uma exceção para um pedido, o mesmo recurso da tela **Exceções** do painel. Enquanto a exceção vale (até `end_date`), o cliente consegue abrir troca ou devolução desse pedido na Central de Trocas mesmo fora do prazo configurado pela loja ou com o pedido em um status que a loja não aceita. Ele também pode abrir uma nova solicitação para um pedido que já teve reversa, com os itens que ainda não estão em outra reversa, desde que nenhuma reversa desse pedido esteja Em análise. Requer token com nível de acesso WRITE.

- A API não consulta a plataforma de e-commerce. Ela grava o `number` exatamente como enviado e não confirma se o pedido existe. Envie sem `#` e sem espaços: o painel remove o `#` e os espaços das pontas ao cadastrar, a API não remove nada. A Central de Trocas só libera o pedido quando o número cadastrado é idêntico ao do pedido.
- Cada pedido aceita uma exceção cadastrada por vez. Se já existir uma para o mesmo número que não foi removida no painel, a criação é recusada, mesmo que a exceção existente já tenha vencido.
- A exceção criada pela API aparece na tela **Exceções** do painel com o nome do token como autor.

**Atenção: os erros desta rota voltam com HTTP `200` e o corpo `{ "error": "<mensagem>" }`.** Confira o corpo da resposta: se veio `id`, a exceção foi criada; se veio `error`, ela foi recusada.

### Especificação completa

Parâmetros, esquemas de request e response e exemplos: https://www.troquecommerce.com.br/swagger/bundled.json

## Servidor MCP

Fonte: https://www.troquecommerce.com.br/docs/mcp

MCP - Troquecommerce, versão 0.6.0.
Endereço do servidor MCP: https://www.troquecommerce.com.br/api/mcp

Header `Authorization: Bearer` em todas as chamadas (ex.: `Authorization: Bearer 99999z99-aaaa-bbbb-cccc-999999999999`). O token de MCP é criado pela Troquecommerce, com a permissão de cada ferramenta: solicite ao time de suporte. O token da API pública não abre o MCP, e o token de MCP não abre a API pública.

O MCP (Model Context Protocol) é o padrão aberto que permite a um assistente de IA usar as ferramentas da Troquecommerce em nome da loja: localizar o pedido, consultar a retenção, cotar a logística reversa, criar a reversa e consultar o status, com as mesmas regras da Central de Trocas e do painel. As ferramentas não são endpoints HTTP: quem chama é o cliente MCP, pelo método `tools/call`, sempre em `POST https://www.troquecommerce.com.br/api/mcp`. O caminho mostrado em cada ferramenta é só o identificador dela.

### Fluxo típico de uma reversa

| # | Ação | Ferramenta |
|---|---|---|
| 1 | Localizar pedido | `prepare_reverse_order` |
| 2 | Cliente escolhe itens, tipo de solicitação e motivo | conversa |
| 3 | Consultar retenção | `get_retention_offer` |
| 4 | Cotar logística reversa | `quote_return_shipping` |
| 5 | Criar reversa | `create_reverse_order` |
| 6 | Consultar status | `track_reverse_order` |
| 7 | Listar reversas (equipe) | `list_reverse_orders` |
| 8 | Buscar detalhes (equipe) | `get_reverse_order` |

A ordem dos passos 1 a 5 é fixa. Aceitar a retenção transforma a devolução em troca, e isso muda as opções de logística reversa: por isso a retenção vem antes da cotação. O fluxo termina antes quando a ferramenta disser: pedido que a loja não aceita para no passo 1, e cotação sem opção que o cliente possa escolher segue para o passo 5 sem o bloco `shipping`.

### Permissões

Cada token de MCP carrega uma lista de permissões, e cada permissão abre uma ferramenta. Sem a permissão, a ferramenta responde `FORBIDDEN`. O servidor só lista as ferramentas liberadas pelas permissões do token: as demais não aparecem para o assistente.

| Conjunto | Para quê | Permissões |
|---|---|---|
| Cliente só acompanha | O chat só consulta o status de reversas já abertas | `reverse.track` |
| Cliente abre e acompanha | O chat cria a reversa e depois consulta o status | `reverse.prepare`<br>`retention.read`<br>`shipping.quote`<br>`reverse.create`<br>`reverse.track` |
| Operador da loja | Para a equipe: cria reversas e consulta todas as reversas da loja | todas |
| Consulta interna | Para a equipe só consultar as reversas da loja | `reverse.list`<br>`reverse.read` |

**Canal público só com as ferramentas de Atendimento ao consumidor.** Elas pedem o número do pedido mais o CPF, CNPJ ou e-mail do cliente e só enxergam aquele pedido. `reverse.list` e `reverse.read` leem todas as reversas da loja sem essa conferência: são para a equipe, nunca para chat do site ou WhatsApp. Retenção, cotação e criação exigem `reverse.prepare`.

### Como conectar

Qualquer cliente que fale MCP por HTTP usa o mesmo endereço e o mesmo header.

**Claude Code**

```bash
claude mcp add --transport http troquecommerce https://www.troquecommerce.com.br/api/mcp --header "Authorization: Bearer SEU-TOKEN"
```

**Cursor** (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "troquecommerce": {
      "url": "https://www.troquecommerce.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer SEU-TOKEN"
      }
    }
  }
}
```

**VS Code com Copilot** (`.vscode/mcp.json`)

```json
{
  "servers": {
    "troquecommerce": {
      "url": "https://www.troquecommerce.com.br/api/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer SEU-TOKEN"
        }
      }
    }
  }
}
```

**claude.ai e o aplicativo de desktop:** em Conectores, adicione um conector personalizado com a URL acima, autenticação `Nenhum` e, em Cabeçalhos de requisição, o nome `Authorization` com o valor `Bearer SEU-TOKEN`. A autenticação por cabeçalho ainda está em beta na Anthropic e pode não aparecer em toda conta. Para trocar o token, remova o conector e crie outro.

**ChatGPT:** o aplicativo ainda não conecta, porque o conector dele só oferece login OAuth ou nenhuma autenticação. Pela API da OpenAI já conecta: a ferramenta de MCP de lá aceita o cabeçalho `authorization`.

### Erros

Erro de ferramenta chega com `isError: true` e um JSON com `error_code` e `message` (em inglês, escrita para o assistente). Na criação o JSON traz também `created`. Campo com formato inválido é recusado antes, como erro de validação do protocolo, e token inválido ou ausente responde HTTP `401`.

| Código | O que aconteceu e o que fazer |
|---|---|
| `FORBIDDEN` | O token não tem a permissão da ferramenta. Não insista. A permissão é dada no token, pela Troquecommerce. |
| `ORDER_NOT_FOUND` | Pedido não encontrado, ou o CPF, CNPJ ou e-mail não é do cliente do pedido. Peça para o cliente conferir os dois dados. |
| `ORDER_NOT_ELIGIBLE` | A loja não aceita reversa para o pedido: prazo expirado, situação não autorizada ou nenhum item disponível. Informe o motivo que veio na mensagem e encerre. |
| `VALIDATION_FAILED` | Item, quantidade, motivo, foto, comentário ou endereço inválido. A resposta traz o que é válido. Corrija com o cliente e chame de novo. |
| `ADDRESS_NOT_EDITABLE` | A loja não permite alterar o endereço na Central de Trocas. Siga com o endereço do pedido, sem enviar `address`. |
| `ALREADY_HAS_ACTIVE_REVERSE` | O pedido já tem reversa ativa e a loja não permite segunda solicitação. Informe o cliente e ofereça a consulta de status. |
| `DUPLICATE_SUSPECTED` | Já existe reversa deste pedido criada nos últimos 10 minutos. Confira `existing_reverses` antes de tentar de novo. |
| `RETENTION_NOT_AVAILABLE` | Veio aceite de retenção para um pedido sem retenção disponível. Chame `get_retention_offer` de novo e siga o que ela retornar. |
| `RETENTION_LEVEL_NOT_AVAILABLE` | Veio um nível de retenção que a loja não oferece. Chame `get_retention_offer` de novo e use um nível da lista. |
| `RETENTION_OFFER_CHANGED` | O cliente aceitou retenção com bônus e escolheu uma entrega em loja física que a loja fecha em vale-compras sem bônus. Chame `get_retention_offer` com o `shipping_company_id` escolhido e confirme de novo com o cliente. |
| `TEMPORARY_FAILURE` | Falha temporária ao ler a loja ou a plataforma de e-commerce. Tente de novo em alguns segundos. |
| `CREATION_UNCONFIRMED` | Não foi possível confirmar se a reversa foi criada. Não repita a criação. Confira antes com `prepare_reverse_order`. **Pode ter sido criada.** |
| `CREATED_WITH_ERRORS` | A reversa foi criada, mas um passo seguinte falhou. Informe ao cliente que a solicitação foi registrada. A loja resolve pelo painel. **A reversa foi criada.** |

### Rate limit

**70 requisições a cada 10 segundos**, contadas **por IP** (não por token e não por ferramenta). Todos os tokens que saem do mesmo IP compartilham o mesmo contador. Ao estourar o limite a resposta é `429 Too Many Requests`. Para um limite maior, fale com o suporte da Troquecommerce.

### Convenções

| Campo | Formato |
|---|---|
| Datas | ISO 8601, salvo onde o campo disser outro formato |
| IDs | UUID v4 |
| Valores monetários | `number` decimal, na moeda do pedido |
| Documentos e CEP | Só dígitos |
| Status e motivos | Em português, com o texto que a loja configurou |

### Grupos

- Atendimento ao consumidor: Ferramentas para o chat com o cliente. Cada chamada exige o número do pedido mais o CPF, CNPJ ou e-mail do cliente, e só enxerga aquele pedido.
- Operação interna da loja: Ferramentas para a equipe da loja. Leem todas as reversas da loja, com os dados do cliente seguindo a regra de visibilidade do painel. Não use em chat aberto ao público.

### Atendimento ao consumidor

#### prepare_reverse_order

**Localiza o pedido e os itens disponíveis para reversa**

**Ferramenta:** `prepare_reverse_order` · **Permissão:** `reverse.prepare`

É a primeira chamada do fluxo, equivalente a **Localizar Pedido** na Central de Trocas. Retorna se a loja aceita abrir reversa para o pedido agora, os itens disponíveis, os motivos que o cliente pode escolher e as reversas já abertas.

Lê o pedido ao vivo na plataforma de e-commerce e atualiza a cópia interna dele. Não cria reversa e não envia e-mail.

- Quando `eligible` é false, use `ineligibility_message`: é o mesmo texto que o cliente leria na Central de Trocas.
- O texto de `reasons[].reason` é a chave do motivo. As outras ferramentas exigem esse texto exato.
- Os prazos já vêm aplicados: motivo listado é motivo que o cliente ainda pode usar. Não recalcule prazo.

#### get_retention_offer

**Consulta a retenção da loja para os itens em devolução**

**Ferramenta:** `get_retention_offer` · **Permissão:** `retention.read`

Verifica se a loja tem **retenção ativa** para este pedido e qual oferta vale para os itens em devolução: o vale-compras com bônus que o cliente pode receber no lugar do reembolso. Usa as mesmas regras da Central de Trocas: retenção configurada e ativa, ao menos um item em devolução, cliente elegível e limite de retenções da loja.

Chame depois de o cliente escolher itens e motivos, e **antes** de `quote_return_shipping`: aceitar a retenção transforma os itens em troca, e isso muda as opções de logística reversa.

- `mode` `offer`: apresente a oferta uma vez e registre a resposta. `automatic` e `forced`: a loja já fecha a devolução em vale-compras, só informe. `none`: não toque no assunto.
- A oferta de `level` 2 é a 2ª tentativa de retenção: só existe quando vem na lista, e só depois de o cliente recusar a 1ª.
- A decisão do cliente segue em `retention_accepted` na cotação e em `retention` na criação.

#### quote_return_shipping

**Cota a logística reversa para os itens selecionados**

**Ferramenta:** `quote_return_shipping` · **Permissão:** `shipping.quote`

Retorna as opções de logística reversa que a loja oferece para os itens e motivos escolhidos: postagem, coleta ou entrega em ponto de devolução. A cotação depende da escolha do cliente, porque a coleta e as regras por motivo variam conforme os itens.

É a chamada mais cara do fluxo: lê o pedido ao vivo e cota, uma a uma, as transportadoras ativas da loja, sem cache. Chame só depois da retenção, quando o cliente já decidiu o que volta e por quê.

- Ofereça ao cliente só as opções com `can_be_chosen` true.
- Lista vazia é resposta válida: siga para a criação sem o bloco `shipping`, e a loja contrata a logística pelo painel.
- Aqui o motivo vai em `reason.description`. Em `get_retention_offer` ele vai em `reason_description`.

#### create_reverse_order

**Cria uma nova reversa para o pedido**

**Ferramenta:** `create_reverse_order` · **Permissão:** `reverse.create`

Cria a reversa pelo mesmo caminho do `POST /order/create` da API: aplica a **aprovação automática** da loja, contrata a logística reversa quando aprova e envia o e-mail ao cliente na mesma chamada. Não tem modo de teste e não dá para desfazer por aqui.

Chame só depois de o cliente aprovar um resumo do que volta, por quê e como chega à loja. `confirm` tem que ser true.

- `shipping` leva o `shipping_company_id` e o `is_collect` da opção escolhida na cotação. Opção com `can_be_chosen` false nunca entra: para ela, omita o bloco.
- Omitir `shipping` não contrata Correios: a loja usa a transportadora padrão dela. Para Correios, envie o ID 2 com o `is_collect` da opção escolhida.
- Resposta incerta (`CREATION_UNCONFIRMED` ou tempo esgotado): confira `existing_reverses` em `prepare_reverse_order` antes de tentar de novo.
- A requisição recebida fica registrada no **histórico** da reversa criada, com os parâmetros enviados e o token que os enviou.

| `outcome` | O que aconteceu |
|---|---|
| `approved_with_shipping` | Aprovação automática, com a logística reversa contratada. |
| `approved_without_shipping` | Aprovação automática com opção que não contrata transportadora (entrega em loja física ou envio pelo cliente). |
| `pending_analysis` | Reversa criada com status Em Análise. Nenhuma logística foi contratada. |
| `approved_shipping_failed` | Aprovação automática, mas a contratação da logística falhou. A loja resolve pelo painel. |

| `shipping_company_id` | Transportadora | O que contrata |
|---|---|---|
| 2 | Correios | Postagem na agência ou coleta domiciliar, conforme o `is_collect` |
| 5 | Motoboy | Coleta no endereço da reversa |
| 6 | Loja física | Entrega no ponto de devolução. Exige `organisation_address_id` |
| 9 | Envio pelo cliente | Sem transportadora contratada e sem rastreio |
| 10 | Devoluxe | Coleta no endereço da reversa |
| 12 | USPS | Postagem pelo cliente |
| 13 | Loggi | Postagem pelo cliente |
| 14 | Recoli | Coleta no endereço da reversa |
| 15 | Jadlog | Postagem pelo cliente |
| 16 | Ícaro | Aceito, mas não contrata por aqui: a coleta exige a chave da NFD, então a reversa fica Em Análise |

#### track_reverse_order

**Consulta o status das reversas de um pedido**

**Ferramenta:** `track_reverse_order` · **Permissão:** `reverse.track`

Retorna as reversas abertas do pedido com o que a Central de Trocas mostra ao cliente: status, itens, logística reversa, cupom ou crédito e reembolso. Usa a mesma conferência de `prepare_reverse_order` (número do pedido mais CPF, CNPJ ou e-mail) e só enxerga aquele pedido.

Lê o pedido ao vivo e atualiza a cópia interna. Não altera a reversa: não cancela, não edita e não acelera nada.

- Campo null quer dizer que a loja ainda não registrou aquele passo. Informe que ainda não aconteceu, sem estimar data.
- Lista vazia não prova que nunca existiu reversa: canceladas, de presente e, na maioria das lojas, as de ruptura não aparecem, como na Central de Trocas.
- O Código de Postagem só vale enquanto o status é Aguardando Envio. Ele pode continuar vindo depois que o pacote já seguiu.

### Operação interna da loja

#### list_reverse_orders

**Lista reversas com paginação e filtros**

**Ferramenta:** `list_reverse_orders` · **Permissão:** `reverse.list`

Retorna uma lista paginada de reversas da loja, com filtros por status, intervalo de datas, pedido, cliente e código de rastreio. É o ponto de partida de qualquer consulta interna. A página começa em 1.

Só lê. Enxerga todas as reversas da loja, sem pedir CPF: é para a equipe, nunca para chat aberto ao público.

- Sem número do pedido, e-mail, rastreio ou datas, a busca cobre só os últimos 30 dias.
- "Em aberto" não é um status. Para contar, pegue o total sem filtro e subtraia o total de `finalizado` e `cancelado`.
- Quatro status aparecem na resposta mas não podem ser filtrados: Processando Reembolso, Em Fila de Reembolso, Pendência Interna e Pendência no Recebimento.

#### get_reverse_order

**Busca os detalhes de uma reversa pelo ID**

**Ferramenta:** `get_reverse_order` · **Permissão:** `reverse.read`

Retorna os detalhes de uma reversa da loja: status, valores, cliente, logística reversa, cupom, dados bancários do reembolso e itens com motivo. Não aceita número do pedido: use `list_reverse_orders` para achar o ID.

Só lê, e só alcança reversas da loja do token.

- O código do cupom vem sempre mascarado. O código completo só se revela no painel, que registra quem revelou.
- O documento do cliente segue a regra "Ocultar CPF do cliente" do painel da loja.
- Não traz o comprovante de reembolso, as notas fiscais nem o histórico da reversa.

### Especificação completa

Esquemas de entrada e saída de cada ferramenta: https://www.troquecommerce.com.br/swagger/mcp.json