latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

a32e528fc383

NFSe

Emitir

Quando uma NFS-e é enviada para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do prestador em nossa base, a nota não será aceita e você receberá uma mensagem de erro de forma síncrona.

Caso a nota seja aceita para processamento, ela será enviada para uma fila e será processada de forma assíncrona. Com isto, a nota poderá ser autorizada ou retornar um erro, de acordo com a validação da prefeitura.

Para verificar se a nota já foi autorizada, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

⚠ Reforma Tributária

Abaixo, campos novos da API de NFSe são denotados com (RT) e destacados em itálico. Durante a transição, alguns municípios podem não aceitar ou não interpretar estes campos.
Muitos municípios estão migrando para o novo padrão da <a href="/reference/emitir_dps_nacional">API de NFSe Nacional</a>, verifique em nosso <a href="https://focusnfe.com.br/guides/reforma-tributaria/">Guia da Reforma Tributária</a>.

⚠ ATENÇÃO Alguns municípios podem ter campos adicionais ou regras específicas para preenchimento de campos. Estas exceções tem se mostrado frequentes em função da Reforma Tributária. Consulte nossa lista de Municípios Integrados para orientações sobre especificidades de seu município.

Abaixo você poderá verificar uma listagem dos principais campos disponíveis.

post/nfse

Query parameters

refstring required

Example:123456

Referência da NFSe

Request body

data_emissaostring date-time required

Data/hora de emissão da NFSe. Alguns municípios não utilizam hora e ela será descartada caso seja fornecida. Formato padrão ISO 8601.

natureza_operacao'1' | '2' | '3' | '4' | '5' | '6' required

Natureza da operação. Informar um dos códigos abaixo. Valor padrão: 1. Campo ignorado em alguns municípios. 1: Tributação no município 2: Tributação fora do município 3: Isenção 4: Imune 5: Exigibilidade suspensa por decisão judicial 6: Exigibilidade suspensa por procedimento administrativo

regime_especial_tributacao'1' | '2' | '3' | '4' | '5' | '6'

Código do regime especial de tributação. Campo ignorado em alguns municípios 1: Microempresa municipal 2: Estimativa 3: Sociedade de profissionais 4: Cooperativa 5: MEI - Simples Nacional 6: ME EPP- Simples Nacional

optante_simples_nacionalboolean required

Informar true (verdadeiro) ou false (falso) se a empresa for optante pelo Simples Nacional. Campo ignorado em alguns municípios.

incentivador_culturalboolean

Informe true (verdadeiro) ou false (falso). Valor padrão: false. Campo ignorado em alguns municípios.

codigo_obrastring

Código da obra quando construção civil. Tamanho máximo: 15 caracteres.

artstring

Código ART quando construção civil. Este campo é ignorado em alguns municípios.

numero_nfse_substituidostring

Caso o município permita substituição de notas, aqui você poderá informar o número da NFSe a ser substituída.

numero_rps_substituidostring

Caso o município permita substituição de notas, aqui você poderá informar o número do RPS a ser substituído.

serie_rps_substituidostring

Obrigatório se informado o campo numero_rps_substituido. Indica a série do RPS a ser substituído.

tipo_rps_substituidostring

Obrigatório se informado o campo numero_rps_substituido. Indica o tipo do RPS a ser substituído. Caso desconheça este valor, utilize "1".

Example request

{
  "data_emissao": "2016-12-25T12:00:00-03:00",
  "natureza_operacao": "1",
  "regime_especial_tributacao": "5",
  "optante_simples_nacional": true,
  "prestador": {
    "cnpj": "12345678000123",
    "inscricao_municipal": "123456",
    "codigo_municipio": "1234567"
  },
  "tomador": {
    "cpf": "12345678909",
    "cnpj": "12345678000123",
    "nif": "123456789",
    "motivo_ausencia_nif": "0",
    "inscricao_municipal": "123456",
    "razao_social": "Empresa Exemplo LTDA",
    "telefone": "11999998888",
    "email": "tomador@example.com",
    "endereco": {
      "logradouro": "Rua das Flores",
      "tipo_logradouro": "Rua",
      "numero": "123A",
      "complemento": "Apto 45, Bloco B",
      "bairro": "Centro",
      "codigo_municipio": "3550308",
      "uf": "SP",
      "cep": "01311000"
    }
  },
  "servico": {
    "valor_servicos": 1500,
    "valor_pis": 10.5,
    "valor_cofins": 5.75,
    "valor_inss": 20,
    "valor_ir": 18,
    "valor_csll": 12,
    "valor_iss": 45,
    "base_calculo": 1500,
    "aliquota": 0.05,
    "item_lista_servico": "17.09",
    "codigo_cnae": "6201501",
    "codigo_tributario_municipio": "123456",
    "discriminacao": "Serviços de desenvolvimento de sistemas sob demanda",
    "codigo_municipio": "3550308",
    "percentual_total_tributos": 0.34,
    "fonte_total_tributos": "IBPT",
    "codigo_nbs": "1.0101.11.00",
    "codigo_indicador_operacao": "020101",
    "ibs_cbs_classificacao_tributaria": "400001",
    "ibs_cbs_situacao_tributaria": "400",
    "ibs_cbs_base_calculo": 1500,
    "ibs_uf_aliquota": 0.0167,
    "ibs_mun_aliquota": 0.0833,
    "cbs_aliquota": 0.9
  },
  "intermediario": {
    "cpf": "12345678909",
    "cnpj": "12345678000123",
    "nif": "123456789",
    "motivo_ausencia_nif": "0",
    "inscricao_municipal": "123456",
    "razao_social": "Empresa Exemplo LTDA"
  },
  "codigo_obra": "123456789012345",
  "art": "ART2023000123",
  "numero_nfse_substituido": "678",
  "numero_rps_substituido": "12345",
  "serie_rps_substituido": "A1",
  "tipo_rps_substituido": "1"
}

Response

Recurso criado com sucesso

statusstring

Status do processamento.

refstring

Referência do DPS.

protocolostring

Protocolo de recebimento do DPS.

Example response

{
  "status": "processando_autorizacao"
}