1. NFCom
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
      POST
    • Atualização de emitente/prestador
      PUT
    • Obtém um emitente/prestador por CNPJ
      GET
    • Upload do certificado digital do emitente/prestador em multipart-form-data.
      POST
    • Deleta o certificado digital do emitente/prestador
      DELETE
  • NFSe
    • Emitir nota de serviço
      POST
    • Listar NFS-e
      GET
    • Baixar XML da nota
      GET
    • Baixar PDF da nota
      GET
    • Consulta nota pelo ID
      GET
    • Solicitar cancelamento da nota
      POST
    • Consulta dados de um município homologado para emissão de NFSe
      GET
    • Consulta municípios homologados para emissão de NFSe
      GET
  • NFe
    • Emitir nota de produto
    • Listar NF-e
    • 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
    • Listar NFC-e
    • 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
    • Emitir conhecimento de transporte eletrônico
    • Listar CT-e
    • 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
    • Emitir CT-e OS
    • Consulta CT-e OS pelo ID
    • Listar CT-e OS
    • 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
    • Solicitar inclusão de DF-e no MDF-e
    • Listar MDF-e
    • Solicitar inclusão de condutor no MDF-e
    • Solicitar encerramento do MDF-e
    • Solicitar cancelamento do MDF-e
    • Emitir Manifesto Eletrônico de Documentos Fiscais
    • Baixar XML do manifesto
    • Baixar PDF do manifesto
    • Baixar XML da última inclusão de DF-e do MDF-e
    • Baixar PDF da última inclusão de DF-e do MDF-e
    • Baixar XML da última inclusão de condutor do MDF-e
    • Baixar PDF da última inclusão de condutor do MDF-e
    • Baixar XML de encerramento do MDF-e
    • Baixar PDF de encerramento do MDF-e
    • Consulta MDF-e pelo ID
  • DC-e
    • Emitir DC-e
    • Listar DC-e
    • Baixar XML do DC-e
    • Baixar PDF do DC-e
    • Consulta DC-e pelo ID
    • Solicitar cancelamento do DC-e
  • NFCom
    • Solicitar cancelamento da NFCom
      POST
    • Listar NFCom
      GET
    • Emitir NFCom
      POST
    • Baixar XML da NFCom
      GET
    • Baixar PDF da NFCom
      GET
    • Consulta NFCom pelo ID
      GET
  • Esquemas
    • Schemas
      • Mensagem
      • Resposta
      • ObterWebhookResponseDTO
    • Raiz
    • NovoWebhookDTO
    • WebhookResponseDTO
    • AtivarEDesativarWebHookDTO
    • AlterarCompanhiaInput
    • EnderecoCompanhia
    • CadastrarEmpresaOutput
    • CancelarNFSe
    • Endereco
    • IBSCBS do Servico
    • Municipio
    • ImovelNFSe
    • 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
    • NFComEventoDTO
    • MDFeInclusaoDFe
    • Assinante
    • MDFeInclusaoDFeDocumento
    • Dados
    • MDFeInclusaoCondutor
    • Destinatario
    • MDFeEncerramento
    • Fatura
    • MDFeEncerramentoEvento
    • GerarNFCom
    • MDFeEvento
    • InformacoesAdicionais
    • MDFeInclusaoCondutorEvento
    • NFComEmitente
    • MDFeInclusaoDocumentoFiscalEvento
    • TerminalAdicional
    • 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
    • DCeEvento
    • Correcao
    • DCeAutorizadoXml
    • CTeCobranca
    • DCeCorreios
    • CTeComponenteValor
    • DCeDeclaracaoEmitente
    • CTeCompraGovernamental
    • DCeDestinatario
    • CTeContainer
    • DCeEmissorIntermediario
    • CTeCreditoPresumido
    • DCeEmitente
    • CTeDevolucaoTributo
    • DCeFisco
    • CTeDiferimento
    • DCeInformacoesAdicionais
    • CTeDocumentoNFe
    • DCeItem
    • CTeDocumentosOriginarios
    • DCeMarketplace
    • CTeDuplicata
    • DCeObservacao
    • CTeEmitente
    • DCeSolicitacaoFisco
    • CTeFatura
    • DCeTotal
    • CTeFerrovia
    • DCeTransportadoraEmissora
    • CTeIBSCBS
    • DCeTransporte
    • CTeICMS
    • GerarDCe
    • 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
    • ListagemDocumentoFiscalInput
    • ApiPublicaErrorDTO
    • DCeCancelamento
    • DCeResponse
    • NFComCancelamentoDTO
    • NFComResponseDTO
  1. NFCom

Emitir NFCom

