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

Saiba como emitir NFS-e em Osasco (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
e-Governe
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
Homologação
Sim
Não disponível

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do Tomador
Endereço do Tomador
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

Campos Exclusivos

Código Classif. Trib. do IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria
ObrigatórioReforma
Código NBS correspondente ao serviço prestado
$.servico.codigo_nbs
ObrigatórioReforma
Localidade de incidência
$.servico.codigo_localidade_incidencia
ObrigatórioReforma
  • 1 Domicílio principal do adquirente
  • 2 local da entrega ou disponibilização
  • 3 local da prestação
  • 4 local do evento
  • 5 local do imóvel
  • 6 local evento
  • 7 Local incidência IBS
  • 8 via explorada
Cód. da operação de fornecimento
$.servico.codigo_indicador_operacao
ObrigatórioReforma

Outras Informações

  • É possível emitir notas de teste (homologação) porém neste ambiente não é gerado link para visualização da nota. A homologação funciona como uma "simulação" dentro do ambiente de produção. Porém emissão e cancelamento funcionam como esperados. As notas emitidas neste ambiente ficam disponíveis por apenas 7 dias, após este prazo elas são excluídas.
  • Este município utiliza uma chave secreta, gerada no site da prefeitura, que deverá ser enviada para nós para autenticação da empresa. Esta chave pode ser gerada da seguinte forma no site da prefeitura:
    • No menu Notas Fiscais clique em Web Service – Gerar Chave Autenticação.
    • Clique em “Gerar Chave”.

JSONs de Exemplo

{
  "data_emissao": "2025-11-19T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4211751
  },
  "tomador": {
    "cnpj": "85.904.290/0001-50",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": 3534401,
      "uf": "SP",
      "cep": "06020902"
    },
    "telefone": "41 3256-8060",
    "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.0,
    "aliquota": 2.0,
    "item_lista_servico": "17.08",
    "valor_iss": 0.02,
    "codigo_nbs": "1.1110.00.00",
    "iss_retido": false
  },
  "ibs_cbs_situacao_tributaria": "000001",
  "codigo_indicador_operacao": "100301",
  "codigo_localidade_incidencia": "1"
}