REST API de Nota Fiscal de Serviço

Guia Rápido

Todas as solicitações na API devem ser realizadas em ambiente criptografado HTTPS através da URL https://api.webmania.com.br. O prefixo /2/ indica que atualmente nós estamos utilizando a versão 2.0 da API.

Todas as respostas são no formato objeto JSON.

Uma requisição bem sucedida é indicada através do status HTTP, o status 2xx indica sucesso. Quando uma requisição ocorre falha o corpo da resposta [body] continua no formato JSON, mas sempre contém o campo error. Por exemplo, caso a sua autenticação não seja bem sucedida irá retornar a seguinte mensagem:

{
  "msg": "Acesso restrito."
}

Módulos & Exemplos

Realize a emissão com apenas um clique na sua Loja Virtual através dos módulos da Webmania® ou realize a integração para os diversos tipos de linguagens de programação.

• Ferramentas
  • Coleção Postman (Testes instantâneos)
  • Vídeo: Testar REST API sem linha de código
• Módulos
  • WooCommerce
• Linguagens
  • PHP

Autenticação

Para as requisições, o corpo da requisição [body] deve ser enviado no formato JSON com os headers Content-Type e Accept definidos para application/json.

A autenticação é realizada através do cabeçalho HTTP (HTTP headers). É necessário o envio do header Authorization Bearer Token com o Access-Token da API 2.0, encontrado no painel Webmania®.

Mantenha as credenciais de acesso em segurança. Nunca publique as credenciais de acesso no código fonte do site, aplicativo ou software onde o usuário possa ter fácil acesso.

Para aplicativos móveis iOS e Android, recomendamos que o processo de emissão seja realizado no servidor (back-end). O código fonte do aplicativo deve possuir somente a solicitação de emissão, enquanto o processo deve ser realizado em seu servidor.

Status município

A disponibilidade de recursos e funções na emissão da NFS-e depende das regras do provedor de cada município. Para obter todos os recursos disponíveis do provedor, envie uma requisição no método GET para a URL /2/nfse/status.

  curl -X GET \
-H "Authorization: Bearer SEU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
https://api.webmania.com.br/2/nfse/status

A resposta do corpo da mensagem será no formato objeto JSON, contendo os campos status, modelo, versao, ambientes, autenticacao, emissao, funcoes e parametros_disponiveis:

{
  "status": true, // Ambiente homologado
  "modelo": "abrasf", // Provedor do município
  "versao": "2.02", // Versão homologada
  "ambientes": [ 1, 2 ], // Ambientes disponíveis para emissão
  "autenticacao": [ "certificado_a1" ], // Formato de autenticação
  "emissao": [ "lote_rps", "nfse" ], // Modelos disponíveis para emissão
  "funcoes": [ "consultar", "cancelar", "substituir" ] // Funções disponíveis
  "codigo_servico": [
    {
      "codigo": "0000", // Código do serviço
      "descricao": "Serviço 1", // Descrição do serviço
      "codigo_tributacao": "000000000", // Código de tributação do serviço no município, caso esteja disponível
      "aliquota_sugerida": {
        "iss": 5 // Alíquota Sugerida do ISS
      }
    },
    {
      "codigo": "0000", // Código do serviço
      "descricao": "Serviço 2", // Descrição do serviço
      "aliquota_sugerida": {
        "iss": 2 // Alíquota Sugerida do ISS
      }
    },
    ...
  ],
  "parametros_disponiveis": {
    "empresa.cnpj": "obrigatorio_pj", // Para pessoa jurídica, obrigatório preencher o CNPJ nas configurações da empresa
    "servico.valor_servicos": "obrigatorio", // Obrigatório informar o valor dos serviços
    "tomador.cpf": "obrigatorio_pf", // Para pessoa física, obrigatório informar o CPF do tomador
    "tomador.email": "opcional", // Informar o e-mail do tomador é opcional
    ...
  }
 }

Sobre Lote RPS e NFS-e

Ao emitir uma Nota Fiscal de Serviço, é retornado o Lote RPS ou a NFS-e emitida. O tratamento depende do provedor de cada município. A Webmania sempre prioriza a emissão de forma síncrona, em tempo real, para proporcionar uma melhor experiência.

Ao realizar a integração é essencial recepcionar o retorno dos modelos lote_rps e nfse. Segue abaixo:

Notificações

Para que sua plataforma se mantenha sempre atualizada, a Webmania disponibiliza notificações automáticas para todos os status da Nota Fiscal e para todas as atualizações relacionadas ao DANFS-e.

As notificações são entregues via Amazon SQS (Simple Queue Service), garantindo entrega confiável mesmo durante picos de volume. O corpo da mensagem segue o formato JSON descrito abaixo e inclui o campo atualizado_em no padrão ISO-8601 quando timestamps são solicitados.

