> 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/15.-processos-de-comex.md). # 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 > \*\*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 ```json {"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"15. ⚓ 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":["15. ⚓ Processos de Comex"],"description":"**Lista processos de comércio exterior**\n\nRetorna todos os processos de importação e exportação do usuário autenticado,\nordenados por data de criação (mais recentes primeiro), 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**Paginação:**\n- `page`: número da página (padrão: 1)\n- `per_page`: itens por página (padrão: 300)\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":"page","in":"query","description":"Número da página (padrão: 1)","required":false,"schema":{"type":"integer"}},{"name":"per_page","in":"query","description":"Itens por página (padrão: 300)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de processos","content":{"application/json":{"schema":{"type":"object","properties":{"processos":{"type":"array","description":"Lista de processos","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID do processo"},"numero":{"type":"string","description":"Código do processo"},"descricao":{"type":"string","nullable":true,"description":"Descrição do processo"},"data_criacao":{"type":"string","description":"Data e hora de criação"},"cliente":{"type":"string","nullable":true,"description":"Razão social do cliente"},"modalidade":{"type":"string","nullable":true,"description":"Modalidade do processo"},"tipo":{"type":"string","nullable":true,"description":"Tipo (importação/exportação)"},"via":{"type":"string","nullable":true,"description":"Via de transporte (marítima/aérea/terrestre)"},"categoria":{"type":"string","nullable":true,"description":"Categoria do processo"},"etapa":{"type":"string","nullable":true,"description":"Etapa atual do processo"},"canal":{"type":"string","nullable":true,"description":"Canal de parametrização"},"vmle":{"type":"number","format":"float","nullable":true,"description":"Valor da mercadoria no local de embarque"},"frete":{"type":"number","format":"float","nullable":true,"description":"Valor do frete"},"seguro":{"type":"number","format":"float","nullable":true,"description":"Valor do seguro"},"vmld":{"type":"number","format":"float","nullable":true,"description":"Valor da mercadoria no local de descarga"},"fornecedor":{"type":"string","nullable":true,"description":"Fornecedor/Importador"},"container":{"type":"string","nullable":true,"description":"Número do container"},"outra_referencia":{"type":"string","nullable":true,"description":"Outra referência"},"condicao_pagamento":{"type":"string","nullable":true,"description":"Condição de pagamento"},"data_cambio_antecipacao":{"type":"string","format":"date","nullable":true,"description":"Data do câmbio de antecipação"},"codigo_purchase_order":{"type":"string","nullable":true,"description":"Código da Purchase Order"},"data_purchase_order":{"type":"string","format":"date","nullable":true,"description":"Data da Purchase Order"},"observacao":{"type":"string","nullable":true,"description":"Observações"},"companhia_aerea":{"type":"string","nullable":true,"description":"Companhia aérea"},"numero_do_voo":{"type":"string","nullable":true,"description":"Número do voo"},"navio":{"type":"string","nullable":true,"description":"Nome do navio"},"placa_do_veiculo_transportador":{"type":"string","nullable":true,"description":"Placa do veículo"},"armador":{"type":"string","nullable":true,"description":"Armador"},"conhecimento_de_embarque":{"type":"string","nullable":true,"description":"Conhecimento de embarque"},"pais_procedencia":{"type":"string","nullable":true,"description":"País de procedência"},"embarque":{"type":"string","nullable":true,"description":"Local de embarque"},"data_embarque":{"type":"string","format":"date","nullable":true,"description":"Data de embarque"},"pais_destino":{"type":"string","nullable":true,"description":"País de destino"},"desembarque":{"type":"string","nullable":true,"description":"Local de desembarque"},"data_chegada":{"type":"string","format":"date","nullable":true,"description":"Data de chegada"},"eta":{"type":"string","format":"date","nullable":true,"description":"ETA (Estimated Time of Arrival)"},"agente_de_carga":{"type":"string","nullable":true,"description":"Agente de carga"},"stakeholder_agente_carga_id":{"type":"integer","nullable":true,"description":"ID do stakeholder agente de carga"},"bl":{"type":"string","nullable":true,"description":"Número do BL (via marítima)"},"data_emissao_bl":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do BL"},"awb":{"type":"string","nullable":true,"description":"Número do AWB (via aérea)"},"data_emissao_awb":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do AWB"},"crt":{"type":"string","nullable":true,"description":"Número do CRT (via terrestre)"},"data_emissao_crt":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do CRT"},"fci":{"type":"string","nullable":true,"description":"FCI"},"incoterm":{"type":"string","nullable":true,"description":"Incoterm utilizado"},"peso_bruto":{"type":"number","format":"float","nullable":true,"description":"Peso bruto em kg"},"peso_liquido":{"type":"number","format":"float","nullable":true,"description":"Peso líquido em kg"},"status_container":{"type":"string","nullable":true,"description":"Status do container"},"presenca_carga":{"type":"string","nullable":true,"description":"Presença da carga"},"numero_invoice":{"type":"string","nullable":true,"description":"Número da invoice"},"valor_invoice":{"type":"number","format":"float","nullable":true,"description":"Valor da invoice"},"vencimento_invoice":{"type":"string","format":"date","nullable":true,"description":"Vencimento da invoice"},"data_cambio_saldo":{"type":"string","format":"date","nullable":true,"description":"Data do câmbio do saldo"},"terminal_de_armazenagem":{"type":"string","nullable":true,"description":"Terminal de armazenagem"},"anexos":{"type":"array","nullable":true,"description":"Anexos do processo","items":{"type":"object","properties":{"anexo":{"type":"object","properties":{"url":{"type":"string","description":"URL do anexo"}}}}}},"di":{"type":"object","nullable":true,"description":"Declaração de Importação","properties":{"codigo":{"type":"string","nullable":true,"description":"Código da DI"},"data_de_desembaraco":{"type":"string","format":"date","nullable":true,"description":"Data de desembaraço"},"data_registro":{"type":"string","format":"date","nullable":true,"description":"Data de registro"}}}},"required":["id","numero"]}},"pagination":{"type":"object","description":"Informações de paginação","properties":{"total":{"type":"integer","description":"Total de registros"},"previous_page":{"type":"string","nullable":true,"description":"URL da página anterior"},"next_page":{"type":"string","nullable":true,"description":"URL da próxima página"}}}},"required":["processos","pagination"]}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Sem permissão","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://changelog.maino.com.br/api-reference-maino/15.-processos-de-comex.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.