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

Saiba como emitir NFS-e em Itupeva (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

Siappa

Formato

Próprio

Autenticação

Utiliza uma senha gerada pelo provedor na liberação do webservice

Cancelamento

Ativo

Ambientes Disponíveis

Ambiente

Disponível

Portal de Acesso

Produção

Sim

Acessar

Homologação

Sim

Não disponível

Campos Importantes

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

Outras Informações

No campo de login_reponsável é necessário informar o número de inscrição disponível na interface da prefeitura
O município disponibiliza um XML de "pré-notas" com informações necessárias no envio da nota que é gerado na interface da prefeitura com a liberação de X notas. Assim, quando atingir a esse número X que foi liberado será necessário gerar outro XML de lote de pré-notas na interface da prefeitura (como se fosse um pedido de liberação de RPS como é feito em vários provedores). Esse arquivo deverá ser gerado e sempre encaminhado para nosso suporte realizar a importação em nossa API. A sua geração é realizada acessando o portal da prefeitura > menu Webservice e clicar em Bloco de Pré Notas, após clicar em 'Novo Bloco de Pre Notas' e após finalizar a geração, e por fim clicar na setinha apontada pra baixo e em seguida em 'Exportar como XML'

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3524006
  },
  "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": 3524006,
      "uf": "SP",
      "cep": "13295000"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice",
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "4.12",
    "iss_retido": false
  }
}