Cada Nota Fiscal possui um número único de identificação chamado de UUID. Este número deve ser utilizado para recepcionar e identificar a Nota Fiscal e atualizar as informações no seu banco de dados.

Notificações
Lote RPS

Será enviado o retorno no formato POST para a URL especificada contendo no corpo os parâmetros uuid, modelo, status, motivo, numero_lote, serie_lote, quantidade_rps, protocolo, info_nfse, log e atualizado_em.

A requisição via POST é realizada no formato application/json:

-X POST \
-header "Content-type: application/json" \

Segue exemplo do retorno via POST:

{
    "uuid": "00000000-0000-0000-0000-000000000000",
    "modelo": "lote_rps",
    "status": "processado",
    "motivo": "Lote processado com sucesso",
    "numero_lote": "0000",
    "serie_lote": "A0",
    "quantidade_rps": 2,
    "protocolo": "000000000000000",
    "info_nfse": [
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "modelo": "nfse",
            "status": "aprovado",
            "motivo": "Autorizado o uso da NFS-e",
            "numero": "00",
            "codigo_verificacao": "000000000",
            "xml": "https://api.webmania.com.br/xmlnfse/[uuid]",
            "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]",
            "pdf_nfse_status": "processado",
            "pdf_rps": "https://api.webmania.com.br/darps/[uuid]"
        },
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "modelo": "nfse",
            "status": "aprovado",
            "motivo": "Autorizado o uso da NFS-e",
            "numero": "00",
            "codigo_verificacao": "000000000",
            "xml": "https://api.webmania.com.br/xmlnfse/[uuid]",
            "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]",
            "pdf_nfse_status": "processando",
            "pdf_rps": "https://api.webmania.com.br/darps/[uuid]"
        }
    ],
    "log": { ... },
    "atualizado_em": "2024-01-01T12:00:00-03:00"
}

Notificações
NFS-e

Será enviado o retorno no formato POST para a URL especificada contendo no corpo os parâmetros uuid, modelo, status, motivo, numero, codigo_verificacao, serie_rps, numero_rps, xml, pdf_nfse, pdf_nfse_status, pdf_rps, log e atualizado_em.

A requisição via POST é realizada no formato application/json:

-X POST \
-header "Content-type: application/json" \

Segue exemplo do retorno via POST:

{
    "uuid": "00000000-0000-0000-0000-000000000000",
    "modelo": "nfse",
    "status": "aprovado",
    "motivo": "Autorizado o uso da NFS-e",
    "numero": "00",
    "codigo_verificacao": "000000000",
    "serie_rps": "A0",
    "numero_rps": 00,
    "xml": "https://api.webmania.com.br/xmlnfse/[uuid]",
    "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]",
    "pdf_nfse_status": "indisponivel",
    "pdf_rps": "https://api.webmania.com.br/darps/[uuid]",
    "log": { ... },
    "atualizado_em": "2024-01-01T12:00:00-03:00"
}

Emissão de Nota Fiscal

Para emitir uma Nota Fiscal de Serviço, envie a requisição no método POST para a URL /2/nfse/emissao contendo no corpo da requisição os objetos no formato JSON.

  curl -X POST \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ambiente": 1,
    "rps": [...]
  }' \
  https://api.webmania.com.br/2/nfse/emissao

Segue abaixo exemplo de como Emitir Nota Fiscal de Serviço de modo simplificado com classe de imposto:

{
  "ambiente": 2,
  "url_notificacao": "http://meudominio.com/retorno.php",
  "rps": [
    {
      "servico": {
        "valor_servicos": "15.00",
        "discriminacao": "Prestação de Serviço referente ao mês X",
        "classe_imposto": "REF000000"
      },
      "tomador": {
        "cpf": "000.000.000-00",
        "nome_completo": "Nome do tomador"
      }
    }
  ]
}

A resposta do corpo da mensagem será no formato objeto JSON, podendo ser retornado os modelos lote_rps ou nfse. Em caso de dúvidas, clique aqui para saber mais sobre Lote RPS e NFS-e.

No momento que realizado a emissão da Nota Fiscal, caso tenha informado o parâmetro url_notificacao, será enviado o retorno no formato POST para URL especificada. Saiba mais

Emissão de Nota Fiscal
Informações da Nota Fiscal

As Informações da Nota Fiscal possuem todos os campos necessários para a emissão de uma Nota Fiscal de Serviço.

Preencha os campos conforme finalidade da sua emissão, alguns parâmetros possuem informações adicionais que podem ser acessadas ao clicar em cima.

Informações da Nota Fiscal
Retorno Lote RPS

