1. NFe
DIGISAN
  • Getting Started
    • Introdução
    • Autenticação
    • Ambiente
    • Reforma Tributária
  • 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
    • Obtém um emitente/prestador por CNPJ
      GET
    • Atualização de emitente/prestador
      PUT
    • Upload do certificado digital do emitente/prestador em multipart-form-data.
      POST
    • Deleta o certificado digital do emitente/prestador
      DELETE
    • Cadastro de emitente/prestador
      POST
  • NFSe
    • Emitir nota de serviço
      POST
    • Baixar XML da nota
      GET
    • Baixar PDF da nota
      GET
    • Consulta nota pelo ID
      GET
    • Solicitar cancelamento da nota
      POST
    • 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
      POST
    • Baixar XML da nota
      GET
    • Baixar PDF da nota
      GET
    • Consulta nota pelo ID
      GET
    • Solicitar Carta de Correção
      POST
    • Solicitar cancelamento da nota
      POST
    • Inutilizar numeração de nota fiscal (NF-e)
      POST
  • NFC-e
    • Emitir nota de consumidor
    • Baixar XML da nota
    • Baixar PDF da nota
    • Consulta nota pelo ID
    • Solicitar cancelamento da nota
    • Inutilizar numeração de nota fiscal (NFC-e)
  • 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
    • CadastrarCompaniaInput
    • ConsultaPaginadaHistoricoWebhookInput
    • NFSeResponseDTO
    • CidadeDTO
    • NFeCancelamentoDTO
    • NFeCartaCorrecaoDTO
    • NFeResponseDTO
    • NFCeResponseDTO
  1. NFe

Emitir nota de produto

POST
/api/v1/nfe
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 nota enviada, em seguida, enviaremos sua(s) nota(s) para a SEFAZ.
Essa rota é assíncrona, para obter a situação de seu envio, utilize a rota /api/v1/nfe/{idNota}. Se preferir, cadastre um Webhook para sua Organização, para que receba notificações sempre que o processamento de uma nota 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

🟢200OK
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://api.digisan.com.br/api/v1/nfe' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ambiente": "1",
    "finalidade": 1,
    "tipoOperacao": 1,
    "indicadorPresencaComprador": 1,
    "identificadorOperacao": 1,
    "codigoMunicipioFatoGeradorIbs": "string",
    "dataPrevisaoEntregaDisponibilizacao": "2025-11-06",
    "tipoNotaDebito": "string",
    "tipoNotaCredito": "string",
    "compraGovernamental": {
        "tipoEnte": 0,
        "percentual": 0,
        "tipoOperacao": 0
    },
    "pagamentoAntecipado": [
        {
            "chave": "string"
        }
    ],
    "naturezaOperacao": "string",
    "consumidorFinal": true,
    "idExterno": "id123",
    "emissao": "2019-08-24T14:15:22.123Z",
    "dataEntradaSaida": "2019-08-24T14:15:22.123Z",
    "enviarPorEmail": false,
    "emitente": {
        "cnpj": "string"
    },
    "destinatario": {
        "nome": "string",
        "cpfCnpj": "string",
        "codigoEstrangeiro": "string",
        "inscricaoEstadual": "string",
        "inscricaoMunicipal": "string",
        "telefone": "string",
        "email": "string",
        "tipoPessoa": "FISICA",
        "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"
            }
        }
    },
    "itens": [
        {
            "codigo": "12345",
            "descricao": "iPhone XR Cinza",
            "ibscbs": {
                "cst": "000",
                "codigoClassificacaoTributaria": "000001",
                "indicadorDoacao": 0,
                "baseCalculo": 0,
                "uf": {
                    "aliquota": 0,
                    "valor": 0
                },
                "municipio": {
                    "aliquota": 0,
                    "valor": 0
                },
                "valorIbs": 0,
                "cbs": {
                    "aliquota": 0,
                    "valor": 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
            }
        }
    },
    "frete": {
        "modalidadeFrete": 0,
        "transportadora": {
            "nome": "string",
            "cpfCnpj": "string",
            "inscricaoEstadual": "string",
            "inscricaoMunicipal": "string",
            "tipoPessoa": "FISICA",
            "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"
                }
            }
        },
        "icmsTransporte": {
            "baseCalculoRetencaoICMS": 100,
            "aliquotaRetencao": 12,
            "valorServico": 150,
            "valorICMSRetido": 18,
            "cfop": "5353",
            "codigoMunicipio": "3550308"
        },
        "veiculo": {
            "placa": "string",
            "uf": "SP",
            "rntc": "string"
        },
        "reboques": [
            {
                "placa": "string",
                "uf": "SP",
                "rntc": "string"
            }
        ],
        "volumes": [
            {
                "quantidade": "string",
                "especie": "caixa",
                "marca": "XYZ",
                "numeracao": "string",
                "pesoLiquido": 0,
                "pesoBruto": 0,
                "lacres": [
                    "string"
                ]
            }
        ],
        "vagao": "string",
        "balsa": "string"
    },
    "fatura": {
        "numero": "string",
        "duplicatas": [
            {
                "numero": 1,
                "dataVencimento": "2025-12-01",
                "valor": 656.64
            }
        ]
    },
    "pagamentos": [
        {
            "forma": "1",
            "valor": 0
        }
    ],
    "notasReferenciadas": [
        {
            "chaveNfe": "35240801234567890123550010000000011000000012"
        }
    ],
    "informacoesAdicionais": "string",
    "metadados": {
        "property1": "string",
        "property2": "string"
    }
}'
Response Response Example
{}
Modificado em 2026-05-20 13:14:12
Página anterior
NFe
Próxima página
Baixar XML da nota
Built with