Guia técnico de emissão de NFS-e em São José do Rio Pardo/SP pela API da Focus NFe

Saiba como emitir NFS-e em São José do Rio Pardo (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
GovDigital
Padrão
ABRASF 2.01
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza 6 dígitos numéricos (2 para Item, 2 para Subitem e 2 para Desdobro Nacional, conforme Código de Tributação Nacional)
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

Campos Exclusivos

CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins /CST
Reforma
Código de Situação Tributária do PIS/COFINS (00-09)
Tipo Retenção PIS/COFINS
$.servico.tipo_retencao_pis_cofins /TpRetPisCofins
Reforma
Tipo de retenção do PIS/COFINS: 1-Retido, 2-Não Retido
Município de Prestação
$.servico.codigo_municipio_prestacao /MunicipioPrestacao
Reforma
Código do município de prestação (IBGE)
País de Prestação
$.servico.codigo_pais_prestacao /PaisPrestacao
Reforma
Código do país de prestação (BACEN)
Código NBS
$.servico.codigo_nbs /CodigoNBS
Reforma
Código NBS (Nomenclatura Brasileira de Serviços) - 9 dígitos
Código Indicador Operação
$.servico.codigo_indicador_operacao /CIndOp
Reforma
Código indicador da operação de fornecimento - 6 dígitos
Classificação Tributária Regular IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular /CClassTribReg
Reforma
Código da Classificação Tributária do IBS e da CBS de tributação regular - 6 dígitos
Imóvel
$.imovel /Imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis (quando CIndOp for 020101, 020201 ou 020301)
CCIB
$.imovel.codigo_cib /CCIB
Reforma
Código do Cadastro Imobiliário Brasileiro (8 chars) - disponível a partir de 2026
Endereço do Imóvel
$.imovel.endereco /Endereco
Reforma
Grupo de informações do endereço do imóvel (usar quando não tiver CCIB)
CEP no Exterior
$.imovel.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.imovel.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.imovel.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
NIF
$.tomador.nif /NIF
Reforma
Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior (1-40 chars)
Motivo Ausência NIF
$.tomador.motivo_ausencia_nif /CodNaoNIF
Reforma
Motivo para não informação do NIF: 0-Não informado na nota de origem, 1-Dispensado do NIF, 2-Não exigência do NIF
CEP no Exterior
$.tomador.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.tomador.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.tomador.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
Obra
$.obra /ConstrucaoCivil
Reforma
Grupo de informações da construção civil
Código Obra
$.obra.codigo /CodigoObra
Reforma
Identificador da obra (1-15 chars). No Focus NFe mapeia para obra.codigo
ART
$.obra.art /Art
Reforma
Anotação de Responsabilidade Técnica (1-15 chars)
Inscrição Imobiliária Fiscal
$.obra.inscricao_imobiliaria /InscImobFisc
Reforma
Inscrição imobiliária fiscal (1-30 chars)
ID Obra
$.obra.id_obra /IdObra
Reforma
Identificador da obra (1-15 chars)
CCIB
$.obra.codigo_cib /CCIB
Reforma
Código do Cadastro Imobiliário Brasileiro (8 chars) - disponível a partir de 2026
Endereço da Obra
$.obra.endereco /Endereco
Reforma
Grupo de informações do endereço da obra
CEP no Exterior
$.obra.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.obra.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.obra.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
Modo de Prestação
$.modo_prestacao /MdPrestacao
Reforma
Modo de Prestação: 0-Desconhecido, 1-Transfronteiriço, 2-Consumo no Brasil, 3-Presença Comercial no Exterior, 4-Movimento Temporário de Pessoas Físicas
Vínculo entre as Partes
$.vinculo_negocio /VincPrest
Reforma
Vínculo entre as partes no negócio: 1-Controlada, 2-Controladora, 3-Coligada, 4-Matriz, 5-Filial ou sucursal, 6-Outro vínculo
Código da Moeda
$.codigo_moeda /TpMoeda
Reforma
Código que identifica a moeda conforme tabela do BACEN (3 dígitos)
Valor do Serviço em Moeda Estrangeira
$.valor_servico_ext /VServMoeda
Reforma
Valor do serviço prestado expresso em moeda estrangeira
Mecanismo ComEx Prestador
$.mecanismo_comercio_ext_prestador /MecAFComexP
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador (00-08)
Mecanismo ComEx Tomador
$.mecanismo_comercio_ext_tomador /MecAFComexT
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador (00-26)
Movimentação Temporária de Bens
$.movimentacao_temporaria_bens /MovTempBens
Reforma
Operação vinculada à Movimentação Temporária de Bens: 0-Desconhecido, 1-Não, 2-Vinculada Declaração de Importação, 3-Vinculada Declaração de Exportação
MDIC
$.mdic /Mdic
Reforma
Compartilhar as informações com a Secretaria de Comércio Exterior: 0-Não enviar, 1-Enviar
Atividade de Evento
$.evento /AtvEvento
Reforma
Grupo de informações do DPS relativas a Evento (obrigatório para atividades do grupo 12.XX.XX)
Nome do Evento
$.evento.nome /Nome
Reforma
Nome/Identificação do evento (1-255 chars)
Data de Início
$.evento.data_inicio /DataInicio
Reforma
Data de início do evento (AAAA-MM-DD)
Data de Fim
$.evento.data_fim /DataFim
Reforma
Data de fim do evento (AAAA-MM-DD)
ID Atividade de Evento
$.evento.id_atividade_evento /IdAtvEv
Reforma
Identificação da Atividade de Evento (código identificador de evento determinado pela Administração Tributária Municipal, 1-30 chars)
Endereço do Evento
$.evento.endereco /Endereco
Reforma
Grupo de informações do endereço do evento
CEP no Exterior
$.evento.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.evento.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.evento.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)

Outras Informações

  • Este provedor requer liberação de ambientes para emissão:
  • Logado no portal da prefeitura > Solicitações: Autorização de Emissão de NFe

JSONs de Exemplo

{
  "data_emissao": "2025-01-12T09:00:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3549706
  },
  "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": 3549706,
      "uf": "SP",
      "cep": "13727-266"
    },
    "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.0,
    "item_lista_servico": "040303",
    "codigo_nbs": "123011100",
    "codigo_indicador_operacao": "030101",
    "ibs_cbs_classificacao_tributaria": "200029",
    "iss_retido": false
  }
}