Segue abaixo exemplo do retorno do Lote RPS contendo os campos uuid, modelo, status, motivo, numero_lote, quantidade_rps, protocolo, info_nfse e log.

Segue exemplo do retorno no formato JSON:

{
  "uuid": "00000000-0000-0000-0000-000000000000", // Número único de identificação
  "modelo": "lote_rps", // Modelo do Lote RPS (nfse, lote_rps)
  "status": "processado", // processando, processado, agendado, reprovado, cancelado, contingencia
  "motivo": "Lote processado com sucesso", // Motivo do status
  "numero_lote": "0000", // Número do Lote RPS
  "serie_lote": "A0", // Série do Lote RPS
  "quantidade_rps": 2, // Quantidade de NFS-e no Lote RPS
  "protocolo": "000000000000000", // Protocolo do Lote RPS
  "info_nfse": [
    {
      "uuid": "00000000-0000-0000-0000-000000000000", // UUID da NFS-e 
      "modelo": "nfse", // Modelo da NFS-e
      "status": "aprovado", // Status da NFS-e
      "motivo": "Autorizado o uso da NFS-e", // Motivo da NFS-e
      "numero": "00", // Número da NFS-e
      "codigo_verificacao": "000000000", // Código de verificação da NFS-e
      "xml": "https://api.webmania.com.br/xmlnfse/[uuid]", // XML da NFS-e
      "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]", // PDF da prefeitura da NFS-e (quando disponível)
      "pdf_nfse_status": "processado", // Status do PDF da prefeitura da NFS-e (quando disponível)
      "pdf_rps": "https://api.webmania.com.br/darps/[uuid]", // PDF do RPS da NFS-e
    }
  ],
  "log": "{...}" // Log de retorno da prefeitura
}

No momento que realizado a emissão da Nota Fiscal de Serviço (NFS-e), caso tenha informado o parâmetro url_notificacao, será enviado o retorno no formato POST para a URL especificada com o retorno no modelo lote_rps. Saiba mais

Informações da Nota Fiscal
Retorno NFS-e

Segue abaixo exemplo do retorno da NFS-e contendo os campos uuid, modelo, status, motivo, numero, codigo_verificacao, serie_rps, numero_rps, xml, pdf_nfse, pdf_nfse_status, pdf_rps e log.

Segue exemplo do retorno no formato JSON:

{
  "uuid": "00000000-0000-0000-0000-000000000000", // UUID da NFS-e 
  "modelo": "nfse", // Modelo da NFS-e
  "status": "aprovado", // processando, aprovado, agendado, reprovado, cancelado, contingencia
  "motivo": "Autorizado o uso da NFS-e", // Motivo da NFS-e
  "numero": "00", // Número da NFS-e
  "codigo_verificacao": "000000000", // Código de verificação da NFS-e
  "serie_rps": "A0", // Série do Lote RPS da NFS-e
  "numero_rps": 00, // Número do Lote RPS da NFS-e
  "xml": "https://api.webmania.com.br/xmlnfse/[uuid]", // XML da NFS-e
  "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]", // PDF da prefeitura da NFS-e (quando disponível)
  "pdf_nfse_status": "processado", // Status do PDF da prefeitura da NFS-e (quando disponível)
  "pdf_rps": "https://api.webmania.com.br/darps/[uuid]", // PDF do RPS da NFS-e
  "log": "{...}" // Log de retorno da prefeitura
}

No momento que realizado a emissão da Nota Fiscal de Serviço (NFS-e), caso tenha informado o parâmetro url_notificacao, será enviado o retorno no formato POST para a URL especificada com o retorno no modelo nfse. Saiba mais

Emissão de Nota Fiscal
Informações do RPS

O RPS (Recibo Provisório de Serviço) contém todas as informações de uma prestação de serviços montados dentro da array rps, conforme mostrado na tabela Informações da Nota Fiscal.

Segue abaixo exemplo de como informar o RPS para emissão em massa:

{
  ...
  "rps": [
    {
      "servico": {
        "valor_servicos": "15.00",
        "discriminacao": "Prestação de Serviço referente ao mês X",
        "classe_imposto": "REF000000"
      },
      "tomador": {
        "cpf": "000.000.000-00",
        "nome_completo": "Nome do tomador"
      }
    },
    {
      "servico": {
        "valor_servicos": "25.00",
        "discriminacao": "Prestação de Serviço referente ao mês Y",
        "classe_imposto": "REF000000"
      },
      "tomador": {
        "cpf": "000.000.000-00",
        "nome_completo": "Nome do tomador"
      }
    }
  ]
}

Emissão de Nota Fiscal > Informações do RPS
Serviço

As informações do serviço são montados dentro do objeto servico, conforme mostrado na tabela Informações do RPS.

