> 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"}}}}}}}}}}}
```
