Páginas filhas
  • Dashboard TSS - Documentos Processados: Guia de Referência

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleImportante

Esta funcionalidade está em Fase de Piloto

                                                                                                                                                                                                                             

                   


 

Section



Painel
borderStylesolid
titleVisão geral

O Dashboard do TOTVS TSS, é uma plataforma disponibilizada para usuários com intuito de, através de uma interface gráfica, reunir e exibir de forma direta, amigável e de fácil entendimento os dados presentes no TSS.


Com o Dashboard Documentos Processados,os usuários conseguem verificar a volumetria de seus documentos processados no TSS, de forma rápida e clara. Para isso, basta informar os poucos parâmetros solicitados, clicar no botão de Pesquisar e o painel será montado com os seguinte dados:

  • Modelo de documento requisitado;
  • Quantidade mensal emitidas para o documento;
  • Total mensal de todos os documentos emitidos.


Tudo isso em poucos segundos.


Abaixo destacaremos os detalhes funcionais e técnicos desta plataforma.


REQUISITOS MÍNIMOS 

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titlePRÉ-REQUISITOS MÍNIMOS
Aviso

O Dashboard necessita do TSS® Release 12.1.2310 ou superior e arquivos binários com data de expedição igual ou superior a Outubro/2022.

Aviso

O Dashboard necessita do último pacote da Expedição Contínua do TSS, para manter sua versão atualizada. 

https://suporte.totvs.com/portal/p/10098/download#detail/1080454

Informações
titleREST 2.0

O Dashboard utiliza a configuração de Appserver REST 2.0.


Âncora
CONFIG_PILOTO
CONFIG_PILOTO

New NFS-e

A New NFS-e apresenta uma reestruturação na forma de montagem dos .XML's pelo TSS apenas de forma interna(Back-End), com uma arquitetura simplificada, indepêndencia de plataforma, alto desempenho e escalabidade. Onde não implementamos as regras do Layout do Município(Prefeitura) nos fontes e sim na Tabela TSS0013, desta maneira tornando - se mais eficiênte e possibilitando o usuário presta seu auto-atendimento.


Após tal processamento e consolidação, os dados são armazenados para posteriormente serem consultados e ter um retorno otimizado.


Não é necessário nenhum configuração adicional para esse procedimento, já que esta embarcado nos processos realizados pelo TSS. Desta forma, com o repositório TSS atualizado com o Expedição Continua destacado anteriormente em Requisitos Mínimos, o sistema já será capaz de realizar o procedimento detalhado anteriormente

É a interface da New NFS-e  onde os usuários irão conseguir  Implementação, Controlar e prestar um auto-atendimento na Manutenção no Layoutdo Documento Fiscal de Serviço(NFS-e) do Município que deseja Transmitir via Web Service. Caso haja a necessidade de Alteração na URL, Assinatura ou estrutura do .XML será possivél realizar via Portal.

Passo 1:

Realizar dowloand do Pacote de Expedição Continua, para adequação dos fontes necessário para utilização da New NFS-e e Portal New NFS-e.

Passo 2:

Realizar dowloand do arquivo tssNewNfse.json, para criação da Tabela TSS0013 e população com os devidos Municípios.

Passo 3:

Seguir documentação para Configuração e Implantação da New NFS-e:

  • Após o arquivo tssNewNfse.JSON ser apagado e a tabela TSS0013 ser populada, será criado um parâmetro no ambiente do TSS, Tabela de Parâmetros(SPED000) >> Parâmetro MV_NEWNFSE. Este parâmetro define fluxo de Transmissão, Consulta e Cancelamento da NFS-e, se será pela New NFS-e ou fluxo padrão do TSS.
O parâmetro MV_NEWNFSE é atualizado automaticamente, após a leitura do arquivo tssNewNfse.JSON e criação da tabela TSS0013 ( municípios NewNfse ). Caso o conteúdo do parâmetro MV_NFSEMUN da entidade ( tabela SPED000 campo ID_ENT ) exista na tabela TSS0013 ( campo COD_MUN ), o parâmetro MV_NEWNFSE receberá o conteúdo "S", caso não existe receberá o conteúdo "N"

.


Painel
titleCONSOLIDAÇÃO DE DADOS

Para a apresentação dos dados no Dashbord Dashboard de documentos processados, é necessário que o TSS realize a consolidação dos dados presentes no TSS de forma antecipada à consulta realizada na interface.


Para isso, há a . Esta consolidação dos dados, que é realizada diariamente e de forma automática por um processo internamente que é disparado internamento no TSS, coletando e consolidando todos os documentos transmitidos ao TSS (autorizados ou não pelos órgão(s) governamental(is) responsável(is)).