Segue abaixo exemplo para informar os serviços sem classe de imposto:

Emissão de Nota Fiscal > RPS > Serviço
Impostos

As informações dos impostos são montados dentro do objeto impostos, conforme mostrado na tabela serviço.

Aproveite o cálculo automático de impostos, ao utilizar a classe de imposto configurado no Painel Webmania®. Nesse caso, deverá ser informado somente o parâmetro classe_imposto com a referência (REF) da classe de imposto configurada.

Emissão de Nota Fiscal > RPS > Serviço > Impostos
IBS/CBS

Para incluir os novos impostos em suas notas fiscais, adicione o array ibs_cbs dentro do campo impostos nas informações do serviço de cada RPS.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de como preencher as informações de tributação do IBS e CBS:

{
  "rps": [
    {
      ...
      "tomador": {...},
      "servico": {
        "valor_servicos": "15.00",
        "discriminacao": "Prestação de Serviço referente ao mês X",
        ...
        "impostos": {
          "iss": "2.00",
          "ibs_cbs": {
            "situacao_tributaria": "000",
            "classificacao_tributaria": "000001",
            "ibs_estadual": {...},
            "ibs_municipal": {...},
            "cbs": {...}
          }
        }
      }
    }
  ]
}

Emissão de Nota Fiscal > RPS > Serviço > Impostos
IBS Estadual

Para as informações de tributação estadual do IBS, adicione o array ibs_estadual dentro do campo ibs_cbs.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de preenchimento do IBS Estadual:

"ibs_estadual": {
  "aliquota_diferimento": "5.00", // Percentual do diferimento
  "valor_devolvido": "10.00" // Valor do tributo devolvido
}

Emissão de Nota Fiscal > RPS > Serviço > Impostos
IBS Municipal

Para as informações de tributação municipal do IBS, adicione o array ibs_municipal dentro do campo ibs_cbs.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de preenchimento do IBS Municipal:

"ibs_municipal": {
  "aliquota_diferimento": "50.00", // Percentual do diferimento
  "valor_devolvido": "10.00" // Valor do tributo devolvido
}

Emissão de Nota Fiscal > RPS > Serviço > Impostos
CBS

Para as informações do CBS, adicione o array cbs dentro do campo ibs_cbs.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de preenchimento do CBS:

"cbs": {
  "aliquota_diferimento": "50.00", // Percentual do diferimento
  "valor_devolvido": "10.00" // Valor do tributo devolvido
}

Emissão de Nota Fiscal > RPS > Serviço > Impostos
Crédito Presumido

O crédito presumido permite o aproveitamento de créditos fiscais em situações específicas. Para utilizá-lo, adicione o array credito_presumido dentro do campo ibs_cbs.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de preenchimento do crédito presumido:

"credito_presumido": {
  "classificacao": "5", // Código da classificação
  "aliquota_ibs": "0.10", // Percentual do IBS
  "aliquota_cbs": "0.05" // Percentual do CBS
}

Emissão de Nota Fiscal > RPS > Serviço > Impostos
Transferência de Crédito

Quando houver transferência de créditos do IBS e CBS (situação tributária 800), adicione o array transferencia_credito dentro do campo ibs_cbs:

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Segue exemplo de preenchimento da transferência de crédito:

"transferencia_credito": {
  "valor_ibs": "2.50", // Valor do IBS a transferir
  "valor_cbs": "4.00" // Valor do CBS a transferir
}

Emissão de Nota Fiscal > RPS > Serviço
Intermediário

As informações do intermediário do serviço são montados dentro do objeto intermediario conforme mostrado na tabela Informações do Serviço.

Emissão de Nota Fiscal > RPS > Serviço
Ente Governamental

Preencha o bloco ente_governamental quando a prestação de serviço for destinada à administração pública direta e suas autarquias ou fundações. A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Emissão de Nota Fiscal > RPS > Serviço
Imóvel

O grupo imovel é obrigatório quando cod_indicador_operacao for 020101, 020201 ou 020301 e o serviço não for de construção civil. Nos demais casos, não informe o grupo.

Locação (objeto imovel.locacao) NOVO

Envie os valores com ponto como separador decimal, de preferência como string, sem vírgula ou expoente. Exemplo: 40% de "1000.00" corresponde a valor_servicos "400.00".

Ajustes (itens de imovel.ajustes[] ou unidades[].ajustes[]) NOVO

Unidades (itens de imovel.unidades[]) NOVO

Ao usar unidades[], informe imovel.codigo_municipio e não envie endereço, CIB, inscrição ou ajustes diretamente em imovel.

Exemplo 1 — Endereço nacional com CEP (trecho de servico, continua igual):

