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

Saiba como emitir NFS-e em Arujá (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: Smarapd

Padrão: Próprio

Autenticação: Certificado digitalLogin e Senha

Cancelamento: Não permite por webservicesApenas via portal / requisição na prefeitura

Ambientes Disponíveis

Ambiente Disponível Portal de Acesso
ProduçãoSimAcessar
HomologaçãoNãoNão possui

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorOpcional
Endereço do TomadorOpcional
Item Lista ServiçoObrigatórioUtiliza um padrão próprio.
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado
natureza_operacaoObrigatório
    Aceita os seguintes valores:
    511 - ISSQN DEVIDO NA SERRA, SEM RETENÇÃO, RECOLHIDO PELO PRESTADOR;
    200 - IMUNIDADE 300 - ISENÇÃO 400 - NÃO INCIDÊNCIA DE ISSQN;
    512 - ISSQN DEVIDO NA SERRA, COM RETENÇÃO, RECOLHIDO PELO TOMADOR;
    615 - ISSQN DEVIDO EM OUTRO MUNICÍPIO, SEM RETENÇÃO, RECOLHIDO PELO PRESTADOR;
    616 - ISSQN DEVIDO EM OUTRO MUNICÍPIO, COM RETENÇÃO, RECOLHIDO PELO TOMADOR;
    911 - ISSQN DEVIDO NA SERRA, SEM RETENÇÃO, RECOLHIDO PELO PRESTADOR - ORGÃO PÚBLICO;
    912 - ISSQN DEVIDO NA SERRA, COM RETENÇÃO, RECOLHIDO PELO TOMADOR - ORGÃO PÚBLICO

Campos Exclusivos

CampoObrigatoriedadeObservação
quantidadeOpcionalSe omitido consideramos 1
valor_unitarioOpcionalSe omitido consideramos o mesmo valor que o campo valor_servicos

Outras Informações

  • É possível informar mais de um serviço por nota, basta trocar a chave "servico" por "servicos" e informar um array de servicos.
  • Não existe o campo "Unidade" na emissão por webservices, por isso ele sempre ficará em branco.
  • Ao enviar a sua nota para o ambiente de homologação de nossa API, ela automaticamente irá trocar o prestador da nota para uma empresa de testes e irá emitir a nota no ambiente normal da prefeitura.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": "1",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3503901
  },
  "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": {
    "valor_servicos": 2,
    "iss_retido": false,
    "item_lista_servico": "14.01",
    "aliquota": 5.0,
    "discriminacao": "Detalhe do serviço"
  }
}