{"info":{"_postman_id":"d9d2297a-7b39-489b-9280-004283e13c56","name":"Contempladas","description":"<html><head></head><body><p><strong>Auth:</strong> Bearer + header <code>partner_id</code>. Sem HMAC.</p>\n<p>Preencha <code>partnerClientSecret</code> no environment. Não commitar o secret.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"33302226","collectionId":"d9d2297a-7b39-489b-9280-004283e13c56","publishedId":"2sBYHNYPPz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-10-06T12:16:19.000Z"},"item":[{"name":"Consultor","item":[{"name":"01. Autenticação","event":[{"listen":"test","script":{"exec":["function readJsonBody() {","  let parsed;","  try {","    parsed = pm.response.json();","  } catch (_error) {","    return null;","  }","  if (parsed && typeof parsed.body === 'string') {","    try {","      parsed = JSON.parse(parsed.body);","    } catch (_error) {","      return parsed;","    }","  }","  if (parsed && parsed.body && typeof parsed.body === 'object' && (parsed.body.access_token || parsed.body.accessToken)) {","    return parsed.body;","  }","  return parsed;","}","","const json = readJsonBody();","const accessToken = json && (json.access_token || json.accessToken);","pm.test('Status is 200', () => pm.response.to.have.status(200));","pm.test('OAuth token contract', () => {","  pm.expect(accessToken, 'access_token').to.be.a('string');","  pm.expect(accessToken.length).to.be.above(10);","});","if (accessToken) {","  pm.collectionVariables.set('accessToken', accessToken);","}"],"type":"text/javascript","packages":{},"requests":{},"id":"6319f854-bb7d-44bf-9845-12a9371bed3f"}}],"id":"8fe367e9-a9da-4f34-86e0-2a76e24751c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"},{"key":"client_id","value":"","type":"text"},{"key":"client_secret","value":"","type":"text"}]},"url":"{{authorizerBaseUrl}}/api/oauth/token","description":"<h2 id=\"objetivo\">Objetivo</h2>\n<p>Autenticar o parceiro e obter o <strong>access token</strong> necessário para realizar as demais requisições da API.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Preencha no environment: <code>partnerId</code>, <code>partnerClientId</code>, <code>partnerClientSecret</code>.</p>\n</li>\n<li><p>Execute esta request <strong>antes</strong> de todas as demais.</p>\n</li>\n<li><p>O script de teste salva <code>accessToken</code> na variável da collection.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — token OAuth2 client_credentials:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"access_token\": \"eyJhbG...\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 300\n}\n\n</code></pre>\n<p><strong>401</strong> — credenciais inválidas.</p>\n","urlObject":{"path":["api","oauth","token"],"host":["{{authorizerBaseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"c36d28d0-4e5c-4ec0-9bd8-6051ba6bfc66","name":"200 OK","originalRequest":{"method":"POST","header":[],"url":"/api/oauth/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 300\n}"}],"_postman_id":"8fe367e9-a9da-4f34-86e0-2a76e24751c3"},{"name":"02. Info User","event":[{"listen":"test","script":{"exec":["let json = null;","try {","  json = pm.response.json();","} catch (_error) {","  json = null;","}","pm.test('Status is 200', () => pm.response.to.have.status(200));",""],"type":"text/javascript","packages":{},"requests":{},"id":"aa721242-395a-4bce-b540-026ea860f40a"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"8491f0ce-27b2-4984-95bf-073521263cc4"}}],"id":"bbd3d113-57b4-4838-a7b8-caf378b35c37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"url":"{{baseUrl}}/auth/me","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Consultar os dados do parceiro autenticado, incluindo <strong>workspace, perfil, permissões e rotas disponíveis</strong>.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Requer <code>accessToken</code> do passo 01.</p>\n</li>\n<li><p>Envie header <code>partner_id</code> com o mesmo parceiro do token.</p>\n</li>\n<li><p>Confirma workspace, perfil e permissões do ator M2M.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — perfil do parceiro:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"actorId\": \"a1b2c3d4-...\",\n  \"workspaceId\": \"11111111-1111-4111-a111-111111111111\",\n  \"actorKind\": \"partner\",\n  \"accessProfileId\": \"consultant\",\n  \"displayName\": \"Parceiro Demo\",\n  \"permissions\": [{ \"service\": \"share-awarded\", \"area\": \"share\", \"nivelAcesso\": \"read\" }],\n  \"frontendRoutes\": [\"/cotas\"]\n}\n\n</code></pre>\n","urlObject":{"path":["auth","me"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"8699f0b1-b2f4-4c81-a5d1-201d0868a8b7","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/auth/me"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"actorId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"workspaceId\": \"11111111-1111-4111-a111-111111111111\",\n  \"actorKind\": \"partner\",\n  \"accessProfileId\": \"consultant\",\n  \"displayName\": \"Parceiro Demo\",\n  \"permissions\": [\n    {\n      \"service\": \"share-awarded\",\n      \"area\": \"share\",\n      \"nivelAcesso\": \"read\"\n    }\n  ],\n  \"frontendRoutes\": [\n    \"/cotas\"\n  ]\n}"}],"_postman_id":"bbd3d113-57b4-4838-a7b8-caf378b35c37"},{"name":"03. Listar Cotas","event":[{"listen":"test","script":{"id":"a5797848-0668-4afa-a7bf-db2b9eaf0970","exec":["const json = pm.response.json();","if (json && json.items && json.items.length > 0) {","  pm.collectionVariables.set('shareId', json.items[0].shareId || json.items[0].publicId);","}","pm.test('Status is 200', () => pm.response.to.have.status(200));"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"87c27eee-5eb2-4aea-a74d-719af86799f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"url":"{{baseUrl}}/shares?status=available&limit=10","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Listar as <strong>cotas disponíveis no workspace do parceiro</strong>, com opção de filtro, ordenação e paginação.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Lista cotas disponíveis no workspace do parceiro.</p>\n</li>\n<li><p>Query opcional: <code>status</code> (default <code>available</code>), <code>limit</code>, <code>sort_by</code>, <code>sort_order</code>.</p>\n</li>\n<li><p>O teste salva o primeiro <code>shareId</code> encontrado.</p>\n</li>\n<li><p>Limite maximo no campo <code>limit</code> é de 100</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — lista paginada:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"items\": [{\n    \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n    \"contractNumber\": \"55818162\",\n    \"groupNumber\": \"1503\",\n    \"shareNumber\": \"2503\",\n    \"credit\": 104151,\n    \"installment\": 732.73,\n    \"price\": 95000,\n    \"shareStatusSlug\": \"available\"\n  }],\n  \"count\": 1,\n  \"totalCount\": 42,\n  \"limit\": 10,\n  \"nextCursor\": null\n}\n\n</code></pre>\n","urlObject":{"path":["shares"],"host":["{{baseUrl}}"],"query":[{"key":"status","value":"available"},{"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"afc7a28b-9fb3-4ba7-a26f-2768c822d5f1","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/shares"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"items\": [\n    {\n      \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n      \"contractNumber\": \"55818162\",\n      \"groupNumber\": \"1503\",\n      \"shareNumber\": \"2503\",\n      \"credit\": 104151,\n      \"installment\": 732.73,\n      \"price\": 95000,\n      \"shareStatusSlug\": \"available\"\n    }\n  ],\n  \"count\": 1,\n  \"totalCount\": 42,\n  \"limit\": 10,\n  \"nextCursor\": null\n}"}],"_postman_id":"87c27eee-5eb2-4aea-a74d-719af86799f7"},{"name":"04. Buscar  Cota","event":[{"listen":"test","script":{"id":"ba4281c2-6b21-44b3-8837-c2b5c8ad196c","exec":["pm.test('Status is 200', () => pm.response.to.have.status(200));"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"0db6d9c3-af06-4bad-8391-b5cad238c56c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"url":"{{baseUrl}}/shares/","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Consultar os <strong>detalhes de uma cota específica</strong>.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Substitua o UUID no path pelo <code>shareId</code> desejado.</p>\n</li>\n<li><p>Retorna detalhes completos da cota, incluindo CET e simulação de parcelas.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — detalhe da cota:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n  \"contractNumber\": \"55818162\",\n  \"credit\": 104151,\n  \"installment\": 732.73,\n  \"price\": 95000,\n  \"administratorName\": \"Rodobens\",\n  \"cet\": { \"monthly\": \"1.00% + IPCA\", \"annual\": \"12.00% + IPCA\" },\n  \"paymentPlanSimulation\": [{ \"paymentDate\": \"2026-04-17\", \"installmentValue\": 732.73, \"isAdjustmentMonth\": false }]\n}\n\n</code></pre>\n<p><strong>404</strong> — cota não encontrada.</p>\n","urlObject":{"path":["shares",""],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"e8a8db78-f003-472c-88f6-7a6f0b68b5c1","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/shares/87e9ec63-a1d9-44d1-a728-b934f4963829"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n  \"contractNumber\": \"55818162\",\n  \"credit\": 104151,\n  \"installment\": 732.73,\n  \"price\": 95000,\n  \"administratorName\": \"Rodobens\",\n  \"cet\": {\n    \"monthly\": \"1.00% + IPCA\",\n    \"annual\": \"12.00% + IPCA\"\n  }\n}"}],"_postman_id":"0db6d9c3-af06-4bad-8391-b5cad238c56c"},{"name":"05. Buscar Carrinho Ativo","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Active cart found or empty', () => pm.expect([200, 404]).to.include(pm.response.code));","if (pm.response.code === 200) {","  const json = pm.response.json();","  if (json && json.cartId) pm.collectionVariables.set('cartId', json.cartId);","}"],"id":"e50849c0-4bbb-4aec-b060-7366a684173d"}}],"id":"03e65f3a-bfbb-4569-8420-e8623accdad7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"url":"{{baseUrl}}/carts/active","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Consultar o <strong>carrinho ativo do consultor</strong>, incluindo as cotas adicionadas e os valores totais.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Retorna o carrinho ativo do consultor vinculado ao parceiro.</p>\n</li>\n<li><p>Só existe <strong>um</strong> carrinho ativo por consultor.</p>\n</li>\n<li><p>Se vazio, retorna <strong>404</strong> — prossiga com \"Add to Cart\".</p>\n</li>\n<li><p>Em <strong>200</strong>, o teste salva <code>cartId</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — carrinho com itens:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"cartId\": \"cart-uuid\",\n  \"status\": \"active\",\n  \"totalPrice\": 95000,\n  \"totalCredit\": 104151,\n  \"shares\": [{ \"shareId\": \"87e9ec63-...\", \"snapshot\": { \"credit\": 104151, \"price\": 95000 } }],\n  \"expiresAt\": \"2026-10-06T12:00:00.000Z\"\n}\n\n</code></pre>\n<p><strong>404</strong> — nenhum carrinho ativo.</p>\n","urlObject":{"path":["carts","active"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"c744cd01-50f4-433b-b6c8-65a19dd60cb5","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/carts/active"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"cartId\": \"b60cdd05-bb50-4ff0-9b8b-aedcdd2f7004\",\n  \"status\": \"active\",\n  \"totalPrice\": 95000,\n  \"totalCredit\": 104151,\n  \"shares\": [\n    {\n      \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n      \"snapshot\": {\n        \"credit\": 104151,\n        \"price\": 95000\n      }\n    }\n  ],\n  \"expiresAt\": \"2026-10-06T12:00:00.000Z\"\n}"}],"_postman_id":"03e65f3a-bfbb-4569-8420-e8623accdad7"},{"name":"06. Adicionar ao Carrinho","event":[{"listen":"test","script":{"exec":["const json = pm.response.json();","if (json && json.cartId) {","  pm.collectionVariables.set('cartId', json.cartId);","}","pm.test('Status is 200', () => pm.response.to.have.status(200));"],"type":"text/javascript","packages":{},"requests":{},"id":"82cf3277-ce8d-4a75-8eba-9c153bf4794a"}}],"id":"c503762d-b302-4514-991f-c5af20a04b5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"shareId\": \"b60cdd05-bb50-4ff0-9b8b-aedcdd2f7004\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/carts/items","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Adicionar uma <strong>cota ao carrinho ativo</strong>, criando o carrinho caso ainda não exista.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Body: <code>{ \"shareId\": \"\" }</code>.</p>\n</li>\n<li><p>Cria carrinho se não existir, ou adiciona cota ao carrinho ativo.</p>\n</li>\n<li><p>O teste salva <code>cartId</code> retornado.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — carrinho atualizado:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"cartId\": \"b60cdd05-bb50-4ff0-9b8b-aedcdd2f7004\",\n  \"status\": \"active\",\n  \"totalPrice\": 95000,\n  \"shares\": [{ \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\" }]\n}\n\n</code></pre>\n<p><strong>409</strong> — cota bloqueada ou indisponível.</p>\n","urlObject":{"path":["carts","items"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"30dd62a8-9523-4c89-b3ce-bf9dff939509","name":"200 OK","originalRequest":{"method":"POST","header":[],"url":"/carts/items"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"cartId\": \"b60cdd05-bb50-4ff0-9b8b-aedcdd2f7004\",\n  \"status\": \"active\",\n  \"totalPrice\": 95000,\n  \"shares\": [\n    {\n      \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\"\n    }\n  ]\n}"}],"_postman_id":"c503762d-b302-4514-991f-c5af20a04b5d"},{"name":"07. Buscar Compradores pelo Documento","event":[{"listen":"test","script":{"exec":["pm.test('Status is 200', () => pm.response.to.have.status(200));","const json = pm.response.json();","if (json && json.items && json.items.length > 0) {","  pm.collectionVariables.set('buyerPublicId', json.items[0].publicId);","}"],"type":"text/javascript","packages":{},"requests":{},"id":"98bfdace-f180-486b-9d5a-999681befabd"}}],"id":"fbdb7a8d-63eb-4ddc-94eb-8fd8a8572f72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"url":"{{baseUrl}}/buyers?search={{buyerDocument}}&limit=20","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Buscar <strong>compradores pelo CPF, CNPJ ou nome</strong>, permitindo identificar um comprador existente.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Query <code>search</code>: CPF/CNPJ ou nome parcial.</p>\n</li>\n<li><p>Se encontrar, o teste salva <code>buyerPublicId</code> do primeiro item.</p>\n</li>\n<li><p>Se vazio, execute \"Create Buyer\" em seguida.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — compradores encontrados:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"items\": [{\n    \"publicId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n    \"name\": \"Rafael Mendes\",\n    \"document\": \"47517812866\",\n    \"documentMasked\": \"***.***.***-66\",\n    \"buyerType\": \"person\",\n    \"kycStatus\": \"pending\",\n    \"reservationsCount\": 0\n  }],\n  \"nextCursor\": null\n}\n\n</code></pre>\n","urlObject":{"path":["buyers"],"host":["{{baseUrl}}"],"query":[{"key":"search","value":"{{buyerDocument}}"},{"key":"limit","value":"20"}],"variable":[]}},"response":[{"id":"3104b417-6a42-41d9-8803-9f7aee61ad46","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/buyers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"items\": [\n    {\n      \"publicId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n      \"name\": \"Rafael Mendes\",\n      \"document\": \"47517812866\",\n      \"documentMasked\": \"***.***.***-66\",\n      \"buyerType\": \"person\",\n      \"kycStatus\": \"pending\",\n      \"reservationsCount\": 0\n    }\n  ],\n  \"nextCursor\": null\n}"}],"_postman_id":"fbdb7a8d-63eb-4ddc-94eb-8fd8a8572f72"},{"name":"08. Criar Comprador","event":[{"listen":"test","script":{"exec":["const json = pm.response.json();","if (json && json.publicId) {","  pm.collectionVariables.set('buyerPublicId', json.publicId);","}","if (json && json.buyerId) {","  pm.collectionVariables.set('buyerPublicId', json.buyerId);","}","pm.test('Created or already linked', () => pm.expect([201, 409]).to.include(pm.response.code));"],"type":"text/javascript","packages":{},"requests":{},"id":"0a432191-b281-4241-873d-b9b8d34d238a"}}],"id":"fe9e83e4-34f1-45cc-8582-3b6795b891cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"document\": \"47517812866\",\n  \"name\": \"Rafael Mendes\",\n  \"email\": \"rafael.mendes@consorciei.com.br\",\n  \"phone\": \"11960700253\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/buyers","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Cadastrar um <strong>novo comprador</strong> no workspace do parceiro.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Body obrigatório: <code>document</code>, <code>name</code>, <code>email</code>, <code>phone</code>.</p>\n</li>\n<li><p>Use quando a busca por documento não retornou comprador.</p>\n</li>\n<li><p>O teste salva <code>buyerPublicId</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>201</strong> — comprador criado:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"publicId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"document\": \"47517812866\",\n  \"name\": \"Rafael Mendes\",\n  \"email\": \"rafael.mendes@consorciei.com.br\",\n  \"phone\": \"11960700053\",\n  \"buyerType\": \"person\"\n}\n\n</code></pre>\n<p><strong>409</strong> — documento já cadastrado no workspace.</p>\n","urlObject":{"path":["buyers"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"87d8ce22-3f30-4a13-b6ae-513c755ce98d","name":"201 Created","originalRequest":{"method":"POST","header":[],"url":"/buyers"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"publicId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"document\": \"47517812866\",\n  \"name\": \"Rafael Mendes\",\n  \"email\": \"rafael.mendes@consorciei.com.br\",\n  \"phone\": \"11960700053\",\n  \"buyerType\": \"person\"\n}"}],"_postman_id":"fe9e83e4-34f1-45cc-8582-3b6795b891cf"},{"name":"09. Criar Reserva","event":[{"listen":"test","script":{"exec":["const json = pm.response.json();","if (json) {","  if (json.publicId) pm.collectionVariables.set('reservationPublicId', json.publicId);","  if (json.reservationId) pm.collectionVariables.set('reservationPublicId', json.reservationId);","  if (json.version) pm.collectionVariables.set('reservationVersion', String(json.version));","  if (json.cartId) pm.collectionVariables.set('cartId', json.cartId);","  if (json.contractId) pm.collectionVariables.set('contractId', json.contractId);","}","const etag = pm.response.headers.get('ETag');","if (etag) {","  pm.collectionVariables.set('reservationVersion', etag.replace(/\\\"/g, ''));","}","pm.test('Status is 201', () => pm.response.to.have.status(201));"],"type":"text/javascript","packages":{},"requests":{},"id":"f1ad7371-e8f8-40a5-bea5-60e36c9c2501"}}],"id":"4e4b2a4b-e7a0-4dba-9a5d-46e42bb1aeff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"buyerId\": \"fe57f54f-1614-4096-99d4-d3cbb3f165f9\",\n  \"cartId\": \"6813e8eb-26f9-4696-b6cf-b2744472ea14\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/reservations","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Criar uma <strong>reserva para o comprador</strong>, utilizando as cotas do carrinho ativo.</p>\n","urlObject":{"path":["reservations"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4e4b2a4b-e7a0-4dba-9a5d-46e42bb1aeff"},{"name":"10. Listar Reservas Pelo Status","event":[{"listen":"test","script":{"exec":["pm.test('Status is 200', () => pm.response.to.have.status(200));","const json = pm.response.json();","if (json && json.items && json.items.length > 0) {","  const item = json.items[0];","  pm.collectionVariables.set('reservationPublicId', item.reservationId || item.publicId);","}"],"type":"text/javascript","packages":{},"requests":{},"id":"6b09c652-a3cf-428b-bd57-e99f689aa24a"}}],"id":"d4392830-07f9-4bd0-a2bf-356118149639","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"url":"{{baseUrl}}/reservations?status=documentation&limit=20&partner_id={{partnerId}}","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Listar as <strong>reservas do parceiro</strong>, permitindo filtrar pelo status da reserva.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Query <code>status</code>: <code>documentation</code>, <code>contract</code>, <code>payment</code>, <code>transfer</code>, <code>finished</code>, <code>cancelled</code>.</p>\n</li>\n<li><p>Query <code>limit</code> e <code>partner_id</code> opcional.</p>\n</li>\n<li><p>O teste salva <code>reservationPublicId</code> do primeiro item.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — lista de reservas:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"items\": [{\n    \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n    \"status\": \"documentation\",\n    \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n    \"totalPrice\": 95000,\n    \"createdAt\": \"2026-10-05T10:00:00.000Z\"\n  }],\n  \"nextCursor\": null\n}\n\n</code></pre>\n","urlObject":{"path":["reservations"],"host":["{{baseUrl}}"],"query":[{"key":"status","value":"documentation"},{"key":"limit","value":"20"},{"key":"partner_id","value":"{{partnerId}}"}],"variable":[]}},"response":[{"id":"203d0766-4e97-4fcf-961d-9e285d2387c5","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"items\": [\n    {\n      \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n      \"status\": \"documentation\",\n      \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n      \"totalPrice\": 95000,\n      \"createdAt\": \"2026-10-05T10:00:00.000Z\"\n    }\n  ],\n  \"nextCursor\": null\n}"}],"_postman_id":"d4392830-07f9-4bd0-a2bf-356118149639"},{"name":"11. Buscar Reserva","event":[{"listen":"test","script":{"type":"text/javascript","exec":["const json = pm.response.json();","if (json) {","  if (json.publicId) pm.collectionVariables.set('reservationPublicId', json.publicId);","  if (json.reservationId) pm.collectionVariables.set('reservationPublicId', json.reservationId);","  if (json.version) pm.collectionVariables.set('reservationVersion', String(json.version));","  if (json.cartId) pm.collectionVariables.set('cartId', json.cartId);","  if (json.contractId) pm.collectionVariables.set('contractId', json.contractId);","}","const etag = pm.response.headers.get('ETag');","if (etag) {","  pm.collectionVariables.set('reservationVersion', etag.replace(/\\\"/g, ''));","}","pm.test('Status is 200', () => pm.response.to.have.status(200));"],"id":"993eedcc-f7a4-440f-936a-02498fc2c0b7"}}],"id":"9fbe55e3-2bc9-4daf-b33e-9c4ad428ab86","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"url":"{{baseUrl}}/reservations/","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Consultar os <strong>detalhes de uma reserva</strong>, incluindo status, comprador, cotas e ações disponíveis.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Use <code>{{ reservationPublicId }}</code> salvo nos passos anteriores.</p>\n</li>\n<li><p>Retorna detalhe completo com cotas, comprador e comandos disponíveis.</p>\n</li>\n<li><p>Header <code>ETag</code> contém a versão para updates concorrentes.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — detalhe da reserva:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"statusStep\": \"awaiting_documents\",\n  \"version\": 1,\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"shares\": [{ \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\" }],\n  \"availableCommands\": [\"send_self_service\", \"cancel\"]\n}\n\n</code></pre>\n","urlObject":{"path":["reservations",""],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"db621b79-508d-459c-93b0-1bccb5076f08","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/reservations/7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"statusStep\": \"awaiting_documents\",\n  \"version\": 1,\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"shares\": [\n    {\n      \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\"\n    }\n  ],\n  \"availableCommands\": [\n    \"send_self_service\",\n    \"cancel\"\n  ]\n}"}],"_postman_id":"9fbe55e3-2bc9-4daf-b33e-9c4ad428ab86"},{"name":"12. Enviar para Autoserviço","event":[{"listen":"test","script":{"id":"e8ad474d-e29d-42c1-a819-778a305c0c86","exec":["const json = pm.response.json();","if (json) {","  if (json.publicId) pm.collectionVariables.set('reservationPublicId', json.publicId);","  if (json.reservationId) pm.collectionVariables.set('reservationPublicId', json.reservationId);","  if (json.version) pm.collectionVariables.set('reservationVersion', String(json.version));","  if (json.cartId) pm.collectionVariables.set('cartId', json.cartId);","  if (json.contractId) pm.collectionVariables.set('contractId', json.contractId);","}","const etag = pm.response.headers.get('ETag');","if (etag) {","  pm.collectionVariables.set('reservationVersion', etag.replace(/\\\"/g, ''));","}","pm.test('Status is 201', () => pm.response.to.have.status(201));"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"19eb285c-7748-4a64-ac84-f45e6eff4e2b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"url":"{{baseUrl}}/reservations//self-service","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Enviar ao <strong>comprador o acesso ao portal de autosserviço</strong> para dar continuidade à reserva.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Envia notificação ao comprador para acessar o portal de autosserviço.</p>\n</li>\n<li><p>Requer reserva ativa em status <code>documentation</code>.</p>\n</li>\n<li><p>Dispara evento assíncrono de notificação.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>202</strong> — enfileirado:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"status\": \"queued\",\n  \"eventId\": \"7fca2d77-...:SELF_SERVICE_NOTIFICATION_EVENT:1735689600000\"\n}\n\n</code></pre>\n<p><strong>404</strong> — reserva não encontrada.<br /><strong>409</strong> — reserva expirada ou em status terminal.</p>\n","urlObject":{"path":["reservations","","self-service"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"5239281a-6c97-4765-bdc6-b98a0b7e62e2","name":"202 Accepted","originalRequest":{"method":"POST","header":[],"url":"/api/v1/reservations/7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a/self-service"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"queued\",\n  \"eventId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a:SELF_SERVICE_NOTIFICATION_EVENT:1735689600000\"\n}"}],"_postman_id":"19eb285c-7748-4a64-ac84-f45e6eff4e2b"},{"name":"13. Remover Reserva","id":"d47a4082-c74c-4ed4-9d59-e3689f88682b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[{"key":"Authorization","value":"Bearer "},{"key":"partner_id","value":"partner-demo"}],"url":"{{baseUrl}}/reservations/","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Cancelar uma <strong>reserva ativa</strong> do parceiro.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Cancela/exclui reserva pelo <code>{{ reservationPublicId }}</code>.</p>\n</li>\n<li><p>Requer header <code>partner_id</code> e Bearer token.</p>\n</li>\n<li><p>Só funciona em reservas ativas (não finalizadas).</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — cancelada:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{ \"status\": \"reservation-cancelled\" }\n\n</code></pre>\n<p><strong>404</strong> — reserva não encontrada.<br /><strong>409</strong> — reserva não está ativa.</p>\n","urlObject":{"path":["reservations",""],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"c99dd870-f114-474a-9d81-bd30fdd8ab1f","name":"200 OK","originalRequest":{"method":"DELETE","header":[],"url":"/reservations/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"reservation-cancelled\"\n}"}],"_postman_id":"d47a4082-c74c-4ed4-9d59-e3689f88682b"},{"name":"14. Criação Direta de Reserva e Envio para Autoserviço","event":[{"listen":"test","script":{"exec":["const json = pm.response.json();","if (json) {","  if (json.publicId) pm.collectionVariables.set('reservationPublicId', json.publicId);","  if (json.reservationId) pm.collectionVariables.set('reservationPublicId', json.reservationId);","  if (json.version) pm.collectionVariables.set('reservationVersion', String(json.version));","  if (json.cartId) pm.collectionVariables.set('cartId', json.cartId);","  if (json.contractId) pm.collectionVariables.set('contractId', json.contractId);","}","const etag = pm.response.headers.get('ETag');","if (etag) {","  pm.collectionVariables.set('reservationVersion', etag.replace(/\\\"/g, ''));","}","pm.test('Status is 201', () => pm.response.to.have.status(201));"],"type":"text/javascript","packages":{},"requests":{},"id":"bd804b2c-36d9-4500-b93c-0790d69ca860"}}],"id":"c3ed328c-58e9-4cd1-bca9-e0aacda38ace","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"shareIds\": [\"87e9ec63-a1d9-44d1-a728-b934f4963829\"]\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/api/v1/reservations","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Criar uma <strong>reserva de forma simplificada</strong>, vinculando o comprador e as cotas e enviando para o fluxo de autosserviço.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Cria reserva informando comprador <strong>já existente</strong>.</p>\n</li>\n<li><p>Body: <code>{ \"buyerId\": \"\", \"shareIds\": [\"\"] }</code>.</p>\n</li>\n<li><p>Alternativa ao fluxo carrinho → reserva.</p>\n</li>\n<li><p>O teste salva <code>reservationPublicId</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>201</strong> — reserva criada:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"statusStep\": \"awaiting_documents\",\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"version\": 1,\n  \"availableCommands\": [\"send_self_service\", \"cancel\"]\n}\n\n</code></pre>\n","urlObject":{"path":["api","v1","reservations"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"d3c04b2d-b717-4972-922a-ee383b1e416d","name":"201 Created","originalRequest":{"method":"POST","header":[],"url":"/api/v1/reservations"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"statusStep\": \"awaiting_documents\",\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"version\": 1,\n  \"availableCommands\": [\n    \"send_self_service\",\n    \"cancel\"\n  ]\n}"}],"_postman_id":"c3ed328c-58e9-4cd1-bca9-e0aacda38ace"},{"name":"14. Criação Direta de Reserva e Comprador com Envio para Autoserviço","event":[{"listen":"test","script":{"exec":["const json = pm.response.json();","if (json) {","  if (json.publicId) pm.collectionVariables.set('reservationPublicId', json.publicId);","  if (json.reservationId) pm.collectionVariables.set('reservationPublicId', json.reservationId);","  if (json.version) pm.collectionVariables.set('reservationVersion', String(json.version));","  if (json.cartId) pm.collectionVariables.set('cartId', json.cartId);","  if (json.contractId) pm.collectionVariables.set('contractId', json.contractId);","}","const etag = pm.response.headers.get('ETag');","if (etag) {","  pm.collectionVariables.set('reservationVersion', etag.replace(/\\\"/g, ''));","}","pm.test('Status is 201', () => pm.response.to.have.status(201));"],"type":"text/javascript","packages":{},"requests":{},"id":"dea7abcb-0d0c-4d51-a00e-33a150bb15ad"}}],"id":"a91f06ab-f5da-4c93-9558-44fb10f0d358","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"shareIds\": [\"87e9ec63-a1d9-44d1-a728-b934f4963829\"],\n  \"buyer\": {\n    \"document\": \"73789958000\",\n    \"name\": \"Andre\",\n    \"email\": \"a@b.com\",\n    \"phone\": \"11999999999\"\n  }\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/api/v1/reservations","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Criar uma <strong>reserva e um novo comprador em uma única chamada</strong>, vinculando as cotas e iniciando o fluxo de autosserviço.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Cria reserva <strong>e comprador</strong> em uma única chamada.</p>\n</li>\n<li><p>Body: <code>{ \"shareIds\": [\"\"], \"buyer\": { \"document\", \"name\", \"email\", \"phone\" } }</code>.</p>\n</li>\n<li><p>Útil quando o comprador ainda não existe.</p>\n</li>\n<li><p>O teste salva <code>reservationPublicId</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>201</strong> — reserva + comprador criados:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"version\": 1\n}\n\n</code></pre>\n","urlObject":{"path":["api","v1","reservations"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"0764878a-5596-4c0b-9fae-2fccbbee0554","name":"201 Created","originalRequest":{"method":"POST","header":[],"url":"/api/v1/reservations"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"reservationId\": \"7fca2d77-4c7a-442e-b6e9-7bd9daf7ce7a\",\n  \"status\": \"documentation\",\n  \"buyerId\": \"6105ae91-05fa-4aa4-96c4-6f59f6584ec7\",\n  \"totalPrice\": 95000,\n  \"version\": 1\n}"}],"_postman_id":"a91f06ab-f5da-4c93-9558-44fb10f0d358"}],"id":"61593619-596a-4be2-869c-6f9aed1497cc","description":"<p>Fluxo M2M do consultor parceiro.</p>\n<p><strong>Ordem:</strong> Token → Get Me → Listar cotas → Carrinho → Comprador → Reserva → Autosserviço.</p>\n<p><em>*</em></p>\n<p><strong>PARA FLUXO CONSULTOR UTILIZE AS CREDENCIAIS DISPONIBILIZADAS DO PERFIL DE CONSULTOR</strong></p>\n<p><em>*</em></p>\n","_postman_id":"61593619-596a-4be2-869c-6f9aed1497cc"},{"name":"Base","item":[{"name":"01. Autenticação","event":[{"listen":"test","script":{"id":"9b71f6aa-394c-482b-ae07-13738fc2e29f","exec":["function readJsonBody() {","  let parsed;","  try {","    parsed = pm.response.json();","  } catch (_error) {","    return null;","  }","  if (parsed && typeof parsed.body === 'string') {","    try {","      parsed = JSON.parse(parsed.body);","    } catch (_error) {","      return parsed;","    }","  }","  if (parsed && parsed.body && typeof parsed.body === 'object' && (parsed.body.access_token || parsed.body.accessToken)) {","    return parsed.body;","  }","  return parsed;","}","","const json = readJsonBody();","const accessToken = json && (json.access_token || json.accessToken);","pm.test('Status is 200', () => pm.response.to.have.status(200));","pm.test('OAuth token contract', () => {","  pm.expect(accessToken, 'access_token').to.be.a('string');","  pm.expect(accessToken.length).to.be.above(10);","});","if (accessToken) {","  pm.collectionVariables.set('accessToken', accessToken);","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"3b86dff0-15dd-4677-9e10-d48390278dda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials","type":"text"},{"key":"partner_id","value":"{{partnerId}}","type":"text"},{"key":"client_id","value":"","type":"text"},{"key":"client_secret","value":"","type":"text"}]},"url":"{{authorizerBaseUrl}}/api/oauth/token","description":"<h2 id=\"objetivo\">Objetivo</h2>\n<p>Autenticar o <strong>parceiro uploader</strong> e obter o <strong>access token</strong> para acessar os endpoints de importação e gestão de bases.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Preencha: <code>partnerIdUploader</code>, <code>partnerClientId</code>, <code>partnerClientSecret</code>.</p>\n</li>\n<li><p>Parceiro com perfil <strong>uploader</strong> (importação de base).</p>\n</li>\n<li><p>Execute primeiro — salva <code>accessToken</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — token OAuth2:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"access_token\": \"eyJhbG...\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 300\n}\n\n</code></pre>\n","urlObject":{"path":["api","oauth","token"],"host":["{{authorizerBaseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"1b52d855-805a-4d05-b867-d51ce32d6945","name":"200 OK","originalRequest":{"method":"POST","header":[],"url":"/api/oauth/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 300\n}"}],"_postman_id":"3b86dff0-15dd-4677-9e10-d48390278dda"},{"name":"02. Info User","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"7388aac3-7929-458e-9c7f-7e758a48c726"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"8a5e908f-351a-4bae-b358-dcc843a34ece"}}],"id":"f1a8c008-2bce-4e3d-a76e-06746c604957","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"partner_id","value":"{{partnerIdUploader}}","type":"text"}],"url":"{{baseUrl}}/auth/me","description":"<h2 id=\"objetivo\">Objetivo</h2>\n<p>Consultar os <strong>dados e permissões do parceiro uploader</strong>, validando o acesso à importação de cotas.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Valida identidade do parceiro uploader.</p>\n</li>\n<li><p>Header <code>partner_id</code>: <code>{{partnerIdUploader}}</code>.</p>\n</li>\n<li><p>Confirma permissões de importação (<code>share:import</code>).</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — perfil uploader:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"actorId\": \"uploader-uuid\",\n  \"workspaceId\": \"11111111-1111-4111-a111-111111111111\",\n  \"actorKind\": \"partner\",\n  \"accessProfileId\": \"backoffice-operator\",\n  \"permissions\": [{ \"area\": \"share\", \"nivelAcesso\": \"import\" }]\n}\n\n</code></pre>\n","urlObject":{"path":["auth","me"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"ec6a560d-7412-4855-bcc8-f47c34fa4e6a","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/auth/me"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"actorId\": \"uploader-uuid\",\n  \"workspaceId\": \"11111111-1111-4111-a111-111111111111\",\n  \"actorKind\": \"partner\",\n  \"accessProfileId\": \"backoffice-operator\",\n  \"permissions\": [\n    {\n      \"area\": \"share\",\n      \"nivelAcesso\": \"import\"\n    }\n  ]\n}"}],"_postman_id":"f1a8c008-2bce-4e3d-a76e-06746c604957"},{"name":"03. Listagem de Base","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"02391b67-4a17-4a3c-9e95-013519615f55"}}],"id":"8138db76-8b5a-4a5f-845b-c08e0e4ae65e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"partner_id","value":"{{partnerIdUploader}}","type":"text"}],"url":"{{baseUrl}}/share-uploads?status=pending","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Listar os <strong>jobs de importação de cotas</strong>, permitindo acompanhar o status do processamento da base.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Lista jobs de importação de cotas.</p>\n</li>\n<li><p>Query <code>status</code>: <code>pending</code>, <code>processed</code>, <code>processed_with_errors</code>, <code>rejected</code>.</p>\n</li>\n<li><p>Bearer + <code>partner_id</code> do uploader.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — array de jobs:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">[{\n  \"id\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n  \"status\": \"pending\",\n  \"baseType\": \"update\",\n  \"created\": 0,\n  \"updated\": 0,\n  \"errors\": 0,\n  \"createdAt\": \"2026-10-05T09:00:00.000Z\"\n}]\n\n</code></pre>\n","urlObject":{"path":["share-uploads"],"host":["{{baseUrl}}"],"query":[{"key":"status","value":"pending"}],"variable":[]}},"response":[{"id":"390610fe-2a0f-4be5-b687-7aa55a0a48aa","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/share-uploads"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n  {\n    \"id\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n    \"status\": \"pending\",\n    \"baseType\": \"update\",\n    \"created\": 0,\n    \"updated\": 0,\n    \"errors\": 0,\n    \"createdAt\": \"2026-10-05T09:00:00.000Z\"\n  }\n]"}],"_postman_id":"8138db76-8b5a-4a5f-845b-c08e0e4ae65e"},{"name":"04. Detalhes de uma Base","id":"d0390dd3-9b21-4977-a4c7-2c50b6e19216","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"{{baseUrl}}/share-uploads/:id","description":"<h2 id=\"objetivo\">Objetivo</h2>\n<p>Consultar os <strong>detalhes de um job de importação</strong>, incluindo status, registros processados e erros de validação.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Substitua <code>:id</code> pelo UUID do job de importação.</p>\n</li>\n<li><p>Retorna status, contadores e erros de validação.</p>\n</li>\n<li><p>Salve o <code>id</code> como <code>shareUploadId</code> para exclusão.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — detalhe do job:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"id\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n  \"status\": \"processed_with_errors\",\n  \"created\": 10,\n  \"updated\": 5,\n  \"errors\": 2,\n  \"ignored\": 1,\n  \"uploadErrors\": [{ \"row\": 3, \"column\": \"GRUPO\", \"reason\": \"Campo obrigatório\" }]\n}\n\n</code></pre>\n<p><strong>404</strong> — job não encontrado.</p>\n","urlObject":{"path":["share-uploads",":id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"type":"any","value":"d39f454e-78f1-4796-bd7a-f30516e492e8","key":"id"}]}},"response":[{"id":"9a35ea25-f849-4508-bc88-3a77ca541d27","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/share-uploads/a698ec57-79ac-4dbe-a941-ce610a8f28b5"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"id\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n  \"status\": \"processed_with_errors\",\n  \"created\": 10,\n  \"updated\": 5,\n  \"errors\": 2,\n  \"ignored\": 1,\n  \"uploadErrors\": [\n    {\n      \"row\": 3,\n      \"column\": \"GRUPO\",\n      \"reason\": \"Campo obrigatório\"\n    }\n  ]\n}"}],"_postman_id":"d0390dd3-9b21-4977-a4c7-2c50b6e19216"},{"name":"05. Apagar job Importação","id":"5ee96822-e00c-45d1-9271-8e39e2515118","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[{"key":"partner_id","value":"mycon-api-uploader"}],"url":"{{baseUrl}}/share-uploads/{{shareUploadId}}","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Remover um <strong>job de importação de cotas</strong> ainda não processado.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Remove job de importação pelo <code>{{shareUploadId}}</code>.</p>\n</li>\n<li><p>Bearer + <code>partner_id</code> do uploader.</p>\n</li>\n<li><p>Só jobs que ainda não foram processados ou em ambiente de teste.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>204</strong> — removido (body vazio).</p>\n<p><strong>404</strong> — job não encontrado.</p>\n","urlObject":{"path":["share-uploads","{{shareUploadId}}"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"1f4ddeee-2179-413d-9f7f-5cf4d7ee6a93","name":"204 No Content","originalRequest":{"method":"DELETE","header":[],"url":"/share-uploads/{{shareUploadId}}"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"5ee96822-e00c-45d1-9271-8e39e2515118"},{"name":"06. Criar Cotas","event":[{"listen":"prerequest","script":{"id":"52e89cad-2485-40c4-b30c-d1be615cee3b","exec":["const CryptoJS = require('crypto-js');","","const tenantHost = 'localhost:5173';","const secret = 'local-bff-hmac-current';","const timestamp = String(Math.floor(Date.now() / 1000));","","function getPath() {","  const url = pm.request.url;","  let path = '';","  if (typeof url.getPath === 'function') {","    const p = url.getPath();","    path = Array.isArray(p) ? p.join('/') : String(p || '');","  } else if (Array.isArray(url.path)) {","    path = url.path.join('/');","  }","  path = pm.variables.replaceIn(path || '/');","  return path.charAt(0) === '/' ? path : '/' + path;","}","","function collectQuery() {","  const query = {};","  const params = pm.request.url.query;","  if (!params) return query;","  const list = typeof params.all === 'function' ? params.all() : [];","  for (const param of list) {","    if (!param || param.disabled || !param.key) continue;","    const value = pm.variables.replaceIn(String(param.value ?? ''));","    query[param.key] = value;","  }","  return query;","}","","function canonicalizeQuery(query) {","  return Object.keys(query).sort().map((key) =>","    `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`","  ).join('&');","}","","function resolveBody() {","  if (pm.request.method.toUpperCase() === 'GET' || pm.request.method.toUpperCase() === 'DELETE') {","    return '';","  }","  if (!pm.request.body || pm.request.body.mode !== 'raw' || !pm.request.body.raw) {","    return '';","  }","  const raw = pm.variables.replaceIn(String(pm.request.body.raw)).trim();","  if (!raw) return '';","  try {","    return JSON.stringify(JSON.parse(raw));","  } catch {","    return raw;","  }","}","","const path = getPath();","const body = resolveBody();","const canonical = [","  pm.request.method.toUpperCase(),","  path,","  canonicalizeQuery(collectQuery()),","  tenantHost.toLowerCase(),","  timestamp,","  CryptoJS.SHA256(body).toString(CryptoJS.enc.Hex),","].join('\\n');","","const signature = 'sha256=' + CryptoJS.HmacSHA256(canonical, secret).toString(CryptoJS.enc.Hex);","","pm.request.headers.upsert({ key: 'X-Tenant-Host', value: tenantHost });","pm.request.headers.upsert({ key: 'X-Timestamp', value: timestamp });","pm.request.headers.upsert({ key: 'X-Signature', value: signature });","pm.request.headers.upsert({ key: 'Origin', value: 'http://localhost:5173' });"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"7d5aa483-28a2-43d4-b741-4bbca69f0aa6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"partner_id","value":"{{partnerIdUploader}}","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"shares\": [\n    {\n      \"ID_DONO_COTA\": \"34.993.731/0001-12\",\n      \"GRUPO\": \"1503\",\n      \"NUMERO_COTA\": \"2523\",\n      \"VERSAO_COTA\": \"0\",\n      \"NUMERO_CONTRATO\": \"55818173\",\n      \"DATA_PRIMEIRA_VENDA\": \"09/12/2024\",\n      \"SITUACAO_COTA\": \"1\",\n      \"VALOR_CREDITO\": 104151,\n      \"TIPO_BEM\": \"Imóvel\",\n      \"VALOR_LIQUIDO_A_PAGAR\": 104151,\n      \"PCT_TX_ADM_TOTAL\": 22,\n      \"PCT_FUNDO_RESERVA_TOTAL\": 0,\n      \"PCT_FUNDO_COMUM_PAGO\": 0.5299,\n      \"PCT_TX_ADM_PAGO\": 2.317,\n      \"PCT_FUNDO_RESERVA_PAGO\": 0,\n      \"PGTOS_RESTANTES\": 176,\n      \"QUANTIDADE_PARCELAS_PAGAS\": 9,\n      \"PARCELAS_EM_ATRASO\": 0,\n      \"VALOR_PARCELA_ATUAL\": 732.73,\n      \"VALOR_EM_ATRASO\": 7,\n      \"VALOR_PLANO_TOTAL\": 132157.71,\n      \"SALDO_DEVEDOR\": 128943.33,\n      \"DATA_FIM_GRUPO\": \"19/08/2040\",\n      \"DATA_CONTEMPLACAO\": \"18/08/2025\",\n      \"INDICE_REAJUSTE\": \"IPCA\",\n      \"DATA_REAJUSTE\": \"16/12/2026\",\n      \"DIA_PAGAMENTO\": 17,\n      \"TAXA_TRANSFERENCIA\": 0,\n      \"GRUPO_AGENTE\": null,\n      \"ID_COTA\": \"55818162\",\n      \"TIPO_CONTEMPLACAO\": \"Sorteio\",\n      \"PARC_VINCENDAS\": \"151x732,63|25x741\",\n      \"SUB_COTA\": \"0\",\n      \"PRAZO_DA_COTA\": 176,\n      \"VALOR_PAGO\": 22893,\n      \"PCT_PRESTAMISTA_PARC\": 0.60\n    }\n  ]\n}\n","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/share-uploads/import","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Criar um <strong>job de importação de cotas</strong> a partir de dados em JSON para processamento assíncrono.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Importa cotas via JSON (alternativa ao upload de arquivo).</p>\n</li>\n<li><p>Body: <code>{ \"shares\": [ { campos da planilha } ] }</code>.</p>\n</li>\n<li><p>O pre-request script assina HMAC (local: secret <code>local-bff-hmac-current</code>).</p>\n</li>\n<li><p>Processamento é assíncrono — acompanhe pelo job em \"Listagem de base\".</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>201</strong> — job criado:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"shareUploadId\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n  \"status\": \"pending\",\n  \"itemCount\": 1,\n  \"payloadSizeBytes\": 2048\n}\n\n</code></pre>\n<p><strong>400</strong> — validação falhou com <code>details: [{ index, column, reason }]</code>.</p>\n","urlObject":{"path":["share-uploads","import"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"50405313-65c3-40e7-b5cf-30f41a904f47","name":"201 Created","originalRequest":{"method":"POST","header":[],"url":"/share-uploads/import"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"shareUploadId\": \"a698ec57-79ac-4dbe-a941-ce610a8f28b5\",\n  \"status\": \"pending\",\n  \"itemCount\": 1,\n  \"payloadSizeBytes\": 2048\n}"}],"_postman_id":"7d5aa483-28a2-43d4-b741-4bbca69f0aa6"},{"name":"07. Listagem de Cotas","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"aaa5e4bd-9478-4ba5-b523-40d1f0347650"}},{"listen":"prerequest","script":{"exec":["const CryptoJS = require('crypto-js');","","const tenantHost = 'localhost:5173';","const secret = 'local-bff-hmac-current';","const timestamp = String(Math.floor(Date.now() / 1000));","","function getPath() {","  const url = pm.request.url;","  let path = '';","  if (typeof url.getPath === 'function') {","    const p = url.getPath();","    path = Array.isArray(p) ? p.join('/') : String(p || '');","  } else if (Array.isArray(url.path)) {","    path = url.path.join('/');","  }","  path = pm.variables.replaceIn(path || '/');","  return path.charAt(0) === '/' ? path : '/' + path;","}","","function collectQuery() {","  const query = {};","  const params = pm.request.url.query;","  if (!params) return query;","  const list = typeof params.all === 'function' ? params.all() : [];","  for (const param of list) {","    if (!param || param.disabled || !param.key) continue;","    const value = pm.variables.replaceIn(String(param.value ?? ''));","    query[param.key] = value;","  }","  return query;","}","","function canonicalizeQuery(query) {","  return Object.keys(query).sort().map((key) =>","    `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`","  ).join('&');","}","","function resolveBody() {","  if (pm.request.method.toUpperCase() === 'GET' || pm.request.method.toUpperCase() === 'DELETE') {","    return '';","  }","  if (!pm.request.body || pm.request.body.mode !== 'raw' || !pm.request.body.raw) {","    return '';","  }","  const raw = pm.variables.replaceIn(String(pm.request.body.raw)).trim();","  if (!raw) return '';","  try {","    return JSON.stringify(JSON.parse(raw));","  } catch {","    return raw;","  }","}","","const path = getPath();","const body = resolveBody();","const canonical = [","  pm.request.method.toUpperCase(),","  path,","  canonicalizeQuery(collectQuery()),","  tenantHost.toLowerCase(),","  timestamp,","  CryptoJS.SHA256(body).toString(CryptoJS.enc.Hex),","].join('\\n');","","const signature = 'sha256=' + CryptoJS.HmacSHA256(canonical, secret).toString(CryptoJS.enc.Hex);","","pm.request.headers.upsert({ key: 'X-Tenant-Host', value: tenantHost });","pm.request.headers.upsert({ key: 'X-Timestamp', value: timestamp });","pm.request.headers.upsert({ key: 'X-Signature', value: signature });","pm.request.headers.upsert({ key: 'Origin', value: 'http://localhost:5173' });"],"type":"text/javascript","packages":{},"requests":{},"id":"cf70b718-bb69-4dbe-9910-217ffc769479"}}],"id":"400eb67c-e3f3-4683-aa73-1d8924671846","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"{{baseUrl}}/shares?limit=50&sort_by=credit&sort_order=desc","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Listar as <strong>cotas do workspace</strong>, permitindo filtrar por status e ordenar por crédito ou preço.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Lista cotas do workspace.</p>\n</li>\n<li><p>Queries: <code>status</code>, <code>limit</code>, <code>sort_by</code> (<code>credit</code>, <code>price</code>), <code>sort_order</code> (<code>asc</code>/<code>desc</code>).</p>\n</li>\n<li><p>Requer HMAC (pre-request script da request).</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — lista paginada:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"items\": [{ \"shareId\": \"861a713d-4744-42b9-ae88-b7a642c6341b\", \"credit\": 104151, \"price\": 95000, \"shareStatusSlug\": \"available\" }],\n  \"count\": 1,\n  \"totalCount\": 150,\n  \"limit\": 50,\n  \"nextCursor\": null\n}\n\n</code></pre>\n","urlObject":{"path":["shares"],"host":["{{baseUrl}}"],"query":[{"disabled":true,"key":"status","value":"in_transaction"},{"key":"limit","value":"50"},{"key":"sort_by","value":"credit"},{"key":"sort_order","value":"desc"}],"variable":[]}},"response":[{"id":"664f30c7-47d2-4494-ade1-6548e9256058","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/shares"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"items\": [\n    {\n      \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n      \"contractNumber\": \"55818162\",\n      \"groupNumber\": \"1503\",\n      \"shareNumber\": \"2503\",\n      \"credit\": 104151,\n      \"installment\": 732.73,\n      \"price\": 95000,\n      \"shareStatusSlug\": \"available\"\n    }\n  ],\n  \"count\": 1,\n  \"totalCount\": 42,\n  \"limit\": 10,\n  \"nextCursor\": null\n}"}],"_postman_id":"400eb67c-e3f3-4683-aa73-1d8924671846"},{"name":"08. Buscar Cota","event":[{"listen":"prerequest","script":{"id":"018e1c08-ea56-447b-9d65-5fb760d86613","exec":["const CryptoJS = require('crypto-js');","","const tenantHost = 'localhost:5173';","const secret = 'local-bff-hmac-current';","const timestamp = String(Math.floor(Date.now() / 1000));","","function getPath() {","  const url = pm.request.url;","  let path = '';","  if (typeof url.getPath === 'function') {","    const p = url.getPath();","    path = Array.isArray(p) ? p.join('/') : String(p || '');","  } else if (Array.isArray(url.path)) {","    path = url.path.join('/');","  }","  path = pm.variables.replaceIn(path || '/');","  return path.charAt(0) === '/' ? path : '/' + path;","}","","function collectQuery() {","  const query = {};","  const params = pm.request.url.query;","  if (!params) return query;","  const list = typeof params.all === 'function' ? params.all() : [];","  for (const param of list) {","    if (!param || param.disabled || !param.key) continue;","    const value = pm.variables.replaceIn(String(param.value ?? ''));","    query[param.key] = value;","  }","  return query;","}","","function canonicalizeQuery(query) {","  return Object.keys(query).sort().map((key) =>","    `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`","  ).join('&');","}","","function resolveBody() {","  if (pm.request.method.toUpperCase() === 'GET' || pm.request.method.toUpperCase() === 'DELETE') {","    return '';","  }","  if (!pm.request.body || pm.request.body.mode !== 'raw' || !pm.request.body.raw) {","    return '';","  }","  const raw = pm.variables.replaceIn(String(pm.request.body.raw)).trim();","  if (!raw) return '';","  try {","    return JSON.stringify(JSON.parse(raw));","  } catch {","    return raw;","  }","}","","const path = getPath();","const body = resolveBody();","const canonical = [","  pm.request.method.toUpperCase(),","  path,","  canonicalizeQuery(collectQuery()),","  tenantHost.toLowerCase(),","  timestamp,","  CryptoJS.SHA256(body).toString(CryptoJS.enc.Hex),","].join('\\n');","","const signature = 'sha256=' + CryptoJS.HmacSHA256(canonical, secret).toString(CryptoJS.enc.Hex);","","pm.request.headers.upsert({ key: 'X-Tenant-Host', value: tenantHost });","pm.request.headers.upsert({ key: 'X-Timestamp', value: timestamp });","pm.request.headers.upsert({ key: 'X-Signature', value: signature });","pm.request.headers.upsert({ key: 'Origin', value: 'http://localhost:5173' });"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"6e2f2d3c-3980-43c5-8d1e-8368203bbe10","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"{{baseUrl}}/shares/:id","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Consultar os <strong>detalhes de uma cota específica</strong>.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Detalhe de uma cota pelo UUID no path.</p>\n</li>\n<li><p>Header opcional <code>x-workspace-id</code> para escopo.</p>\n</li>\n<li><p>Requer HMAC.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — detalhe da cota:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"shareId\": \"861a713d-4744-42b9-ae88-b7a642c6341b\",\n  \"contractNumber\": \"55818162\",\n  \"credit\": 104151,\n  \"installment\": 732.73,\n  \"price\": 95000,\n  \"administratorName\": \"Rodobens\",\n  \"cet\": { \"monthly\": \"1.00% + IPCA\", \"annual\": \"12.00% + IPCA\" }\n}\n\n</code></pre>\n<p><strong>404</strong> — cota não encontrada.</p>\n","urlObject":{"path":["shares",":id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"type":"any","value":"28f3b239-79ab-4498-b7ae-486ec3b855e1","key":"id"}]}},"response":[{"id":"a70490b8-d352-4ab5-9d6f-ee8116a11993","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/shares/87e9ec63-a1d9-44d1-a728-b934f4963829"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"shareId\": \"87e9ec63-a1d9-44d1-a728-b934f4963829\",\n  \"contractNumber\": \"55818162\",\n  \"credit\": 104151,\n  \"installment\": 732.73,\n  \"price\": 95000,\n  \"administratorName\": \"Rodobens\",\n  \"cet\": {\n    \"monthly\": \"1.00% + IPCA\",\n    \"annual\": \"12.00% + IPCA\"\n  }\n}"}],"_postman_id":"6e2f2d3c-3980-43c5-8d1e-8368203bbe10"},{"name":"09. Atualizar Cota","id":"e11c4753-e841-42b5-adcc-ed83d57e07c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"price\": 34369.85\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/shares/:id","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Atualizar os <strong>dados editáveis de uma cota específica</strong>.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Atualiza campos editáveis da cota.</p>\n</li>\n<li><p>Body parcial, ex: <code>{ \"overdueValue\": 99.9 }</code>.</p>\n</li>\n<li><p>Método PATCH no path <code>/shares/:id</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong> — cota atualizada (mesmo shape do GET detalhe):</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"shareId\": \"e9bf9f26-672e-4054-9361-4abd76b44003\",\n  \"overdueValue\": 99.9,\n  \"credit\": 104151,\n  \"price\": 95000\n}\n\n</code></pre>\n<p><strong>404</strong> — cota não encontrada.<br /><strong>409</strong> — cota bloqueada.</p>\n","urlObject":{"path":["shares",":id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"type":"any","value":"28f3b239-79ab-4498-b7ae-486ec3b855e1","key":"id"}]}},"response":[{"id":"9b86fc9a-d172-480d-a8e7-774490238be9","name":"200 OK","originalRequest":{"method":"PATCH","header":[],"url":"/shares/e9bf9f26-672e-4054-9361-4abd76b44003"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"shareId\": \"e9bf9f26-672e-4054-9361-4abd76b44003\",\n  \"overdueValue\": 99.9,\n  \"credit\": 104151,\n  \"price\": 95000\n}"}],"_postman_id":"e11c4753-e841-42b5-adcc-ed83d57e07c2"},{"name":"10. Apagar Cota","id":"576b87a3-780a-4f7f-b7f5-bd2c81927de1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[{"key":"partner_id","value":"mycon-api-uploader"}],"url":"{{baseUrl}}/shares/","description":"<h3 id=\"objetivo\">Objetivo</h3>\n<p>Excluir uma <strong>cota específica</strong> do workspace do parceiro.</p>\n<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li><p>Exclui cota pelo <code>{{ shareId }}</code>.</p>\n</li>\n<li><p>Requer permissão <code>share:write</code>.</p>\n</li>\n<li><p>Bearer + <code>partner_id</code>.</p>\n</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>204</strong> — removida (body vazio).</p>\n<p><strong>404</strong> — cota não encontrada.</p>\n","urlObject":{"path":["shares",""],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"9302ce5c-3c77-479c-99bb-35e19f2ca754","name":"204 No Content","originalRequest":{"method":"DELETE","header":[],"url":"/shares/"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"576b87a3-780a-4f7f-b7f5-bd2c81927de1"}],"id":"cd235bd9-e933-4a69-8ab7-7841fa598e1b","description":"<p>Fluxo M2M do parceiro <strong>uploader</strong>, utilizado para <strong>importação e gestão de cotas</strong>.</p>\n<p><strong>Ordem:</strong> Token → Get Me → Importar/Listar bases → Consultar cotas.</p>\n<p><strong>Importante:</strong> para o fluxo de base, utilize as credenciais disponibilizadas para o perfil <strong>uploader</strong>.</p>\n","_postman_id":"cd235bd9-e933-4a69-8ab7-7841fa598e1b"},{"name":"Health Check","id":"4339146a-4bc9-4e00-bdd6-e5ccc00cedc4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/health","description":"<h2 id=\"como-usar\">Como usar</h2>\n<ol>\n<li>Probe de liveness — sem autenticação.</li>\n<li>URL: <code>GET {{baseUrl}}/health</code>.</li>\n</ol>\n<h2 id=\"exemplo-de-retorno\">Exemplo de retorno</h2>\n<p><strong>200</strong>:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{ \"status\": \"ok\" }\n</code></pre>\n","urlObject":{"path":["health"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"77165aaa-546d-4c59-b556-32f0f7dbc280","name":"200 OK","originalRequest":{"method":"GET","header":[],"url":"/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ok\"\n}"}],"_postman_id":"4339146a-4bc9-4e00-bdd6-e5ccc00cedc4"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["function getRequestPath() {","  const url = pm.request.url;","  let path = '';","","  if (typeof url.getPath === 'function') {","    const maybePath = url.getPath();","    if (Array.isArray(maybePath)) {","      path = maybePath.join('/');","    } else if (typeof maybePath === 'string') {","      path = maybePath;","    }","  }","","  if (!path && Array.isArray(url.path)) {","    path = url.path.join('/');","  }","","  path = pm.variables.replaceIn(String(path || ''));","  if (!path || path === '/') return path || '/';","  return path.charAt(0) === '/' ? path : '/' + path;","}","","function readVariable(name) {","  return pm.environment.get(name) || pm.collectionVariables.get(name) || '';","}","","const pathname = getRequestPath();","if (!pathname.endsWith('/api/oauth/token')) {","  const partnerId = readVariable('partnerId');","  if (partnerId) {","    pm.request.headers.upsert({ key: 'partner_id', value: partnerId });","  }","}"],"id":"bfe4044e-5d81-46e8-97a6-84cc4bc1c9fd"}}],"variable":[{"key":"accessToken","value":""},{"key":"workspaceId","value":""},{"key":"consultantId","value":""},{"key":"shareId","value":""},{"key":"cartId","value":""},{"key":"buyerPublicId","value":""},{"key":"reservationPublicId","value":""},{"key":"reservationVersion","value":""},{"key":"partnerClientId","value":"","type":"default"},{"key":"partnerClientSecret","value":"","type":"default"}]}