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

get

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

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Respostas

200

Lista de contratos de câmbio

application/json

401

Não autorizado

application/json

get

/comex/gestao_de_cambio/contratos

HTTPcURLJavaScriptPython

GET /api/v2/comex/gestao_de_cambio/contratos HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "contratos": [
    {
      "id": "aa5400db-ee28-4c25-90b0-fbb1078b943f",
      "status": "pendente",
      "codigo": "ASDASD",
      "data_moeda_nacional": "25/11/2024",
      "data_moeda_estrangeira": "25/11/2024",
      "beneficiario": "ABELINHA 2",
      "valor_total_moeda_estrangeira": "US$ 6.804,00",
      "taxa_cambio": "R$ 5,5984",
      "valor_total": "R$ 38.091,19"
    }
  ]
}

Visualizar contrato de câmbio específico

get

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

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de rota

idstringObrigatório

UUID do contrato de câmbio

Respostas

200

Detalhes do contrato de câmbio

application/json

401

Não autorizado

application/json

404

Contrato não encontrado

application/json

get

/comex/gestao_de_cambio/contratos/{id}

HTTPcURLJavaScriptPython

GET /api/v2/comex/gestao_de_cambio/contratos/{id} HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "contrato": {
    "id": "aa5400db-ee28-4c25-90b0-fbb1078b943f",
    "codigo": "123",
    "tipo_de_contrato": "Compra de serviços ou exportação de mercadorias",
    "operador_de_cambio": "BANCO DO BRASIL S.A.",
    "modalidade": "Antecipado",
    "moeda": "Dólar americano",
    "taxa_cambio": "R$ 0,0212",
    "valor_total_moeda_estrangeira": "US$ 5,66",
    "valor_total": "R$ 0,12",
    "beneficiario": "MAINO SISTEMAS ERP",
    "pais": "CHILE",
    "data_moeda_nacional": "18/09/2024",
    "data_moeda_estrangeira": "19/09/2024",
    "codigo_bacen": "-",
    "anexos": [
      {}
    ],
    "pagamentos": [
      {
        "processo": "2108514308",
        "descricao": "Pagamento ao fornecedor",
        "codigo": "IVBR101230302A           IVBR101230302N",
        "di": "23/1191097-2",
        "beneficiario": "MAINO SISTEMAS ERP",
        "data_vencimento": "18/09/2024",
        "valor_moeda_estrangeira": "US$ 5,66",
        "valor_total_fatura_moeda_estrangeira": "US$ 30.141,46"
      }
    ],
    "status": "finalizado",
    "total_pagamentos": 1,
    "total_contrato": "US$ 5,66",
    "total_pago": "US$ 5,66"
  }
}