Voltar

Guia técnico de emissão de NFS-e em Campina Grande/PB pela API da Focus NFe

Saiba como emitir NFS-e em Campina Grande (PB) 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
WebISS
Formato
Próprio (ABRASF)
Autenticação
Certificado digital
Cancelamento
Não permite por webservices Apenas via portal / requisição na prefeitura

Ambientes Disponíveis

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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAEObrigatório
Código Tributário MunicípioObrigatórioUtiliza o valor do campo item_lista_servico.

Campos do Provedor

Chaves de acesso da NFS-e referenciada
$.chaves_nfse_referenciadas /gRefNFSe
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /refNFSe
Reforma
Indicador de consumidor final
$.consumidor_final /indFinal
ObrigatórioReforma
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Destinatário
$.destinatario /dest
Reforma
Grupo de informações do destinatário. O destinatário só deve ser informado quando [indicador_destinatario = 1]
CNPJ
$.destinatario.cnpj /CNPJ
Reforma
Número do CNPJ
CPF
$.destinatario.cpf /CPF
Reforma
Número do CPF
Email
$.destinatario.email /email
Reforma
Endereço
$.destinatario.endereco /end
Reforma
Grupo de informações do endereço
Bairro do endereço
$.destinatario.endereco.bairro /xBairro
Reforma
CEP
$.destinatario.endereco.cep /CEP
Reforma
CEP no exterior
$.destinatario.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Código município
$.destinatario.endereco.codigo_municipio /cMun
Reforma
Código do país
$.destinatario.endereco.codigo_pais_ext /cPais
Reforma
Tabela de Países ISO
Complemento do endereço
$.destinatario.endereco.complemento /xCpl
Reforma
Logradouro
$.destinatario.endereco.logradouro /xLgr
Reforma
Nome da cidade no exterior
$.destinatario.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Número no logradouro do endereço
$.destinatario.endereco.numero /nro
Reforma
Região no exterior
$.destinatario.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Motivo ausência NIF
$.destinatario.motivo_ausencia_nif /cNaoNIF
Reforma
  • Tipo do motivo para não informação do NIF. Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF
$.destinatario.nif /NIF
Reforma
Número de Identificação Fiscal fornecido por um órgão de administração tributária no exterior
Razão Social
$.destinatario.razao_social /xNome
Reforma
Nome ou Razão Social
Telefone
$.destinatario.telefone /fone
Reforma
Documentos Referenciados
$.documentos_referenciados /gReeRepRes
Reforma
Lista de objetos do tipo documentos_referenciados
Chave DFe
$.documentos_referenciados[].chave_dfe /chaveDFe
Reforma
Chave do Documento Fiscal eletrônico do repositório nacional referenciado para os casos de operações já tributadas
CNPJ do fornecedor
$.documentos_referenciados[].cnpj_fornecedor /CNPJ
Reforma
Código município
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /cMunDocFiscal
Reforma
Cód. do município emissor do doc. fiscal que não se encontra no repositório nacional
CPF do fornecedor
$.documentos_referenciados[].cpf_fornecedor /CPF
Reforma
Data comp. doc. ded.
$.documentos_referenciados[].data_competencia_documento_dedutivel /dtCompDoc
Reforma
Data da comp. do documento dedutível. (AAAA-MM-DD)
Data emissão doc. ded.
$.documentos_referenciados[].data_emissao_documento_dedutivel /dtEmiDoc
Reforma
Data da emissão do documento dedutível. (AAAA-MM-DD)
Descrição chave DFe
$.documentos_referenciados[].descricao_chave_dfe /xTipoChaveDFe
Reforma
Descrição da DF -e a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional. Deve ser preenchido apenas quando tipoChaveDFe = 9 (Outro)
Descrição do doc.
$.documentos_referenciados[].descricao_documento_fiscal_outro /xDocFiscal
Reforma
Desc. doc. não fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /xDoc
Reforma
Desc. repasse
$.documentos_referenciados[].descricao_tipo_valor_incluido /xTpReeRepRes
Reforma
Descrição do reembolso ou ressarcimento quando a opção é "99 - Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a operações por conta e ordem de terceiro"
Motivo ausência NIF do forn.
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /cNaoNIF
Reforma
  • Tipo do motivo para não informação do NIF. Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF do fornecedor
$.documentos_referenciados[].nif_fornecedor /NIF
Reforma
Tipo NIF (Número de Identificação Fiscal) - fornecido por um órgão de administração tributária no exterior
Número do documento fiscal
$.documentos_referenciados[].numero_documento_fiscal_outro /nDocFiscal
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Número do documento não fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal /nDoc
Reforma
Razão Social do fornecedor
$.documentos_referenciados[].razao_social_fornecedor /xNome
Reforma
Nome ou Razão Social
Tipo chave DFe
$.documentos_referenciados[].tipo_chave_dfe /tipoChaveDFe
Reforma
  • Tipo de documento do repositório nacional. Valores possíveis:
  • 1 - NFS-e
  • 2 - NF-e
  • 3 - CT-e
  • 9 - Outro
