Cross Segmentos - Linha Logix - NFSE - Layout único do TSS na NFSE do Logix

Tempo aproximado para leitura: 00:19:29 min

Dúvida
Como emitir uma NFSe - Nota fiscal de serviço eletrônica pelo Layout único do TSS - TOTVS Service SOA no Logix?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Logix) - Nota Fiscal de Serviço Eletrônica (NFSE) - Versão 12

Solução
O Layout único do TSS será o meio de envio das NFSE caso o seu município ainda não tenha aderido ao Emissor Nacional da NFS-e conforme consulta disponível em: Municípios Aderentes, verifique o quadro Adesão ao Emissor Nacional da NFS-e.

Então deverá ser verificado se o município está homologado no TSS, conforme link: Cross Segmentos - Linha Logix - NFSE - Qual é a relação de municípios homologados para emissão de NFS-e no Logix, pois para esses casos será mantida a utilização do layout único do TSS.

Conforme contrato TOTVS, capitais ou municípios com 500.000 habitantes ou mais, serão tratados pelo produto padrão, cabendo aos outros casos o desenvolvimento participativo ou customização do Logix/TSS para ajustes de layout.

Com a entrada do layout nacional e da Reforma Tributária a conversão efetuada pelo TSS para o layout de cada provedor específico das prefeituras que não aderiram ao provedor nacional precisará passar por ajustes, estas alterações estão sendo feitas por demanda, então verifique no artigo supracitado, a relação de prefeituras homologadas ao layout único da NFSE se esse processo já ocorreu:

Caso não tenha ocorrido a adequação ainda, abra um ticket para o VDP, que a demanda será direcionada para a equipe do TSS incluir a alteração na fila de desenvolvimentos.

Cabe ressaltar também que todas as notas de serviço, mesmo as emitidas pelo provedor próprio da prefeitura, após autorizadas serão convertidas ao ADN - Ambiente de Dados Nacional e para isso, ao fim de todo o processo, precisam conter todas as informações necessárias para atender ao layout nacional da NFSE.

Com a entrada do layout nacional da NFSE, é necessário que a série das notas de serviço atendam ao requisito da SEFAZ - Secretaria da Fazenda para geração da TAG serie de acordo com a faixa de utilização:

Cadastre uma série exclusiva para NFS-e no VDP10050/VDP0741 - Numeração fiscal, onde o Tipo Doc deve ser FATSERV e o modelo igual a 56. O Logix possui apenas 3 caracteres para a série. Consulte sua prefeitura para determinar se o provedor do seu município precisará modificar ou gerar uma determinada faixa de série para posterior integração das notas autorizadas no provedor próprio com o layout nacional.

E será necessário a parametrização:
No LOG00086 - Parâmetros do Sistema informe o parâmetro em PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL ELETRONICA>Data de início da utilização da nota fiscal de serviço eletrônica. - data inicial_nfse.

Em PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL ELETRONICA>Utilizar painel da NF-e e NFS-e? - inicio_utiliz_obf40000 - ative o parâmetro, pois o OBF50000, só funciona com o OBF40000 ativado.

E no VDP10076/VDP9109 - Configuração documentos eletrônicos na opção NFS-e, informar os campos abaixo de acordo com as informações disponibilizadas pela prefeitura e seu certificado digital:

Lembrando que no campo Versão do arquivo, deve-se informar a versão disponível no campo Versão Homologada no artigo que relaciona os municípios homologados.

Como o layout de geração de XML muda de uma prefeitura para a outra, para facilitar as homologações de campos específicos de cada prefeitura foi criado o layout único do TSS. 
Esta funcionalidade visa reduzir as chances de que um layout de prefeitura seja incompatível com o TSS já que apesar de cada prefeitura ter um layout diferente do outro, muitas prefeituras possuem tags comm códigos e finalidades iguais entre si.

Desta forma o Sistema de origem gera todas as informações para o TSS num layout de comunicação interno e o TSS após receber e processar estas informações segrega e envia para a prefeitura apenas as informações esperadas no schema ou formato utilizado para a prefeitura. Dessa forma a chance de ocorrer algum erro de schema é menor.

Antes de iniciar as parametrizações do OBF50000 - Painel NFSe ative o layout único do TSS pelo LOG00086 - Administração de Parâmetros no parâmetro PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL ELETRONICA>Utilizar layout único do TSS para transmissão de NFS-e? - utiliza_layout_unico_tss.

Em PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL ELETRONICA>Permitir enviar mais de um item na NFS-e? - permite_itens_nfse - precisa ser marcado como N - Não, pois todas as notas emitidas mesmo em prefeituras que utilizam provedores próprios - e que por isso a nível de sistema utilizam o layout único do TSS - serão convertidas por estes provedores ao layout nacional depois que as notas estiverem autorizadas. O layout nacional não aceita mais de um item por nota, por isso, tudo já deve ser gerado em conformidade com o layout nacional já desde o envio.

Em PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL DE SERVIÇO ELETRÔNICA>Gerar tag tpRetPisCofins com novos valores? - gera_tag_tpretpiscofins - Para esse parâmetro é necessário identificar se a prefeitura utilizada requer a geração da TAG de retenção PIS e COFINS com os valores ampliados, onde acoberta também o CSLL em suas variações de recolhimento e retenção. Mais detalhes consulte o parâmetro direto no LOG00086 e caso não identifique o valor adequado, mantenha num primeiro momento o parâmetro como N e avalie como o teste de envio vai ocorrer.

