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

                                                                                                                                                                                                                             


          Image Modified          Image Modified

 Image Removed

Image Added

[Clique na imagem para ampliar]


section
Section

VISÃO GERAL

Painel
borderStylesolid
titleVisão geralResumo

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:

  • ModeloModelos 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 

MÍNIMOS
Âncora
requisitos
requisitos
 

Painel
borderColorlightgray
borderWidth1
borderStylesolid
titlePRÉ-REQUISITOS MÍNIMOSConfiguração mínima
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
titlePorta Multiprotocolo e REST 2.0


O Dashboardutiliza a configuração de Appserver REST 2.0. necessita que a Porta Multiprotocolo esteja habilitada e também se faça presente a configuração do REST 2.0 no Appserver do TSS.


Abordaremos estes tópicos a seguir:


Totvs custom tabs box
tabs01 - Porta Multiprotocolo, 02 - REST 2.0
idsconf1,conf2
Totvs custom tabs box items
defaultyes
referenciaconf1
Informações
titlePorta Multiprotocolo


Desenvolvido com novas tecnologias de mercado e recursos avançados o Dashboard garante melhor desempenho, eficiência e segurança. Para o correto funcionamento deste portal e de todos os artefatos é necessário habilitar a Porta Multiprotocolo.

Para isso:

  • Na seção GENERAL, deve-se incluir a chave “App_Environment”, cujo valor deve ser o nome do ambiente onde os serviços serão executados. 
  • Na seção DRIVERS,  deve-se habilitar a porta multiprotocolo na chave “MultiProtocolPort” com o valor = 1.
  • Por padrão a conexão SSL está ativa na porta multiprotocolo, os detalhes das configurações estão disponíveis na documentação Application Server - Porta Multiprotocolo. Para desabilitar a conexão por SSL é necessário informar a chave “MultiProtocolPortSecure = 0”


Bloco de código
firstline1
titleExemplo Appserver.ini
linenumberstrue
[General]
Port=7890
App_Environment=TSS_12.1.2210


[Drivers]
ACTIVE=TCP
MultiProtocolPortSecure=0
MultiProtocolPort=1


Image Added

[Clique na imagem para ampliar]


Para mais detalhes sobre Porta Multiprotocolo, por favor verificar aqui.

Totvs custom tabs box items
defaultno
referenciaconf2
Informações
titleComunicação REST 2.0


Devido a arquitetura simplificada, de plataformas independentes, escalabilidade e desempenho, a comunicação Dashboard com o servidor TSS é realizada através da comunicação REST. Para que essa comunicação ocorra será necessário efetuar algumas configurações no servidor APPServer do TSS. Para maiores informações sobre REST consulte o documento de referenciada da rotina:


Informações
titleEmpresa/Filial

Deve ser informado ao menos uma empresa e filial no cadastro do Mingle

Bloco de código
firstline1
titleExemplo Appserver.ini
linenumberstrue
;===================================================
;======================= REST ======================
;===================================================
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=TSS_12.1.2210

[HTTPV11]
Enable=1
Sockets=HTTPREST
TimeOut=120

[HTTPREST]
Port=1323
IPsBind=
URIs=HTTPURI
Security=0
;Para correto funcionamento do uso de REST com TSS o conteúdo da chave Security não deve ser alterado, permanecendo como 0
;Mais detalhes de uso consulte: https://tdn.totvs.com/x/gkkSCw

[HTTPURI]
URL=/tss/nfse
PrepareIn=ALL
Instances=1,10
CORSEnable=1
AllowOrigin=*
EXPIRATIONTIME=120
EXPIRATIONDELTA=1

;===================================================
;===============  Chamada dos Jobs  ================
;===================================================
[ONSTART]
JOBS = JOB_HTTP,JOB_WS,IPC_ONDEMAND,IPC_CONT,TSSTASKPROC,IPC_SMTP, HTTPJOB
REFRESHRATE=10


Image Added

[Clique na imagem para ampliar]


Para mais detalhes sobre Porta Multiprotocolo, por favor verificar aqui.

PRÉ-CONDIÇÃO

Âncora
CONFIG_PILOTO
CONFIG_PILOTO

Painel
titleCONSOLIDAÇÃO DE DADOSConsolidação de dados


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

Para isso, há a um processo de consolidação dos dados, que é realizada documentos presentes no TSS, realizado diariamente e de forma automática por um processo 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))recepcionados, independentemente do status do documento (autorizado ou não).

Após tal este processamento e de consolidação, os dados são armazenados para posteriormente serem consultados e ter um retorno otimizadoe disponibilizados de forma otimizada para futuras consultas.

Não é necessário nenhum se faz necessária nenhuma configuração adicional para esse tal procedimento, uma vez que que esta está embarcado nos processos realizados pelo TSS. Desta forma, com 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 tal procedimento detalhado anteriormente.


Aviso
titleImportante

Importante ressaltar que, após atualização do sistema TSS, como primeira carga de dados, serão consolidados todos documentos processados desde 01/01/2023 até o dia anterior a data corrente. Todos os dias serão atualizados os valores para o mês atual.


DASHBOARD TSS

Âncora
dashboard
dashboard
Âncora
Portal New NFS-ePortal New NFS-e

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


