Emissão nota de serviço

1161

JSON a ser enviado

{
 "documento": {
 "identificacao": {
 "tipoRps": "string",
 "tipoTributacao": int,
 "naturezaTributacao": int,
 "situacaoNota": int,
 "incentivoFiscal": int,
 "numeroRps": int,
 "rpsSerie": "string",
 "regimeEspecialTributacao": int,
 "optanteSimplesNacional": int,
 "incentivadorCultural": int
 },
 "tipoAmbiente": int,
 "prestador": {
 "cpfCnpj": "string",
 "razaoSocial": "string",
 "nomeFantasia": "string",
 "inscricaoMunicipal": "string",
 "inscricaoEstadual": "string",
 "inscricaoSuframa": "string",
 "inscricaoMunicipalIsento": false,
 "inscricaoEstadualIsento": true,
 "inscricaoSuframaIsento": true,
 "telefone": {
 "dataCriacao": "09/02/2021 17:56:42",
 "dataAtualizacao": "09/02/2021 17:56:42",
 "usuarioCriacao": "string",
 "usuarioAlteracao": "string",
 "id": int,
 "tipo": "_1",
 "ddd": int,
 "telefone": int,
 "ativo": true,
 "notAtivo": false
 },
 "email": "string",
 "endereco": {
 "tipoEndereco": "string",
 "logradouro": "string",
 "numero": "string",
 "complemento": "",
 "bairro": "string",
 "municipio": "string",
 "estado": "string",
 "cep": "string",
 "codigoIbgeMunicipio": "string"
 }
 },
 "tomador": {
 "cpfCnpj": "string",
 "razaoSocial": "string",
 "nomeFantasia": "string",
 "inscricaoMunicipal": "string",
 "inscricaoEstadual": "string",
 "inscricaoSuframa": "string",
 "inscricaoMunicipalIsento": false,
 "inscricaoEstadualIsento": true,
 "inscricaoSuframaIsento": true,
 "telefone": {
 "dataCriacao": "09/02/2021 17:55:51",
 "dataAtualizacao": "09/02/2021 17:55:51",
 "usuarioCriacao": "string",
 "usuarioAlteracao": "string",
 "id": int,
 "tipo": "_1",
 "ddd": int,
 "telefone": int,
 "ativo": true,
 "notAtivo": false
 },
 "email": "string",
 "endereco": {
 "tipoEndereco": "string",
 "logradouro": "string",
 "numero": "string",
 "complemento": "string",
 "bairro": "string",
 "municipio": "string",
 "estado": "string",
 "cep": "string",
 "codigoIbgeMunicipio": "string"
 }
 },
 "servico": {
 "quantidadeServicos": int,
 "issRetido": int,
 "codigoItemListaServico": "string",
 "codigoSubItemListaServico": "string",
 "codigoCnae": int,
 "discriminacaoServico": "string",
 "descricaoRPS": "string",
 "codigoCidadePrestacao": "string",
 "descricaoCidadePrestacao": "string",
 "exigibilidadeISS": int,
 "municipioIncidencia": "string",
 "competencia": "26/02/2021 17:03:13",
 "tributavel": "string",
 "operacao": "string",
 "tributoMunicipioDescricao": "string",
 "cargaTributariaFonte": "string"
 },
 "total": {
 "valorServicos": "string",
 "baseCalculo": "string",
 "valorLiquidoNfse": "string",
 "valorUnitarioServico": "string",
 "descontoIncondicionado": "string",
 "descontoCondicionado": "string",
 "valorDeducoes": "string",
 "valorIssServico": "string",
 "valorIssRetido": "string",
 "outrasRetencoes": "string",
 "valorISS": "string",
 "valorPIS": "string",
 "valorCOFINS": "string",
 "valorINSS": "string",
 "valorIR": "string",
 "valorCSLL": "string",
 "valorCargaTributaria": "string",
 "aliquotaISS": "string",
 "aliquotaPIS": "string",
 "aliquotaCOFINS": "string",
 "aliquotaINSS": "string",
 "aliquotaIR": "string",
 "aliquotaCSLL": "string",
 "aliquotaCargaTributaria": "string",
 "valorISSRetido": "string",
 "valorISSServico": "string"
 }
 },
 "agendamentos": [
 {
 "label": "Segunda-feira, 1 de Março de 2021",
 "data": "01/03/2021",
 "ativo": true
 },
 {
 "label": "Quinta-feira, 1 de Abril de 2021",
 "data": "01/04/2021",
 "ativo": true
 },
 {
 "label": "Segunda-feira, 3 de Maio de 2021",
 "data": "03/05/2021",
 "ativo": true
 },
 {
 "label": "Terça-feira, 1 de Junho de 2021",
 "data": "01/06/2021",
 "ativo": true
 }
 ]
}

📘

Nota importante

O JSON acima refere-se a emissão de nota fiscal eletrônica de serviço, onde uma nota foi emitida no dia 28/02/2021 e outras quatros notas foram agendas para os respectivos dias. Neste caso a requisição é feita no método "emitir/agendar", para maiores detalhes ver o método link no menu lateral.

Para apenas emitir uma nota fiscal eletrônica de serviço a requisição dever ser feita no método "emitir", o mesmo JSON deve ser informado com o array "agendamentos" nulo.

Para apenas agendar notas notas fiscais eletrônica de serviço a requisição deve ser feita no método "somenteAgendar", o JSON ser enviado é como no exemplo acima, mesmo não havendo uma emissão no momento em que a requisição é feita, os dados da nota devem ser informados para salvá-los e emitir a nota conforme os respectivos agendamentos informados.

📘

Sobre o campo "tipo"

O campo "tipo", linhas 32, 67, é um "enum", sendo os valores: _1 (Comercial), _2 (Residêncial),
_3 (Celular).

Resposta da Api

{
    "id": "string",
    "detalhe": {
        "dataAtualizacao": "25/02/2021 15:52:02",
        "protocolo": "string",
        "identificador": "string",
        "codigoVerificacao": "string",
        "serie": "string",
        "numero": "string",
        "xml": "DATA/2/20/XML/4d3e123a-4a15-4bcf-8a1f-8482c69d859c",
        "pdf": "DATA/2/20/PDF/bb4e1e09-f745-42ee-ab97-795f8503b3e0",
        "origem": "INTEGRA_NFE",
        "situacao": {
            "estagio": "EMISSAO",
            "status": "SUCESSO",
            "mensagem": "Nota Fiscal de Serviço Emitida em 2021-02-25",
            "dataEmissao": "25/02/2021"
        },
        "tentativas": int
    }
}

Exemplo de erro

{
    "id": "string",
    "detalhe": {
        "dataAtualizacao": "01/03/2021 15:39:30",
        "origem": "INTEGRA_NFE",
        "situacao": {
            "estagio": "EMISSAO",
            "status": "PROCESSANDO",
            "mensagem": "",
            "dataEmissao": "01/03/2021"
        },
        "tentativas": int
    }
}

📘

Sobre o erro

Em caso de dados incorretos na emissão de nota fiscal eletrônica de serviço será retornado um JSON como o acima, é o mesmo retornado no caso de sucesso, no campo "mensagem" será apresentado a mensagem retornada pelo SEFAZ, assim como no campo "codigo" será apresentado o valor padrão.

Os códigos retornados pelo SEFAZ podem ser encontrados no Manual de Orientação do Contribuinte.