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 possui

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.

{
  "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"
    }
  ]
}