# 15. 🌐 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":"15. 🌐 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":["15. 🌐 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":"15. 🌐 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":["15. 🌐 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":"15. 🌐 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":["15. 🌐 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: 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:

```
GET https://changelog.maino.com.br/api-reference-maino/15.-declaracoes-de-importacao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.