Processo – Instalação e Configuração TSS

1.

Dados Cadastrais

Cliente: T54886 – Federação das Indústrias do Estado do Rio de Janeiro

Projeto: D000011437001 - FATURAMENTO - 5TA Contrato: CT 5313/2015

Produto: Protheus 12.1.17 – FINA720

Gerente do Projeto: Ana Castro

2. Descrição do item

O objetivo principal é prover os serviços de emissão e manutenção de documentos fiscais eletrônicos como: Nota Fiscal Eletrônica
(NFe) e Nota Fiscal de Serviço Eletrônica (NFSe). Para que o processo seja realizado corretamente, é preciso seguir o cronograma
abaixo:

1. MIT010 - Instalação e Configuração TSS

2. MIT010 - Atualização de certificado
3. MIT010 - Protheus 12.1.17 – FINA720

3. Análise e aplicação

1 - Execute o instalador do TSS, o arquivo é nomeado como: TSS.exe

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 0

 Processo – Instalação e Configuração TSS

2 - Será exibida a tela de boas-vindas.

3- É apresentado a tela de contrato de licença.

4 - Escolha a pasta de instalação do TSS em Procurar, por default é C:\totvstped\.

5 - Escolha o tipo de instalação do TSS, a 2 opções disponíveis

Online: Ou seja, um programa que estará rodando no lado do servidor, cujo objetivo é realizar comunicação com transmissão de
documentos eletrônicos.

Off-line: Um programa que estará rodando no lado do cliente, cujo objetivo é realizar a contingencia no caso de eventual queda da
comunicação.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 1

 Processo – Instalação e Configuração TSS

6 - Configure o serviço de HTTP que o TSS disponibilizará. Configure o servidor e a porta.

Informe os campos Database (MSSQL, ORACLE etc.), Alias (conexão ODBC criada para o banco de dados do TSS) e Servidor.

No campo Servidor deve ser informado o IP do Servidor no qual está sendo realizada a instalação.

OBS: Caso este campo seja preenchido como LOCALHOST, o acesso se dará internamente apenas pelo servidor no qual está instalado o
TSS, qualquer outra máquina da Rede não enxergará o Serviço.

7 - A seguir, informe os programas que deseja instalar.

Os itens em cinza são pacotes desabilitados por incompatibilidade ou escolhas anteriores.

8 - Preencha os campos Porta do serviço do appserver, nome do serviço do appserver e descrição do serviço do appserver.

9 - Aguarde até que a barra de status da porcentagem instalada chegue ao final.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 2

 Processo – Instalação e Configuração TSS

10 - Será exibida uma nova tela para seleção dos ícones que podem ser exibidos na área de trabalho.

11 - Aguarde até que a barra de status da porcentagem instalada chegue ao final.

OBS: Para verificar se o server está instalado corretamente, acesse o endereço do Web Service configurado nos passos anteriores via
HTTP.

Exemplo: http://127.0.0.1:8080/.

12 - Validado o funcionamento de todos os serviços, no diretório do TSS, acessar a rota: totvssped\bin\smartclient\smartclient.exe

Os parâmetros iniciais para inicialização do sistema são:

1. Programa Inicial: TSSINTERFACE
2. Comunicação no cliente: TCP
3. Ambiente no servidor: SPED

13 - No primeiro acesso a ferramenta, será solicitado um usuário e senha para efetuar o login. Por padrão o primeiro acesso é
realizado com:

Usuário: ADMIN
Senha: ADMIN

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 3

 Processo – Instalação e Configuração TSS

14 - Ao clicar em entrar, será solicitado uma nova senha por questões de segurança:

O aplicativo acessa o gerenciamento de usuários que permite manipular as contas que podem acessar o Sistema.

 Crie um usuário. Informe o nome e clique no ícone de Adição.

 Defina a senha de acesso, que deve ser redefinida no primeiro acesso (semelhante ao acesso com o usuário ADMIN) e
adicione o CNPJ da empresa/filial que o usuário deve ter acesso.
 Clique no ícone representado pelo disquete para salvar as configurações.

15 - Acesse o aplicativo com o usuário recém-criado para utilizar as funcionalidades.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 4

 Processo – Instalação e Configuração TSS

