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

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

Empresas MEI e optantes pelo Simples Nacional possuem prazos definidos para deixar de emitir utilizando este ambiente municipal. Consulte a obrigatoriedade de emissão no Ambiente Nacional.

Provedor

Sigiss

Formato

Próprio

Autenticação

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	Obrigatório
Endereço do Tomador	Obrigatório
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

Campos do Provedor

Cód. moeda

$.codigo_moeda /dps_serv_tpmoeda

Reforma

Identifica a moeda da transação comercial

Indicador se a NFS-e deverá ser disponibilizada ao MDIC Valores possíveis: 0 - Não enviar para o MDIC; 1 - Enviar para o MDIC;

$.mdic /dps_serv_mdic

Reforma

Apoio prestador ext.

$.mecanismo_comercio_ext_prestador /dps_serv_mecafcomexp

Reforma

Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador do serviço
Valores possíveis:
00 - Desconhecido (tipo não informado na nota de origem);
01 - Nenhum;
02 - ACC - Adiantamento sobre Contrato de Câmbio - Redução a Zero do IR e do IOF;
03 - ACE - Adiantamento sobre Cambiais Entregues - Redução a Zero do IR e do IOF;
04 - BNDES-Exim Pós-Embarque - Serviços;
05 - BNDES-Exim Pré-Embarque - Serviços;
06 - FGE - Fundo de Garantia à Exportação;
07 - PROEX - EQUALIZAÇÃO
08 - PROEX - Financiamento;

Apoio tomador ext.

$.mecanismo_comercio_ext_tomador /dps_serv_mecafcomext

Reforma

Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador do serviço
Valores possíveis:
00 - Desconhecido (tipo não informado na nota de origem);
01 - Nenhum;
02 - Adm. Pública e Repr. Internacional;
03 - Alugueis e Arrend. Mercantil de maquinas, equip., embarc. e aeronaves;
04 - Arrendamento Mercantil de aeronave para empresa de transporte aéreo público;
05 - Comissão a agentes externos na exportação;
06 - Despesas de armazenagem, mov. e transporte de carga no exterior;
07 - Eventos FIFA (subsidiária);
08 - Eventos FIFA;
09 - Fretes, arrendamentos de embarcações ou aeronaves e outros;
10 - Material Aeronáutico;
11 - Promoção de Bens no Exterior;
12 - Promoção de Dest. Turísticos Brasileiros;
13 - Promoção do Brasil no Exterior;
14 - Promoção Serviços no Exterior;
15 - RECINE;
16 - RECOPA;
17 - Registro e Manutenção de marcas, patentes e cultivares;
18 - REICOMP;
19 - REIDI;
20 - REPENEC;
21 - REPES;
22 - RETAERO;
23 - RETID;
24 - Royalties, Assistência Técnica, Científica e Assemelhados;
25 - Serviços de avaliação da conformidade vinculados aos Acordos da OMC;
26 - ZPE;

Modo prestação

$.modo_prestacao /dps_serv_mdprestacao

Reforma

Valores possíveis:
0 - Desconhecido (tipo não informado na nota de origem);
1 - Transfronteiriço;
2 - Consumo no Brasil;
3 - Movimento Temporário de Pessoas Físicas;
4 - Consumo no Exterior;

Movimentação Temporária

$.movimentacao_temporaria_bens /dps_serv_movtempbens

Reforma

Vínculo da Operação à Movimentação Temporária de Bens
Valores possíveis:
0 - Desconhecido (tipo não informado na nota de origem);
1 - Não;
2 - Vinculada - Declaração de Importação;
3 - Vinculada - Declaração de Exportação;

Servico

$.servico

Código indicador Operação

$.servico.codigo_indicador_operacao /dps_cindop

Reforma

Cód. NBS

$.servico.codigo_nbs /dps_serv_cnbs

ObrigatórioReforma

Código da lista de Nomenclatura Brasileira de Serviços (NBS)

Código de tributação nacional

$.servico.codigo_tributacao_nacional_iss /dps_serv_ctribnac

Reforma

COFINS Retido

$.servico.cofins_retido /retencao_cofins

Reforma

Campo booleano utilizado para indicar o tipo de retenção do COFINS.
Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.

CSLL Retido

$.servico.csll_retido /retencao_csll

Reforma

Campo booleano utilizado para indicar o tipo de retenção do CSLL.
Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.

Cód. Trib. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria /dps_ibscbs_valores_trib_cclasstrib

Reforma

Código de Classificação Tributária do IBS e da CBS

PIS Retido

$.servico.pis_retido /retencao_pis

Reforma

Campo booleano utilizado para indicar o tipo de retenção do PIS.
Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.

Tipo de retenção do PIS/COFINS:

$.servico.tipo_retencao_pis_cofins /retencao_pis

Reforma

Obrigatória quando informado o PIS/COFINS ou CSLL.
Tipo de Retenção PIS/COFINS e CSLL, conforme padrão nacional (mesmo campo da API nfsen).
Se informado, sobrescreve valores individuais de pis_retido, cofins_retido e csll_retido.
Valores possíveis:
0 - PIS/COFINS/CSLL Não Retidos;
1 - PIS/COFINS Retidos;
2 - PIS/COFINS Não Retidos;
3 - PIS/COFINS/CSLL Retidos;
4 - PIS/COFINS Retidos, CSLL Não Retido;
5 - PIS Retido, COFINS/CSLL Não Retido;
6 - COFINS Retido, PIS/CSLL Não Retido;
7 - PIS Não Retido, COFINS/CSLL Retidos;
8 - PIS/COFINS Não Retidos, CSLL Retido;
9 - COFINS Não Retido, PIS/CSLL Retidos.

Valor serv. ext.

$.valor_servico_ext /dps_serv_vservmoeda

Reforma

Valor do serviço prestado expresso em moeda estrangeira especificada em tpmoeda

Vínculo negócio

$.vinculo_negocio /dps_serv_vincprest

Reforma

Vínculo entre as partes no negócio
Valores possíveis:
0 - Sem vínculo com o Tomador/Prestador
1 - Controlada;
2 - Controladora;
3 - Coligada;
4 - Matriz;
5 - Filial ou sucursal;
6 - Outro vínculo;

{
  "data_emissao": "2026-01-14T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3522604
  },
  "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": 3522604,
      "uf": "SP",
      "cep": "13974629"
    },
    "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": 4.39,
    "item_lista_servico": "14.01",
    "codigo_nbs": "1.2001.10.00",
    "iss_retido": false
  }
}