{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"f7d882cc-2ad2-4f6d-9b4f-0e346cacbaab","name":"Bem-vindo","description":"<img src=\"https://content.pstmn.io/1f1e191f-a061-445c-859e-45518432ea1b/U2NyZWVuc2hvdF83LnBuZw==\">\n\n**Versão:** 1.0.0\n\n**Integrar sua empresa com as soluções da BBCE é simples e rápido. Tudo isso é possível por meio do BBCE Connect. Conheça as possibilidades e escolha o melhor para o seu negócio ou cliente!**\n\n### Transforme suas operações\n\nO BBCE Connect é o que vai apoiar você, desenvolvedor, nessa jornada. É uma solução integrada que conecta o EHUB BBCE aos sistemas proprietários de clientes e/ou de seus parceiros. Promove eficiência aos processos internos, menos risco operacional, automação e customização. Permite automação de rotinas de backoffice, análises e acompanhamento em tempo real do EHUB BBCE e da BBCE Curva Forward, tudo de forma customizada.\n\nPor meio de um portfólio completo de APIs e webhooks, integra ferramentas de negociação, dados e gestão de riscos. Como resultado, as operações se tornam mais ágeis e seguras.\n\n### Confira os principais benefícios\n\n- Customização das atividades e operações\n    \n- Redução de riscos operacionais\n    \n- Automação e simplificação de rotinas\n    \n- Inteligência de dados na sua mão\n    \n- Gestão de portfólio facilitada em seus sistemas\n    \n\n### Isso significa na prática\n\n- Integração completa com os sistemas de backoffice, ERP, CRM e BI da sua empresa.\n    \n- Acompanhamento de books de negócios diretamente em seus sistemas, sem precisar gerar ou importar relatórios entre diversas plataformas: inclua, exclua, edite e agrida ofertas.\n    \n- Gestão de limites: exclusão, inclusão, restituição e reversão de restituição, em tempo real, em lote ou com alguma contraparte.\n    \n- Extração de relatórios diretamente em seus sistemas, sem precisar gerar ou importar relatórios entre diversas plataformas.\n    \n- E muito mais!\n    \n\n### Como contratar o BBCE Connect?\n\nPara saber mais detalhes como contratar entre em contato com [comercial@bbce.com.br](https://mailto:comercial@bbce.com.br/).\n\n### Precisa de ajuda ou quer compartilhar ideias?\n\nFale com nosso time de Suporte por telefone ou WhatsApp número (11) 3077-0900. Se preferir, você pode também enviar um e-mail para [suporte@bbce.com.br](https://mailto:suporte@bbce.com.br/).\n\n[<img src=\"https://content.pstmn.io/6a4140a3-9788-4c1d-b48b-f9bb3519bac0/U2NyZWVuc2hvdF84LnBuZw==\">](https://pt.surveymonkey.com/r/CXWJQPQ)\n\n### Como acesso o BBCE Connect?\n\nO acesso ao BBCE Connect é realizado por meio de APIs RESTful e Webhooks. Para utilizá-lo, a empresa deve ser cliente da BBCE e ter contratado o serviço BBCE Connect.\n\nA autenticação é feita por meio de credenciais (login e senha) que já são utilizadas no EHUB — ou seja, **não é a BBCE que fornece essas credenciais**, mas sim a própria empresa, que é responsável pela gestão dos usuários autorizados.\n\nA BBCE fornece apenas a **apiKey**, que deve ser utilizada junto às credenciais para habilitar o acesso às APIs.\n\n### Quais os requisitos mínimos para acessar o BBCE Connect?\n\n- Estar credenciado como cliente BBCE.\n    \n- Ter credenciais válidas no EHUB (login e senha).\n    \n- Conexão HTTPS obrigatória para segurança dos dados.\n    \n- Infraestrutura capaz de consumir APIs REST.\n    \n\n### Qual o browser apropriado para abrir o portal?\n\nEmbora o BBCE Connect seja voltado para integração via API, o portal administrativo pode ser acessado via navegador moderno como Google Chrome ou Microsoft Edge. Navegadores desatualizados podem comprometer a experiência.\n\n### Tenho que comprar um certificado?\n\nNão é necessário adquirir certificado digital ICP-Brasil. A autenticação é feita por login e senha. Contratos podem ser assinados eletronicamente com validade jurídica conforme MP 2.200-2/2001, mesmo sem certificado ICP-Brasil. [Saiba mais em Contrato de Prestação de Serviços e Acesso às Plataformas da BBCE](https://www.bbce.com.br/wp-content/uploads/2025/06/20250627-Contrato-de-Prestacao-de-Servicos-e-Acessos-Final-1.pdf)\n\n### Preciso instalar um certificado?\n\nNão. O sistema utiliza autenticação por token e credenciais. A comunicação com os endpoints deve ser feita via HTTPS, mas não exige instalação de certificados no cliente.\n\n### Preciso instalar algum programa?\n\nNão é necessário instalar nenhum software específico. A integração é feita diretamente via chamadas HTTP para os endpoints da BBCE.\n\n### Existe alguma limitação de linguagem para se integrar com o BBCE Connect?\n\nNão há limitação. Qualquer linguagem que suporte requisições HTTP e manipulação de JSON pode ser usada (ex: Python, Java, JavaScript, C#, etc.). A estrutura é compatível com qualquer stack moderno.\n\n### Qual o período disponível das bases?\n\nDepende do plano contratado:\n\n- Market Data: acesso a contratos históricos e negócios do mercado.\n    \n- Post Trading: permite o acesso aos negócios e registros realizados no dia atual e no dia anterior, além dos contratos firmados nos últimos 30 dias.\n    \n\n### Como funciona a identificação de usuário?\n\nCada usuário recebe credenciais individuais e intransferíveis. A empresa cliente é responsável por parametrizar perfis e limites operacionais. O uso indevido das credenciais é de responsabilidade da empresa.\n\n### Existe um guia rápido de uso do EHUB?\n\nSim, para detalhes sobre a plataforma consulte o nosso [Manual do Usuário](https://www.bbce.com.br/wp-content/uploads/2024/10/20241030-Manual-EHUB-V1.4.pdf) (direcionar para o documento do manual do usuário no site da BBCE)\n\nPrecisa de ajuda? Fale conosco pelo telefone ou WhatsApp número (11) 3077-0900 se preferir você pode também enviar um e-mail para [suporte@bbce.com.br](https://mailto:suporte@bbce.com.br/).\n\n# Primeiros Passos\n\n1. **Autenticação Segura e Direta:**\n    \n    1. **Obtenha sua apiKey** com o time de suporte BBCE.\n        \n    2. **Faça login** para obter seu JWT:\n        \n        1. Endpoint: `POST /v2/login`\n            \n        2. Exemplo de payload:\n            \n            ``` json\n               {\n               \"companyExternalCode\": \"123\",\n               \"email\": \"usuario@empresa.com.br\",\n               \"password\": \"suaSenha\"\n               }           \n            \n             ```\n            \n        3. Exemplo de resposta:\n            \n            ``` json\n              {\n              \"idToken\": \"eyJraWQiOiJ...\",\n              \"refreshToken\": \"eyJjdHkiOiJ...\",\n              \"expiresIn\": 14400\n              }\n            \n             ```\n            \n    3. **Use o idToken** como Bearer Token nas próximas requisições.\n        \n2. **Desvende Nossos Endpoints:** Mergulhe nos grupos de endpoints (Auth, Wallets, Companies, Products, Orders, etc.) para mapear os recursos à sua disposição e dominar cada interação. Sempre informando no header as chaves obtidas`Authorization: Bearer {idToken}, apiKey: {apiKey}`\n    \n3. **Teste:** Aproveite nossos exemplos práticos para construir e validar suas primeiras requisições, transformando dados em resultados!\n    \n\n## Glossário\n\n- **apiKey:** Chave de acesso única para autenticação.\n    \n- **idToken:** Token JWT usado como Bearer Token.\n    \n- **Rate Limiting:** Quantidade máxima de requisições que é possível fazer por minuto\n    \n\n# Atualizações\n\n- **v1.0.0 (12/11/2025)**\n    \n    - Publicação","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"48979689","team":10587132,"collectionId":"f7d882cc-2ad2-4f6d-9b4f-0e346cacbaab","publishedId":"2sB3QJPWWr","public":true,"publicUrl":"https://portaldodesenvolvedor.bbce.com.br","privateUrl":"https://go.postman.co/documentation/48979689-f7d882cc-2ad2-4f6d-9b4f-0e346cacbaab","customColor":{"top-bar":"7B4A99","right-sidebar":"3B4151","highlight":"52AFB7"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"BBCE Portal do Desenvolvedor"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/8aaef518-fe46-4b73-81c5-eb2114af280e/U2VtIHTDrXR1bG8yLmpwZw==","colors":{"top-bar":"7B4A99","right-sidebar":"3B4151","highlight":"52AFB7"}},{"name":"light","logo":"https://content.pstmn.io/bdb0a92f-3375-42fd-af14-7e3ec1aa3c83/U2VtIHTDrXR1bG8yLmpwZw==","colors":{"top-bar":"7B4A99","right-sidebar":"3B4151","highlight":"52AFB7"}}]}},"version":"8.10.1","publishDate":"2025-11-11T21:28:53.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"BBCE Portal do Desenvolvedor","description":""},"logos":{"logoLight":"https://content.pstmn.io/bdb0a92f-3375-42fd-af14-7e3ec1aa3c83/U2VtIHTDrXR1bG8yLmpwZw==","logoDark":"https://content.pstmn.io/8aaef518-fe46-4b73-81c5-eb2114af280e/U2VtIHTDrXR1bG8yLmpwZw=="}},"statusCode":200},"environments":[{"name":"BETA","id":"f7d0ad77-3065-4deb-a2da-8de9e097b308","owner":"48979512","values":[{"key":"baseUrl","value":"https://api-beta.qa.bbce.tech/bus","enabled":true,"type":"default"},{"key":"apiKey","value":"","enabled":true,"type":"secret"},{"key":"companyCode","value":"","enabled":true,"type":"default"},{"key":"email","value":"","enabled":true,"type":"default"},{"key":"password","value":"","enabled":true,"type":"secret"},{"key":"jwt","value":"","enabled":true,"type":"secret"},{"key":"refreshToken","value":"","enabled":true,"type":"secret"},{"key":"companyId","value":"","enabled":true,"type":"default"},{"key":"userId","value":"","enabled":true,"type":"default"},{"key":"walletId","value":"","enabled":true,"type":"default"},{"key":"underlyingAsset_id","value":"","enabled":true,"type":"any"},{"key":"productCategory_id","value":"","enabled":true,"type":"any"},{"key":"first_feature_id","value":"","enabled":true,"type":"any"},{"key":"first_feature_description","value":"","enabled":true,"type":"any"}],"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/f3243d01d6e9f85c8b092c4964ee7e180aca50d97314e0d5467d1056501055d7","favicon":"https://bbce.com.br/favicon.ico"},"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":"BETA","value":"48979512-f7d0ad77-3065-4deb-a2da-8de9e097b308"}],"canonicalUrl":"https://portaldodesenvolvedor.bbce.com.br/view/metadata/2sB3QJPWWr"}