15. ⚓ Processos de Comex

Gestão completa de comércio exterior Controle end-to-end de processos de importação e exportação. Cobertura:

• Processos de importação e exportação

• Controle documental completo

• Gestão de câmbio e remessas

• Drawback e regimes especiais

Lista processos de comércio exterior

get

Lista processos de comércio exterior

Retorna todos os processos de importação e exportação do usuário autenticado, ordenados por data de criação (mais recentes primeiro), com todos os detalhes de cada processo, incluindo informações de pré-embarque, embarque e despacho aduaneiro.

Requer permissão: O usuário precisa ter permissão de leitura em "processos".

Paginação:

• page: número da página (padrão: 1)

• per_page: itens por página (padrão: 300)

Informações retornadas:

• Dados gerais do processo (número, descrição, cliente, modalidade, tipo)

• Dados de pré-embarque (fornecedor, container, purchase order)

• Dados de embarque (navio/voo, BL/AWB, datas, incoterm)

• Dados de despacho aduaneiro (invoice, terminal de armazenagem)

• DI (Declaração de Importação) quando disponível

• Anexos do processo

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 consulta

pageintegerOpcional

Número da página (padrão: 1)

per_pageintegerOpcional

Itens por página (padrão: 300)

Respostas

200

Lista de processos

application/json

401

Não autorizado

application/json

403

Sem permissão

application/json

get

/processos

HTTPcURLJavaScriptPython

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

{
  "processos": [
    {
      "id": 1,
      "numero": "text",
      "descricao": "text",
      "data_criacao": "text",
      "cliente": "text",
      "modalidade": "text",
      "tipo": "text",
      "via": "text",
      "categoria": "text",
      "etapa": "text",
      "canal": "text",
      "vmle": 1,
      "frete": 1,
      "seguro": 1,
      "vmld": 1,
      "fornecedor": "text",
      "container": "text",
      "outra_referencia": "text",
      "condicao_pagamento": "text",
      "data_cambio_antecipacao": "2026-06-17",
      "codigo_purchase_order": "text",
      "data_purchase_order": "2026-06-17",
      "observacao": "text",
      "companhia_aerea": "text",
      "numero_do_voo": "text",
      "navio": "text",
      "placa_do_veiculo_transportador": "text",
      "armador": "text",
      "conhecimento_de_embarque": "text",
      "pais_procedencia": "text",
      "embarque": "text",
      "data_embarque": "2026-06-17",
      "pais_destino": "text",
      "desembarque": "text",
      "data_chegada": "2026-06-17",
      "eta": "2026-06-17",
      "agente_de_carga": "text",
      "stakeholder_agente_carga_id": 1,
      "bl": "text",
      "data_emissao_bl": "2026-06-17",
      "awb": "text",
      "data_emissao_awb": "2026-06-17",
      "crt": "text",
      "data_emissao_crt": "2026-06-17",
      "fci": "text",
      "incoterm": "text",
      "peso_bruto": 1,
      "peso_liquido": 1,
      "status_container": "text",
      "presenca_carga": "text",
      "numero_invoice": "text",
      "valor_invoice": 1,
      "vencimento_invoice": "2026-06-17",
      "data_cambio_saldo": "2026-06-17",
      "terminal_de_armazenagem": "text",
      "anexos": [
        {
          "anexo": {
            "url": "text"
          }
        }
      ],
      "di": {
        "codigo": "text",
        "data_de_desembaraco": "2026-06-17",
        "data_registro": "2026-06-17"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "previous_page": "text",
    "next_page": "text"
  }
}