# Cademeupedido > Página de rastreio e painel de acompanhamento de pedidos para e-commerce. Centraliza, de forma integrada, o e-commerce, o ERP e as transportadoras, e automatiza a comunicação entre cliente, loja e transportadoras: o cliente acompanha o pedido, o faturamento e o rastreio em um único ambiente, e a loja monitora atrasos, ocorrências, extravios e devoluções e atualiza o status do pedido no e-commerce, com API pública e 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.cademeupedido.com.br e a parte textual da documentação da API pública e do servidor MCP. Índice curto: https://www.cademeupedido.com.br/llms.txt. Esquemas, parâmetros e exemplos da API e do MCP ficam nos arquivos JSON indicados em cada seção. Conteúdo conferido em outubro de 2026. ## Página inicial Fonte: https://www.cademeupedido.com.br/home ### Forneça a melhor experiência pós-venda para seu Cliente A Cademeupedido tem como objetivo aprimorar e automatizar a comunicação entre Cliente e Loja. Aumente a confiança do seu cliente com informações do pedido, faturamento e de rastreios, tudo em único ambiente! ### Aumente o engajamento dos clientes 83% dos compradores esperam ser comunicados regularmente sobre suas compras. ### Reduza a ansiedade no rastreio 2.6x é a média de visitas recebidas pelas páginas de rastreio a cada pedido. ### Centralizamos de forma integrada seu Ecommerce com o ERP e as Transportadoras! #### ERPs Tiny, Bling, Eccosys, Linx Microvix, Linx e-millennium, TOTVS #### Plataformas Loja Integrada, Magazord, Tray, VTEX, Shopify, Nuvemshop, Irroba, Linx OMS, iSET, Magento 2, Dooca, Bagy, Uoou Solutions, WooCommerce, Wbuy, Webstore, TrayCorp/ Fbits, Linx Commerce, Betalabs, Vnda, Yampi, Oracle, DLoja Virtual, Climba Commerce, Shoppub, Moovin, Panorama Sistemas, Braavo, Wapstore, Wake #### Transportadoras Correios, Jadlog, GFL, Rodonaves, Jamef, Braspress, Smart2C, Elohim, DBA, OnTime, Rodoê, PotSpeed, Total Express, TNT, Melhor Envio, Novo Rio - Azplan, Daytona Express, Rede Sul Logística, Grupo Astrolog, VTEx Tracking, Corelli Express, Destak Logística e Transportes, Next Express, DLog Transportes, Carriers, Loggi, Rodoviário Camilo dos Santos, BSC Transportes, J&T Express, GOLLOG, Patrus Transportes, IS Entrega, Mandaê, AWR Logística, Buslog, Azul Cargo Express, Diálogo Logística Inteligente ### Melhore a experiência dos seus clientes com o acompanhamento de encomendas em tempo real! Exemplo de linha do tempo exibido na página: - Criado: Seu pedido Nr 1250 foi identificado pela plataforma. - Pago: O pagamento do seu pedido foi identificado pela plataforma. - Em separação: Nossa equipe já está preparando seu pedido para o envio. - Faturado: Seu pedido foi faturado e você pode consultar sua Nota Fiscal Eletrônica. - Enviado: Seu pedido já está a caminho e será entregue pela transportadora. - Entregue: Identificamos que seu pedido foi entregue, caso tenha algum problema com sua entrega entre em contato com nosso SAC. ### Aprimore e automatize a comunicação entre cliente, loja e transportadoras - Monitoramento de atrasos na entrega - Abertura automática de acareações junto às transportadoras - Monitoramento de ocorrências no fluxo de entrega - Controle de extravios e devoluções - Atualização de status do pedido no Ecommerce em tempo real ### Transforme a Experiência Logística Junte-se à comunidade de lojas e clientes que confiam na Cademeupedido para simplificar e aprimorar a experiência de rastreio de encomendas. ### Rodapé - Contato: comercial@troquecommerce.com.br - Compliance e segurança: https://www.cademeupedido.com.br/compliance ## Compliance e segurança Fonte: https://www.cademeupedido.com.br/compliance ### Segurança e Conformidade na Cademeupedido A Cademeupedido 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.cademeupedido.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.cademeupedido.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.cademeupedido.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.cademeupedido.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.cademeupedido.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.cademeupedido.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 Cademeupedido 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 Cademeupedido é 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 Cademeupedido 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 Cademeupedido 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 Cademeupedido 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 Cademeupedido 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. ## API pública Fonte: https://www.cademeupedido.com.br/docs API - Cademeupedido, versão 1.0.0. Base da API: https://www.cademeupedido.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**. ### Endpoints | # | Ação | Endpoint | |---|---|---| | 1 | Listar pedidos | `GET /order/list` | | 2 | Buscar detalhes | `GET /order` | Datas em ISO 8601 · IDs em UUID v4 · valores monetários como `number` decimal · documentos/CEP só dígitos. ### Grupos - Detalhes do Pedido: Consulta dos detalhes completos de um pedido específico (timeline, faturas, ocorrências, notificações). - Lista de Pedidos: Listagem paginada de pedidos da loja, com filtros por status, ocorrências, transportadora, cliente, datas e mais. ### Detalhes do Pedido #### GET /order/{id} **Busca os detalhes de um pedido pelo ID** Retorna o objeto completo de um pedido: cliente, produtos, timeline de status, faturas com eventos de rastreio, ocorrências e notificações enviadas. ### Lista de Pedidos #### GET /order/list **Lista pedidos com paginação e filtros** Retorna uma lista paginada de pedidos com filtros por status, ocorrências, transportadora, cliente, número da NF, código de rastreio e intervalos de data (criação/atualização). A página começa em 1. Use `limit` para controlar o tamanho da página (máximo 100). ### Especificação completa Parâmetros, esquemas e exemplos: https://www.cademeupedido.com.br/swagger/bundled.json ## Servidor MCP Fonte: https://www.cademeupedido.com.br/docs/mcp MCP - Cademeupedido, versão 0.1.0. Endereço do servidor MCP: https://www.cademeupedido.com.br/api/mcp Header `Authorization: Bearer` em todas as chamadas (ex.: `Authorization: Bearer 99999z99-aaaa-bbbb-cccc-999999999999`). O token de MCP é gerado no painel em **Configurações > MCP**, com as permissões de cada ferramenta. 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 consultar os pedidos da loja no Cademeupedido. As ferramentas não são endpoints HTTP: quem chama é o cliente MCP, pelo método `tools/call`, sempre em `POST https://www.cademeupedido.com.br/api/mcp`. O caminho mostrado em cada ferramenta é só o identificador dela. Todas as ferramentas só leem: nenhuma reenvia, cancela, altera endereço ou abre ocorrência. ### Ferramentas | # | Ação | Ferramenta | Permissão | |---|---|---|---| | 1 | Rastrear o pedido do cliente | `get_order_status` | `order.track` | | 2 | Listar pedidos (equipe) | `list_orders` | `order.list` | | 3 | Contar pedidos por status (equipe) | `count_orders` | `order.list` | | 4 | Buscar detalhes de um pedido (equipe) | `get_order` | `order.read` | ### Regras das respostas - **Só as ferramentas do token:** o servidor lista apenas as ferramentas liberadas pelas permissões do token; as demais não aparecem para o assistente. - **Uma loja por token:** o servidor pertence à loja do token e nunca devolve pedido de outra loja. - **Sempre em nome da loja:** o assistente nunca cita Cademeupedido, a página de rastreio como produto nem qualquer indício de sistema terceiro; fala em nome da loja ("nosso sistema", "a loja", "seu pedido"). O link do comprovante é enviado sem comentar o domínio nem de onde vem. - **Dados mascarados:** sem o número do pedido, `get_order_status` devolve os últimos pedidos do cliente mascarados, como a página de rastreio, sem comprovante de entrega. Telefone, CPF e CNPJ do cliente nunca saem no rastreio do consumidor. Em `get_order`, o CPF ou CNPJ sempre vem mascarado. Valor mascarado não identifica ninguém e nunca deve ser lido como número completo. - **Nota fiscal x despacho:** quando `is_only_dispatched` é true, o registro é um pacote despachado pela loja, não uma nota fiscal. - **Dois prazos:** o prazo da loja (`store_delivery_deadline_*`, em dias úteis a partir da etapa de referência) e a previsão da transportadora (`expected_delivery_date`). Os dois podem ser informados ao cliente identificado, sempre dizendo de quem é cada um; quando só um existe, informe só esse. - **Dias úteis e datas:** prazo da loja é sempre em dias úteis. Toda data é dita ao usuário como dd/mm/aaaa (com hh:mm quando houver hora), mesmo quando o campo vem em ISO 8601. - **Cada consulta de `get_order_status` conta como visita do cliente à página de rastreio.** ### Códigos de erro | Código | Quando | |---|---| | `FORBIDDEN` | O token não tem a permissão da ferramenta. | | `INVALID_IDENTIFIER` | O identificador não é CPF, CNPJ nem e-mail. | | `ORDER_NOT_FOUND` | Pedido não encontrado para esse cliente ou nessa loja. | | `TRACKING_CENTER_DISABLED` | A loja não mostra o rastreio aos clientes. | | `AMBIGUOUS_ORDER_NUMBER` | Mais de um pedido com o mesmo número; a resposta traz os candidatos. | | `TEMPORARY_FAILURE` | Falha temporária; tente de novo. | ### Grupos - Atendimento ao consumidor: Para o chat com o cliente. Cada consulta exige o CPF, CNPJ ou e-mail de quem comprou, com ou sem o número do pedido, e só enxerga os pedidos dessa pessoa. - Operação interna da loja: Para a equipe da loja. Leem todos os pedidos da loja sem pedir CPF. Não use em chat aberto ao público. ### Atendimento ao consumidor #### get_order_status **Rastreia o pedido do cliente** **Ferramenta:** `get_order_status` · **Permissão:** `order.track` · **Somente leitura** Mostra o andamento dos pedidos do cliente como a página de rastreio da loja. A resposta começa pela última movimentação (`latest_update`); a linha do tempo completa vem logo abaixo, como histórico. Só lê: não cancela, não reenvia, não altera endereço e não abre ocorrência. Cada consulta é registrada como uma visita à página de rastreio. ##### Roteiro de atendimento 1. Peça o CPF, CNPJ ou e-mail usado na compra e, se o cliente tiver, o número do pedido. Sem o número, vêm os últimos pedidos mascarados: avise e peça o número para abrir o certo. 2. Responda primeiro só com a última movimentação: a etapa atual e a data, em uma ou duas frases (ex.: "Seu pedido saiu para entrega em 05/10/2026 às 14:30"). Se houver ocorrência aberta, cite-a com as palavras da página. O histórico completo só se o cliente pedir. 3. Previsões: se houver previsão da transportadora ou prazo da loja, pode informar, dizendo de quem é e, no prazo da loja, em dias úteis a partir da etapa de referência. Se não houver, não estime. 4. Pedido entregue com `delivery_proof_available` true: pergunte se o cliente quer ver o comprovante de entrega; se ele aceitar, envie só o link do comprovante e o nome de quem recebeu, e nada mais. Se o cliente disser que não recebeu, oriente a falar com o atendimento da loja. 5. Registro só despachado (`is_only_dispatched`): fale em pacote ou despacho, nunca em nota fiscal. Fale como atendente da loja, em português do Brasil, curto e cordial. Nunca cite Cademeupedido, a página de rastreio como produto nem qualquer sistema terceiro: fale em nome da loja ("nosso sistema", "a loja", "seu pedido"). Envie o link do comprovante sem comentar o domínio nem de onde ele vem. Datas em dd/mm/aaaa e horas em hh:mm. Valores mascarados não identificam ninguém e nunca são lidos como número completo. **Anotações MCP:** `readOnlyHint: true`, `idempotentHint: true`, `destructiveHint: false`, `openWorldHint: false`. ### Operação interna da loja #### list_orders **Lista os pedidos da loja** **Ferramenta:** `list_orders` · **Permissão:** `order.list` Busca os pedidos da loja e devolve o total de resultados e uma página de resumos. Use `get_order` com o `id` para o pedido completo. - `order_number`, `invoice_number` e `tracking_code` buscam por trecho: um trecho curto pode trazer muitos pedidos. - Sem `status`, os status buscados dependem dos outros filtros, como na API pública. - Sem janela de datas, uma loja grande pode demorar: prefira informar uma janela. #### count_orders **Conta os pedidos por status** **Ferramenta:** `count_orders` · **Permissão:** `order.list` Conta os pedidos da loja criados na janela e divide o total por status, com os mesmos números do contador da API pública. Sem janela, conta todos os pedidos da loja. - Não conta ocorrências: use `list_orders` com filtro de ocorrência. #### get_order **Busca os detalhes de um pedido** **Ferramenta:** `get_order` · **Permissão:** `order.read` Devolve um pedido da loja pelo ID ou pelo número: status e datas, cliente, produtos, histórico de status, notas fiscais ou pacotes com rastreio, ocorrências e notificações enviadas. - Informe `order_id` ou `order_number`, um dos dois. - Quando o número pertence a mais de um pedido, responde `AMBIGUOUS_ORDER_NUMBER` com os candidatos e as datas de criação. - O CPF ou CNPJ do cliente sempre vem mascarado. ### Especificação completa Esquemas de entrada e saída de cada ferramenta: https://www.cademeupedido.com.br/swagger/mcp.json