> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/16.-gestao-de-cambio.md). # 16. 💱 Gestão de Câmbio **Controle de operações cambiais** Gestão de contratos de câmbio e operações financeiras internacionais. **Recursos:** * Contratos de câmbio * Controle de liquidação * Relatórios regulamentares * Integração com bancos ## Listar contratos de câmbio > \*\*Listar todos os contratos de câmbio\*\*\ > \ > Endpoint utilizado para consultar todos os contratos de câmbio da empresa.\ > Permite visualizar informações consolidadas sobre operações cambiais para\ > processos de importação e exportação.\ > \ > \*\*Informações fornecidas:\*\*\ > \- Status do contrato (pendente/finalizado)\ > \- Código de identificação do contrato\ > \- Datas das operações (moeda nacional e estrangeira)\ > \- Dados do beneficiário\ > \- Valores e taxas de câmbio\ > \- Valores totais convertidos\ > \ > \*\*Casos de uso:\*\*\ > \- Monitoramento de contratos ativos\ > \- Relatórios de operações cambiais\ > \- Controle de fluxo de câmbio\ > \- Auditoria de operações de comex ```json {"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"16. 💱 Gestão de Câmbio","description":"**Controle de operações cambiais**\nGestão de contratos de câmbio e operações financeiras internacionais.\n**Recursos:**\n- Contratos de câmbio\n- Controle de liquidação\n- Relatórios regulamentares\n- Integração com bancos"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/comex/gestao_de_cambio/contratos":{"get":{"summary":"Listar contratos de câmbio","tags":["16. 💱 Gestão de Câmbio"],"description":"**Listar todos os contratos de câmbio**\n\nEndpoint utilizado para consultar todos os contratos de câmbio da empresa.\nPermite visualizar informações consolidadas sobre operações cambiais para\nprocessos de importação e exportação.\n\n**Informações fornecidas:**\n- Status do contrato (pendente/finalizado)\n- Código de identificação do contrato\n- Datas das operações (moeda nacional e estrangeira)\n- Dados do beneficiário\n- Valores e taxas de câmbio\n- Valores totais convertidos\n\n**Casos de uso:**\n- Monitoramento de contratos ativos\n- Relatórios de operações cambiais\n- Controle de fluxo de câmbio\n- Auditoria de operações de comex","responses":{"200":{"description":"Lista de contratos de câmbio","content":{"application/json":{"schema":{"type":"object","properties":{"contratos":{"type":"array","description":"Lista dos contratos de câmbio","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID único do contrato"},"status":{"type":"string","description":"Status atual do contrato","enum":["pendente","finalizado"]},"codigo":{"type":"string","description":"Código identificador do contrato"},"data_moeda_nacional":{"type":"string","description":"Data da operação em moeda nacional"},"data_moeda_estrangeira":{"type":"string","description":"Data da operação em moeda estrangeira"},"beneficiario":{"type":"string","description":"Nome do beneficiário da operação"},"valor_total_moeda_estrangeira":{"type":"string","description":"Valor total em moeda estrangeira formatado"},"taxa_cambio":{"type":"string","description":"Taxa de câmbio aplicada"},"valor_total":{"type":"string","description":"Valor total convertido em reais"}}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` ## Visualizar contrato de câmbio específico > \*\*Visualizar detalhes específicos de um contrato de câmbio\*\*\ > \ > Endpoint utilizado para consultar informações detalhadas de um contrato\ > de câmbio específico, incluindo dados completos dos pagamentos realizados\ > e informações adicionais sobre a operação.\ > \ > \*\*Informações detalhadas:\*\*\ > \- Dados completos do contrato (tipo, operador, modalidade)\ > \- Informações do beneficiário e país de origem\ > \- Histórico completo de pagamentos\ > \- Valores totais e parciais da operação\ > \- Anexos e documentações relacionadas\ > \- Status consolidado da operação\ > \ > \*\*Casos de uso:\*\*\ > \- Detalhamento para auditoria\ > \- Acompanhamento de pagamentos\ > \- Relatórios detalhados de comex\ > \- Controle documental de operações ```json {"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"16. 💱 Gestão de Câmbio","description":"**Controle de operações cambiais**\nGestão de contratos de câmbio e operações financeiras internacionais.\n**Recursos:**\n- Contratos de câmbio\n- Controle de liquidação\n- Relatórios regulamentares\n- Integração com bancos"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/comex/gestao_de_cambio/contratos/{id}":{"get":{"summary":"Visualizar contrato de câmbio específico","tags":["16. 💱 Gestão de Câmbio"],"description":"**Visualizar detalhes específicos de um contrato de câmbio**\n\nEndpoint utilizado para consultar informações detalhadas de um contrato\nde câmbio específico, incluindo dados completos dos pagamentos realizados\ne informações adicionais sobre a operação.\n\n**Informações detalhadas:**\n- Dados completos do contrato (tipo, operador, modalidade)\n- Informações do beneficiário e país de origem\n- Histórico completo de pagamentos\n- Valores totais e parciais da operação\n- Anexos e documentações relacionadas\n- Status consolidado da operação\n\n**Casos de uso:**\n- Detalhamento para auditoria\n- Acompanhamento de pagamentos\n- Relatórios detalhados de comex\n- Controle documental de operações","responses":{"200":{"description":"Detalhes do contrato de câmbio","content":{"application/json":{"schema":{"type":"object","properties":{"contrato":{"type":"object","description":"Detalhes completos do contrato","properties":{"id":{"type":"string","format":"uuid","description":"UUID único do contrato"},"codigo":{"type":"string","description":"Código do contrato"},"tipo_de_contrato":{"type":"string","description":"Tipo da operação cambial"},"operador_de_cambio":{"type":"string","description":"Banco operador da transação"},"modalidade":{"type":"string","description":"Modalidade da operação"},"moeda":{"type":"string","description":"Tipo da moeda estrangeira"},"taxa_cambio":{"type":"string","description":"Taxa de câmbio aplicada"},"valor_total_moeda_estrangeira":{"type":"string","description":"Valor total em moeda estrangeira"},"valor_total":{"type":"string","description":"Valor total em reais"},"beneficiario":{"type":"string","description":"Nome do beneficiário"},"pais":{"type":"string","description":"País da operação"},"data_moeda_nacional":{"type":"string","description":"Data em moeda nacional"},"data_moeda_estrangeira":{"type":"string","description":"Data em moeda estrangeira"},"codigo_bacen":{"type":"string","description":"Código BACEN da operação"},"anexos":{"type":"array","description":"Lista de anexos do contrato","items":{"type":"object"}},"pagamentos":{"type":"array","description":"Lista de pagamentos realizados","items":{"type":"object","properties":{"processo":{"type":"string"},"descricao":{"type":"string"},"codigo":{"type":"string"},"di":{"type":"string"},"beneficiario":{"type":"string"},"data_vencimento":{"type":"string"},"valor_moeda_estrangeira":{"type":"string"},"valor_total_fatura_moeda_estrangeira":{"type":"string"}}}},"status":{"type":"string","enum":["pendente","finalizado"]},"total_pagamentos":{"type":"integer","description":"Quantidade total de pagamentos"},"total_contrato":{"type":"string","description":"Valor total do contrato"},"total_pago":{"type":"string","description":"Valor total já pago"}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Contrato não encontrado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://changelog.maino.com.br/api-reference-maino/16.-gestao-de-cambio.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.