Totvs custom tabs box
tabs01 - Consolidação de documentos
idsconfig1
Totvs custom tabs box items
defaultyes
referenciaconfig1
Informações
titlePortal New NFS-e.
Informações
titleCOMO CONFIGURAR New NFS-e
Informações
titleObservações:


Âncora
Portal New NFS-e
Portal New NFS-e

Painel
titlePortal New NFS-e - Exemplo de Utilização.


Demonstração pratica de utilização e das principais funcionalidades do Portal New NFS-e.

Totvs custom tabs box
tabs01 - Acessando o Portal New NFS-e, 02 - Page Home, 03 - Page Configurar, 04 - Manutenção no Layout, 05 - De Para_New NFS-e
idspnf1,pnf2,pnf3,pnf4,pnf5
Totvs custom tabs box items
defaultyes
referenciapnf1

Acessando Portal New NFS-e


Para acessar o Portal New NFS-e usuário deve acessar o TSS Interface, portal foi disponibilizado tanto para o Adminstrador quanto para os usuários cadastrados. Foi criado uma nova opção no menu com nome "Portal NEW NFS-e". Para o correto funcionamento do Portal New NFS-e habilitar Porta Multiprotocoloe configurar Comunicação REST.


Informações
titleNota

Observação: O TSS Interface não está disponível para serviços Localizados (Mercado Internacional) e para a versão offline do TSS (TSS Offline). Para Mais informações, acessar documentação relacionado ao TSS Interface.


[Clique na imagem para ampliar]


Configurações de Acesso

Para realizar o acesso às interfaces do TSS é preciso configurar um usuário com acesso ao Sistema, então:

1. Execute o SmartClient do TSS acessando algum aplicativo de interface.

2. No primeiro acesso, faça o login com o usuário ADMIN e senha ADMIN; o aplicativo solicita que seja definida uma nova senha para o usuário ADMIN.

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

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

5. 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.

6. Clique no ícone representado pelo disquete para salvar as configurações.

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

Conteúdo Relacionado

Totvs custom tabs box items
defaultno
referenciapnf2
Informações
titlePage Home do Portal New NFS-e.


Após acessar o Portal New NFS-e a inicialização padrão será direcionado para a Page Home,  atráves dessa pagina conseguiremos acessar a Documentação do Portal New NFS-e através da opção Documentação e a opção Configurar será direcionado para Page Configurar, onde todo o mecanismo do Portal funciona. Na parte superior direita tem um Avatar User,  para sair do Portal quando desejado.


I.  Avatar Use na parte superior do Portal, é o caminho para sair do Portal New NFS-e.

II.  Para acessar a Page Configurar, existe 2 maneiras. Clicando na opção do Menu Configurar ou clicando no card Configurar.

III. Documentação relacionado ao PortalNew NFS-e, será disponibilizada de 2 maneiras. Cliclando na opção do Menu Documentação ou clicando no card Documentação.


[Clique na imagem para ampliar]

Totvs custom tabs box items
defaultno
referenciapnf3
Informações
titlePage Configurar do Portal New NFS-e.


Page Configurar é onde todo o mecanismo do Portal New NFS-e, atráves dela será possivél implementar um novo Município, realizar manutenção no Layout quando necessário e controle dos municipios implementados e os que estão trabalhando pagina conseguiremos.  Na parte superior direita tem um Avatar User para sair do Portal quando desejado, na parte inferior direito tem um Icon .XML para fazer Download de todas as informações carregadas do Município no Card acima.


I.  Avatar Use na parte superior do Portal, é o caminho para sair do Portal New NFS-e.                                                                                                                                                                                                                        

II. Icone Home disponibilizado acima do Card contendo informações do Município, será direcionado para a Page Home.

III.Icone .XML disponibilizado na parte inferior direita do Card Contendo as informações do Município, destina-se a realizar o Download das informações carregadas do Município para melhor visualização e edição do mesmo. Nome do arquivo por padrão será o  Código do IBGE do Município +_ + Nome de Município +_+ UF.XML possibilitando o usuário escolher o diretório e nome.

IV. Campo Procura é onde iremos digitar o Código do IBGE do Município, baseado no código digitado iremos verificar se o mesmo está implementado na New NFS-e e caso não esteja contemplado na New NFS-e iré realizar uma busca na API do Código dos Municípios do IBGE e apresentar Caso o município esteja implementado na New NFS-e irá apresentar as informações no Card ao lado.                                                                                 

                                                                                                                                                                                                                                                                    


[Clique na imagem para ampliar]

Totvs custom tabs box items
defaultno
referenciapnf4
Informações
titleManutenção no Layout da Prefeitura pelo Portal New NFS-e.