{
  "cod_indicador_operacao": "020301",
  "valor_servicos": "150000.00",
  "discriminacao": "Intermediação na venda de imóvel residencial",
  "imovel": {
    "endereco": "Av. Paulista",
    "numero": "1000",
    "complemento": "Apto 101",
    "bairro": "Bela Vista",
    "cep": "01310100"
  }
}

Exemplo 2 — Endereço estruturado (trecho de servico, continua igual):

{
  "imovel": {
    "endereco": {
      "logradouro": "Av. Paulista",
      "numero": "1000",
      "bairro": "Bela Vista",
      "endereco_nacional": {
        "codigo_municipio_ibge": "3550308",
        "cep": "01310100"
      }
    }
  }
}

Exemplo 3 — CIB com município (trecho de servico):

{
  "imovel": {
    "codigo_cib": "AB12CD34",
    "codigo_municipio": "3550308",
    "inscricao_imobiliaria": "001234"
  }
}

Exemplo 4 — Locação de imóvel (serviço 99.03.01, trecho de servico):

{
  "codigo_servico": "990301",
  "codigo_nbs": "110021000",
  "cod_indicador_operacao": "020201",
  "valor_servicos": "400.00",
  "imovel": {
    "endereco": "Rua Otávio Francisco Dias",
    "numero": "100",
    "bairro": "Água Verde",
    "cep": "80620310",
    "locacao": {
      "percentual_copropriedade": "40.00",
      "valor_total_operacao": "1000.00"
    },
    "ajustes": [
      { "tipo": "03", "valor": "150.00" }
    ]
  }
}

Exemplo 5 — Mais de um imóvel na mesma nota (trecho de servico):

{
  "imovel": {
    "codigo_municipio": "4106902",
    "unidades": [
      {
        "endereco": "Rua XV de Novembro",
        "numero": "100",
        "bairro": "Centro",
        "cep": "80020310"
      },
      {
        "codigo_cib": "AB12CD34",
        "inscricao_imobiliaria": "001234"
      }
    ]
  }
}

Para mais detalhes sobre os campos do serviço, consulte a seção Reforma Tributária — Novos Campos.

Emissão de Nota Fiscal > RPS > Serviço
Bens móveis

Na locação de bens móveis (serviço 99.04.01), informe a lista servico.bens_moveis[] junto com servico.impostos.ibs_cbs. A lista é obrigatória nesse serviço e não é aceita nos demais. Informe de 1 a 1.000 bens; os campos abaixo pertencem a cada item:

Exemplo — trecho de servico: mantenha os demais dados obrigatórios da emissão e use a classificação tributária aplicável à operação.

{
  "codigo_servico": "990401",
  "valor_servicos": "100.00",
  "impostos": {
    "ibs_cbs": {
      "situacao_tributaria": "000",
      "classificacao_tributaria": "000001"
    }
  },
  "bens_moveis": [
    {
      "codigo_ncm": "84713012",
      "descricao": "Computador portátil",
      "quantidade": 2
    }
  ]
}

Emissão de Nota Fiscal > RPS > Serviço
Ajuste da base de cálculo

No provedor Padrão Nacional, as deduções/reduções do ISSQN e os reembolsos/repasses passam a ser informados em um único grupo, servico.ajuste_base_calculo. Os grupos deducao_reducao e reembolso_repasse continuam aceitos e são convertidos automaticamente quando houver correspondência direta (veja a tabela de correspondência abaixo). Não informe ajuste_base_calculo junto com deducao_reducao ou reembolso_repasse.

Informe percentual_iss, valor_iss ou documentos.

Informe exatamente um entre dfe_nacional, dfe_outro e doc_outro em cada documento. Junto com percentual_iss ou valor_iss, somente os tipos 101 a 105 e 199 são aceitos nos documentos. Para os serviços 06.01 e 06.02, informe somente os tipos 9 ou 199.

Exemplo — trecho de servico:

{
  "valor_servicos": "1000.00",
  "ajuste_base_calculo": {
    "documentos": [
      {
        "tipo": "2",
        "valor_total": "300.00",
        "valor_aplicado": "300.00",
        "data_emissao": "2026-11-20",
        "data_competencia": "2026-11-20",
        "dfe_nacional": {
          "tipo_chave_dfe": 2,
          "chave_dfe": "41261112345678000195550010000012341000012345"
        }
      }
    ]
  }
}

Emissão de Nota Fiscal > RPS > Serviço
Reembolso/Repasse

O parâmetro reembolso_repasse deve ser enviado nos casos de reembolso, repasse ou ressarcimento que serão considerados na base de cálculo do ISSQN, do IBS e da CBS. A tabela abaixo lista os parâmetros que podem ser enviados dentro do array:

Emissão de Nota Fiscal > RPS > Serviço > Reembolso/Repasse
Documentos

