DT Protheus - Criação da tela de parâmetros onde irá buscar no TSS.

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Criação da tela de parâmetros onde irá buscar no TSS.

03. SOLUÇÃO

Foi implementado no ERP Protheus uma nova opção de menu para os documentos NF-e (SPEDNFE) e NFS-e (FISA022), que permite ao usuário através do próprio ERP Protheus modificar o conteúdo de alguns parâmetros do TSS.

No ERP Protheus, a opção de submenu para esta rotina está disponível em: 

Para NF-e

No módulo do Faturamento (SIGAFAT), acessar "Atualizações / NF-e e NFS-e / NF-e Sefaz (SPEDNFE)". Acessar a submenu "Outras Ações / Parâmetros / TSS".

Para NFS-e

No módulo do Faturamento (SIGAFAT), acessar "Atualizações / NF-e e NFS-e / NFS-e (FISA022)". Acessar a submenu "Outras Ações / Parâmetros TSS".

Objetivo

Esta rotina foi desenvolvido com o objetivo de modificar um parâmetro do TSS diretamente do ERP Protheus para a filial/entidade logada no momento.

A lista de parâmetros que possibilitam tal operação é controlada e limitada, com o intuito de não modificar nenhum parâmetro de sistema e que poderia modificar fluxos do TSS no geral e que impactariam à todas entidades. Já outros parâmetros não podem ser alterados devido a lógica de controle do próprio ERP, como por exemplo o parâmetro de ambiente, contingencia e etc.

Tela principal

Pré-requisitos

Parâmetros necessários:

Deve-se criar o parâmetro MV_TSSREST no ERP Protheus, através do configurador e informar neste o endpoint do API REST do TSS. Para mais informações sobre a como configurar APIs no TSS clique aqui.

Exemplo de criação e configuração:

No módulo Configurador (SIGACFG) do ERP Protheus, acessar "Ambiente / Cadastro / Parâmetros". Clicar na lupa para busca do parâmetro.

Caso este não exista basta cria-lo, para isso clicar em "Incluir". Preencher conforme dados abaixo e clicar em "Salvar".

Filial: [em branco para todas as filiais]

Nome de Var.: MV_TSSREST

Tipo: 1-Caractere

Em uso: 1-Sim

Cont. Por: <Informar com endpoint configurado no seu TSS>. Exemplo: http://localhost:1323/api/tss

Descrição: URL Rest do TSS

Acesso à rotina

O acesso à nova rotina, caso o parâmetro de controle de acesso esteja habilitado (MV_ADMNFE para NF-e Sefaz e MV_ADMNFSE para NFS-e) será somente para usuários administradores. Com este controle habilitado, para os demais usuários a rotina não será nem apresentada no menu.

Caso o parâmetro de controle de acesso esteja desabilitado, a rotina será apresentada para qualquer usuário do sistema. 

Ajuste de Parâmetros

Serão apresentados todos os parâmetros existentes para a filial/entidade logada no momento no sistema ERP Protheus.

Somente os parâmetros predeterminados poderão ser alterados. Para identificar estes parâmetros é possível acessar a legenda das bolinhas dando dois cliques na própria bolinha verde ou vermelha, onde:

Verde - Parâmetro editável no Protheus

Vermelho - Parâmetro não editável pela rotina (estes parâmetros pode ser editáveis de outras maneiras através de rotinas do Protheus, como por exemplo o MV_AMBIENTE pode ser alterado através da opção "Outras ações / Parâmetros / NF-e" no qual é apresentado algumas opções como "Ambiente?", "Modalidade?" e etc...

04. DEMAIS INFORMAÇÕES

TSSPARAM - /V1/NFE/TSS/PARAM/:id - GET - API REST para retorno de todos os parâmetros da entidade no TSS

TSSPARAM - /V1/NFE/TSS/PARAM/CONFIG/ - POST - API REST para inclusão e edição de parâmetro para a entidade no TSS

05. ASSUNTOS RELACIONADOS

        Não Há.