1. MDF-e (Beta)
DIGISAN
  • Getting Started
    • Introdução
    • Ambiente
    • Autenticação
    • Certificado Digital
    • Exemplo de requisições
    • Reforma Tributária
    • Suporte e SLA
  • Webhooks
    • Eventos disponíves
    • Cadastra webhook
      POST
    • Atualiza o cadastro de webhook
      PUT
    • Ativa/desativa um webhook
      PUT
    • Retorna os dados do webhook cadastrado
      GET
    • Lista histórico de webhooks enviados
      GET
  • Empresas
    • Cadastro de emitente/prestador
    • Atualização de emitente/prestador
    • Obtém um emitente/prestador por CNPJ
    • Upload do certificado digital do emitente/prestador em multipart-form-data.
    • Deleta o certificado digital do emitente/prestador
  • NFSe
    • Emitir nota de serviço
    • Baixar XML da nota
    • Baixar PDF da nota
    • Consulta nota pelo ID
    • Solicitar cancelamento da nota
    • Consulta dados de um município homologado para emissão de NFSe
    • Consulta municípios homologados para emissão de NFSe
  • NFe
    • Emitir nota de produto
    • Baixar XML da nota
    • Baixar PDF da nota
    • Consulta nota pelo ID
    • Solicitar Carta de Correção
    • Solicitar cancelamento da nota
    • Inutilizar numeração de nota fiscal (NF-e)
  • NFC-e
    • Emitir nota de consumidor
    • Consulta nota pelo ID
    • Baixar XML da nota
    • Baixar PDF da nota
    • Solicitar cancelamento da nota
    • Inutilizar numeração de nota fiscal (NFC-e)
  • CT-e (Beta)
    • Emitir conhecimento de transporte eletrônico
    • Consulta CT-e pelo ID
    • Baixar XML do CT-e
    • Baixar PDF do DACTE
    • Solicitar Carta de Correção do CT-e
    • Solicitar cancelamento do CT-e
  • CT-e OS (Beta)
    • Emitir CT-e OS
    • Consulta CT-e OS pelo ID
    • Baixar XML do CT-e OS
    • Baixar PDF do DACTE OS
    • Solicitar Carta de Correção do CT-e OS
    • Solicitar cancelamento do CT-e OS
  • MDF-e (Beta)
    • Solicitar inclusão de DF-e no MDF-e
      POST
    • Solicitar inclusão de condutor no MDF-e
      POST
    • Solicitar encerramento do MDF-e
      POST
    • Solicitar cancelamento do MDF-e
      POST
    • Emitir Manifesto Eletrônico de Documentos Fiscais
      POST
    • Baixar XML do manifesto
      GET
    • Baixar PDF do manifesto
      GET
    • Baixar XML da última inclusão de DF-e do MDF-e
      GET
    • Baixar PDF da última inclusão de DF-e do MDF-e
      GET
    • Baixar XML da última inclusão de condutor do MDF-e
      GET
    • Baixar PDF da última inclusão de condutor do MDF-e
      GET
    • Baixar XML de encerramento do MDF-e
      GET
    • Baixar PDF de encerramento do MDF-e
      GET
    • Consulta MDF-e pelo ID
      GET
  • Raiz
  • Esquemas
    • Schemas
      • Mensagem
      • Resposta
      • ObterWebhookResponseDTO
    • Raiz
    • NovoWebhookDTO
    • WebhookResponseDTO
    • AtivarEDesativarWebHookDTO
    • AlterarCompanhiaInput
    • EnderecoCompanhia
    • CadastrarEmpresaOutput
    • CancelarNFSe
    • Endereco
    • IBSCBS do Servico
    • Municipio
    • NFSe
    • NFSeIbptDTO
    • Pais
    • Prestador
    • Servico
    • ServicoInformacaoExterior
    • Tomador
    • deducao
    • obra
    • servicoAtividadeEvento
    • tributacaoTotal
    • tributacaoTotalConteudo
    • Evento
    • InutilizarDTO
    • NumeracaoDTO
    • CBS
    • CBS Total
    • Emitente
    • Frete
    • IBS Município
    • IBS Total
    • IBS UF
    • IBSCBS Total
    • IBSCBS do Item
    • ICMS
    • IPI
    • Imposto
    • Item
    • NFe
    • NFeAjusteCompetenciaDTO
    • NFeApropriacaoCreditoPresumidoIbsZfmDTO
    • NFeCompraGovernamentalDTO
    • NFeCreditoPresumidoDTO
    • NFeCreditoPresumidoOperacaoDTO
    • NFeDuplicataDTO
    • NFeEstornoCreditoDTO
    • NFeFaturaDTO
    • NFeItemDFeReferenciadoDTO
    • NFeItemISDTO
    • NFeMonofasicoDTO
    • NFeMonofasicoDiferimentoDTO
    • NFeMonofasicoPadraoDTO
    • NFeMonofasicoRetencaoDTO
    • NFeMonofasicoRetidoDTO
    • NFePagamentoAntecipadoDTO
    • NFeReferenciada
    • NFeRetencaoICMSTransporteDTO
    • NFeTransferenciaCreditoDTO
    • NFeVeiculoDTO
    • NFeVolumeDTO
    • Pagamento
    • Total
    • Transportadora
    • Destinatario NFCe
    • NFCe
    • MDFeInclusaoDFe
    • MDFeInclusaoDFeDocumento
    • MDFeInclusaoCondutor
    • MDFeEncerramento
    • MDFeEncerramentoEvento
    • MDFeEvento
    • MDFeInclusaoCondutorEvento
    • MDFeInclusaoDocumentoFiscalEvento
    • CargaLotacao
    • DocumentoCTe
    • DocumentoMDFe
    • DocumentoNFe
    • EmbarcacaoCombinada
    • EntregaParcial
    • LocalizacaoCarga
    • MDFETotalizadores
    • MDFe
    • MDFeAereo
    • MDFeAquaviario
    • MDFeAutorizadoXml
    • MDFeCiot
    • MDFeComponentePagamento
    • MDFeCondutor
    • MDFeContratante
    • MDFeContrato
    • MDFeDadosBancarios
    • MDFeDispositivoValePedagio
    • MDFeEmitente
    • MDFeFerroviario
    • MDFeInformacoesANTT
    • MDFeInformacoesModal
    • MDFeMunicipioCarregamento
    • MDFeMunicipioDescarregamento
    • MDFePagamentoContrato
    • MDFeParcelaPagamento
    • MDFeProdutoPerigoso
    • MDFeProdutoPredominante
    • MDFeProprietarioVeiculo
    • MDFeResponsavelTecnico
    • MDFeRodoviario
    • MDFeSeguro
    • MDFeUnidadeCarga
    • MDFeUnidadeTransporte
    • MDFeValePedagio
    • MDFeVeiculoReboque
    • MDFeVeiculoTracao
    • TerminalCarregamento
    • TerminalDescarregamento
    • Trem
    • UnidadeVazia
    • Vagao
    • CadastrarCompaniaInput
    • CTeEvento
    • Correcao
    • CTeCobranca
    • CTeComponenteValor
    • CTeCompraGovernamental
    • CTeContainer
    • CTeCreditoPresumido
    • CTeDevolucaoTributo
    • CTeDiferimento
    • CTeDocumentoNFe
    • CTeDocumentosOriginarios
    • CTeDuplicata
    • CTeEmitente
    • CTeFatura
    • CTeFerrovia
    • CTeIBSCBS
    • CTeICMS
    • CTeImposto
    • CTeInformacoesCarga
    • CTeInformacoesModal
    • CTeLacre
    • CTeModalAereo
    • CTeModalAquaviario
    • CTeModalDutoviario
    • CTeModalFerroviario
    • CTeModalMultimodal
    • CTeModalRodoviario
    • CTeOS
    • CTeOSDocumentoReferenciado
    • CTeOSFretamento
    • CTeOSInformacoesServico
    • CTeOSModalRodoviario
    • CTeOSProprietarioVeiculo
    • CTeOSVeiculo
    • CTeOrdemColeta
    • CTeOutroDocumento
    • CTeParticipante
    • CTeProdutoPerigoso
    • CTeQuantidadeCarga
    • CTeReducaoAliquota
    • CTeSeguro
    • CTeTomador
    • CTeTributacaoRegular
    • CTeTributoCompartilhado
    • CTeTributosFederais
    • CTeVagao
    • CTeValePedagio
    • CTeValoresPrestacao
    • CTeVeiculo
    • CTeVeiculoNovo
    • CTe
    • ConsultaPaginadaHistoricoWebhookInput
    • NFSeCancelamentoDTO
    • NFSeResponseDTO
    • CidadeDTO
    • NFeCancelamentoDTO
    • NFeCartaCorrecaoDTO
    • NFeResponseDTO
    • NFCeResponseDTO
    • MDFeCancelamento
    • MDFeEncerramentoResponse
    • MDFeInclusaoCondutorResponse
    • MDFeInclusaoDFeDocumentoResponse
    • MDFeInclusaoDFeResponse
    • MDFeResponse
    • CTeCancelamentoDTO
    • CTeCartaCorrecaoDTO
    • CTeResponse
    • CTeOSResponse
  1. MDF-e (Beta)

