# 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

> \*\*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

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"16. ⚓ Processos de Comex","description":"**Gestão completa de comércio exterior**\nControle end-to-end de processos de importação e exportação.\n**Cobertura:**\n- Processos de importação e exportação\n- Controle documental completo\n- Gestão de câmbio e remessas\n- Drawback e regimes especiais"}],"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":{"/processos":{"get":{"summary":"Lista processos de comércio exterior","tags":["16. ⚓ Processos de Comex"],"description":"**Lista processos de comércio exterior**\n\nRetorna lista de processos de importação e exportação com todos os detalhes\nde cada processo, incluindo informações de pré-embarque, embarque e despacho aduaneiro.\n\n**Requer permissão:** O usuário precisa ter permissão de leitura em \"processos\".\n\n**Informações retornadas:**\n- Dados gerais do processo (número, descrição, cliente, modalidade, tipo)\n- Dados de pré-embarque (fornecedor, container, purchase order)\n- Dados de embarque (navio/voo, BL/AWB, datas, incoterm)\n- Dados de despacho aduaneiro (invoice, terminal de armazenagem)\n- DI (Declaração de Importação) quando disponível\n- Anexos do processo","parameters":[{"name":"tipo","in":"query","schema":{"type":"string","enum":["importacao","exportacao"]},"description":"Tipo de processo","required":false},{"name":"status","in":"query","schema":{"type":"string","enum":["em_andamento","concluido","cancelado"]},"description":"Status do processo","required":false},{"name":"numero_processo","in":"query","description":"Número do processo","required":false,"schema":{"type":"string"}},{"name":"cliente_id","in":"query","description":"ID do cliente","required":false,"schema":{"type":"integer"}},{"name":"data_inicio","in":"query","schema":{"type":"string","format":"date"},"description":"Data de início","required":false},{"name":"data_fim","in":"query","schema":{"type":"string","format":"date"},"description":"Data de fim","required":false},{"name":"page","in":"query","description":"Número da página","required":false,"schema":{"type":"integer"}},{"name":"per_page","in":"query","description":"Itens por página (padrão: 300)","required":false,"schema":{"type":"integer"}}],"responses":{"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Sem permissão","content":{"Sem permissão":{},"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```