{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"07e4cd93-ecd0-4f63-866b-814637c7553f","name":"R3 Express - Public API","description":"Documentação oficial da **API Pública R3 Express**.\n\nEssa API permite que parceiros integrem seus sistemas diretamente com a plataforma R3 Express, possibilitando a criação de pedidos, cálculo de frete, rastreamento e emissão de etiquetas de envio. Todos os endpoints seguem o padrão RESTful e retornam dados em formato JSON.\n\n**Autenticação:**  \nPara consumir os endpoints, utilize o cabeçalho `Authorization` com o token no formato `Basic {{authorization_token}}`.\n\n**Base URL:**  \n`https://app.r3express.com.br/`\n\n## Visão Geral da Autorização\n\nO R3 Express oferece um fluxo de autorização simplificado para permitir que sistemas terceiros obtenham tokens de acesso para seus clientes de forma segura. Este processo permite que você integre seus clientes com nossa API sem que eles precisem compartilhar credenciais diretamente.\n\n## Como Funciona\n\n[<b>https://www.youtube.com/watch?v=lxc4EKtIDOk</b>](https://www.youtube.com/watch?v=lxc4EKtIDOk)\n\nO processo de integração segue um fluxo de 3 etapas simples:\n\n### 1\\. Redirecionamento para Autorização\n\nPara iniciar a integração de um cliente, você deve redirecioná-lo para nossa URL de integração com os parâmetros necessários:\n\n[https://app.r3express.com.br/integrate-seller](https://app.r3express.com.br/integrate-seller)\n\n### 2\\. Parâmetros Obrigatórios\n\n| Parâmetro | Descrição |\n| --- | --- |\n| `reference` | Identificador único do cliente no seu sistema |\n| `webhook` | URL para onde o R3 Express enviará notificações sobre alterações |\n| `redirectTo` | URL para onde o cliente será redirecionado após a autorização |\n\n### 3\\. Exemplo de URL Completa\n\n[https://app.r3express.com.br/integrate-seller?reference=cliente123&amp;webhook=https://seusistema.com/webhook&amp;redirectTo=https://seusistema.com/integration-success](https://app.r3express.com.br/integrate-seller?reference=cliente123&webhook=https://seusistema.com/webhook&redirectTo=https://seusistema.com/integration-success)\n\n## Fluxo Passo a Passo\n\n### Passo 1: Preparação\n\n- Prepare uma URL de webhook em seu sistema para receber notificações\n    \n- Defina uma página de retorno (redirectTo) para onde o cliente será enviado após a autorização\n    \n- Tenha em mãos o identificador único do cliente no seu sistema (reference)\n    \n\n### Passo 2: Redirecionamento\n\n- Redirecione seu cliente para a URL de integração do R3 Express com os parâmetros configurados\n    \n- O cliente apenas entra com usuário e senha na plataforma ou se ele estiver logado o processo será automático.\n    \n\n### Passo 3: Autorização\n\n- O cliente autoriza a integração em nosso sistema\n    \n- O R3 Express gera um token único para essa integração\n    \n\n### Passo 4: Retorno\n\n- Após a autorização, o cliente é redirecionado para sua URL `redirectTo`\n    \n- O redirecionamento incluirá dois parâmetros na URL:\n    \n    - `token`: Token de acesso gerado para essa integração\n        \n    - `reference`: O mesmo valor que você enviou originalmente\n        \n\nExemplo de URL de retorno:  \n[https://seusistema.com/integration-success?token=abc123xyz789&amp;reference=cliente123](https://seusistema.com/integration-success?token=abc123xyz789&reference=cliente123)\n\n### Passo 5: Armazenamento\n\n- Capture e armazene o token associado ao cliente (reference)\n    \n- Use este token em todas as requisições à API do R3 Express para esse cliente específico\n    \n\n## Considerações Importantes\n\n- **Segurança**: Mantenha os tokens seguros e não os exponha em URLs ou logs\n    \n- **Webhook**: Certifique-se de que sua URL de webhook está acessível e preparada para receber notificações\n    \n- **Validação**: Sempre valide se o parâmetro `reference` retornado corresponde ao cliente esperado\n    \n- **Armazenamento**: Associe corretamente cada token ao cliente correspondente em seu sistema\n    \n\n## Próximos Passos\n\nApós obter o token, você pode utilizá-lo para fazer requisições autenticadas à API do R3 Express em nome do cliente autorizado. Consulte a documentação da API para detalhes sobre como usar o token nas requisições.\n\n**Suporte:**  \nEntre em contato pelo e-mail: `desenvolvimento@r3express.com.br`\n\n⚠️**Atenção:** Todos os dados presentes nesta documentação são **fictícios** e servem apenas como exemplo.  \nPara obter suas **credenciais reais de autenticação** e instruções específicas de requisição, entre em contato pelo e-mail.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"29745427","team":5564709,"collectionId":"07e4cd93-ecd0-4f63-866b-814637c7553f","publishedId":"2sB34bLiTL","public":true,"publicUrl":"https://documenter-api.postman.tech/view/29745427/2sB34bLiTL","privateUrl":"https://go.postman.co/documentation/29745427-07e4cd93-ecd0-4f63-866b-814637c7553f","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ed1c24"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":"Documentação oficial da API pública da R3 Express para integração de pedidos, frete, rastreamento e etiquetas no modelo Same Day Delivery. Endpoints RESTful com autenticação básica e suporte técnico em desenvolvimento@r3express.com.br."},{"name":"title","value":"R3 Express - Public API Documentation | Same Day Delivery Integration"}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/2d9aa4bb-d76e-46cf-a964-ec29efebdeb0/d2hpdGUtbG9nby5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"ed1c24"}},{"name":"light","logo":"https://content.pstmn.io/2ccf44a3-f29d-4fe4-a5ef-f11f9e64c3b7/bG9nby5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ed1c24"}}]}},"version":"8.10.1","publishDate":"2025-07-05T16:04:51.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"R3 Express - Public API Documentation | Same Day Delivery Integration","description":"Documentação oficial da API pública da R3 Express para integração de pedidos, frete, rastreamento e etiquetas no modelo Same Day Delivery. Endpoints RESTful com autenticação básica e suporte técnico em desenvolvimento@r3express.com.br."},"logos":{"logoLight":"https://content.pstmn.io/2ccf44a3-f29d-4fe4-a5ef-f11f9e64c3b7/bG9nby5wbmc=","logoDark":"https://content.pstmn.io/2d9aa4bb-d76e-46cf-a964-ec29efebdeb0/d2hpdGUtbG9nby5wbmc="}},"statusCode":200},"environments":[{"name":"Production","id":"a3b82009-8f03-4cbd-b159-f1064911072c","owner":"37638138","values":[{"key":"token","value":"","type":"default","enabled":true},{"key":"collectionName","value":"","type":"default","enabled":true},{"key":"collectionSchemaUrl","value":"","type":"default","enabled":true},{"key":"accessKey","value":"","type":"default","enabled":true},{"key":"workspaceId","value":"","type":"default","enabled":true},{"key":"collectionId","value":"","type":"default","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/156854ddc0a4a3aa4d3c3da3ab894628d19232d7800ca10ab929c10f306c7d77","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"37638138-a3b82009-8f03-4cbd-b159-f1064911072c"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB34bLiTL"}