Esta seção apresenta os tipos de documentos que podem ser referenciados para validar a operação de reembolso/repasse.

A tabela abaixo lista os parâmetros que podem ser enviados dentro do array, é obrigatório preencher pelo menos um dos grupos de documentos: dfe_nacional, dfe_outro ou doc_outro.

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
Dedução/Redução

A dedução ou redução na Nota Fiscal de Serviço eletrônica aplica-se exclusivamente para municípios aderentes ao Padrão Nacional. Esta funcionalidade refere-se à subtração de valores da base de cálculo do Imposto Sobre Serviços (ISSQN), diminuindo o valor final do imposto a ser pago pelo prestador de serviço.

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
Tipos de dedução/redução

Para informar a dedução ou redução na Nota Fiscal de Serviço eletrônica, é necessário informar apenas uma das opções abaixo conforme sua necessidade:

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
Documentos de dedução/redução

Documentos de dedução/redução (deducao_reducao.documentos[]): cada item deve conter apenas um identificador de documento e os campos obrigatórios abaixo.

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
Nota fiscal Municipal

Para informar os dados de um NFS-e municipal fora do padrão nacional, preencha os campos abaixo:

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
NF/NFS não eletrônica

Para informar os dados de uma NF ou NFS não eletrônica, preencha os campos abaixo:

Emissão de Nota Fiscal > RPS > Serviço > Dedução/Redução
Fornecedor

Para informar os dados do fornecedor do serviço prestado, preencha os campos abaixo:

Fornecedor (deducao_reducao.documentos[].fornecedor): informe apenas um entre CPF, CNPJ ou identificação estrangeira, e preencha os campos correspondentes abaixo.

Emissão de Nota Fiscal > RPS
Tomador

As informações do tomador do serviço são montados dentro do objeto tomador conforme mostrado na tabela Informações do RPS.

Emissão de Nota Fiscal > RPS > Tomador
Estrangeiro

Para as Notas Fiscais de Serviço onde o tomador reside fora do país, é necessário informar os dados do tomador estrangeiro. As informações são montadas dentro do objeto tomador conforme mostrado na tabela Informações do RPS.
Obs.: O tomador estrangeiro só está disponível para o modelo Abrasf versão 2.04

Emissão de Nota Fiscal > RPS
Destinatário

O grupo destinatario deve ser informado quando servico.indicador_destinatario=1. As informações do destinatário são montadas dentro do objeto destinatario conforme mostrado nas subseções abaixo. O campo nome substitui os campos legados nome_completo e razao_social, e o endereço é informado como objeto aninhado endereco com subgrupos endereco_nacional ou endereco_exterior.

Emissão de Nota Fiscal > RPS
Construção Civil

As informações de construção civil devem ser informadas caso o serviço prestado esteja relacionado à obras de construção civil. As informações são montadas dentro do objeto construcao_civil conforme mostrado na tabela Informações do RPS. Os parâmetros podem variar conforme o padrão adotado pelo provedor que atende o município, abaixo estão listados os parâmetros para o modelo Abrasf, Padrão Nacional, Sigissweb e São Paulo (RTC).

Para o Padrão Nacional é obrigatório informar um dos três parâmetros: inscricao_imobiliaria_fiscal, codigo_obra ou os campos do endereço da obra. Quando um é informado, os outros dois não podem ser informados.

Para o Sigissweb é obrigatório informar os seguintes parâmetros: cno, nome, endereco, cep, numero, bairro.

Emissão de Nota Fiscal > RPS
Atividades em eventos

As informações relativas a atividades em eventos devem ser informadas caso o serviço prestado pertença ao item 12 da lista de serviços, ou seja, o código de serviço seja 12.XX.XX. As informações são montadas dentro do objeto atividades_evento e estão disponíveis para os modelos Padrão Nacional, SigissWeb e São Paulo (RTC). Os parâmetros variam conforme o provedor.

Além dos parâmetros dispostos acima, o Sigissweb também utiliza os seguintes parâmetros:

Emissão de Nota Fiscal
Provedores

Conforme estipulado por cada provedor, campos adicionais podem ser solicitados dentro do objeto servico, conforme mostrado na tabela Informações do RPS. Verifique o provedor do seu município ao consultar o status e verifique os campos adicionais disponíveis e/ou obrigatórios.

Provedor Abrasf

O modelo de XML da Abrasf é o mais utilizado pelos municípios em emissões de Nota Fiscal de Serviço, o modelo está disponível nas versões 1.00, 2.00, 2.01, 2.02, 2.03 e 2.04. Os campos específicos para cada versão desse modelo estão listados na tabela abaixo:

Emissão de Nota Fiscal > RPS > Provedores > Abrasf
Itens