16 – No APSDU, é importante validar na tabela SIGAMAT todos os campos de um cabeçalho de nota, para que não ocorra nenhum
erro durante o processo, e que todas as informações no TSS, Protheus e Certificado, sejam idênticas.

17 – Com as entidades configuradas, é preciso validar o cadastro para garantir que os dados estão preenchidos corretamente, para
isso, temos que acessar a rota: Outras Ações / Entidade

18 – Selecione a entidade que será revisada e clique em configurar.

19 – Será exibido uma nova tela de configuração, na pasta GERAL, acesse a aba GERAL e valide os campos Conta de e-mail, E-mail,
Senha e URL do Portal TSS, conforme imagem abaixo.

20 – Já na aba Totvs Colaboração.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 5

 Processo – Instalação e Configuração TSS

21 – Na pasta fiscal, selecione a subpasta NFS-e e revise os campos da aba GERAL: Ambiente, Versão, Código do Município no IBGE,
Código do Município no SIAF e CNPJ conforme imagem abaixo.

Importante: Alguns municípios solicitam a inclusão de usuário e senha do webservice, na configuração do wizard e também na
configuração do TSS, é necessário a inclusão das informações de login para que não ocorra erro de acesso durante as transmissões.

4. Lista de Fontes necessários para execução do sistema

Rota para download dos fontes:

D000011437001 - FATURAMENTO - 5TA - CT 53132015\Desenho e Construção\FONTES\19-07-03_FIS_RDMAKE_NFSE_P12.1.17

NFSEXml001.PRW
NFSEXml002.PRW
NFSEXml003.PRW
NFSEXml102.PRW
Nfsexmlenv.PRW
NFSEXmlUni.PRW

D000011437001 - FATURAMENTO - 5TA - CT 53132015\Desenho e Construção\FONTES

CHGXFIL.PRW

D000011437001 - FATURAMENTO - 5TA - CT 53132015\Desenho e Construção\FONTES\PONTO DE ENTRADA

fi020cabec.prw

5. Lista de patchs que devem ser aplicados após instalação.

Rota para download dos patchs: D000011437001 - FATURAMENTO - 5TA - CT 53132015\Desenho e Construção\Pacotes a aplicar

000_TSS_ATUALIZACAO_RPO_TTVFLGP1J002-1567185733623-506057 – Contém o RPO mais atualizado para configuração do TSS.

001_ERP_PACOTE_DE_CORRECAO_3817537_DSERFINR-19538 12.1.17 - Ajustes na rotina Geração de Nota Fiscal.
002_ERP_PACOTE_DE_CORRECAO_000000_DSERFIS1-14338_12.1.17 - Ajuste para a utilização correta da função GETREMOTETYPE.
003_ERP_PACOTE_DE_CORRECAO_5827477_DSERTSS2-4107_12.1.17 - Realizada manutenção na rotina FISA022.prw, para geração do XML Cancelado quando a NF possui cancelamento.
004_ERP_PACOTE_DE_CORRECAO_3646792_DSERFAT-7471_12.1.17 – Pacote de correção para incluir o filtro na tela de documento de saída.
005_ERP_PACOTE_DE_CORRECAO_4054655_DSERFAT-8074_12.1.17 - Ajustes efetuados na janela de seleção de Série/Nota exibida na Geração do Documento de Saída.
006_ERP_PACOTE_EMERGENCIAL_7056500_MPRIMESP-19766_12.1.17 - Ajuste para leitura da tabela SBZ quando parâmetro MV_ARQPROD = SBZ
007_TSS_19-06-06-TSS_RELEASE_12.1.17_ARQUIVOS_CONF - Insira os arquivos CONF na pasta system do TSS e substitua pelos antigos se necessário.
009_TSS_19-10-11-TSS_SCHEMAS_RELEASE_12.1.17 - Descompactar os arquivos baixados na pasta SCHEMAS do TSS e substituir os arquivos antigos caso exista.
010_TSS_19-10-11-TSS_URLS_RELEASE_12.1.17 - Instruções para atualizar as URL’s do TSS na página 7.
011_ERP_PACOTE_EMERGENCIAL_7498856_MPRIMESP-20099_12.1.17 – Correção da divergência de informações entre as tabelas SA1 e SF2 para clientes que possuem mais de 1 loja.
012_ERP_PACOTE_EMERGENCIAL_7476099_MPRIMESP-20078_12.1.17 – Correção para conseguir preencher o TS Padrão na SBZ sem gerar erros no momento de gerar a NFSe.
013_ERP_PACOTE_DE_CORRECAO_7030301_DSERFINR-21783_12.1.17 - Ponto de entrada na rotina FINA720 na função de Estorno de NF ('FI720ESTNF').
014_ERP_PACOTE_DE_CORRECAO_6790000_DSERFAT-13891_12.1.17 – Ajuste SX5 e SD9 para exibir 9 posições.
015_ERP_PACOTE_DE_CORRECAO_7827074_DSERTSS2-5480_12.1.17 – Realizada alteração do layout de NFS-e para o município de Duque de Caxias – RJ
016_ERP_19-12-02_ATUALIZACAO_12.1.17_FATURAMENTO_EXPEDICAO_CONTINUA_TTTP12 - Fontes padrões atualizados de acordo com o ambiente de homologação.
017_TSS_PACOTE_DE_CORRECAO_7961338_DSERTSS2-5854_12.1.17 – Realizada alteração do layout de NFS-e para o município de Nova Friburgo - RJ

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 6

 Processo – Instalação e Configuração TSS

