Configuração TMS

Objetivos e Âmbito

Esta nova funcionalidade, o TMS, que passa a fazer parte integrante do WPMS, recorre a uma aplicação externa, sendo por isso necessária uma configuração inicial dos sistemas que irão comunicar entre si, bem como de parameterizações especificas que irão ser utilizadas por este “módulo”.

Pretentede-se com esta documento indicar os passos necessários para a configuração inicial do sistema TMS no WPMS.

Ativação do TMS

Foi criado um novo parâmetro de sistema que permite activar/desactivar as funcionalidades directamente ligadas à utilização do TMS. Este parâmetro pode tomar apenas dois valores 1 ou 0, sendo que activa o TMS no caso do seu valor estar a 1.

Nos ecrans seguintes é apresentada a forma de como proceder a esta activação.

Instalação -> Base -> Instalações [IG001]

Selecione a instalação onde pretende ativar o TMS.

Ao clicar no botão (Parâmetros) irá para o écran dos Parâmetros de Sistema:

Clique em (Modificar) e no parâmetro de sistema “usesTMS” colocar o valor “1”.

Guardar a nova configuração usando o botão .

Deverá ser efectuado um restart aos serviços e todos os utilizadores com sessão aberta devem terminar as mesmas e voltar a efectuar login no WPMS.

Criação de um numerador para Extração de contentores

Para que a identificação de cada conjunto de contentores possa ser idêntificada univocamente é necessário criar um numerador que será posteriormente utilizado aquando da solicitação da extração de contentores a enviar para o sistema remoto.

Para tal há que proceder da seguinte forma:

Aplicação -> Elementos Base -> Outros Dados -> Numeradores -> Numeradores [IG015]

Seleccione o botão adicionar

Preencha os campos Numerador, Tipo de Numerador, Número de Caracteres e Estrutura. Ex:

Seleccione o botão para guardar os dados introduzidos. Após a criação do novo numerador deve-se proceder à definição do intervalo do numerador. Seleccione o numerador criado anteriormente e o botão

Após esta seleccção seleccione o botão para adicionar o novo intervalo.

Deve preencher os campos Intervalo, Primeiro Valor, Último Valor. Ex:

Seleccione o botão para guardar os dados introduzidos.

Criação de Sistema Externo

Para que seja possivel a comunicação com o sistema que nos irá devolver dados relativos ao TMS, é necessário que seja criado/configurado um novo sistema externo que autorize o WPMS a comunicar com o “exterior”.

Assm há que proceder da seguinte forma:

Instalação -> Interfaces -> Sistemas Externos [IG004]

Seleccione o botão adicionar

Preencha os campos Sistema Externo e Password. Seleccione o botão para guardar os dados introduzidos.

Cria Objecto/Método com protocolo de dados

Após a criação do sistema externo é necessário indicar o método que irá estar disponivel para o TMS comunicar com o WPMS informando que tem dados optimizados para serem recolhidos.

Assim há que proceder da seguinte forma:

Instalação -> Adaptações Locais -> Objecto/Método com protocolo de dados [IG026]

Seleccione o botão adicionar

Preencha todos os campos com os dados indicados:

  • Objecto: FAPLOG920
  • Método: optimizationReadyCall
  • Sistema Externo: (o sistema externo criado no ponto anterior)Protocolo de Dados: SOAP
  • Endereço do Sistema Externo: (IP indicado pelo fornecedor do serviço)

Seleccione o botão para guardar os dados introduzidos.

Após esta acção deve seleccionar o Objecto/Método FAPLOG920 – optimizationReadyCall e clicar no botão para que seja gerado o WSDL relativo ao método em questão.

Será então apresenta a seguinte mensagem:

Cria Definições Objectos/Métodos remotos

Por outro lado é necessário indicar no WPMS todos os métodos remotos que irão utilizados bem como as definições dos mesmos para que os mesmos possam ser utilizados nos métodos “internos” do WPMS.

Proceda da seguinte forma:

Instalação -> Adaptações Locais -> Definições Objectos/Métodos remotos [IG027]

Seleccione o botão adicionar

Preencha os dados relativos ao objecto e método do WPMS que irá utilizar o método remoto. Indique ainda os dados relativos ao sistema e método remoto a ser utilizado.

Ex:

Seleccione o botão para guardar os dados introduzidos.

Deve repetir esta acção para todos os métodos remotos que deseja usar.

Dúvidas e Outras Questões

Esclarecimento de dúvidas ou outra qualquer questão relacionada com a parametrização e/ ou utilização desta funcionalidade podem ser colocadas ao serviço técnico da Isretail via tel: 211509901 ou pelo e-mail: tech@isretail.eu

Comunicação dos Elementos das Faturas Emitidas por WebService

Objectivos e Âmbito:

Com a entrada em vigor do Decreto-Lei 198/2012 de 24 de Agosto, todas as entidades que emitam documentos valorizados a partir do Wpms são obrigadas a comunicar à Autoridade Tributária e Aduaneira(AT), por transmissão eletrónica de dados, os elementos dos documentos emitidos nos termos do Código de IVA.

O presente manual detalha os processos de parametrização em WPMS e procedimentos ao nível dos sistemas operativo dos servidores aplicacionais, para uma das vias postas à disposição dos contribuintes – a transmissão eletrónica, em tempo real, via web service. Pressupõe que o técnico responsável pela parametrização é alguém devidamente familiarizado com o WPMS e com administração de sistemas operativos.