As informações dos itens são montadas dentro do objeto itens conforme mostrado na tabela do provedor Abrasf.

Emissão de Nota Fiscal
Provedor Cecam

Os campos específicos para emissão de Nota Fiscal de Serviço para os municípios atendidos pelo provedor Cecam estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor Conam

Os campos específicos para emissão de Nota Fiscal de Serviço para os municípios atendidos pelo provedor Conam estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor DSF

Os campos específicos para emissão de Nota Fiscal de Serviço nos municípios atendidos pelo provedor DSF estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor Equiplano

Os campos específicos para emissão de Nota Fiscal de Serviço para o provedor Equiplano estão listados nas tabelas abaixo:

Emissão de Nota Fiscal
Provedor Florianópolis

Os campos específicos para emissão de Nota Fiscal de Serviço no município de Florianópolis estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor Governa

Os campos específicos para emissão de Nota Fiscal de Serviço para os municípios atendidos pelo provedor Governa estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor IPM

Os campos específicos para emissão de Nota Fiscal de Serviço para os municípios atendidos pelo provedor IPM estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor Fortaleza

Os campos específicos para emissão de Nota Fiscal de Serviço para o município de Fortaleza, CE estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor Osasco

Os campos específicos para emissão de Nota Fiscal de Serviço para o município de Osasco estão listados na tabela abaixo:

Emissão de Nota Fiscal
Padrão Nacional

Os campos específicos para emissão de Nota Fiscal de Serviço para os municípios conveniados ao Padrão Nacional estão listados na tabela abaixo:

Comércio Exterior

Para municípios no modelo padrao_nacional, os campos abaixo podem ser enviados em servico quando a operação envolver comércio exterior.

Exemplo de envio de comércio exterior (servico):

{
  "modo_prestacao": 1,
  "vinculo_prestacao": 2,
  "tipo_moeda": "840",
  "valor_servico_moeda": "1250.00",
  "mecanismo_apoio_comex_prestador": "01",
  "mecanismo_apoio_comex_tomador": "10",
  "movimento_temporario_bens": 0,
  "numero_di": "123456789012",
  "numero_re": "RE202600001",
  "mdic": 1
}

Emissão de Nota Fiscal
Provedor São Paulo

Os campos específicos para emissão de Nota Fiscal de Serviço para o município de São Paulo estão listados na tabela abaixo:

Emissão de Nota Fiscal
Provedor SIGISS

Os campos específicos para emissão de Nota Fiscal de Serviço para o provedor SIGISS estão listados na tabela abaixo:

Provedor Sigissweb

Os campos específicos para emissão de Nota Fiscal de Serviço para o provedor Sigissweb estão listados na tabela abaixo:

Além dos parâmetros de intermediário na emissão pode-se também informar os seguintes parâmetros:

Provedor Thema

Os campos específicos para emissão de Nota Fiscal de Serviço para o provedor Thema estão listados na tabela abaixo:

Reforma Tributária

🧭 Guia rápido (ISS x IBS/CBS)

Na prática, a adaptação da integração varia principalmente pelo provedor do seu município (campo modelo no endpoint /2/nfse/status).

Exemplo - Padrão Nacional (não enviar impostos.iss):

{
  "ambiente": 1,
  "rps": [
    {
      "servico": {
        "valor_servicos": "15.00",
        "discriminacao": "Prestação de Serviço referente ao mês X",
        "finalidade": 0,
        "tributacao_iss": 1,
        "consumidor_final": 1,
        "cod_indicador_operacao": "100501",
        "codigo_servico": "01.05.01",
        "codigo_nbs": "115021000",
        "natureza_operacao": 1,
        "iss_retido": 2,
        "impostos": {
          "cst_pis_cofins": "00",
          "ibs_cbs": {
            "situacao_tributaria": "000",
            "classificacao_tributaria": "000001"
          }
        }
      },
      "tomador": {...}
    }
  ]
}

Exemplo - Provedor municipal (ex.: IPM) (enviar impostos.iss):

{
  "ambiente": 1,
  "rps": [
    {
      "servico": {
        "valor_servicos": "15.00",
        "discriminacao": "Prestação de Serviço referente ao mês X",
        "codigo_servico": "01.05",
        "natureza_operacao": 1,
        "iss_retido": 2,
        "impostos": {
          "iss": "5.00"
        }
      },
      "tomador": {...}
    }
  ]
}

📅 Quando começa?

Reforma Tributária
Novos Campos da Reforma Tributária

Com a chegada da Reforma Tributária, novos campos foram adicionados ao layout de emissão de NFS-e. Os novos campos estão listados na tabela abaixo:

Reforma Tributária
Mudanças na NFS-e Padrão Nacional

