Emitir nota de consumidor

POST

/api/v1/nfce

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/nfce/{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: ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://api.digisan.com.br/api/v1/nfce' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ambiente": "1",
    "indicadorPresencaComprador": 1,
    "identificadorOperacao": 1,
    "naturezaOperacao": "string",
    "consumidorFinal": true,
    "idExterno": "id123",
    "emissao": "2019-08-24T14:15:22.123Z",
    "dataEntradaSaida": "2019-08-24T14:15:22.123Z",
    "emitente": {
        "cnpj": "string"
    },
    "destinatario": {
        "cpfCnpj": "string"
    },
    "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
            }
        }
    },
    "pagamentos": [
        {
            "forma": "1",
            "valor": 0
        }
    ],
    "informacoesAdicionais": "string",
    "metadados": {
        "property1": "string",
        "property2": "string"
    }
}'

Response Example

{}

Modificado em 2026-05-20 13:14:12