Criação do utilizador responsável pela invocação do web service

A comunicação dos elementos da fatura via web service é efetuada por utilizadores devidamente qualificados para esse efeito. A respetiva habilitação é efetuada no Portal das Finanças e consiste na criação de um subutilizador de perfíl WFA-Comunicação de dados de faturas do NIF da entidade emitente do documento valorizado a comunicar.

Dado que a invocação do web service é efetuada com recurso às credenciais de autênticação no Portal da Finanças dos subutilizadores WFA anteriormente descritos é necessário guardar em Wpms essa informação. A forma adequada de o fazer consiste na criação de um utilizador especifico por cada entidade emitente e consumidora do serviço de comunicação de faturas existente na instalação do Wpms.

No sentido de concretizar o que anteriormente foi dito admita-se, por hipótese, a existência, numa instalação do WPMS, da entidade “XPTO, SA”, com NIF “100100100” e com subutilizador WFA “777” devidamente criado no Portal da Finanças. Para que o Wpms possa evocar o subutilizador “777” na respetiva invocação do web service será necessário criar em Wpms, o utilizador “100100100777”, o qual deverá ter a mesma password que subutilizador WFA da entidade “XPTO, SA” no Portal da Finanças.

Fica claro que a regra da construção em Wpms do utilizador que invoca o webservice resume-se à concatenação do NIF da entidade com o respetivo código do utilizador WFA parametrizado no Portal da Finanças. Em termos teóricos assim é, mas na prática a volta é necessário mascarar as credenciais de autenticação no Portal das Finanças.

Os écrans seguintes exemplificam a correta criação do utilizador “web service”.

O primeiro passo consistem em criar para a entidade um contacto do tipo “Comunicação Faturas”. Esta trigger permite que os processos batch ou interativos de interface do Wpms saibam que a entidade “XPTO, S.A” é uma emitente de faturas, permite também ligar o subutilizador WFA do NIF da entidade “XPTO, SA” ao código WPMS da mesma entidade organizacional.

Global → Aplicação → Elementos Básicos → Unidades → Organizacionais → Empresas [AG001]

Ao acesso ao écran dos “Contactos” é efetuado no menu “Opções” → “Contactos”, a partir do qual será possível criar, o novo tipo de contacto “Comunicação Faturas”. O valor da sequência deve coincidir com o código do subutilizador WFA no Portal das Finanças.

Por confirmação do écran, cria-se o tipo de contacto “Comunicação Faturas”. O resultado é o seguinte:

Se o primeiro passo consistiu em ligar em Wpms a empresa “XPTO, SA” ao subutilizador WFA do respetivo NIF, o segunda passo, que a seguir se exemplifica, consiste em criar o id do utilizador que invocará o web service.

Global → Instalação → Segurança → Utilizadores [IS001]

A criação do utilizador é feita no écran principal desta transaçã. O acesso ao écran de criação de utilizadores é efetuado no menu “Lista” → “Criar”. Recordamos que o id do nosso utilizador deverá ser o código “100100100777”. Não é necessário indicar nada para além do código sui generis deste utilizador e de uma descrição sucinta condizente com o o fim deste utilizador.

Por confirmação do écran é criado o utilizador.

Fica apenas faltar definir a password especifica para este utilizador, a qual deve ser igual ao do subutilizador WFA no Portal da Finanças. O acesso à criação da password é efetuado em “Opções” “→ Modificar Password”.

Confirmado o écran, o utilizador “100100100777” fica apto a ser utilizado para invocação do web service pelos os processos batch ou interativos de interface do Wpms aquando emissão dos documentos valorizados.

Parametrização do Sistema Externo “AT- Comunicação de Faturas”

Do ponto de vista de interface, os dados do documento comercial emitido são enviados por mensagens do tipo “DOC”. Por isso, o sistema externo a criar exclusivamente para efeito da comunicação da fatura por web service de conter a mensagem tipo “DOC” na respetiva definição. Exemplifica-se a criação de um sistema esterno para evocação do script de interface de invocação do web service de comunicação de faturas.

Global → Instalação → Interface → Sistemas Externos [IG004]

O path indicado serve apenas para indicar a localização do script de saida, no qual evoca-se o web service. O script de saída é da responsabilidade técnica da IsRetail e só deve utilizado quando as mensagens do “DOC” possuem dados de documentos comercial . De seguida deve-se definir, para a mensagem do tipo “DOC”, o endpoint e o serviço invocado na comunicação das faturas. Para esse efeito, deve-se aceder écran “Informações Adicionais” acedível a partir do menu “Opções”.

O valor da ação remota deve ter sempre o valor “RegisterInvoice”. No que toca ao endereço do sistema remoto este pode ter um dos dois seguintes valores:

  1. Ambiente Produção: https://servicos.portaldasfinancas.gov.pt:400/fews/faturas
  2. Ambiente Qualidade: https://servicos.portaldasfinancas.gov.pt:700/fews/faturas

Os endpoints enumerados são os válidos á data. Para evitar constragimentos posteriores diz o bom senso que se deve proceder à respetiva confirmação.

Notas finais

Este manual deve ser complementado com a leitura de toda a documentação disponibilizada no Portal das Finanças sobre esta temática.

Caso após a leitura deste manual ainda subsistam dúvidas contacte o serviço técnico da IsRetail via tel: 211509901 ou por e-mail: tech@isretail.eu