A partir de 01/12/2026, as emissões do provedor Padrão Nacional passam a seguir novas regras. A homologação já está disponível para você testar a sua integração antes dessa data. As mudanças valem somente para o provedor Padrão Nacional; os demais provedores municipais não são afetados. Para saber o provedor do seu município, consulte o campo modelo do endpoint /2/nfse/status e a seção Provedores › Padrão Nacional.

Resumo e calendário

Até 01/12/2026, em produção, os campos novos (imovel.locacao, imovel.unidades[], servico.bens_moveis[] e servico.ajuste_base_calculo) e os novos códigos de serviço são recusados pela API. Use-os somente em homologação até essa data.

O que muda na sua integração

Exemplo — imóvel identificado só pelo CIB: hoje

{
  "imovel": {
    "codigo_cib": "12345678"
  }
}

A partir de 01/12/2026, informe também o município do imóvel:

{
  "imovel": {
    "codigo_cib": "12345678",
    "codigo_municipio": "3550308"
  }
}

Exemplo — imóvel identificado só pela inscrição imobiliária: hoje

{
  "imovel": {
    "inscricao_imobiliaria": "001234"
  }
}

A partir de 01/12/2026, acrescente o endereço nacional (ou o CIB com o município):

{
  "imovel": {
    "inscricao_imobiliaria": "001234",
    "endereco": "Av. Paulista",
    "numero": "1000",
    "bairro": "Bela Vista",
    "cep": "01310100"
  }
}

Novos códigos de serviço

Disponíveis em homologação e, a partir de 01/12/2026, em produção.

O código 99.05.01 (operações condominiais) ainda não está disponível.

Novos códigos de indicador da operação

Novos valores aceitos em cod_indicador_operacao, disponíveis em homologação e, a partir de 01/12/2026, em produção. Os códigos atuais continuam válidos.

Para as situações tributárias (situacao_tributaria) 400, 410, 620, 800, 810, 811 e 820, não informe cod_indicador_operacao, credito_presumido, situacao_tributaria_regular, classificacao_tributaria_regular nem aliquota_diferimento: a partir de 01/12/2026, esses campos são recusados nessas situações.

Próximas mudanças (prévia) PRÉVIA

Até 01/12/2026, em produção, o grupo ajuste_base_calculo inteiro é recusado.

O regime de apuração será obrigatório para o prestador optante pelo Simples Nacional (ME/EPP) e não aceito para o MEI e para quem não é optante.

curl -X GET \
-H "Authorization: Bearer SEU_ACCESS_TOKEN" \
https://api.webmania.com.br/nfse/00000000-0000-0000-0000-000000000000

https://api.webmania.com.br/nfse/00000000-0000-0000-0000-000000000000?token=[TOKEN]

Funções
Consultar Nota Fiscal

Para consultar o status de emissão da Nota Fiscal de Serviço, envie a requisição no método GET para URL /2/nfse/consulta contendo na URL o uuid ou o ID (Número do pedido ou ID de processamento) da Nota Fiscal.

Segue abaixo exemplo da consulta de uma Nota Fiscal:

curl -X GET \
-H "Authorization: Bearer SEU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
https://api.webmania.com.br/2/nfse/consulta/43eace5c-8008-4f6c-b830-b6d52d7ff90c

A resposta do corpo da mensagem será no formato objeto JSON, contendo os campos uuid, status, motivo, numero, codigo_verificacao, serie_rps, numero_rps, pdf_rps, pdf_nfse, pdf_nfse_status, xml e log:

{
  "uuid": "43eace5c-8008-4f6c-b830-b6d52d7ff90c", // Número único de identificação
  "modelo": "nfse", // Modelo da Nota Fiscal (nfse, lote_rps)
  "status": "aprovado", // aprovado, reprovado, cancelado, processamento ou contingencia
  "motivo": "Autorizado o uso da NFS-e", // Motivo do status
  "numero": "25000", // Número da NF-e
  "codigo_verificacao": "SFH-046", // Número de série
  "serie_rps": "A1", // Série do RPS
  "numero_rps": "2000", // Número do RPS
  "pdf_rps": "https://api.webmania.com.br/darps/[uuid]",
  "pdf_nfse": "https://api.webmania.com.br/nfse/[uuid]", // PDF da prefeitura da NFS-e (quando disponível)
  "pdf_nfse_status": "processado",  // processado, processando, indisponivel (quando disponível)
  "xml": "https://api.webmania.com.br/xmlnfse/[uuid]",
  "log": "{...}", // Log de retorno da prefeitura
  "atualizado_em": "2024-01-01T12:00:00-03:00" // Momento em que ocorreu a última alteração do status
}

Funções
Cancelar Nota Fiscal | Agendamento