Oten Tecnologia
Oten Fiscal
Documentação

NFS-e

São Paulo — regras da NFS-e

São Paulo usa o código IBGE 3550308. A tag TributacaoRPS não é enviada no JSON: a API calcula o valor a partir de `naturezaTributacao`, `iss.tipoTributacao` e `codigoCidadeIncidencia`.

Identificação do município

Código IBGE

3550308

Município

São Paulo / SP

Como a TributacaoRPS é definida

Use a combinação abaixo. Qualquer caso diferente pode exigir ajuste de tributação com o time fiscal.

T

Tributado em São Paulo

naturezaTributacao ≠ 4 · iss.tipoTributacao = 6

F

Tributado fora de São Paulo

naturezaTributacao ≠ 4 · iss.tipoTributacao = 7

A

Tributado em São Paulo, porém isento

naturezaTributacao ≠ 4 · iss.tipoTributacao = 1

B

Tributado fora de São Paulo, porém isento

codigoCidadeIncidencia ≠ 3550308 · iss.tipoTributacao = 1

Exemplo de payload para São Paulo

Serviço tributado no município (equivalente a TributacaoRPS = T). Ajuste alíquota, código de serviço e tomador aos dados reais.

POST /nfse · São Paulo
[
  {
    "idIntegracao": "SP-2026-0001",
    "prestador": {
      "cpfCnpj": "00000000000000"
    },
    "tomador": {
      "cpfCnpj": "11111111000191",
      "razaoSocial": "Cliente Exemplo LTDA",
      "inscricaoMunicipal": "12345678",
      "email": "financeiro@cliente.com",
      "endereco": {
        "tipoLogradouro": "Avenida",
        "logradouro": "Paulista",
        "numero": "1000",
        "complemento": "Conjunto 101",
        "bairro": "Bela Vista",
        "tipoBairro": "Bairro",
        "codigoCidade": "3550308",
        "descricaoCidade": "Sao Paulo",
        "estado": "SP",
        "cep": "01310100"
      }
    },
    "cidadePrestacao": {
      "codigo": "3550308",
      "descricao": "Sao Paulo"
    },
    "servico": [
      {
        "codigo": "1.05",
        "codigoTributacao": "1.05",
        "discriminacao": "Licenca de uso de software e suporte tecnico mensal.",
        "cnae": "6203100",
        "codigoCidadeIncidencia": "3550308",
        "descricaoCidadeIncidencia": "SAO PAULO",
        "iss": {
          "tipoTributacao": 6,
          "exigibilidade": 1,
          "retido": false,
          "aliquota": 2.9
        },
        "valor": {
          "servico": 1500,
          "descontoCondicionado": 0,
          "descontoIncondicionado": 0
        }
      }
    ]
  }
]

Cuidados em São Paulo

  • Informe o endereço completo do tomador, inclusive CEP e bairro.
  • O código de serviço deve ser o item da lista aceito pela Prefeitura.
  • Alíquota de ISS precisa ser compatível com o serviço e o regime do prestador.
  • Para tomador estrangeiro, alguns provedores aceitam o documento no campo `cpfCnpj`.