{ "item": [ { "name": "auth", "description": "", "item": [ { "name": "token", "description": "", "item": [ { "id": "089ade96-94ca-473f-bcbb-e5efb97a374f", "name": "Obtém token de acesso (client credentials)", "request": { "name": "Obtém token de acesso (client credentials)", "description": {}, "url": { "path": [ "auth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientId\": \"\",\n \"clientSecret\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "700f75b7-ca16-45fb-b7a6-964d8b29cf25", "name": "Token emitido", "originalRequest": { "url": { "path": [ "auth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientId\": \"\",\n \"clientSecret\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accessToken\": \"\",\n \"tokenType\": \"\",\n \"expiresIn\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfc06785-0424-41ba-b249-83179634d2e7", "name": "Credencial inválida ou token expirado", "originalRequest": { "url": { "path": [ "auth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientId\": \"\",\n \"clientSecret\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "whoami", "description": "", "item": [ { "id": "5a1e138d-44dd-458e-922b-026df29db4a1", "name": "Confirma qual parceiro o token representa", "request": { "name": "Confirma qual parceiro o token representa", "description": { "content": "Útil para validar a credencial e o ambiente logo no início da integração, sem\nefeito colateral. Não exige `X-End-User-Id`.\n", "type": "text/plain" }, "url": { "path": [ "auth", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d166cf78-3465-4ed2-b848-e82f97e8e623", "name": "Identificação do parceiro dono do token", "originalRequest": { "url": { "path": [ "auth", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"partnerId\": \"\",\n \"partnerName\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "633ee402-e71f-47cb-a94b-b5c642a62e8c", "name": "Credencial inválida ou token expirado", "originalRequest": { "url": { "path": [ "auth", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "offices", "description": "", "item": [ { "id": "f0dd9d4f-d89e-4397-ad92-0f3df4b73702", "name": "Cria um office (tenant do cliente final do parceiro)", "request": { "name": "Cria um office (tenant do cliente final do parceiro)", "description": {}, "url": { "path": [ "offices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"\",\n \"name\": \"\",\n \"taxId\": \"\",\n \"aiConfidenceThreshold\": \"\",\n \"isSandbox\": false,\n \"aiMonthlyCostCapUsd\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dd446628-623f-4e35-8259-03b915bc7533", "name": "Office criado", "originalRequest": { "url": { "path": [ "offices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"\",\n \"name\": \"\",\n \"taxId\": \"\",\n \"aiConfidenceThreshold\": \"\",\n \"isSandbox\": false,\n \"aiMonthlyCostCapUsd\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"code\": \"\",\n \"isSandbox\": \"\",\n \"isActive\": \"\",\n \"aiMonthlyCostCapUsd\": \"\",\n \"createdAt\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8515e6a7-fee9-46dc-b95e-004638344da4", "name": "Conflito (externalId ou Idempotency-Key reutilizada com payload diferente, ou unicidade violada)", "originalRequest": { "url": { "path": [ "offices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"\",\n \"name\": \"\",\n \"taxId\": \"\",\n \"aiConfidenceThreshold\": \"\",\n \"isSandbox\": false,\n \"aiMonthlyCostCapUsd\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "57ae6f1c-dfc9-43a1-918d-eada408f7f94", "name": "Lista offices da credencial", "request": { "name": "Lista offices da credencial", "description": {}, "url": { "path": [ "offices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "aa7a2a99-d8ec-430c-bdc7-bf9257421940", "name": "Lista", "originalRequest": { "url": { "path": [ "offices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"code\": \"\",\n \"isSandbox\": \"\",\n \"isActive\": \"\",\n \"aiMonthlyCostCapUsd\": \"\",\n \"createdAt\": \"\"\n },\n {\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"code\": \"\",\n \"isSandbox\": \"\",\n \"isActive\": \"\",\n \"aiMonthlyCostCapUsd\": \"\",\n \"createdAt\": \"\"\n }\n ],\n \"pagination\": {\n \"page\": \"\",\n \"pageSize\": \"\",\n \"totalCount\": \"\",\n \"totalPages\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{officeId}", "description": "", "item": [ { "name": "portfolios", "description": "", "item": [ { "id": "fc64b6c3-682b-4264-bf95-41920b526c6a", "name": "Cria uma carteira (investidor) no office", "request": { "name": "Cria uma carteira (investidor) no office", "description": {}, "url": { "path": [ "offices", ":officeId", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "officeId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"\",\n \"name\": \"\",\n \"consolidatorPortfolioCode\": \"\",\n \"email\": \"\",\n \"taxId\": \"\",\n \"accounts\": [\n {\n \"custodian\": \"\",\n \"accountNumber\": \"\",\n \"contaSinacor\": \"\"\n },\n {\n \"custodian\": \"\",\n \"accountNumber\": \"\",\n \"contaSinacor\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c03e305c-bf7f-4c66-90c5-aeb1e2853451", "name": "Carteira criada", "originalRequest": { "url": { "path": [ "offices", ":officeId", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"\",\n \"name\": \"\",\n \"consolidatorPortfolioCode\": \"\",\n \"email\": \"\",\n \"taxId\": \"\",\n \"accounts\": [\n {\n \"custodian\": \"\",\n \"accountNumber\": \"\",\n \"contaSinacor\": \"\"\n },\n {\n \"custodian\": \"\",\n \"accountNumber\": \"\",\n \"contaSinacor\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"portfolioId\": \"\",\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"consolidatorPortfolioCode\": \"\",\n \"accountsCount\": \"\",\n \"createdAt\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6c957d39-3b33-4516-83fd-fb022f55fcfb", "name": "Lista carteiras do office", "request": { "name": "Lista carteiras do office", "description": {}, "url": { "path": [ "offices", ":officeId", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [ { "type": "any", "value": "", "key": "officeId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "75575276-eede-4974-aeab-bb4d2192ae94", "name": "Lista", "originalRequest": { "url": { "path": [ "offices", ":officeId", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"portfolioId\": \"\",\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"consolidatorPortfolioCode\": \"\",\n \"accountsCount\": \"\",\n \"createdAt\": \"\"\n },\n {\n \"portfolioId\": \"\",\n \"officeId\": \"\",\n \"externalId\": \"\",\n \"name\": \"\",\n \"consolidatorPortfolioCode\": \"\",\n \"accountsCount\": \"\",\n \"createdAt\": \"\"\n }\n ],\n \"pagination\": {\n \"page\": \"\",\n \"pageSize\": \"\",\n \"totalCount\": \"\",\n \"totalPages\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "custodian-positions", "description": "", "item": [ { "name": "import", "description": "", "item": [ { "id": "93fed0cd-b9c3-42ab-a9b6-ebd1c7f600e6", "name": "Importa planilha de custódia (fluxo padrão, mesmos modelos de hoje)", "request": { "name": "Importa planilha de custódia (fluxo padrão, mesmos modelos de hoje)", "description": { "content": "Fluxo principal de custódia: o usuário final envia a planilha da instituição, no\nmodelo específico (XP, Genial, BTG) ou no modelo genérico, exatamente como já\nacontece hoje na plataforma. O backend parseia com o importador correspondente.\n\n**É por ESCRITÓRIO, não por carteira**: a planilha da instituição cobre todas as\ncontas do escritório. A reconciliação atribui cada linha à carteira certa pelas\ncontas cadastradas no provisionamento.\n\n**Substitutivo** por (escritório, custodiante, período): cada import troca a carga\nanterior, então reenviar o mesmo arquivo é seguro e não duplica posições.\n\nO período é mensal (MM-AAAA) porque é assim que as posições de custódia são\narmazenadas e consultadas pela reconciliação.\n", "type": "text/plain" }, "url": { "path": [ "offices", ":officeId", "custodian-positions", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "officeId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) Planilha .xlsx no modelo indicado (até 25 MB)", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "(Required) Modelo da planilha; \"generic\" = layout genérico da plataforma", "type": "text/plain" }, "key": "model", "value": "genial", "type": "text" }, { "description": { "content": "(Required) Período de referência no formato MM-AAAA", "type": "text/plain" }, "key": "period", "value": "09-3757", "type": "text" } ] }, "auth": null }, "response": [ { "id": "9a6433c0-77ec-4682-a39b-4b0e945f94ad", "name": "Planilha processada", "originalRequest": { "url": { "path": [ "offices", ":officeId", "custodian-positions", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) Planilha .xlsx no modelo indicado (até 25 MB)", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "(Required) Modelo da planilha; \"generic\" = layout genérico da plataforma", "type": "text/plain" }, "key": "model", "value": "genial", "type": "text" }, { "description": { "content": "(Required) Período de referência no formato MM-AAAA", "type": "text/plain" }, "key": "period", "value": "09-3757", "type": "text" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accepted\": \"\",\n \"replaced\": \"\",\n \"custodian\": \"\",\n \"period\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f149746d-0166-45f1-ae6e-34102ceae0a7", "name": "Payload inválido", "originalRequest": { "url": { "path": [ "offices", ":officeId", "custodian-positions", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) Planilha .xlsx no modelo indicado (até 25 MB)", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "(Required) Modelo da planilha; \"generic\" = layout genérico da plataforma", "type": "text/plain" }, "key": "model", "value": "genial", "type": "text" }, { "description": { "content": "(Required) Período de referência no formato MM-AAAA", "type": "text/plain" }, "key": "period", "value": "09-3757", "type": "text" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7c60bef-32d1-402c-bcc8-d577883cb9fd", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "offices", ":officeId", "custodian-positions", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) Planilha .xlsx no modelo indicado (até 25 MB)", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "(Required) Modelo da planilha; \"generic\" = layout genérico da plataforma", "type": "text/plain" }, "key": "model", "value": "genial", "type": "text" }, { "description": { "content": "(Required) Período de referência no formato MM-AAAA", "type": "text/plain" }, "key": "period", "value": "09-3757", "type": "text" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "group-rules", "description": "", "item": [ { "id": "75f37e5f-dfd9-481d-852e-fcfe0cf3f150", "name": "Lista regras de grupo ativas do office", "request": { "name": "Lista regras de grupo ativas do office", "description": {}, "url": { "path": [ "offices", ":officeId", "group-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "officeId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ee55184d-9c55-471b-afef-676c2c799d36", "name": "Lista", "originalRequest": { "url": { "path": [ "offices", ":officeId", "group-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "officeId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"ruleId\": \"\",\n \"ruleType\": \"OneToMany\",\n \"consolidatorSide\": [\n \"\",\n \"\"\n ],\n \"custodianSide\": [\n \"\",\n \"\"\n ],\n \"description\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\"\n },\n {\n \"ruleId\": \"\",\n \"ruleType\": \"ManyToMany\",\n \"consolidatorSide\": [\n \"\",\n \"\"\n ],\n \"custodianSide\": [\n \"\",\n \"\"\n ],\n \"description\": \"\",\n \"isActive\": \"\",\n \"createdAt\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "portfolios", "description": "", "item": [ { "name": "{portfolioId}", "description": "", "item": [ { "name": "reconciliations", "description": "", "item": [ { "id": "4addad5b-3a74-4cd4-98ac-30c87fbe92fd", "name": "Executa a reconciliação da carteira em uma data", "request": { "name": "Executa a reconciliação da carteira em uma data", "description": {}, "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "portfolioId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"mode\": \"sync\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "91e4b6cc-6a56-443a-92d4-3ddf7e0fde84", "name": "(sync) Run concluído", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"mode\": \"sync\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"runId\": \"\",\n \"portfolioId\": \"\",\n \"date\": \"\",\n \"status\": \"completed\",\n \"matchedCount\": \"\",\n \"groupMatchCount\": \"\",\n \"unmatchedConsolidatorCount\": \"\",\n \"unmatchedCustodianCount\": \"\",\n \"totalConsolidatorValue\": \"\",\n \"totalCustodianValue\": \"\",\n \"totalDifference\": \"\",\n \"createdAt\": \"\",\n \"createdByEndUserId\": \"\",\n \"pairs\": [\n {\n \"pairId\": \"\",\n \"mappingId\": \"\",\n \"matchOrigin\": \"ai\",\n \"confidence\": \"\",\n \"justification\": \"\",\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n \"valueDifference\": \"\"\n },\n {\n \"pairId\": \"\",\n \"mappingId\": \"\",\n \"matchOrigin\": \"deterministic\",\n \"confidence\": \"\",\n \"justification\": \"\",\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n \"valueDifference\": \"\"\n }\n ],\n \"groupMatches\": [\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Confirmed\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n },\n {\n \"matchId\": \"\",\n \"matchType\": \"Manual\",\n \"status\": \"Pending\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n }\n ],\n \"pendingSuggestions\": [\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Rejected\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n },\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Confirmed\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n }\n ],\n \"unmatchedConsolidator\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n }\n ],\n \"unmatchedCustodian\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56be4aad-30c2-4da7-b618-5dd598bcc1cd", "name": "(async) Run aceito; acompanhar via GET /reconciliations/{runId} ou webhook", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"mode\": \"sync\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"runId\": \"\",\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d4db693-5b9b-49db-a244-206c6b6abbbd", "name": "Sem posições de um dos lados para a data (code=positions_missing)", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"mode\": \"sync\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "71487020-9793-41b7-8eef-97251535c07c", "name": "Histórico de runs da carteira", "request": { "name": "Histórico de runs da carteira", "description": {}, "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [ { "type": "any", "value": "", "key": "portfolioId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2b156990-1a05-44f1-a6b7-c6481918d6a3", "name": "Lista de runs (resumo)", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "reconciliations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pageSize", "value": "50" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"runId\": \"\",\n \"portfolioId\": \"\",\n \"date\": \"\",\n \"status\": \"failed\",\n \"matchedCount\": \"\",\n \"groupMatchCount\": \"\",\n \"unmatchedConsolidatorCount\": \"\",\n \"unmatchedCustodianCount\": \"\",\n \"totalConsolidatorValue\": \"\",\n \"totalCustodianValue\": \"\",\n \"totalDifference\": \"\",\n \"createdAt\": \"\",\n \"createdByEndUserId\": \"\"\n },\n {\n \"runId\": \"\",\n \"portfolioId\": \"\",\n \"date\": \"\",\n \"status\": \"failed\",\n \"matchedCount\": \"\",\n \"groupMatchCount\": \"\",\n \"unmatchedConsolidatorCount\": \"\",\n \"unmatchedCustodianCount\": \"\",\n \"totalConsolidatorValue\": \"\",\n \"totalCustodianValue\": \"\",\n \"totalDifference\": \"\",\n \"createdAt\": \"\",\n \"createdByEndUserId\": \"\"\n }\n ],\n \"pagination\": {\n \"page\": \"\",\n \"pageSize\": \"\",\n \"totalCount\": \"\",\n \"totalPages\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "manual-matches", "description": "", "item": [ { "id": "562064e6-f566-4551-ba9b-a436178fc9b2", "name": "Cria match manual 1:1 (aprende o mapeamento para runs futuros)", "request": { "name": "Cria match manual 1:1 (aprende o mapeamento para runs futuros)", "description": { "content": "Os dois lados são os OBJETOS COMPLETOS devolvidos pela reconciliação (mesma forma de `consolidatorPosition`/`custodianPosition` na resposta do run), não apenas um id: o motor aprende o mapeamento a partir dos dados do ativo. Recomenda-se reenviar exatamente o objeto recebido na lista de não-pareados.", "type": "text/plain" }, "url": { "path": [ "portfolios", ":portfolioId", "manual-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "portfolioId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n },\n \"justification\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5edde9ed-22d2-4c46-bbef-f37afbcdd36c", "name": "Match criado", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "manual-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n },\n \"justification\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"mappingId\": \"\",\n \"pair\": {\n \"pairId\": \"\",\n \"mappingId\": \"\",\n \"matchOrigin\": \"ai\",\n \"confidence\": \"\",\n \"justification\": \"\",\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n \"valueDifference\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68508cae-f30b-455b-a353-e7f6f632f5af", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "manual-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n },\n \"justification\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26c80ada-8f87-4690-ac19-865f9b1f7720", "name": "Payload inválido", "originalRequest": { "url": { "path": [ "portfolios", ":portfolioId", "manual-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "portfolioId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n },\n \"justification\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "reconciliations", "description": "", "item": [ { "name": "{runId}", "description": "", "item": [ { "id": "d948e933-f214-4bd4-a28a-437fd9948790", "name": "Status e resumo de um run", "request": { "name": "Status e resumo de um run", "description": {}, "url": { "path": [ "reconciliations", ":runId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1ccf9f08-7a47-4d98-8d24-4566a9de90c7", "name": "Resumo", "originalRequest": { "url": { "path": [ "reconciliations", ":runId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"runId\": \"\",\n \"portfolioId\": \"\",\n \"date\": \"\",\n \"status\": \"queued\",\n \"matchedCount\": \"\",\n \"groupMatchCount\": \"\",\n \"unmatchedConsolidatorCount\": \"\",\n \"unmatchedCustodianCount\": \"\",\n \"totalConsolidatorValue\": \"\",\n \"totalCustodianValue\": \"\",\n \"totalDifference\": \"\",\n \"createdAt\": \"\",\n \"createdByEndUserId\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "605f3a91-3b04-4e1f-8fbb-b2e44f625624", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "reconciliations", ":runId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "result", "description": "", "item": [ { "id": "c2fa048c-3f14-4126-976a-b7371c9288c1", "name": "Resumo do run com os grupos N:M", "request": { "name": "Resumo do run com os grupos N:M", "description": { "content": "Devolve o resumo e os grupos N:M (que são persistidos).\n\n**Atenção:** `pairs`, `unmatchedConsolidator` e `unmatchedCustodian` vêm vazios\naqui. O detalhe linha a linha não é armazenado, então só está disponível na\nresposta do POST que executa a reconciliação. Guarde esse payload se precisar\nexibi-lo depois, ou execute a reconciliação novamente.\n", "type": "text/plain" }, "url": { "path": [ "reconciliations", ":runId", "result" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4960842e-f685-4116-9a32-90ad3274effc", "name": "Resumo e grupos do run", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "result" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"runId\": \"\",\n \"portfolioId\": \"\",\n \"date\": \"\",\n \"status\": \"completed\",\n \"matchedCount\": \"\",\n \"groupMatchCount\": \"\",\n \"unmatchedConsolidatorCount\": \"\",\n \"unmatchedCustodianCount\": \"\",\n \"totalConsolidatorValue\": \"\",\n \"totalCustodianValue\": \"\",\n \"totalDifference\": \"\",\n \"createdAt\": \"\",\n \"createdByEndUserId\": \"\",\n \"pairs\": [\n {\n \"pairId\": \"\",\n \"mappingId\": \"\",\n \"matchOrigin\": \"ai\",\n \"confidence\": \"\",\n \"justification\": \"\",\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n \"valueDifference\": \"\"\n },\n {\n \"pairId\": \"\",\n \"mappingId\": \"\",\n \"matchOrigin\": \"deterministic\",\n \"confidence\": \"\",\n \"justification\": \"\",\n \"consolidatorPosition\": {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n \"custodianPosition\": {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n \"valueDifference\": \"\"\n }\n ],\n \"groupMatches\": [\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Confirmed\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n },\n {\n \"matchId\": \"\",\n \"matchType\": \"Manual\",\n \"status\": \"Pending\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n }\n ],\n \"pendingSuggestions\": [\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Rejected\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n },\n {\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Confirmed\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n }\n ],\n \"unmatchedConsolidator\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n },\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\",\n \"positionId\": \"\"\n }\n ],\n \"unmatchedCustodian\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n },\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\",\n \"positionId\": \"\",\n \"custodian\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c40320d-2382-4b49-94bf-92347b5eb7a0", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "result" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "export", "description": "", "item": [ { "name": "excel", "description": "", "item": [ { "id": "e27efd2f-59f0-4a70-985d-aaada252fc5d", "name": "Exporta o resultado em Excel (.xlsx)", "request": { "name": "Exporta o resultado em Excel (.xlsx)", "description": { "content": "Mesmo layout de planilha usado na plataforma, incluindo a seção de grupos N:M.\n\nComo o detalhe linha a linha não é armazenado, o arquivo é remontado recalculando\na reconciliação daquela data. O download **não** cria um run novo no histórico,\nmas se as posições mudaram desde a execução original os números podem diferir.\n", "type": "text/plain" }, "url": { "path": [ "reconciliations", ":runId", "export", "excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9914c054-26d6-4ce8-9fc2-0b7a62d95b77", "name": "Arquivo", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "export", "excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9dbd750f-6d21-4ea3-963b-c6d82740b53f", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "export", "excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "group-matches", "description": "", "item": [ { "id": "d7d8b91e-278b-4744-a443-964ec426efb4", "name": "Cria match de grupo N:M (gera sempre uma regra reutilizável por carteira)", "request": { "name": "Cria match de grupo N:M (gera sempre uma regra reutilizável por carteira)", "description": { "content": "Assim como no match manual 1:1, os dois lados são os objetos completos das posições selecionadas (do resultado da reconciliação), não ids. Diferente da confirmação de sugestão de IA, o match manual de grupo SEMPRE gera uma regra reutilizável, na mesma convenção do 1:1 da plataforma. Não há opção de não salvar como regra.", "type": "text/plain" }, "url": { "path": [ "reconciliations", ":runId", "group-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPositions\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n }\n ],\n \"custodianPositions\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n }\n ],\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "cdd6ea3f-8344-4332-9353-1a8a790b3766", "name": "Grupo criado", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "group-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPositions\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n }\n ],\n \"custodianPositions\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n }\n ],\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Pending\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52f630b3-e8bc-40ef-9caf-a545449deebb", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "group-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPositions\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n }\n ],\n \"custodianPositions\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n }\n ],\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf34d7f6-2154-4f90-8d83-f9588b7ba981", "name": "Payload inválido", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "group-matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"consolidatorPositions\": [\n {\n \"name\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"code\": \"\",\n \"description\": \"\",\n \"assetClass\": \"\",\n \"assetType\": \"\",\n \"institution\": \"\"\n }\n ],\n \"custodianPositions\": [\n {\n \"description\": \"\",\n \"quantity\": \"\",\n \"grossValue\": \"\",\n \"ticker\": \"\",\n \"isin\": \"\",\n \"cnpj\": \"\",\n \"cetipCode\": \"\",\n \"type\": \"\",\n \"issuer\": \"\",\n \"accountNumber\": \"\"\n }\n ],\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{matchId}", "description": "", "item": [ { "id": "5ca7d3a3-bb84-4eee-9dfd-0f721b18d6e2", "name": "Exclui match de grupo (desativa a regra associada, se houver)", "request": { "name": "Exclui match de grupo (desativa a regra associada, se houver)", "description": {}, "url": { "path": [ "reconciliations", ":runId", "group-matches", ":matchId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "matchId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "af57948b-25d8-417d-8b7a-49abaee22d10", "name": "Removido", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "group-matches", ":matchId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "matchId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "20d3de11-6a20-4b15-a440-bb08f2292648", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "group-matches", ":matchId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "matchId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "suggestions", "description": "", "item": [ { "name": "{matchId}", "description": "", "item": [ { "name": "confirm", "description": "", "item": [ { "id": "1a9b825f-ee7f-44f9-b037-cde803521896", "name": "Confirma sugestão de grupo da IA", "request": { "name": "Confirma sugestão de grupo da IA", "description": {}, "url": { "path": [ "reconciliations", ":runId", "suggestions", ":matchId", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "matchId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"saveAsRule\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "cf9bdad2-595e-4ab0-a21e-38176dfba54a", "name": "Confirmada", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "suggestions", ":matchId", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "matchId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"saveAsRule\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"matchId\": \"\",\n \"matchType\": \"AISuggested\",\n \"status\": \"Pending\",\n \"ruleId\": \"\",\n \"consolidatorItems\": [\n \"\",\n \"\"\n ],\n \"custodianItems\": [\n \"\",\n \"\"\n ],\n \"consolidatorTotalValue\": \"\",\n \"custodianTotalValue\": \"\",\n \"consolidatorTotalQuantity\": \"\",\n \"custodianTotalQuantity\": \"\",\n \"difference\": \"\",\n \"aiConfidence\": \"\",\n \"aiReason\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "reject", "description": "", "item": [ { "id": "5b4cab27-f274-440f-ae6b-9ea22bde9bfe", "name": "Rejeita sugestão de grupo da IA", "request": { "name": "Rejeita sugestão de grupo da IA", "description": {}, "url": { "path": [ "reconciliations", ":runId", "suggestions", ":matchId", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "runId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "matchId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "b38bcb6d-03ed-496b-b50b-455a496a146f", "name": "Rejeitada", "originalRequest": { "url": { "path": [ "reconciliations", ":runId", "suggestions", ":matchId", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "runId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "matchId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "disabled": false, "description": { "content": "Torna o POST seguro para retentativa por 24h. Repetição com o mesmo corpo devolve\na resposta original e o header `Idempotent-Replay: true`; corpo diferente na mesma\nchave devolve 409.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] } ] }, { "name": "manual-matches", "description": "", "item": [ { "name": "{mappingId}", "description": "", "item": [ { "id": "cac701eb-7cdf-411a-a06f-d44c1aa796a3", "name": "Desfaz um match 1:1 e remove o mapeamento aprendido", "request": { "name": "Desfaz um match 1:1 e remove o mapeamento aprendido", "description": {}, "url": { "path": [ "manual-matches", ":mappingId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "mappingId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "ac91e2c1-9d9d-4e3e-8075-12e4b3fc5ec8", "name": "Removido", "originalRequest": { "url": { "path": [ "manual-matches", ":mappingId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "mappingId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2422bf9a-af47-40c7-bc14-473c5b909e04", "name": "Recurso não encontrado (ou fora do escopo da credencial)", "originalRequest": { "url": { "path": [ "manual-matches", ":mappingId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "mappingId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"conflict\",\n \"message\": \"\",\n \"details\": [\n \"\",\n \"\"\n ],\n \"traceId\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "group-rules", "description": "", "item": [ { "name": "{ruleId}", "description": "", "item": [ { "id": "d3b9b221-bc38-4d2c-a0d5-cbab5d5fd81d", "name": "Atualiza regra (descrição/ativação)", "request": { "name": "Atualiza regra (descrição/ativação)", "description": {}, "url": { "path": [ "group-rules", ":ruleId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ruleId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d718610c-5492-424d-8be5-0f9f56daecee", "name": "Atualizada", "originalRequest": { "url": { "path": [ "group-rules", ":ruleId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ruleId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"isActive\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c36e6b72-a6d7-4302-9f35-4b46e86029cd", "name": "Desativa a regra", "request": { "name": "Desativa a regra", "description": {}, "url": { "path": [ "group-rules", ":ruleId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ruleId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "02fddb53-02f8-4213-b2b3-c95a09f1bff9", "name": "Desativada", "originalRequest": { "url": { "path": [ "group-rules", ":ruleId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ruleId" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) Id estável do usuário final no parceiro (autoria + custo de IA)", "type": "text/plain" }, "key": "X-End-User-Id", "value": "" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "type": "any", "value": "{{bearerToken}}", "key": "token" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.frominvestors.com/partner/v1" } ], "info": { "_postman_id": "4a7549f5-0b8e-4d13-818d-3b035d132bcc", "name": "Reconciliation Partner API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "API de reconciliação de posições da From Investors para a Smartbrain, parceira\nexclusiva desta integração. Todas as chamadas são server-to-server com a credencial\nde parceiro emitida para a Smartbrain. Operações de escrita exigem o header\n`X-End-User-Id` (usuário final da Smartbrain), usado para autoria dos runs e\nrastreio de custo de IA.\n\nConvenções: datas `yyyy-MM-dd`; camelCase; paginação `page`/`pageSize`.\n\n**Idempotência.** Envie `Idempotency-Key` (até 64 caracteres, único por requisição)\nnos POSTs de escrita. Dentro de 24 horas, repetir a mesma chave com o mesmo corpo\ndevolve a resposta original sem executar de novo, com o header\n`Idempotent-Replay: true`. A mesma chave com corpo ou caminho diferente devolve `409`.\nSe a primeira chamada ainda estiver em processamento, a segunda também recebe `409`:\nrepita em instantes. Resposta de erro não é guardada, então a mesma chave serve para\nretentar a requisição que falhou.\n\nNão se aplica a `POST /auth/token` (repetir precisa emitir token novo) nem ao import\nde planilha, que é multipart e já é substitutivo por escritório, custodiante e\nperíodo.\n\nA criação de escritório e de carteira é idempotente também por `externalId`,\nindependentemente do header.\n\n**Fora desta versão** (documentado para planejamento, ainda não disponível):\npush programático de posições por carteira (`PUT .../custodian-positions` e\n`.../consolidator-positions`), consulta de consumo (`GET /usage`) e webhooks\n(`PUT /webhooks`). Posições entram por importação de planilha, no endpoint por\nescritório descrito em Positions.\n", "type": "text/plain" } } }