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

get

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

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de consulta

per_pageintegerOpcional

Quantidade de registros por página

pageintegerOpcional

Número da página

Respostas

200

Lista de DIs

application/json

401

Não autorizado

application/json

get

/dis

HTTPcURLJavaScriptPython

GET /api/v2/dis HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "dis": [
    {
      "id": 333333,
      "codigo": "33/3333333-3",
      "fornecedor": "FORNECEDOR LTDA"
    }
  ],
  "pagination": {
    "total": 50,
    "previous_page": "/api/v2/dis?page=1",
    "next_page": "/api/v2/dis?page=3"
  }
}

Criar nova DI

post

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.

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Corpo

multipart/form-data

di[arquivo]string · binaryObrigatório

Arquivo XML do Siscomex

di[webhook_url]stringOpcional

URL para notificação quando a DI for processada

di[valor_afrmm]numberOpcional

Taxa AFRMM

di[data_pagamento_afrmm]string · dateOpcional

Data de Desembaraço

Respostas

201

DI criada

application/json

400

Erro ao processar a DI

application/json

401

Não autorizado

application/json

post

/dis

HTTPcURLJavaScriptPython

POST /api/v2/dis HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 109

{
  "di[arquivo]": "binary",
  "di[webhook_url]": "text",
  "di[valor_afrmm]": 1,
  "di[data_pagamento_afrmm]": "2026-03-05"
}

{
  "id": "06b9dedf-0d19-4685-8032-a23e557307f5",
  "codigo": "333333",
  "statusCodigo": "text",
  "statusNome": "text",
  "url": "https://api.maino.com.br/api/v2/dis/06b9dedf-0d19-4685-8032-a23e557307f5"
}

Gera NF-e a partir da DI

post

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

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de rota

idintegerObrigatório

ID da DI

Respostas

200

NF-e sendo gerada

application/json

messagestringOpcional

Mensagem de status

Example: Aguarde, a nota fiscal está sendo gerada.

di_idintegerOpcional

ID da DI

Example: 533599

progresso_urlstring · uriOpcional

URL para acompanhar o progresso da finalização

Example: https://api.maino.com.br/dis/533599/progresso_finalizacao?chave=abc123

401

Não autorizado

application/json

404

DI não encontrada

application/json

422

Não é possível gerar a NF-e

application/json

post

/dis/{id}/gerar_nfe

HTTPcURLJavaScriptPython

POST /api/v2/dis/{id}/gerar_nfe HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "Aguarde, a nota fiscal está sendo gerada.",
  "di_id": 533599,
  "progresso_url": "https://api.maino.com.br/dis/533599/progresso_finalizacao?chave=abc123"
}