Agora no Bluesoft ERP, é possível realizar a inclusão de receitas de prestação de serviço municipal com a opção de emitir a NFS-e (Nota Fiscal de Serviço Eletrônica) via API

O objetivo desta melhoria é automatizar o fluxo de faturamento de serviços, permitindo que a emissão da nota fiscal e a geração do contas a receber ocorram em um único processo simplificado via integração, eliminando a necessidade de registros manuais.

A partir desta atualização, o endpoint de receitas de prestação de serviço municipal foi expandido para suportar o novo fluxo de emissão:

  • Novo Parâmetro de Emissão: Foi adicionado o campo enviarNotaFiscalAPrefeitura. Quando definido como SIM (true), o sistema assume a responsabilidade de gerar o RPS e transmitir para a prefeitura.
  • Série do RPS: Ao optar pelo envio à prefeitura, o campo serieRps torna-se obrigatório, enquanto o número da nota fiscal torna-se opcional, pois será gerado automaticamente pelo sistema.
  • Recálculo Automático de Impostos: O ERP passará a ignorar valores de impostos enviados no JSON (como PIS, COFINS e ISS), realizando o recálculo mandatório com base nas alíquotas padrão configuradas no sistema para garantir a conformidade fiscal.
  • Registro de Notas Externas: Caso o usuário deseje apenas registrar uma nota já emitida (parâmetro enviarNotaFiscalAPrefeitura como Não/false), os campos numeroNotaFiscal, serieNotaFiscal e dataEmissao continuam sendo obrigatórios.

Exemplo de JSON:

{
    "servicoKey": 1,
    "discriminacaoServico": "Serviço de Consultoria",
    "valorTotalOperacao": 1000,
    "parcelas": [
        {
            "descritivo": "string",
            "valorNominal": 980,
            "desconto": 0,
            "juros": 0,
            "multa": 0,
            "dataVencimento": "01/05/2026"
        }
    ],
    "notaFiscal": {
        "enviarNotaFiscalAPrefeitura": true,
        "serieRps": "2",
        "dataEmissao": "23/02/2026",
        "dataPrestacaoServico": "25/02/2026"
    },
    "totais": {
        "valorDespesasNaoTributadas": 0,
        "valorDespesasAcessorias": 0,
        "baseCalculoIssRetido": 1000,
        "baseCalculoIssNormal": 0,
        "baseCalculoInssRetido": 1000,
        "tipoDeIss": "ISS_RETIDO",
        "codigoServicoNfseKey": 95
        "tipoServicoSpedKey": 2601
    },
    "impostosParaContribuicao": {
        "pisAliquota": 0.65,
        "cofinsAliquota": 3.00,
        "cstPisCofins": 2
    },
    "formaPagamento": "DINHEIRO",
    "naturezaRendimentoKey": 328,
    "centroResultados": [
        {
            "centroResultadoKey": 1,
            "valor": 1000,
            "canaisDeVenda": [
                {
                    "canalVendaKey": 2,
                    "valor": 1000
                }
            ]
        }
    ]
}

Observações e Validações Importantes

  • Configuração de Loja e Município: Para o envio automático, a loja deve estar em ambiente de NFS-e habilitado (Produção ou Homologação) e o município deve estar homologado pelo ERP.
  • Cadastro de Serviço: O serviço informado deve possuir a flag serviço Prestado = Sim ativa no cadastro.
  • EFD-Reinf: O preenchimento da naturezaRendimentoKey é obrigatório para todos os contratos que exigem nota fiscal.
  • Limites de Contrato: O sistema validará se o valor do lançamento excede o saldo remanescente do contrato financeiro.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r367.01