Tipo valor incluído
$.documentos_referenciados[].tipo_valor_incluido /tpReeRepRes
Reforma
Tipo de valor incluído neste documento, recebido por motivo de estarem relacionadas a operações de terceiros, objeto de reembolso, repasse ou ressarcimento pelo recebedor, já tributados e aqui referenciado
Val. reemb./ressarc.
$.documentos_referenciados[].valor_repasse /vlrReeRepRes
Reforma
Valor monetário reembolso ou ressarcimento(total ou parcial, conforme documento informado) utilizado para não inclusão na base de cálculo do ISS e do IBS e da CBS da NFS-e que está sendo emitida (R$)
Indicador da finalidade da emissão de NFS-e
$.finalidade_emissao /finNFSe
Reforma
Imóvel
$.imovel /imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis, exceto obras
CIB
$.imovel.codigo_cib /cCIB
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Endereço do imóvel
$.imovel.endereco /end
Reforma
Grupo de informações do endereço do imóvel
Bairro do endereço
$.imovel.endereco.bairro /xBairro
Reforma
CEP
$.imovel.endereco.cep /CEP
Reforma
CEP no exterior
$.imovel.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Complemento do endereço
$.imovel.endereco.complemento /xCpl
Reforma
Logradouro
$.imovel.endereco.logradouro /xLgr
Reforma
Nome da cidade no exterior
$.imovel.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Número no logradouro do endereço
$.imovel.endereco.numero /nro
Reforma
Região no exterior
$.imovel.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
Ind. Destinatário
$.indicador_destinatario /indDest
Reforma
  • Indica o destinatário do serviço. Valores possíveis:
  • 0 - O destinatário é o próprio tomador/adquirente identificado na NFS-e (tomador=adquirente=destinatário)
  • 1 - O destinatário não é o próprio adquirente, podendo ser outra pessoa, física ou jurídica (ou equiparada), ou um
  • estabelecimento diferente do indicado como tomador (tomador=adquirente≠destinatário)
Serviço
$.servico /Servico
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento /pDifCBS
Reforma
Código indicador da operação
$.servico.codigo_indicador_operacao /cIndOp
Reforma
Código indicador da operação de fornecimento, conforme tabela "código indicador de operação"
Código NBS
$.servico.codigo_nbs /CodigoNbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Cód. class. trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód. class. trib. reg. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular /cClassTribReg
Reforma
Código de Classificação Tributária do IBS e da CBS de tributação regular
Cód. créd. pres. IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao /cCredPres
Reforma
Código e classificação do crédito presumido: IBS e CBS
CST IBS/CBS
$.servico.ibs_cbs_situacao_tributaria /CST
Reforma
Código de Situação Tributária do IBS e da CBS
CST trib. reg. IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular /CSTReg
Reforma
Código de Situação Tributária do IBS e da CBS de tributação regular
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento /pDifMun
Reforma
Perc. de diferimento para IBS UF
$.servico.ibs_uf_percentual_diferimento /pDifUF
Reforma
Tipo ente governamental
$.tipo_compra_governamental /tpEnteGov
Reforma
  • Tipo de ente governamental. Para administração pública direta e suas autarquias e fundações.
  • Valores possíveis:
  • 1 - União
  • 2 - Estado
  • 3 - Distrito Federal
  • 4 - Município
Tipo Operação Entes Governamentais
$.tipo_operacao_governamental /tpOper
Reforma
  • Tipo de Operação com Entes Governamentais ou outros serviços sobre bens imóveis:
  • 1 - Fornecimento com pagamento posterior;
  • 2 - Recebimento do pagamento com fornecimento já realizado;
  • 3 - Fornecimento com pagamento já realizado;
  • 4 - Recebimento do pagamento com fornecimento posterior;
  • 5 - Fornecimento e recebimento do pagamento concomitantes.

Outras Informações

  • Caso haja algum erro referente ao uso de numeração RPS, é possível verificar com o provedor em “callcenter2@webiss.com.br”.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2504009
  },
  "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": 2504009,
      "uf": "PB",
      "cep": "82900-010"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "04.01",
    "codigo_tributario_municipio": "04.01",
    "codigo_cnae": "8630503",
    "discriminacao": "TESTE DE WEBSERVICE"
  }
}
{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2504009
  },
  "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": 2504009,
      "uf": "PB",
      "cep": "82900-010"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "04.01",
    "codigo_tributario_municipio": "04.01",
    "codigo_cnae": "8630503",
    "discriminacao": "TESTE DE WEBSERVICE",
    "codigo_indicador_operacao": "000001",
    "ibs_cbs_situacao_tributaria": "001",
    "ibs_cbs_classificacao_tributaria": "000001"
  }
}