Demonstração pratica de utilização e das principais funcionalidades do  Portal New NFS-eDashboard de Documento processados pelo TSS.


Totvs custom tabs box
tabs01 - Acessando o Portal New NFS-eDashboard, 02 - Page HomeDashboard Documentos Processados, 03 - Page Configurar, 04 - Manutenção no Layout, 05 - De Para_New NFS-eAcessando Documentação
idspnf1,pnf2,pnf3,pnf4,pnf5
Totvs custom tabs box items
defaultyes
referenciapnf1
Informações
titlePage Acessando Dashborad de Documentos Processados
Acessando Portal New NFS-e


Para acessar

o Portal New NFS-e

o Dashboard usuário deve acessar o TSS Interface

,

. O portal foi disponibilizado tanto para o

Adminstrador

Administrador quanto para os usuários cadastrados.

Foi criado uma

Uma vez dentro do TSS Interface, basta clicar na nova opção

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

Image Removed

[Clique na imagem para ampliar]

de menu com nome "

Portal NEW NFS-e". Para o correto funcionamento do Portal New NFS-e habilitar Porta Multiprotocoloe configurar Comunicação REST.

Dashboard".


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

o TSSINTERFACE.

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.


Image Added

[Clique na imagem para ampliar]

Conteúdo Relacionado

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.  Image Removed Avatar Use na parte superior do Portal, é o caminho para sair do Portal New NFS-e.                                                                                                                                                                                                                        

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

III.Image RemovedIcone .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. Image Removed 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 Image RemovedCaso o município esteja implementado na New NFS-e irá apresentar as informações no Card ao lado.                                                                                 

                                                                                                                                                                                                                                                                    

Image Removed

Image Removed

[Clique na imagem para ampliar]

Totvs custom tabs box items
defaultno
referenciapnf2

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.  Image Removed Avatar Use na parte superior do Portal, é o caminho para sair do Portal New NFS-e.

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

III. Image RemovedDocumentaçã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.

Image Removed

[Clique na imagem para ampliar]

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


Uma vez posicionado dentro da opção de menu Dashboard, basta preencher os parâmetros de filtros:

CNPJ: Informar o código de CNPJ da empresa cadastrada no TSS a qual deseja-se realizar a consulta dos documentos processados por esta empresa. Caso não seja informada a entidade, o sistema irá retornar dados de todas as entidades cujo CNPJ seja igual ao informado, independente dos valores de UF, IE e IDEMPRESA, aglutinando os documentos por CNPJ.

Entidade: Informar o código de entidade TSS para a qual deseja-se realizar a consulta dos documentos processados. Importante: Quando informados os campos CNPJ e ENTIDADE, o campo entidade irá complementar como filtro a mais ao campo CNPJ, desta forma tornando-se uma combinação de dados CNPJ e Entidade como filtro de busca.

Modelos de documento: Informar um ou mais modelos de documento eletrônico que serão levados em conta para apresentação do painel com resultado de volumetria de documentos processados.

Data Inicial - Data Final: Informar a data completa inicial e data completa final (range) de processamento de documentos processados no TSS a serem considerados para apresentação de resultados.

Importante destacar que apesar de ser possível informar o dia especifico do mês, este não será considerado como filtro, sendo considerado o mês completo. Também não serão considerados meses excedentes à 3 meses a partir da data inicial.

Exemplo 1:

Data inicial: 15/01/2023

Data final: 25/03/2023 

A consulta será realizada para o meses completos: 01/01/2023 à 31/03/2023.


Exemplo 2:

Data inicial: 15/01/2023

Data final: 25/06/2023 

A consulta será realizada para o meses completos: 01/01/2023 à 31/03/2023.


Após preenchimento dos parâmetros de filtro, o botão Pesquisar é habilitado para que efetivamente seja realizada a consulta da volumetria dos documentos informados.


A seguir, vídeo com exemplo da interface em funcionamento:

Image Added

[Clique na imagem para ampliar]


Aviso
titleImportante

Para o mercado internacional utilizar o campo entidade e selecionar os modelos de documentos internacionais (REMITO ou FACT) irá retornar a quantidade desses documentos caso possuir dados.

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 ProcuraImage Removed 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  Image Removedser 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.

Image Removed

[Clique na imagem para ampliar]

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

II. Image Removed 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 Image RemovedCaso o município esteja implementado na New NFS-e irá apresentar as informações no Card ao lado. 

III. Image Removed 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. Image Removed 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.  Image Removed Campo Editar utilizado para Habilitar/Bloquear a opção de Edição do Layout da Prefeitura.

VI. Image Removed 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 Image Removed. 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. Image RemovedIcone .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
referenciapnf5pnf3
Informações
titleDe Para de NFS-e via Portal New NFS-e.Page Documentação


Na rotina de Dashboard temos mais uma opção de menu que é a Documentação. Esta opção basicamente leva o usuário ao documento mais atualizado sobre a interface de Dashoboard.

Image Added

[Clique na imagem para ampliar]

Totvs custom tabs box items
defaultno
referenciapnf4
Informações
titlePage Documentação


Na rotina de Dashboard temos mais uma opção de menu que é a Documentação. Esta opção basicamente leva o usuário ao documento mais atualizado sobre a interface de Dashoboard.

Image Added

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

Image Removed

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>