16. ⚓ 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 lista de processos de importação e exportação 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".

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

tipostring · enumOpcional

Tipo de processo

Valores possíveis:

statusstring · enumOpcional

Status do processo

Valores possíveis:

numero_processostringOpcional

Número do processo

cliente_idintegerOpcional

ID do cliente

data_iniciostring · dateOpcional

Data de início

data_fimstring · dateOpcional

Data de fim

pageintegerOpcional

Número da página

per_pageintegerOpcional

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

Respostas

401

Não autorizado

application/json

403

Sem permissão

Sem permissãoapplication/json

get

/processos

HTTPcURLJavaScriptPython

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

{
  "error": "Chave de API inválida"
}