6. TSS – Atualização das URLs do TSS

1 - Pare o serviço do TSS;

2 - Efetue download do arquivo TSSATUURL.JSON disponibilizado no caminho abaixo:

D000011437001 - FATURAMENTO - 5TA - CT 53132015\Desenho e Construção\Pacotes a aplicar\010_19-10-11-

TSS_URLS_RELEASE_12.1.17\tssatuurl.json

3 - Acesse a pasta de instalação do TSS e após realizar o download do arquivo extraia o arquivo TSSATUURL.JSON e salve na pasta
system do TSS;

4 - Clique com o botão direto do mouse no arquivo e acesse as propriedades do arquivo. Desmarque a opção "somente leitura" caso
esteja marcada;

5 - Reinicie o serviço do TSS para que o arquivo seja apagado da pasta system;

6 - Se arquivo não foi apagado da pasta system, entre na pasta SEMAFORO do TSS e exclua o arquivo com a mesma nomenclatura
TSSATUURL e refaça o procedimento;

7 - Após conclusão, reinicie o TSS.

8 – Na tabela SPED158 do APSDU do TSS, os links de todos os municípios estarão atualizados, para localizar algum especifico é
possível fazer um filtro pelo código de município.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 7

 Processo – Instalação e Configuração TSS

7. Instruções para configurar a primeira nota a ser emitida pela filial através da FINA720.

Para realizar o processo é necessário acessar o APSDU.

A tabela SX5 se encontra no Top Connect, conforme imagem abaixo.

Revise a conexão ao Top Connect.

Pesquise pela SX5.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 8

 Processo – Instalação e Configuração TSS

No final da tabela, inclua um novo registro, ao incluir a filial com a numeração da nota desejada, todas as próximas notas irão ter o
mesmo padrão de posições.

6 – Para funcionamento desta configuração de numeração por filial utilizamos o ponto de entrada “CHGXFIL.PRW” que filtrará
somente as series da respectiva filial.

Exemplo de algumas filiais já registradas na tabela SX5.

7 - Acesse o configurador para verificar se houve o preenchimento correto da SX5

1. Faça o acesso ao configurador com a filial que será utilizada

2. Acesse a rota: Ambiente / Cadastro / Tabelas
3. Localize a Tabela 00 - Chave 01 - SÉRIE DE N.FISCAIS, conforme imagem abaixo:

4. Clique em editar e dentro da pasta itens, será exibido todos os tipos de série e as suas respectivas descrições, dessa forma é
possível incluir uma nova série, ou alterar as existentes.

OBS: Caso no configurador esteja configurado de acordo com as necessidades da filial, não é necessário realizar nenhum tipo de
alteração de chave ou descrição na aplicação.

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 9

 Processo – Instalação e Configuração TSS