POST
/api/v1/nfcom
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 NFCom enviado, em seguida, enviaremos seu(s) NFCom para a SEFAZ.
Essa rota é assíncrona, para obter a situação de seu envio, utilize a rota /api/v1/nfcom/{id}. Se preferir, cadastre um Webhook para sua Organização, para que receba notificações sempre que o processamento de uma NFCom 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/nfcom' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ambiente": "string",
    "modelo": "string",
    "codigoUfEmitente": "string",
    "codigoMunicipioFatoGerador": "string",
    "codigoNumerico": "string",
    "serie": "string",
    "numero": "string",
    "dataEmissao": "2019-08-24T14:15:22.123Z",
    "tipoEmissao": "string",
    "numeroSiteAutorizador": "string",
    "finalidade": "string",
    "tipoFaturamento": "string",
    "versaoAplicativo": "string",
    "indicadorPrePago": "string",
    "indicadorCessaoMeiosRede": "string",
    "indicadorNotaEntrada": "string",
    "dataHoraContingencia": "2019-08-24T14:15:22.123Z",
    "justificativaContingencia": "stringstringstr",
    "tipoPagamentoAntecipado": "string",
    "idExterno": "string",
    "emitente": {
        "cnpj": "12345678000195"
    },
    "dados": {
        "destinatario": {
            "nome": "string",
            "cnpj": "string",
            "cpf": "string",
            "idOutros": "string",
            "indicadorIe": "string",
            "inscricaoEstadual": "string",
            "inscricaoMunicipal": "string",
            "endereco": {
                "uf": "DF",
                "municipio": {
                    "codigoIbge": "5300108",
                    "nome": "Brasília"
                },
                "logradouro": "Rua 15",
                "complemento": "Casa 02",
                "numero": "151",
                "bairro": "Asa Sul",
                "cep": "70070900",
                "pais": {
                    "nome": "string",
                    "sigla": "string",
                    "bacen": "1058"
                }
            }
        },
        "assinante": {
            "codigo": "string",
            "tipo": "string",
            "tipoServico": "string",
            "contrato": "string",
            "inicioContrato": "string",
            "fimContrato": "string",
            "terminalPrincipal": "string",
            "ufTerminalPrincipal": "string",
            "terminaisAdicionais": [
                "string"
            ],
            "terminaisAdicionaisDetalhados": [
                {
                    "numero": "string",
                    "codigoUf": "string"
                }
            ]
        },
        "itens": [
            {
                "codigo": "12345",
                "descricao": "iPhone XR Cinza",
                "ibscbs": {
                    "cst": "000",
                    "codigoClassificacaoTributaria": "000001",
                    "indicadorDoacao": 0,
                    "baseCalculo": 0,
                    "uf": {
                        "aliquota": 0,
                        "valor": 0,
                        "predAliq": 0,
                        "paliqEfet": 0
                    },
                    "municipio": {
                        "aliquota": 0,
                        "valor": 0,
                        "predAliq": 0,
                        "paliqEfet": 0
                    },
                    "valorIbs": 0,
                    "cbs": {
                        "aliquota": 0,
                        "valor": 0,
                        "predAliq": 0,
                        "paliqEfet": 0
                    },
                    "monofasico": {
                        "padrao": {
                            "quantidade": 0,
                            "aliquotaAdRemIbs": 0,
                            "aliquotaAdRemCbs": 0,
                            "valorIbs": 0,
                            "valorCbs": 0
                        },
                        "retencao": {
                            "quantidade": 0,
                            "aliquotaAdRemIbs": 0,
                            "valorIbs": 0,
                            "aliquotaAdRemCbs": 0,
                            "valorCbs": 0
                        },
                        "retidoAnteriormente": {
                            "quantidade": 0,
                            "aliquotaAdRemIbs": 0,
                            "valorIbs": 0,
                            "aliquotaAdRemCbs": 0,
                            "valorCbs": 0
                        },
                        "diferimento": {
                            "aliquotaIbs": 0,
                            "valorIbs": 0,
                            "aliquotaCbs": 0,
                            "valorCbs": 0
                        },
                        "valorTotalIbs": 0,
                        "valorTotalCbs": 0
                    },
                    "transferenciaCredito": {
                        "valorIbs": 0,
                        "valorCbs": 0
                    },
                    "ajusteCompetencia": {
                        "competenciaApuracao": "string",
                        "valorIbs": 0,
                        "valorCbs": 0
                    },
                    "estornoCredito": {
                        "valorIbs": 0,
                        "valorCbs": 0
                    },
                    "creditoPresumidoOperacao": {
                        "baseCalculo": 0,
                        "codigoClassificacao": 0,
                        "ibs": {
                            "percentual": 0,
                            "valor": 0,
                            "valorCondicaoSuspensiva": 0
                        },
                        "cbs": {
                            "percentual": 0,
                            "valor": 0,
                            "valorCondicaoSuspensiva": 0
                        }
                    },
                    "apropriacaoCreditoPresumidoIbsZfm": {
                        "competenciaApuracao": "string",
                        "tipoClassificacao": 0,
                        "valorCreditoPresumidoSaldoDevedorApurado": 0
                    }
                },
                "icms": {
                    "situacaoTributaria": "00",
                    "situacaoTributariaSimplesNacional": "101",
                    "origem": "1",
                    "modalidadeBaseCalculo": "0",
                    "modalidadeBaseCalculoSt": "0",
                    "baseCalculo": 0,
                    "aliquota": 0,
                    "valor": 0,
                    "motivoDesoneracao": "1",
                    "valorICMSDesonerado": 0
                },
                "pis": {
                    "situacaoTributaria": "01",
                    "baseCalculo": 0,
                    "aliquota": 0,
                    "valor": 0
                },
                "cofins": {
                    "situacaoTributaria": "01",
                    "baseCalculo": 0,
                    "aliquota": 0,
                    "valor": 0
                },
                "ipi": {
                    "situacaoTributaria": "1",
                    "baseCalculo": 0,
                    "aliquota": 0,
                    "valor": 0,
                    "codigoEnquadramento": "string"
                },
                "cfop": "string",
                "ncm": "string",
                "cest": "string",
                "unidadeComercial": "un",
                "valorUnitario": 0,
                "valorLiquido": 0,
                "valorBruto": 0,
                "quantidade": 0,
                "desconto": 0,
                "frete": 0,
                "seguro": 0,
                "outrasDespesas": 0,
                "codigoBeneficioFiscal": "string",
                "informacoesAdicionais": "string",
                "classificacaoSubapuracaoIbsZfm": "string",
                "indicadorBemMovelUsado": 0,
                "dfeReferenciado": {
                    "chaveAcesso": "string",
                    "numero": 0
                },
                "valorTotal": 0,
                "is": {
                    "cst": "string",
                    "classificacaoTributaria": "string",
                    "baseCalculo": 0,
                    "aliquota": 0,
                    "aliquotaEspecifica": 0,
                    "unidadeTributavel": "string",
                    "quantidadeTributavel": 0,
                    "valor": 0
                }
            }
        ],
        "total": {
            "baseCalculoICMS": 0,
            "valorICMS": 0,
            "valorICMSDesonerado": 0,
            "valorICMSST": 0,
            "valorBCICMSST": 0,
            "valorProdutos": 0,
            "valorFrete": 0,
            "valorSeguro": 0,
            "valorDesconto": 0,
            "valorImpostoImportacao": 0,
            "valorIPI": 0,
            "valorPIS": 0,
            "valorCOFINS": 0,
            "outrasDespesasAcessorias": 0,
            "valorICMSPartilhaUfDestino": 0,
            "valorICMSPartilhaUfRemetente": 0,
            "valorICMSFCPUfDestino": 0,
            "valorTotalNfe": 0,
            "valorIPIDevolvido": 0,
            "valorFcp": 0,
            "valorImpostoSeletivo": 0,
            "ibscbs": {
                "baseCalculo": 0,
                "valorIbsMonofasico": 0,
                "valorCbsMonofasica": 0,
                "valorIbsMonofasicoRetencao": 0,
                "valorCbsMonofasicaRetencao": 0,
                "valorIbsMonofasicoRetido": 0,
                "valorCbsMonofasicaRetida": 0,
                "valorIbsEstornado": 0,
                "valorCbsEstornado": 0,
                "ibs": {
                    "valorDiferimentoUf": 0,
                    "valorDevolucaoTributoUf": 0,
                    "valorIbsUf": 0,
                    "valorDiferimentoMunicipio": 0,
                    "valorDevolucaoTributoMunicipio": 0,
                    "valorIbsMunicipio": 0,
                    "valorIbs": 0,
                    "valorCreditoPresumido": 0,
                    "valorCreditoPresumidoCondicional": 0
                },
                "cbs": {
                    "valorDiferimento": 0,
                    "valorDevolucaoTributo": 0,
                    "valorCbs": 0,
                    "valorCreditoPresumido": 0,
                    "valorCreditoPresumidoCondicional": 0
                }
            }
        },
        "fatura": {
            "competencia": "string",
            "dataVencimento": "string",
            "periodoUsoInicial": "string",
            "periodoUsoFim": "string",
            "codigoBarras": "string"
        },
        "informacoesAdicionais": {
            "fisco": "string",
            "complementares": [
                "string"
            ]
        },
        "autorizadosXml": [
            "string"
        ]
    },
    "metadados": {
        "property1": "string",
        "property2": "string"
    }
}'
Response Response Example
{}
Modificado em 2026-09-09 12:47:00
Página anterior
Listar NFCom
Próxima página
Baixar XML da NFCom
Built with