Processo para realizar Manutenção no Layout da Prefeitura/Município é simples e é realizado através da Page Configurar do Portal New NFS-e, no campo Procura iremos digitar o Código do IBGE do Município para carregar as informações do Layout do Município no Card ao Lado. Após carregar as informações, escolher a propriedade do Modelo que deseja prestar manutenção por exemplo:  Alteração na URL, Assinatura ou estrutura do .XML e clicarem Detalhes  ser encaminhado para a Page Manutenção e realizar a manutenção necessário para o funcionamento da NFS-e da Prefeitura/Município.


Aviso
titleImportante

Vamos apresentar alguns exemplos de Manutenção no Layout da Prefeitura pelo Portal New NFS-e:

  • Inclusão da Tag para Assinatura do Método Consulta Lote.;
  • Alteração na URL do Ambiente Web Service;
  • Remoção da Tag para o Método de Cancelamento;
  • Correção na Montagem do .XML RPS, para buscar informação correta conforme alteração da Prefeitura.


[Clique na imagem para ampliar]



I.  Avatar Use na parte superior do Portal, é o caminho para sair do Portal New NFS-e.                                                                                                                                                                                                                        

II. Campo Procura é onde iremos digitar o Código do IBGE do Município, baseado no código digitado iremos verificar se o mesmo está implementado na New NFS-e e caso não esteja contemplado na New NFS-e iré realizar uma busca na API do Código dos Municípios do IBGE e apresentar Caso o município esteja implementado na New NFS-e irá apresentar as informações no Card ao lado. 

III. Campo Detalhe é a rota para ser direcionado para a Page Manutenção, onde é carregado a Propriedade do Modelo que deseja prestar manutenção e possibilitando a Edição/Alteração e até mesmo Remoção o conteúdo caso necessário ou caia em desuso ou desativação do processo da Prefeitura/Município.

IV. Campo Voltar utilizado para voltar a Page Configurar com a inteligênciade carregar Automaticamente as informações do Código do IBGE do Município da ocasião.

V.  Campo Editar utilizado para Habilitar/Bloquear a opção de Edição do Layout da Prefeitura.

VI. Campo Gravação utilizado realizar a Gravação do Layout da Prefeitura que foi Editado/Alterado e até mesmo removido o conteudo caso necessário, a alteração será considerado na New NFS-e e irá realizar Notificação de Sucesso, caso a gravação for realizada com sucesso . Após a Notificação ser apresentada com sucesso, será automaticamente redirecionado para a Page Configurar e carregando as informações da Prefeitura/Município da ocasião, já apresentando no modelo da propriedade a informação que sofreu Manutenção.

VII. Icone .XML disponibilizado na parte inferior direita do Card Contendo as informações do Layout da Prefeitura selecionado para Manutenção, destina-se a realizar o Download do Layout da Prefeitura para melhor visualização e edição do mesmo. Nome do arquivo por padrão será o  Nome de Município +_+ UF+_+Propriedade do Modelo.XML possibilitando o usuário escolher o diretório e nome.

Totvs custom tabs box items
defaultno
referenciapnf5
Informações
titleDe Para de NFS-e via Portal New NFS-e.


O conceito da New NFS-e utiliza as estruturas de envio (remessa, consulta lote, consulta por rps, cancelamento). Essa configuração requer um DE/PARA entre as tags do XML Único (TSS) com as tags do XML da Prefeitura (convertido). 

Com a estrutura base em mãos inicia-se o DE/PARA com  o XML único.


Informações
titleNota

Observação: Esse DE/PARA para exemplificar a estrutura de envio do RPS, para as demais estruturas de envio (cancelamento, consulta lote e consulta por RPS ).



O identificador numérico em destaque no colchetes [1[identificacao:numerorps]1] faz parte da chave de pesquisa utilizado para identificar o DE/PARA a ser executado dentro da estrutura JSON configurada na Propriedade xml_depara.



XML_DEPARA:  Campo responsável pelas configurações do seguinte cenário. 1- Estrutura com condicionais de/para possíveis de acordo com o manual da prefeitura. Exemplo:

"items": [ -> Raiz principal

            {

            "id_path": "[5[identificacao:tipotrib]5]", -> Chave id do path configurado na estrutura de envio

            "condicionais": [ -> If/else que serão analisados

{

                       "1": { -> sequencial das condicionais

                                   "formula": "alltrim(cConteudo) == '6'", -> Expressão ADVPL a ser analisada

                                   "return": "1" -> Conteúdo a ser retornado caso a expressão seja verdade

                       },

                       "2": {

                                   "formula": "alltrim(cConteudo) == '2'",

                                   "return": "2"

                       },

                       "3": {

                                   "formula": "alltrim(cConteudo) == '1'",

                                   "return": "3"

                       },

                       "4": {

                                   "formula": ".T.",

                                   "return": "99"

                       }

            }

]

                                  


[Clique na imagem para ampliar]

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titleASSUNTOS RELACIONADOS
HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>