> 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/14.-declaracoes-de-importacao.md).

# 14. 🌐 Declarações de Importação

**Gestão de processos de importação** Controle completo de DIs e processos aduaneiros. **Funcionalidades:**

* Registro e controle de DIs
* Cálculo de impostos de importação
* Controle de licenças e autorizações
* Integração com despachantes

## Listar Declarações de Importação

> Retorna lista de Declarações de Importação (DI)

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"14. 🌐 Declarações de Importação","description":"**Gestão de processos de importação**\nControle completo de DIs e processos aduaneiros.\n**Funcionalidades:**\n- Registro e controle de DIs\n- Cálculo de impostos de importação\n- Controle de licenças e autorizações\n- Integração com despachantes"}],"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":{"/dis":{"get":{"summary":"Listar Declarações de Importação","tags":["14. 🌐 Declarações de Importação"],"description":"Retorna lista de Declarações de Importação (DI)","parameters":[{"name":"per_page","in":"query","description":"Quantidade de registros por página","required":false,"schema":{"type":"integer"}},{"name":"page","in":"query","description":"Número da página","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de DIs","content":{"application/json":{"schema":{"type":"object","properties":{"dis":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID da DI"},"codigo":{"type":"string","description":"Código da DI"},"fornecedor":{"type":"string","nullable":true,"description":"Razão social do fornecedor"}}}},"pagination":{"type":"object","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"}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Erro indicando ausência ou invalidade da chave de API"}}}}}}}}}}}
```

## Criar nova DI

> \*\*Importa uma Declaração de Importação a partir de arquivo XML do Siscomex\*\*\
> \
> Este endpoint processa o arquivo XML exportado do sistema Siscomex (Receita Federal)\
> e cria automaticamente a DI com todas as adições, mercadorias e impostos.

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"14. 🌐 Declarações de Importação","description":"**Gestão de processos de importação**\nControle completo de DIs e processos aduaneiros.\n**Funcionalidades:**\n- Registro e controle de DIs\n- Cálculo de impostos de importação\n- Controle de licenças e autorizações\n- Integração com despachantes"}],"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":{"/dis":{"post":{"summary":"Criar nova DI","tags":["14. 🌐 Declarações de Importação"],"description":"**Importa uma Declaração de Importação a partir de arquivo XML do Siscomex**\n\nEste endpoint processa o arquivo XML exportado do sistema Siscomex (Receita Federal)\ne cria automaticamente a DI com todas as adições, mercadorias e impostos.","parameters":[],"responses":{"201":{"description":"DI criada","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID da DI"},"codigo":{"type":"string","description":"Código da DI"},"statusCodigo":{"type":"string","description":"Status da DI"},"statusNome":{"type":"string"},"url":{"type":"string","format":"uri","description":"URL para visualização da DI"}}}}}},"400":{"description":"Erro ao processar a DI","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Mensagem de erro"},"validation":{"type":"array","items":{"type":"string"},"description":"Detalhes do erro de validação"}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Erro indicando ausência ou invalidade da chave de API"}}}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"di[arquivo]":{"type":"string","format":"binary","description":"Arquivo XML do Siscomex"},"di[webhook_url]":{"type":"string","description":"URL para notificação quando a DI for processada"},"di[valor_afrmm]":{"type":"number","description":"Taxa AFRMM"},"di[data_pagamento_afrmm]":{"type":"string","format":"date","description":"Data de Desembaraço"}},"required":["di[arquivo]"]}}},"required":true,"description":"Arquivo XML do Siscomex"}}}}}
```

## Gera NF-e a partir da DI

> \*\*Gera uma NF-e de entrada com base nos dados da DI\*\*\
> \
> Este endpoint inicia o processo de geração de NF-e a partir de uma DI finalizada.\
> O processo é assíncrono e uma URL de progresso é retornada.\
> \
> \*\*Pré-requisitos:\*\*\
> \- DI deve estar em status de digitação\
> \- Todos os dados obrigatórios devem estar preenchidos

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"14. 🌐 Declarações de Importação","description":"**Gestão de processos de importação**\nControle completo de DIs e processos aduaneiros.\n**Funcionalidades:**\n- Registro e controle de DIs\n- Cálculo de impostos de importação\n- Controle de licenças e autorizações\n- Integração com despachantes"}],"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":{"/dis/{id}/gerar_nfe":{"post":{"summary":"Gera NF-e a partir da DI","tags":["14. 🌐 Declarações de Importação"],"description":"**Gera uma NF-e de entrada com base nos dados da DI**\n\nEste endpoint inicia o processo de geração de NF-e a partir de uma DI finalizada.\nO processo é assíncrono e uma URL de progresso é retornada.\n\n**Pré-requisitos:**\n- DI deve estar em status de digitação\n- Todos os dados obrigatórios devem estar preenchidos","responses":{"200":{"description":"NF-e sendo gerada","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Mensagem de status"},"di_id":{"type":"integer","description":"ID da DI"},"progresso_url":{"type":"string","format":"uri","description":"URL para acompanhar o progresso da finalização"}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"DI não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}}}}}},"422":{"description":"Não é possível gerar a NF-e","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Mensagem de erro"},"errors":{"type":"array","items":{"type":"string"},"description":"Lista de pendências ou erros de validação"}}}}}}}}}}}
```


---

# 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/14.-declaracoes-de-importacao.md?ask=<question>&goal=<endgoal>
```

`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.