Guia técnico de emissão de NFS-e em Taboão da Serra/SP pela API da Focus NFe

Saiba como emitir NFS-e em Taboão da Serra (SP) pela API da Focus NFe. Este guia é voltado para clientes e para quem está testando a nossa API. Aqui, você encontra os campos obrigatórios, exemplos e observações específicas para desenvolvedores.

Informações Gerais

Provedor: Etransparencia

Padrão: Próprio

Autenticação: Token

O token deve ser gerado no portal da prefeitura conforme orientado em Outras Informações e inserido no campo senha do cadastro do cliente na API, aba Documentos Fiscais

Cancelamento: Ativo

Ambientes Disponíveis

Ambiente	Disponível	Portal de Acesso
Produção	Sim	Acessar
Homologação	Sim	Acessar

Campos Importantes

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Obrigatório
Endereço do Tomador	Obrigatório
Item Lista Serviço	Obrigatório	Utiliza o padrão nacional da Lei Complementar 116/2003
Código CNAE	Não utilizado
Código Tributário Município	Não utilizado

Outras Informações

Obrigatório informar os campos valor_iss e aliquota.
Processo para liberação do ambiente de homologação e produção:
- Faça o cadastro do usuário e da empresa no site da prefeitura ou solicite liberação por e-mail: vre.atende@taboaodaserra.sp.gov.br
A autenticação do webservice é feita usando dois tokens (códigos):
- O código do Usuário cadastrado e código do Contribuinte (empresa).
- Para o Login: Sistema > Segurança > Editar Perfil > Código do usuário para login em Webservices
- Para a senha: Contribuintes > Cadastro de Contribuintes > Consultar > Código (abaixo de Razão Social)
- Para consultar os códigos no cadastro do cliente na prefeitura (são diferentes do login e senha de acesso ao portal)
Esse município tem uma particularidade, ao informar o campo "codigo_municipio" dentro do "servico" é necessário adicionar o restante dos dados do endereço, um exemplo é demonstrado na próxima seção em "JSON com código código do município"

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "regime_especial_tributacao": 1,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3552809
  },
  "tomador": {
    "cnpj": "11.111.111/0001-11",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": 4106902,
      "uf": "PR",
      "cep": "82900-010"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice \n Quebra de linha 1 | Quebra de linha 2",
    "valor_servicos": 1,
    "aliquota": 3,
    "item_lista_servico": "4.03",
    "valor_iss": 0.03,
    "iss_retido": false
  }
}

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "regime_especial_tributacao": 1,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3552809
  },
  "tomador": {
    "cnpj": "11.111.111/0001-11",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": 4106902,
      "uf": "PR",
      "cep": "82900-010"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice \n Quebra de linha 1 | Quebra de linha 2",
    "valor_servicos": 1,
    "aliquota": 3,
    "item_lista_servico": "4.03",
    "valor_iss": 0.03,
    "iss_retido": false,
    "codigo_municipio": 3552809,
    "endereco": {
      "logradouro": "Rua Teste",
      "numero": "1234",
      "bairro": "Centro",
      "cep": "1234567"
    }
  }
}