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

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

D2ti

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

Acessar

Homologação

Não

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 nacional da Lei Complementar 116/2003
Código CNAE	Obrigatório
Código Tributário Município	Não utilizado

Outras Informações

É preciso utilizar um token de acesso disponível após cadastro no ambiente da prefeitura
Não há ambiente de homologação, porém, é possível utilizar o token “C36D17ABC320D2054E91AD97A46B6BBB” para emissão nesse ambiente
O webservice do provedor não disponibiliza as operações de consulta, substituição e correção da NFSe, apenas envio e cancelamento
É obrigatório informar o e-mail e telefone do prestador
É possível emitir múltiplos serviços na nota conforme o json de exemplo abaixo.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": true,
  "natureza_operacao": "1",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2101400
  },
  "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": {
    "valor_servicos": 1.0,
    "item_lista_servico": "0901",
    "codigo_cnae": "551080100",
    "aliquota": 5.0,
    "valor_iss": 0.05,
    "discriminacao": "TESTE DE WEBSERVICE"
  }
}

{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": true,
  "natureza_operacao": "1",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2101400
  },
  "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": {
    "valor_servicos": 1.0,
    "item_lista_servico": "0901",
    "codigo_cnae": "551080100",
    "aliquota": 5.0,
    "valor_iss": 0.05,
    "discriminacao": "TESTE DE WEBSERVICE"
  },
  "itens": [
    {
      "discriminacao": "diária 1",
      "quantidade": 1,
      "tributavel": true,
      "valor_total": "1",
      "valor_unitario": "1"
    },
    {
      "discriminacao": "diária 2",
      "quantidade": 1,
      "tributavel": true,
      "valor_total": "1",
      "valor_unitario": "1"
    }
  ]
}