> 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","parameters":[{"name":"page","in":"query","required":false,"description":"Número da página para paginação (padrão: 1)","schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"description":"Quantidade de itens por página (padrão: 50; acima de 100 aplica o teto de 100)","schema":{"type":"integer","minimum":1,"maximum":100}}],"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"}}}},"pagination":{"type":"object","properties":{"total":{"type":"integer"},"previous_page":{"type":"string","nullable":true},"next_page":{"type":"string","nullable":true}}}}}}}},"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"},"duimp":{"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"}}}}}}}}}}}
```