Para emails no layout único, verifique as informações do artigo: Cross Segmentos - Linha Logix - NFSE - E-mail do tomador

Caso você não tenha este parâmetro ou não esteja neste pacote, será preciso atualizar o seu ambiente Logix e o TSS, pois este é o processo vigente de emissão de NFS-e.

Faturamento da nota:
O item deverá ser cadastrado como tipo Serviço na opção Comercial do MAN10021 - Cadastro de item, e deve ser informado os campos destacados da imagem abaixo:

Conforme o artigo: Cross Segmentos - Linha Logix - NFSE - Geração das tags de códigos de atividade do RPS, Serviço prestado, CNAE e Serviço no município

Caso já esteja gerando notas de serviço considerando a reforma tributária e precise informar o código NBS - Nomenclatura Brasileira de Serviços, ele é parametrizado pelo MAN10021 na aba Comercial no campo Código NBS.

Para prefeituras que não trabalham com o provedor GINFES é necessário desativar o parâmetro do LOG00086 em PROCESSO SAIDAS>FATURAMENTO>NOTA FISCAL ELETRONICA>Realizar consulta de NFSe, pelo RPS ? - consulta_nfse_rps_tss.

Para atender a emissão das nota fiscais de serviço eletrônico, passou a ser obrigatório informar alguns dados complementares da NFSE, para isso foi implementado inicialmente no VDP0746 - Solicitação de Faturamento Manual e desde o pacote publicado em 02/02/2026, no VDP20000. Essa tela será aberta quando o tipo da solicitação é SOLSERV e o parâmetro da reforma data_inicio_ref_trib estiver informado e com data maior que a atual: 

Ind Final: Indica operação de uso ou consumo pessoal;

Cod Ind. Operação: Código indicador de operação, cadastrado pelo VDP10106 - Cadastro do código indicador da operação, cujos códigos podem ser importados pelo arquivo cod_ind_op.txt;

Tipo de operação: Conforme a Regra de validação da NFSE: Código do tipo de Operação - tpOper - deve ser informado quando se tratar de uma compra governamental ou um dos serviços da LC 116/2003 listados: 25.05; 15.09; 17.12; 10.05. Caso a operação não envolva entidade governamental, informe 0.

Para grupo acima será gerado conforme dados informados na solicitação de faturamento as TAGS indFinal, cIndOP e tpOper.

A TAG indDest será gerada como 1 se a nota possuir endereço de entrega e neste caso também irá gerar o grupo dest, caso não tenha endereço de entrega a TAG será gerado como 0.

As TAGS gRefNFSe, refNFSe e tpEnteGov ainda não foram implementadas e serão liberadas em pacote futuro.

Para notas de serviço faturadas a partir de um pedido, poderá ser informado os dados na consulta da nota antes do envio para a prefeitura realizado alteração na aba Nota fiscal eletrônica>Informações da NFSE para permitir a modificação/inclusão dos dados da NFSE:

Será permitido a alteração para notas que ainda não foram enviadas para prefeitura ou que estão com status de R - Rejeitada, 8 - Falha de schema ou 9 - Erro no Logix no OBF50000. Consulte a nota na tela principal e altere os dados na opção Informações da NFS-e.

A Tributação para o layout único precisa corresponder ao tipo de tributação ao qual o ISS se refere, para identificar a opção correta, verifique Cross Segmentos - Linha Logix - NFSE - Erro schema na tag TIPOTRIB

Depois de faturar a nota, deverá ser enviada para a Prefeitura através do OBF50000 - Painel NFS-e.

Outra questão que diverge de prefeitura em prefeitura é a utilização de webservice para cancelamento. Verifique na coluna Cancelamento no artigo que relaciona os municípios homologados, e então veja o artigo: Cross Segmentos - Linha Logix - NFSE - Cancelar a nota fiscal de serviço eletrônica

Dependendo da operação ou da prefeitura, pode existir a necessidade de enviar o endereço do tomador do serviço, com um endereço diferente do endereço do cliente, para isso, verifique o artigo: Cross Segmentos - Linha Logix - NFSE - Enviar o endereço de entrega como município tomador na nota fiscal eletrônica de serviço, para esse comportamento, além de ativar o parâmetro, informa um endereço de entrega.

Para geração dos textos adicionais da NFSE, verifique: Cross Segmentos - Linha Logix - NFSE - Impressão dos textos adicionais para as notas de serviço. Os textos podem precisar de quebra de linha, para isso: Cross Segmentos - Linha Logix - NFSE - Gerar caractere de quebra de linha no xml da NFS-e.

Com a entrada da NT-007, para clientes não optantes do simples passou a ser necessário gerar o grupo tottrib no XML do TSS, nele serão gerados os valores aproximados do impostos, para isso verifique: Cross Segmentos - Linha Logix - FAT - Lei da Transparência - Valor Aproximado dos Tributos

Caso a operação possua valores de PIS apurados, é necessário que o tributo PIS_REC seja gerado na nota fiscal.

Importante
Dependendo da prefeitura, pode haver a necessidade utilização de um método diferente para geração das mensagens de comunicação. No geral as prefeituras utilizam comunicação REST, contudo, como é o caso de Barueri, a comunicação é feita por arquivos de texto. Para isso, verifique as informações do artigo: Cross Segmentos - Linha Logix - NFSE - Utilização do método GERAARQIMP

Saiba mais
Verifique também o manual do OBF50000: