Emitir nota de serviço

POST

/api/v1/nfse

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 Prefeitura.

Essa rota é assíncrona, para obter a situação de seu envio, utilize a rota /api/v1/nfse/{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/nfse' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "naturezaTributacao": 1,
    "padraoNacional": false,
    "idExterno": "id123",
    "emissao": "2019-08-24T14:15:22.123Z",
    "competencia": "2023-08-14",
    "enviarPorEmail": false,
    "prestador": {
        "cnpj": "string"
    },
    "tomador": {
        "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"
            }
        }
    },
    "ibpt": {
        "automatico": true
    },
    "servico": {
        "descricao": "string",
        "ibscbs": {
            "cst": "000",
            "codigoClassificacaoTributaria": "000001",
            "codigoIndicadorOperacao": "100301",
            "tipoEnteGovernamental": "null"
        },
        "cnae": "4751201",
        "codigoNbs": "114061900",
        "codigoContribuinte": "452000301",
        "informacaoExterior": {
            "modoPrestacao": 2,
            "vinculoPrestacao": 0,
            "tipoMoeda": "000",
            "valorServicos": 1000,
            "tipoFomentoPrestador": "01",
            "tipoFomentoTomador": "01",
            "tipoMovimentacaoBens": 1,
            "tipoMDIC": 0
        },
        "atividadeEvento": {
            "dataInicio": "2026-03-05",
            "dataFim": "2026-03-06",
            "descricao": "Feira de serviços",
            "idAtvEvt": "ABC123",
            "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"
                }
            }
        },
        "obra": {
            "codigo": "12345"
        },
        "codigoMunicipio": "5300108",
        "codigoMunicipioIncidencia": "5300108",
        "itemListaServicoLC116": "08.02",
        "codigoTributacaoMunicipio": "802",
        "tipoTributacao": 1,
        "indicadorExigibilidade": 1,
        "tipoImunidade": 0,
        "issRetido": false,
        "valorServicos": "802",
        "descontoCondicionado": 0,
        "descontoIncondicionado": 0,
        "deducao": {
            "valor": 0,
            "tipo": 0
        },
        "aliquotaIss": 3,
        "valorIss": 0,
        "baseCalculo": 0,
        "valorCofins": 0,
        "cofinsRetido": false,
        "pisRetido": false,
        "csllRetido": false,
        "valorCsll": 0,
        "valorIr": 0,
        "aliquotaPis": 1.65,
        "aliquotaCofins": 7.6,
        "valorPis": 0,
        "baseInss": 1000,
        "aliquotaInss": 11,
        "valorInss": 110,
        "cstPisCofins": "00",
        "tributacaoTotal": {
            "federal": {
                "valorPercentual": 2.21
            },
            "estadual": {
                "valorPercentual": 2.21
            },
            "municipal": {
                "valorPercentual": 2.21
            },
            "percentualSimplesNacional": 6
        }
    },
    "informacoesAdicionais": "string",
    "metadados": {
        "property1": "string",
        "property2": "string"
    }
}'

Response Example

{}

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