Emitir Manifesto Eletrônico de Documentos Fiscais

POST
/api/v1/mdfe
Nesta etapa, iremos realizar uma validação de esquema do JSON, e de algumas regras de negócio, se tudo estiver OK, você receberá um ID para cada manifesto enviado, em seguida, enviaremos seu(s) manifesto(s) para a SEFAZ.
Essa rota é assíncrona, para obter a situação de seu envio, utilize a rota /api/v1/mdfe/{idManifesto}. Se preferir, cadastre um Webhook para sua Organização, para que receba notificações sempre que o processamento de um manifesto for finalizado.

Requisição

Authorization
API Key
Adicionar parâmetro em header
x-api-key
Exemplo:
x-api-key: ********************
or
Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://api.digisan.com.br/api/v1/mdfe' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ambiente": "1",
    "modelo": "58",
    "codigoUfEmitente": "35",
    "tipoEmitente": "1",
    "tipoTransportador": "1",
    "serie": "1",
    "numero": 123,
    "codigoNumerico": "12345678",
    "modal": "1",
    "emissao": "2019-08-24T14:15:22.123Z",
    "tipoEmissao": "1",
    "processoEmissao": "0",
    "versaoAplicativo": "DIGISAN_0.01",
    "ufCarregamento": "SP",
    "ufDescarregamento": "RJ",
    "municipiosCarregamento": [
        {
            "codigoMunicipio": "3550308",
            "municipio": "São Paulo"
        }
    ],
    "ufsPercurso": [
        "MG"
    ],
    "inicioViagem": "2019-08-24T14:15:22.123Z",
    "canalVerde": false,
    "carregaPosterior": false,
    "idExterno": "mdfe-123",
    "emitente": {
        "cnpj": "12345678000195"
    },
    "dadosModal": {
        "versaoModal": "3.0",
        "rodoviario": {
            "antt": {
                "rntrc": "12345678",
                "ciots": [
                    {
                        "codigo": "123456789012",
                        "responsavelCpfCnpj": "12345678000195",
                        "responsavelTipoPessoa": "FISICA"
                    }
                ],
                "valePedagio": {
                    "dispositivos": [
                        {
                            "cnpjFornecedor": "12345678000195",
                            "responsavelPagamentoCpfCnpj": "98765432000110",
                            "responsavelPagamentoTipoPessoa": "FISICA",
                            "numeroCompra": "123456",
                            "valor": 150,
                            "tipo": "01"
                        }
                    ],
                    "categoriaCombinacaoVeicular": "02"
                },
                "contratantes": [
                    {
                        "nome": "Comercial Exemplo Ltda",
                        "documento": "12345678000195",
                        "tipoDocumento": "FISICA",
                        "contrato": {
                            "numero": "CTR-2026-001",
                            "valorGlobal": 10000
                        }
                    }
                ],
                "pagamentos": [
                    {
                        "nomeResponsavel": "Comercial Exemplo Ltda",
                        "documentoResponsavel": "12345678000195",
                        "tipoDocumentoResponsavel": "FISICA",
                        "componentes": [
                            {
                                "tipo": "01",
                                "valor": 2000,
                                "descricao": "Outras despesas"
                            }
                        ],
                        "valorContrato": 2500,
                        "altoDesempenho": false,
                        "formaPagamento": "0",
                        "valorAdiantamento": 500,
                        "antecipaAdiantamento": false,
                        "parcelas": [
                            {
                                "numero": "001",
                                "vencimento": "2026-08-07",
                                "valor": 1000
                            }
                        ],
                        "tipoAntecipacao": "0",
                        "dadosBancarios": {
                            "codigoBanco": "001",
                            "agencia": "1234",
                            "cnpjInstituicaoPagamentoFrete": "12345678000195",
                            "pix": "fiscal@exemplo.com.br"
                        }
                    }
                ]
            },
            "veiculoTracao": {
                "codigoInterno": "TRAC01",
                "placa": "ABC1D23",
                "renavam": "12345678901",
                "taraKg": "8000",
                "capacidadeKg": "25000",
                "capacidadeM3": "90",
                "proprietario": {
                    "cpfCnpj": "12345678000195",
                    "tipoPessoa": "FISICA",
                    "rntrc": "12345678",
                    "nome": "Proprietário Exemplo Ltda",
                    "inscricaoEstadual": "110042490114",
                    "uf": "SP",
                    "tipoProprietario": "0"
                },
                "condutores": [
                    {
                        "nome": "João da Silva",
                        "cpf": "12345678901"
                    }
                ],
                "tipoRodado": "01",
                "tipoCarroceria": "00",
                "ufLicenciamento": "SP"
            },
            "reboques": [
                {
                    "codigoInterno": "TRAC01",
                    "placa": "ABC1D23",
                    "renavam": "12345678901",
                    "taraKg": "8000",
                    "capacidadeKg": "25000",
                    "capacidadeM3": "90",
                    "proprietario": {
                        "cpfCnpj": "12345678000195",
                        "tipoPessoa": "FISICA",
                        "rntrc": "12345678",
                        "nome": "Proprietário Exemplo Ltda",
                        "inscricaoEstadual": "110042490114",
                        "uf": "SP",
                        "tipoProprietario": "0"
                    },
                    "tipoCarroceria": "00",
                    "ufLicenciamento": "SP"
                }
            ],
            "codigoAgendamentoPorto": "AG123",
            "lacresRodoviarios": [
                "RODO123"
            ]
        },
        "aereo": {
            "nacionalidade": "PP",
            "matricula": "ABC",
            "numeroVoo": "1234",
            "codigoAerodromoEmbarque": "SBGR",
            "codigoAerodromoDestino": "SBGL",
            "dataVoo": "2026-07-07"
        },
        "aquaviario": {
            "irin": "BR1234567",
            "tipoEmbarcacao": "10",
            "codigoEmbarcacao": "EMB001",
            "nomeEmbarcacao": "Navio Exemplo",
            "numeroViagem": "V2026001",
            "codigoPortoEmbarque": "BRSSZ",
            "codigoPortoDestino": "BRRIO",
            "portoTransbordo": "BRPNG",
            "tipoNavegacao": "0",
            "terminaisCarregamento": [
                {
                    "codigo": "TERM1",
                    "nome": "Terminal 1"
                }
            ],
            "terminaisDescarregamento": [
                {
                    "codigo": "TERM2",
                    "nome": "Terminal 2"
                }
            ],
            "embarcacoesCombinadas": [
                {
                    "codigo": "BALSA01",
                    "balsa": "Balsa Exemplo"
                }
            ],
            "unidadesCargaVazias": [
                {
                    "identificacao": "CONT1234567",
                    "tipo": "1"
                }
            ],
            "unidadesTransporteVazias": [
                {
                    "identificacao": "CONT1234567",
                    "tipo": "1"
                }
            ],
            "mmsi": "710123456"
        },
        "ferroviario": {
            "trem": {
                "prefixo": "T123",
                "dataHoraTrem": "2019-08-24T14:15:22.123Z",
                "origem": "Terminal A",
                "destino": "Terminal B",
                "quantidadeVagoes": "10"
            },
            "vagoes": [
                {
                    "pesoBaseCalculo": 10.5,
                    "pesoReal": 10.25,
                    "tipo": "01",
                    "serie": "A",
                    "numero": "123456",
                    "sequencia": "1",
                    "taraUtil": "50000"
                }
            ]
        }
    },
    "documentosPorMunicipio": [
        {
            "codigoMunicipio": "3304557",
            "municipio": "Rio de Janeiro",
            "ctes": [
                {
                    "segundoCodigoBarras": "1234567890",
                    "reentrega": false,
                    "unidadesTransporte": [
                        {
                            "tipo": "1",
                            "identificacao": "CARRETA01",
                            "lacres": [
                                "LACREUT1"
                            ],
                            "unidadesCarga": [
                                {
                                    "tipo": "1",
                                    "identificacao": "CONT1234567",
                                    "lacres": [
                                        "LACREUC1"
                                    ],
                                    "quantidadeRateada": 100
                                }
                            ],
                            "quantidadeRateada": 100
                        }
                    ],
                    "produtosPerigosos": [
                        {
                            "numeroOnu": "1203",
                            "nomeEmbarque": "Gasolina",
                            "classeRisco": "3",
                            "grupoEmbalagem": "II",
                            "quantidadeTotalProduto": "1000 L",
                            "quantidadeTipoVolumes": "10 tambores"
                        }
                    ],
                    "entregaParcial": {
                        "quantidadeTotal": 100,
                        "quantidadeParcial": 50
                    },
                    "prestacaoParcial": false,
                    "chavesNFePrestacaoParcial": [
                        "35260712345678000195550010000000011000000010"
                    ],
                    "chave": "35260712345678000195570010000000011000000010"
                }
            ],
            "nfes": [
                {
                    "segundoCodigoBarras": "1234567890",
                    "reentrega": false,
                    "unidadesTransporte": [
                        {
                            "tipo": "1",
                            "identificacao": "CARRETA01",
                            "lacres": [
                                "LACREUT1"
                            ],
                            "unidadesCarga": [
                                {
                                    "tipo": "1",
                                    "identificacao": "CONT1234567",
                                    "lacres": [
                                        "LACREUC1"
                                    ],
                                    "quantidadeRateada": 100
                                }
                            ],
                            "quantidadeRateada": 100
                        }
                    ],
                    "produtosPerigosos": [
                        {
                            "numeroOnu": "1203",
                            "nomeEmbarque": "Gasolina",
                            "classeRisco": "3",
                            "grupoEmbalagem": "II",
                            "quantidadeTotalProduto": "1000 L",
                            "quantidadeTipoVolumes": "10 tambores"
                        }
                    ],
                    "entregaParcial": {
                        "quantidadeTotal": 100,
                        "quantidadeParcial": 50
                    },
                    "prestacaoParcial": false,
                    "chavesNFePrestacaoParcial": [
                        "35260712345678000195550010000000011000000010"
                    ],
                    "chave": "35260712345678000195550010000000011000000010"
                }
            ],
            "mdfes": [
                {
                    "segundoCodigoBarras": "1234567890",
                    "reentrega": false,
                    "unidadesTransporte": [
                        {
                            "tipo": "1",
                            "identificacao": "CARRETA01",
                            "lacres": [
                                "LACREUT1"
                            ],
                            "unidadesCarga": [
                                {
                                    "tipo": "1",
                                    "identificacao": "CONT1234567",
                                    "lacres": [
                                        "LACREUC1"
                                    ],
                                    "quantidadeRateada": 100
                                }
                            ],
                            "quantidadeRateada": 100
                        }
                    ],
                    "produtosPerigosos": [
                        {
                            "numeroOnu": "1203",
                            "nomeEmbarque": "Gasolina",
                            "classeRisco": "3",
                            "grupoEmbalagem": "II",
                            "quantidadeTotalProduto": "1000 L",
                            "quantidadeTipoVolumes": "10 tambores"
                        }
                    ],
                    "entregaParcial": {
                        "quantidadeTotal": 100,
                        "quantidadeParcial": 50
                    },
                    "prestacaoParcial": false,
                    "chavesNFePrestacaoParcial": [
                        "35260712345678000195550010000000011000000010"
                    ],
                    "chave": "35260712345678000195580010000000011000000010"
                }
            ]
        }
    ],
    "seguros": [
        {
            "responsavel": "1",
            "responsavelCpfCnpj": "12345678000195",
            "responsavelTipoPessoa": "FISICA",
            "seguradora": "Seguradora Exemplo",
            "cnpjSeguradora": "12345678000195",
            "numeroApolice": "AP123456",
            "averbacoes": [
                "AV123"
            ]
        }
    ],
    "produtoPredominante": {
        "tipoCarga": "01",
        "descricao": "Produtos alimentícios",
        "gtin": "SEM GTIN",
        "ncm": "19059090",
        "cargaLotacao": {
            "carregamento": {
                "cep": "01504001",
                "latitude": "-23.55052",
                "longitude": "-46.633308"
            },
            "descarregamento": {
                "cep": "01504001",
                "latitude": "-23.55052",
                "longitude": "-46.633308"
            }
        }
    },
    "total": {
        "quantidadeCte": "1",
        "quantidadeNfe": "0",
        "quantidadeMdfe": "0",
        "valorTotalCarga": 25000,
        "unidadePeso": "01",
        "pesoBruto": 1250.5
    },
    "lacres": [
        "LACRE123"
    ],
    "autorizadosXml": [
        {
            "cpfCnpj": "12345678000195",
            "tipoPessoa": "FISICA"
        }
    ],
    "informacoesAdicionaisFisco": "Operação conforme contrato 2026/001.",
    "informacoesComplementares": "Carga entregue em horário comercial.",
    "responsavelTecnico": {
        "cnpj": "12345678000195",
        "contato": "Suporte",
        "email": "suporte@exemplo.com.br",
        "telefone": "1133334444",
        "idCsrt": "01",
        "hashCsrt": "abc123"
    },
    "metadados": {
        "romaneio": "ROM-2026-001"
    },
    "valorTotalCarga": 0
}'
Response Response Example
{}
Modificado em 2026-07-15 17:20:30
Página anterior
Solicitar cancelamento do MDF-e
Próxima página
Baixar XML do manifesto
Built with