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

Saiba como emitir NFS-e em Guaraci (PR) 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

Elotech

Formato

Próprio (ABRASF)

Autenticação

Certificado digital 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

Acessar

Homologação

Sim

Não disponível

Campos Importantes

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Opcional
Endereço do Tomador	Opcional
Item Lista Serviço	Obrigatório	Utiliza o padrão da Lei Complementar 116/2003
Código CNAE	Obrigatório
Código Tributário Município	Não utilizado

Campos do Provedor

Serviço

$.servico /Servico

CST PIS/COFINS

$.servico.situacao_tributaria_pis_cofins /CSTPisCofins

Reforma

Código de Situação Tributária do PIS/COFINS (CST)
Envio obrigatório somente quando houver envio de valores de PIS e COFINS.
Valores possíveis:
00 - Nenhum;
01 - Operação Tributável com Alíquota Básica;
02 - Operação Tributável com Alíquota Diferenciada;
03 - Operação Tributável com Alíquota por Unidade de Medida de Produto;
04 - Operação Tributável monofásica - Revenda a Alíquota Zero;
05 - Operação Tributável por Substituição Tributária;
06 - Operação Tributável a Alíquota Zero;
07 - Operação Isenta da Contribuição;
08 - Operação sem Incidência da Contribuição;
09 - Operação com Suspensão da Contribuição;
49 - Outras Operações de Saída;
50 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
51 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
52 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita de Exportação;
53 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
54 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
55 - Operação com Direito a Crédito – Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
56 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
60 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
61 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
62 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação;
63 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
64 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
65 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
66 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
67 - Crédito Presumido – Outras Operações;
70 - Operação de Aquisição sem Direito a Crédito;
71 - Operação de Aquisição com Isenção;
72 - Operação de Aquisição com Suspensão;
73 - Operação de Aquisição a Alíquota Zero;
74 - Operação de Aquisição sem Incidência da Contribuição;
75 - Operação de Aquisição por Substituição Tributária;
98 - Outras Operações de Entrada;
99 - Outras Operações.

Outras Informações

Necessário gerar token no portal da prefeitura (Clicar em 'Acessar Contribuinte' e seleciona o cadastro. Em seguida clicar em Informações > Informações da Empresa, e por fim clicar no cadeado verde para a geração). O token é enviado para o e-mail cadastrado no portal.
É possível emitir nota sem identificar tomador (sem ambos: CPF e endereço), mas nesse caso não se permite cancelamento.
Para alternar emissão em homologação/produção pode ser necessário configurar no portal da prefeitura - Menu lateral > Informações da Empresa > Dados de integração entre sistemas.

JSONs de Exemplo

{
  "data_emissao": "2025-08-27T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4109203
  },
  "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": {
    "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,
    "aliquota": 2.01,
    "item_lista_servico": "14.02",
    "codigo_cnae": 4520001,
    "iss_retido": false
  }
}