8. Parâmetros

Abaixo a relação de parâmetros a serem configurados na tabela SX6, os parâmetros devem ser configurados 1 por filial conforme
exemplo a seguir

Os demais parâmetros mencionados na tabela abaixo não precisam ser configurados para cada filial.

Nome Descrição Conteúdo

Código do regime tributário do emitente da Nfe 1-Simples Nacional; 2-Simples Nacional-
MV_CODREG Excesso de 3
MV_SPEDEXC Informar a quantidade de horas, conforme a SEFAZ de cada estado determina, para 24
Informa se deverá digitar a chave da Nfe/Cte caso a espécie seja SPED/CTE e Form.
Próprio=Não
MV_DCHVNFE .T. = Sim; .F. = Não. .T.
Informar se o botão de inutilização deve ser apresentado na rotina SPEDNFE. .T. = Sim; .F. =
MV_INUTILI Não. .F.
MV_INUTCLI Informar o código do cliente que será utilizado na nota a ser inutilizada. 0
MV_INUTPRO Informar o código do produto que será utilizado na nota a ser inutilizada. 0
MV_INUTTES Informar o código do TES que será utilizado na nota a ser inutilizada. 0

UNI=NF;1=SPED;A=RPS
MV_ESPECIE Contêm tipos de documentos fiscais utilizados na emissão de notas fiscais Um por filial
MV_ITEMAGL Aglutinar ITENS do RPS na geração do XML da Nfse ABRASF? S=SIM N=Não N
Indica se a descrição do serviço prestado na Nota Fiscal Eletrônica será composta: 1 - pedido
MV_NFESERV de vendas + descrição SX5 ou 2 - somente SX5. 1
Define os tipos de documentos que o TSS deve transmitir para a solução TOTVS Colaboração
(0=TODOS;1=NFe;2=CTe;3=NFSe)
MV_DOCSCOL Exemplo = 2,3 0
Array contendo o endereço com número, complemento, bairro, cidade, CEP e UF do local ",
MV_ENDPRES dos serviços prestados. 0
URL de comunicação com o TSS URL de comunicação com o TSS URL de comunicação com o http://10.31.187.72:9401
MV_SPEDURL TSS um por filial
Informe o nome do campo de USUARIO da tabela SC5 que contempla a informação de Dados
MV_CMPUSR complementares da NFSe, quando Não utilizado C5_MENNOTA C5_XMENNFS
Campo ou dado a ser gravado na natureza do titulo. Quando o mesmo for gerado IIF(EMPTY(SC5->C5_NATUREZ),SA1-
MV_1DUPNAT automaticamente pelo modulo de faturamento. >A1_NATUREZ,SC5->C5_NATUREZ)
Campo ou dado a ser gravado no prefixo do titulo. Quando o mesmo for gerado
MV_1DUPREF automaticamente pelo modulo de faturamento. SF2->F2_SERIE
MV_ARREFAT Arredonda Valor total no Pedido de Venda ? S
Define se a liberação manual de credito deverá considerar a quantidade liberada(1), a
MV_AVALEST quantidade em estoque(2) ou (3) bloqueia o estoque. 1

MV_RMCLASS Parâmetro de integração EAI Protheus x ClassisNet. .T.

MV_ITEMAGL Parâmetro para aglutinar itens S
MV_TPNRNFS Controle de numeração com uso de SD9 3
Indica se a descrição do serviço será composta pela tabela 60 e a discriminação do serviço
MV_NFEDESC será composta pelo pedido de vendas. T

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 10

 Processo – Instalação e Configuração TSS

9. Aprovações

Aprovador por: Assinatura Data

Analista responsável pelo teste –
___/___/___
FIRJAN

Kaue dos Santos Correa – Analista

___/___/___
TOTVS

Reuben Vitor de Vasconcelos –

___/___/___
Analista TOTVS

Rodrigo Luis da Silva Costa – Analista

___/___/___
TOTVS

Marcelo Castro – Gerente FIRJAN ___/___/___

Ana Castro – Coordenadora de Projeto

___/___/___
TOTVS

MIT010 – INSTALAÇÃO E CONFIGURAÇÃO TSS 11