Manual de Integração

Retail Manager
Versão 1.4
Setembro de 2022
Índice
Introdução ................................................................................................................................ 4
Versões Compatíveis .............................................................................................................................................. 4

Diagrama de Comunicação ................................................................................................................................... 4

Regras de Integração ............................................................................................................................................. 5

Instalação ................................................................................................................................. 6
Instalação do Web Service ..................................................................................................................................... 6

Definições Regionais .............................................................................................................................................. 8

Configuração do Sistema ........................................................................................................ 9

Assistente de Configuração ................................................................................................................................... 9

Configuração do Web Service .............................................................................................................................. 10

Configuração da Integração no ERP ..................................................................................... 11

Configurações ....................................................................................................................................................... 11

Organização .......................................................................................................................................................... 12

Grupos ...........................................................................................................................................................................12
Empresas .......................................................................................................................................................................12
Lojas ...............................................................................................................................................................................13
Terminais .......................................................................................................................................................................13

Configuração do acesso TCP/IP aos Terminais .................................................................... 15

Regras de Configuração ....................................................................................................................................... 15

Perímetro de Sincronização ................................................................................................................................ 18

Filtro de Famílias ..........................................................................................................................................................18

Mapeamentos ....................................................................................................................................................... 18

Caixas e Bancos .................................................................................................................................................... 19

Documentos para Integração Financeira e Logística ....................................................................................... 19

Tesouraria .....................................................................................................................................................................20
Vendas ...........................................................................................................................................................................20
Compras ........................................................................................................................................................................21

Retail Manager 2
 Conta Corrente .............................................................................................................................................................21
Mapeamento dos Documentos ........................................................................................................................... 21

Meios de Pagamento ............................................................................................................................................ 23

Unidades ............................................................................................................................................................... 23

IVA .......................................................................................................................................................................... 23

Impostos Especiais ............................................................................................................................................... 24

Motivos Estorno .................................................................................................................................................... 24

Sincronização ......................................................................................................................... 24
Sincronização Manual .......................................................................................................................................... 24

Sincronização Automática ................................................................................................................................... 25

Consulta ao Sistema Central ................................................................................................ 25

Ficheiros distribuídos no Pssst!/Tlim .........................................................................................................................26
Ficheiros distribuídos no Web Service.......................................................................................................................27

Anexo 1 – Imagens de artigos ............................................................................................... 30

Retail Manager 3
Introdução
A aplicação Retail Manager tem como objeto integrar os dados introduzidos no Pssst!/Tlim (Frontend de ponto
de venda) com o ERP PRIMAVERA (Backoffice financeiro).

A integração é do tipo Financeira e Logística, ou seja, permite integrar a informação operacional e financeira.
Na informação operacional estão incluídos os movimentos de stock e de vendas que são integrados
individualmente, bem como os movimentos de caixa. Já na informação financeira são integrados todos os
dados de faturação, caixas, bancos, contas correntes de clientes e contas correntes de fornecedores no ERP
PRIMAVERA.

Versões Compatíveis
Para utilizar o Retail Manager é necessário garantir as versões compatíveis com o software PRIMAVERA.
Relativamente ao ponto de venda, é importante assegurar que existe uma versão completa de um dos
produtos Pssst!/Tlim (não disponível nas versões Easy ou Express) nas distribuições Linux ou Windows.

Do lado do backoffice financeiro, deverá ter instalada a versão 10 do ERP PRIMAVERA.

Nota importante: A versão do ERP PRIMAVERA deverá ser Professional ou Executive e na sua subscrição
deverá existir a licença de TEC.MTR. Além disso, deverão também ser licenciados os restantes módulos que tem
acesso. Para saber mais informações, sugere-se a consulta do artigo de apoio no Help Center V10.

Diagrama de Comunicação

Retail Manager 4
O diagrama de comunicação representa os atores presentes na integração de dados entre o ponto de venda e
o backoffice financeiro:

Frontend
O Pssst!/Tlim poderá estar a operar como um posto isolado ou em rede, sendo que em rede apenas o posto
servidor precisa de comunicar com o Retail Manager. A comunicação é realizada através de um WebService.

Middleware
O Retail Manager permite intregrar com o:

• POS: Integra dados entre o frontend e a base de dados intermédia;

• ERP PRIMAVERA - Integra dados da base de dados intermédiA, recorrendo aos motores de integração
do mesmo;

Backoffice financeiro
No ERP PRIMAVERA não é necessário efetuar qualquer operação para que a integração seja realizada com
sucesso, uma vez que todo o fluxo necessário é efetuado pelo Retail Manager, recorrendo aos motores do ERP.

Regras de Integração
Existe um conjunto de regras para que a integração possa ocorrer com sucesso, nomeadamente:

1. A criação de artigos é realizada exclusivamente no ERP

Todos os artigos devem ser criados no ERP e posteriormente integrados.

2. A edição de artigos no Pssst!/Tlim está limitada

Para o correto funcionamento, algumas propriedades (tais como o código, descrição, preços e stocks)
não devem ser editadas no Pssst!/Tlim, sendo possível alterar outras propriedades. As regras de
integração impõem que a gestão de preços e stocks seja efetuada exclusivamente no ERP.

3. Gestão de Preços
Os preços de venda no Pssst!/Tlim são definidos e alterados exclusivamente no ERP.

4. Artigos Isentos de IVA

No Pssst!/Tlim, o código do motivo de isenção deverá corresponder ao código oficial do Motivo de
Isenção (consultar mais informações junto da Autoridade Tributária). No ERP é necessário garantir que
no artigo está atribuída a taxa de IVA isenta com o motivo corretamente preenchido.

5. Gestão de Stocks
A gestão de stocks é efetuada exclusivamente no ERP PRIMAVERA. Sempre que ocorrer uma integração
de dados, os valores de stocks dos artigos no Pssst!/Tlim são atualizados com os valores de stock desse

Retail Manager 5
 artigo no armazém mapeado para o terminal.
Desta forma, os valores de stocks estarão sempre atualizados de acordo com o armazém, ainda que
não tenham existido entradas de artigos no Pssst!/Tlim.

6. Famílias e Subfamílias
As Famílias do ERP são utilizadas para indicar quais os artigos a integrar no terminal. Assim, apenas os
artigos existentes nas famílias selecionadas serão integrados no terminal. As subfamílias selecionadas
são mapeadas para as Famílias do Pssst!/Tlim e todos os artigos das famílias selecionadas são criados
no Pssst!/Tlim.

7. Os clientes criados no ERP não são integrados no Pssst!/Tlim

Apenas as fichas de cliente criadas no Pssst!/Tlim são criadas no ERP PRIMAVERA. No entanto, as fichas
criadas no ERP, incluindo as alterações de dados, não são automaticamente criadas no Pssst!/Tlim.
Por exemplo, quando desativa um cliente no ERP PRIMAVERA, esta alteração não é refletida no
Pssst!/Tlim.

8. Documentos Anulados
A anulação de documentos não é suportada em ambientes integrados. Desta forma, deverá ativar o
parâmetro POSI = 1 no ficheiro de configurações (config.flg) do POS para impedir que o operador possa
anular documentos. Como alternativa, deverá emitir uma Nota de Crédito para anular documentos.

Instalação
Ao instalar o Retail Manager será também instalado um Web Service e, para o correto funcionamento do
mesmo, deverá instalar manualmente a plataforma .NET Core Runtime & Hosting Bundle (download aqui).

Instalação do Web Service

Deverá garantir que tem o IIS (Internet Information Service) instalado e configurado.

Para instalar o Web Service, siga os seguintes passos:

1. Aceder ao Painel de Controlo da máquina e selecionar a opção Programas;

Retail Manager 6
 2. No canto superior esquerdo, em Programas e Funcionalidades clicar em Ativar ou desativar
funcionalidades do Windows;

3. Nas funcionalidades do Windows apresentadas, ativar a opção Serviços de Informação Internet;

Para o correto funcionamento do Web Service deverá também ativar as funcionalidades relacionadas:

• Ferramentas de gestão Web:

- Metabase do IIS e compatibilidade de configuração IIS
- Consola de gestão do IIS.

Retail Manager 7
 • Funcionalidades de desenvolvimento de aplicações:
- .NET Extensibility 4.x;
- ASP .NET 4.x;
- Extensões ISAPI;
- Protocolo de WebSocket.

• Segurança:
- Autenticação básica;
- Autenticação Windows.

Definições Regionais
Para o correto funcionamento de todo o processo, nomeadamente o formato da data, é necessário garantir
que as definições regionais estão devidamente configuradas para Portugal.

Para editar as definições regionais, siga os seguintes passos:

1. Aceder ao Painel de Controlo e selecionar a opção Região;
2. No separador Formatos, selecionar a opção Português (Portugal) e o formato dd/MM/yyyy;
3. No separador Localização, escolher a opção Portugal;
4. No separador Administração, alterar a região para Português (Portugal). Após esta alteração, será
pedido para reiniciar o computador;
5. Depois de reiniciar o computador, abrir novamente o separador Administração;
6. Clicar em Copiar Definições;

Retail Manager 8
 7. Ativar as opções Ecrã de boas-vindas e contas do sistema e Novas contas de utilizador.

Configuração do Sistema
Assistente de Configuração
Após instalar a aplicação, ao aceder pela primeira vez será apresentado um Assistente que o irá auxiliar em
todos os passos de configuração. Deverá introduzir todos os dados e credenciais solicitados para que a aplicação
funcione corretamente.

Para configurar a aplicação, siga os seguintes passos:

1. Abrir a aplicação;

2. Clicar em Seguinte;

3. Na janela Servidor de Dados, definir o servidor SQL onde a base de dados ficará alojada. Este servidor
tem de ser o mesmo servidor onde se encontra a base de dados do ERP PRIMAVERA. Através do botão
disponível no lado direito, poderá pesquisar os servidores disponíveis;

4. Inserir o nome do Utilizador utilizado para aceder ao SQL Server e a respetiva Palavra-passe;
5. Introduzir a Base de Dados a utilizar, sendo possível usar uma já existente através de um ícone
disponível para o efeito ou criar uma base de dados introduzindo o nome a atribuir à base de dados e
clicar no ícone à direita da caixa de texto;
6. Definir o Timeout, ou seja, o tempo limite para a execução da instrução SQL. Se não existir a necessidade
de configurar este valor, é recomendado que este permaneça com o valor 0;
Nota: Todas as informações referidas anteriormente são importantes porque permitem aceder à base
de dados do Retail Manager;

7. Clicar em Seguinte;

8. Indicar o Utilizador usado para aceder ao ERP PRIMAVERA v10 e a respetiva Palavra-passe;

9. Ativar a opção Login automático para que não seja apresentado o ecrã de autenticação na iniciação da
aplicação;

10. Clicar em Seguinte;

11. Nas configurações do correio eletrónico, inserir o Email do utilizador que será usado para o envio de
notificações e a respetiva Palavra passe;
12. Inserir o Servidor SMTP de email que será utilizado para envio de notificações;
13. Introduzir o número da Porta usada pelo serviço de SMTP;
14. Ativar a opção Usa SSL caso o serviço de email utilizado obrigue a uso de SSL;
15. Clicar em Seguinte;

Retail Manager 9
 16. Nos Destinatários de mensagens automáticas, inserir o email para o qual será enviado o relatório de
sincronização no campo Todas as notificações, bem como o email para o qual será enviado o relatório
de sincronização em caso de erro no campo Notificações de erro.

Configuração do Web Service

Para iniciar a configuração do Web Service, deverá editar as credenciais do ficheiro Web.config disponível na
pasta “.../PeT100/Web/PeTRest/”, nomeadamente, o nome do servidor após “Data Source=”, o nome da base
de dados após “Initial Catalog=” e, por fim, as credenciais do SQL em “Id=” e “password=”.

Para configurar o WebService no Pssst!/Tlim, siga os seguintes passos:

1. Aceder a Sistemas | > | Configurações | Serviços Cloud;

2. No separador Serviço Cloud – Sincronização de dados, indicar o Endereço URL do Web Service. Em
caso de dúvidas, poderá consultar o Browse Website do site PeTRest no Internet Information Services (IIS)
Manager;

3. Inserir o Id. Empresa (nome) do ERP PRIMAVERA;

4. Identificar o Id. Loja e o Id. Terminal com o máximo de três caracteres, respetivamente. Estes nomes
correspondem aos códigos de loja utilizados na configuração da loja no Retail Manager;

5. Selecionar as opções pretendidas:

• Sincronização ativa;

• Arranque aplicação: ativa a sincronização com o Web Service no arranque da aplicação;

• Fecho aplicação: ativa a sincronização com o Web Service no fecho da aplicação;

• Fecho caixa: ativa a sincronização com o Web Service após o fecho do caixa;

• Gravar documento: ativa a sincronização com o Web Service após a gravação de um documento;
Nota: Poderá configurar os dados a sincronizar a qualquer momento.

6. Para verificar se o Web Service está devidamente configurado poderá clicar na opção Testar. Em caso
positivo, será apresentada a seguinte mensagem: “Resposta ao ping:” seguido da data e hora. Na segunda
linha, é apresentado o texto “SQL”. É necessário editar as credenciais da base de dados do SQL do Retail
Manager no ficheiro PRIWSConfig na pasta “.../PeT100/Web/PeTRest/bin/cfg” disponível na pasta de
instalação do Retail Manager;

7. Editar o ficheiro e inserir o nome do servidor após “Data Source=”, o nome da base de dados após “Initial
Catalog=” e, por fim, as credenciais do SQL em “Id=” e “password=”;

8. Reiniciar o serviço IIS;

Retail Manager 10
 9. Clicar em Testar.
Deverá ser apresentada uma notificação com duas datas e horas, indicando o sucesso desta operação.

Configuração da Integração no ERP

Configurações
No ERP, em Integração | Configurações | Servidor de Dados são definidas as credenciais de acesso à base
de dados do Retail Manager.

No separador Integração, são definidas as credenciais de acesso ao ERPv10 e é possível configurar a

sincronização automática, selecionando as seguintes opções:

• Não valida artigos inativos: com esta opção não irá controlar os artigos ativos ou inativos na integração,
tornando a atualização/importação mais ágil. É recomendar ativar esta opção para a primeira importação
quando existe grande volume de artigos;

• Não integra movimentos de caixa: não integra movimentos de tesouraria;

• Não integra liquidações automáticas: não líquida os documentos de faturação com base nos
movimentos de tesouraria. Esta opção deve ser ativada sempre que são usados tipos de documentos
com liquidação automática configurada no ERP;

• Início automático: inicia a o processo de sincronização dos terminais automaticamente;

• Encerra aplicação após sincronização: após a sincronização dos terminais, irá encerrar o Retail
Manager;

• Integração continua: a sincronização dos terminais é realizada periodicamente. O período de integração

é definido no campo Intervalo, sendo que o valor mínimo recomendado é de 120 segundos;

• Lotes: neste campo, poderá escolher uma das seguintes opções:

- Não utiliza lotes: a empresa não irá controlar os lotes de artigos quer no ERP quer no POS;
- Usa lotes apenas no ERP: a empresa irá controlar os lotes de artigos apenas no ERP. Do lado do POS

Retail Manager 11
 não é efetuado nenhum controlo aos lotes de artigos, sendo a integração de artigos com lote efetuada
de acordo com as regras configuradas no ERP;
- Usa lotes no ERP e no POS: importa os lotes do ERP para o POS no momento da venda. Caso o
artigo movimente lotes, o POS irá questionar o operador para saber qual o lote que está a ser vendido,
sendo essa informação apresentada no momento da integração com o ERP;

• Extensão imagens: define as extensões de imagens a integrar (ver Anexo 1);

• Ignora caracteres quer no código de barras principal como no alternativo;

• Importação de dados do ERP: define a hora a partir da qual é efetuada a importação;

• Integração de dados do ERP: define a hora a partir da qual é realizada a integração. É possível ainda
definir se é validada a numeração para os documentos de venda, compra ou internos.

Nota: Estas opções devem ser corretamente configuradas uma vez que podem afetar o
desempenho do POS e a normal utilização do mesmo por parte do operador. De referir que a
importação de tabelas com elevada densidade de registos em horário produtivo pode implicar
períodos de inatividade. Dessa forma, poderá definir o horário mais adequado para restringir
operações de integração ou importação mais “pesadas” fora das horas produtivas.

No separador Correio eletrónico, deverá definir a conta para o envio de mensagens bem como os endereços
eletrónicos para os quais é enviado o relatório de sincronização.

Organização
No separador Organização, é possível aceder a uma visão geral das empresas disponíveis no ERP
PRIMAVERA, assim como o estado, o grupo a que pertence, as lojas da empresa e seus terminais.

Após gravar a informação como grupos, lojas ou terminais, é possível consultá-la diretamente clicando na
caixa pretendida. Por exemplo, para visualizar a informação de um terminal deverá clicar diretamente na
coluna “Cód. Terminal” ou “Terminal”. Assim, a aplicação irá abrir automaticamente o separador Terminais com
a informação do terminal carregada.

Grupos
As empresas com características similares são agrupadas no mesmo grupo, que é constituindo por um código
e uma descrição.

Empresas
No quadro de configuração da empresa, deverá preencher os seguintes dados:

1. Código: código e descrição da empresa;

2. Grupo: grupo ao qual a empresa pertence;

Retail Manager 12
 3. Formato contabilístico das entidades: número de dígitos para a criação das entidades na Contabilidade
(para contemplar seis dígitos deverá indicar 000000);

4. CDU de preços tem IVA incluído: se ativo, os campos criados têm o valor do IVA incluído;
5. Mapeamento de entidades: escolher o modo de integração dos clientes:
• Utiliza como critério o NIF de cliente;

• Utiliza como critério o código Entidade Externa;

• Utiliza como critério o NIF de cliente, ordenado por campo definido no Retail Manager. Desta
forma, caso existam clientes com o mesmo NIF (por exemplo, uma cadeia de lojas), o ERP saberá
qual a regra a utilizar na integração.

Para guardar as configurações, deverá clicar em Gravar.

Lojas
Após a configuração da empresa, deverá criar a loja. Para tal, siga os seguintes passos:

1. Clicar em Novo;

2. Introduzir um Identificador para a loja e a respetiva Descrição;

3. Para selecionar a empresa à qual a loja pertence, na caixa de texto Empresa clicar em F4 ou diretamente
no ícone F4 com o rato. Posteriormente, deverá selecionar a empresa na tabela apresentada;

4. Indicar a Morada e Localidade;

5. Clicar em Gravar.

Terminais
Após criar a loja, é necessário associar cada terminal do Pssst! / Tlim à Conta Corrente (cliente aberto no
ERPv10) e à Caixa.

Retail Manager 13
Na área Terminais deverá configurar toda a informação presente nos diversos separadores.

Separador Geral:

• Terminal: código e nome atribuídos ao terminal a configurar;

• Ativo: Indica o estado do terminal (Ativo/Inativo), sendo que os dados do terminal só serão integrados se
esta opção estiver ativa;

• Endereço IP: endereço utilizado para a importação dos dados do Pssst!/Tlim. A configuração deste
endereço tem o formato Endereço: porta. De referir que deverá ser possível aceder ao Pssst!/Tlim a
partir deste endereço e, dessa forma, deverão ser tidas em consideração as definições de rede e firewall;

• Loja: loja à qual este terminal pertence;

• Empresa: empresa à qual a loja pertence;

• Localização: localização do terminal - Continente, Açores ou Madeira;

• Conta corrente terminal: cliente do ERP PRIMAVERA correspondente ao terminal do Pssst!/Tlim;

• Cliente indiferenciado: cliente do ERP PRIMAVERA que corresponde ao cliente indiferenciado;

• Localização do armazém: armazém e localização do armazém utilizados para a criação dos documentos
de compras;

• Moeda base: moeda base da empresa;

• Tam. código Famílias e Artigos: tamanhos definidos no terminal para os códigos de famílias e artigos,
disponível Psss!/Tlim em Sistema | Configurações | Gerais | Botões. O valor deverá ser igual ao que
está definido nas propriedades Tamanho dos códigos. Esta configuração é necessária para que o Retail
Manager possa criar no Pssst!/Tlim os novos códigos oriundos do ERP PRIMAVERA. No Pssst!/Tlim, o
código dos artigos criados via Retail Manager incluem o código da respetiva família;

Retail Manager 14
 • Forçar envio de documentos/recolha de dados: permite definir uma hora a partir da qual são
enviados documentos e recolhidos dados. Estas opções podem ser utilizadas caso não esteja
configurado o envio de documentos / recolha de dados na abertura e/ou fecho de caixa, assegurando
assim que existem sincronizações regulares. Também poderá inserir uma hora a partir da qual estas
operações sejam executadas dado que podem causar um fluxo de dados denso. Desta forma, mitiga-se
que o POS, integrador ou mesmo o ERP estejam com recursos ocupados durante o horário produtivo,
mantendo assim uma boa fluidez na utilização do POS e restantes aplicações.

Após configurar o terminal, é necessário efetuar mapeamentos das diversas figuras envolvidas no processo de
integração de dados, descrito abaixo.

Configuração do acesso TCP/IP aos Terminais

O acesso aos terminais Pssst!/Tlim é realizado através de um protocolo TCP/IP, possibilitando o acesso a
qualquer terminal com acesso à internet.

Na implementação do Retail Manager, deverá ter em consideração as seguintes configurações importantes:

• A configuração suporta endereços IP e resolução de nomes, permitindo tanto o uso de IPs fixos como de
serviços do tipo DynDns ou NoIP;

• Os terminais devem ter o porto 8808 aberto para que seja possível comunicar com a loja;

• A opção Aceita comandos via ETCOM tem de estar ativa disponível em Sistema | Configurar | Rede |
Posto.

Regras de Configuração
1. Terminal do Pssst!/Tlim
Uma vez que este conceito não existe com o mesmo formato no ERP PRIMAVERA, para uma correta
integração devem ser criados os seguintes elementos:

• Armazém (o mesmo armazém pode ser utilizado em diferentes terminais);

• Caixa do terminal;
• Conta “cliente”;
• Séries de Documentos (as séries são criadas no Retail Manager).

2. Documentos
O mapeamento dos documentos do Pssst!/Tlim com os do ERP PRIMAVERA é realizado manualmente,
ou seja, para cada tipo de documento do Pssst!/Tlim deverá indicar qual o documento correspondente
no ERP.

Retail Manager 15
 No ERP não é necessário criar documentos específicos para a integração. Poderá utilizar os
documentos já existentes, uma vez que a unicidade da numeração será garantida pela série associada a
cada documento/terminal. Contudo, deverá existir um mapeamento de documentos por cada ano de
trabalho aberto no Pssst!/Tlim.

Além dos documentos existentes no Pssst!/Tlim, é também necessário indicar alguns documentos
específicos do ERP PRIMAVERA, bem como do processo de integração, designadamente:
Documentos Gerais
• Tesouraria;
• Abertura de Caixa;
• Fecho de Caixa;
• Entrada em Caixa;
• Saída de Caixa.
Integração Financeira e Logística
• Vendas;
• Compras;
• Documentos financeiros cliente;
• Documentos de tesouraria;
• Movimentos de stock;
• Documentos de stock.

3. Modos de Pagamento (Movimentos Bancários)

A integração dos modos de pagamento no ERP PRIMAVERA é realizada com base nos códigos do
Pssst!/Tlim, adicionando o sufixo “P” ou “R” consoante no ERP se trate de um modo de pagamento a
pagar (P) ou a receber (R). Estes sufixos são utilizados nestas integrações dado que no Pssst!/Tlim o
tipo de movimento é determinado pelo documento ao qual está associado (para cada modo de
pagamento do Pssst!/Tlim existem dois movimentos bancários no ERP PRIMAVERA).

No ERP, em todos os modos de pagamento os movimentos devem estar configurados como

Numerário, com exceção dos cheques. Durante a integração são também identificados os cheques pré-
datados e são tratados de acordo com as suas especificidades. Neste processo, é também necessário
criar dois movimentos bancários no ERP PRIMAVERA para tratar as caixas dos terminais,
normalmente designados por Genérico a Crédito e Genérico a Débito.

4. Destinos dos Meios

Este mapeamento é sempre configurado manualmente e indica, por cada terminal, qual a Caixa ou
Banco do ERP PRIMAVERA em que serão lançados os movimentos bancários oriundos do Pssst!/Tlim.

Retail Manager 16
 5. Clientes
A integração dos clientes provém do Pssst!/Tlim para o ERP PRIMAVERA e é realizada através do código
do cliente o P&T. No ERP, esse código é composto por dois elementos:
• Código do terminal: até três caracteres, seguidos de um ponto;
• Código do cliente (00000001,00000002,00000003,00000004): oito dígitos.

Por exemplo, o cliente número 23 do terminal T01 será o cliente T01.00000023 no ERP PRIMAVERA.

Sempre que criar um cliente no Pssst!/Tlim, este é integrado no ERP PRIMAVERA e, durante a integração,
será verificada a existência prévia de algum cliente com o mesmo NIF:
• Caso não exista ou o cliente do Pssst!/Tlim não possua NIF, será criada uma ficha de cliente no
ERP;
• Caso o NIF exista no ERP, então o cliente criado no Pssst!/Tlim será mapeado para o cliente já
existente e os respetivos dados serão atualizados.

Nota importante: Todas as alterações efetuadas na ficha de um cliente no Pssst!/Tlim não são
refletidas no ERP PRIMAVERA. O mesmo se aplica se realizar alterações na ficha do cliente no ERP.

6. Artigos

Os artigos são sempre integrados do ERP para o Pssst!/Tlim, ou seja, os artigos são criados/alterados no
ERP PRIMAVERA e, posteriormente, integrados no frontend.
O Retail Manager irá integrar no Pssst!/Tlim o subconjunto de artigos pertencente à(s) família(s) de
artigos indicada no ponto 8.

Quando já existem artigos criados no Pssst!/Tlim e estes não podem ser eliminados (porque, por
exemplo, já foram usados em documentos), é necessário mapear esses artigos.
7. Seleção das Famílias
Conjunto de configurações das famílias existentes no ERP PRIMAVERA que serão usadas para mapear
e integrar com o Pssst!/Tlim. Apenas os artigos pertencentes a estas famílias serão criados no
Pssst!/Tlim.
8. Famílias
As famílias de artigos no Pssst!/Tlim devem ser mapeadas para subfamílias no ERP PRIMAVERA.

9. Fornecedores (apenas para integração financeira)

Tal como no caso dos clientes, o mapeamento dos fornecedores entre o Pssst!/Tlim e o ERP
PRIMAVERA é realizado pelo NIF. Sempre que um determinado NIF não exista no ERP PRIMAVERA ou o
fornecedor não tenha o NIF definido no Pssst!/Tlim, será criada uma ficha de fornecedor no ERP.

Por predefinição, apenas são abertos no ERP os fornecedores que tenham movimentos no Pssst!/Tlim.
Nota importante: Todas as alterações efetuadas na ficha de um fornecedor no Pssst!/Tlim não são
refletidas no ERP PRIMAVERA. O mesmo se aplica se realizar alterações na ficha do fornecedor no ERP.

Retail Manager 17
Perímetro de Sincronização
No separador Perímetro de sincronização, é possível consultar uma visão geral das famílias existentes no
ERP PRIMAVERA. Ao clicar em Visualizar Resultado, é apresentada uma tabela com todos os artigos
pertencentes às famílias.

Filtro de Famílias
A integração das famílias para o terminal pode ser editada através da opção Filtro de Famílias. É ainda possível
recorrer a uma instrução SQL em que apenas são inseridas as condições utilizadas na cláusula “WHERE”,
realizando assim uma importação das famílias mais personalizada a cada terminal. Os filtros podem ser
aplicados juntamente com a instrução SQL ou ambos, de acordo com a opção selecionada em Forma de
aplicação de filtros.

Após alterar esta configuração, deverá correr uma nova sincronização com o terminal para aplicar as
alterações no Pssst!/Tlim. Poderá consultar o resultado desta sincronização através da opção em Visualizar
Resultado.

Mapeamentos

Caso tenham sido criados campos de utilizador (CDU) na tabela de artigos do ERP PRIMAVERA, poderá mapear
os campos existentes na tabela de artigos no POS na área Artigos pata garantir a coerência deste tipo de
dados.

Por exemplo, criar um CDU na tabela “Artigos” com o nome CDU_PedeObs e definir a expressão SQL seguinte:

select * from (

SELECT 'N' as 'Código' , 'Não' as 'Descrição'

UNION SELECT 'S' as 'Código' , 'Sim' as 'Descrição'

UNION SELECT 'O' as 'Código' , 'Obriga' as 'Descrição'

UNION SELECT '' as 'Código' , 'Não Altera' as 'Descrição') X

O campo Pede Observações poderá ser mapeado com o campo CDU_PedeObs, criado anteriormente na
tabela de artigos do ERP PRIMAVERA.

Retail Manager 18
Já no grupo Preços poderá efetuar um mapeamento entre a tabela de preços do Pssst!/Tlim e a tabela de
preços do ERP PRIMAVERA.

Para garantir a sincronização de dados, deverá mapear no mínimo uma tabela de preços, sendo que a tabela
de preços do ERP deverá estar configurada para ter IVA incluído.

Caixas e Bancos

Neste separador, é possível indicar qual a conta Caixa ou Banco a utilizar para lançar um modo de
pagamento. Assim, deverá escolher a Caixa/Banco do ERP PRIMAVERA através da tecla F4 para indicar qual o
modo de pagamento do Pssst!/Tlim a lançar.

Por predefinição, todos os modos de pagamento são lançados na caixa do terminal (Caixa pré-definido do
terminal). Contudo, é possível alterá-la selecionando a Caixa/Banco ERP PRIMAVERA no modo de pagamento
pretendido.

Caso pretenda criar uma caixa para o terminal, deverá clicar em Criar Caixa.

Documentos para Integração Financeira e Logística

Na Integração Financeira e Logística, os documentos abaixo devem estar disponíveis na configuração. Caso
não existam, deverá criá-los no ERP PRIMAVERA, sendo que a criação/configuração dos tipos de documentos
não implica a criação de séries, já que estas podem ser criadas pelo Retail Manager aquando da configuração.

Retail Manager 19
Tesouraria

Documento Tipo Documento Série

Entrada de Caixa Movimento em Conta Criada pelo Retail Manager

Saída de Caixa Movimento em Conta Criada pelo Retail Manager

Abertura de Caixa Movimento em Conta Criada pelo Retail Manager

Fecho de Caixa Movimento em Conta Criada pelo Retail Manager

Doc. Tesouraria Movimento em Conta 1 Série

Vendas
Liquidação
Documento Tipo Documento Permitido a Natureza Estado
Automática

Clientes a Crédito
Financeiro Clientes A pagar Pendente Não
(ex: Nota Crédito)

Clientes a Débito
Financeiro Clientes A receber Pendente Não
(ex: Fatura Simplificada)

Retail Manager 20
Compras
Sujeito a
Documento Tipo Documento Permitido a Natureza
Conversão

Fornec. a Crédito Financeiro Fornecedores;

A pagar Sim
(ex: Compra) (Ligação Contas Correntes) Indiferenciado

Conta Corrente
Documento Tipo Documento Permitido a Natureza Utilizado em

Liquidação Clientes; Conta Clientes

Liquidação Recebimento
(Ligação Tesouraria) Outros Dev. - Pendentes

Liquidação Conta Fornecedor

Pagamento Fornecedores Pagamento
(Ligação Tesouraria) - Pendentes

Mapeamento dos Documentos

Retail Manager 21
O mapeamento dos documentos do Pssst!/Tlim com os documentos do ERP PRIMAVERA é realizado
manualmente, ou seja, para cada tipo de documento do Pssst!/Tlim deverá indicar qual o documento que lhe
corresponde no ERP:

Documentos de Movimento de Caixa

Para estes documentos deverá escolher o tipo de documento ERP PRIMAVERA através da tecla de atalho F4.

Documentos de Tesouraria

Neste caso, deverá mapear o documento de tesouraria utilizado para lançar movimentos bancários.

Documentos de Composição

Para o documento de composição de artigos deverá configurar um documento de stock. Assim, sempre é que
é emitido um documento de venda com saída de stock e com algum artigo que no ERP está configurado
como artigo composto, é criado um documento de stock antes da integração da venda.

Documentos de Decomposição

Neste caso, deverá configurar um documento de stock para a decomposição de artigos. Assim, se emitir um
documento com entrada de stock (por exemplo uma nota de crédito) e se nesse documento constar algum
artigo que no ERP está configurado como artigo composto, é criado um documento de stock antes da
integração da venda.

Nota: Após gravar as configurações da empresa, é criada uma série específica para os documentos de stock
configurados.

Documento de liquidação geral débito

Neste caso, deverá mapear o documento de conta corrente a utilizar para a liquidação de documentos.

Documento de liquidação geral crédito

Neste caso, deverá mapear o documento de conta corrente a utilizar em pagamentos.

Nos documentos que são apresentados na grelha seguinte, nomeadamente na coluna “Cód. ERP” ou “Desc.
ERP”, deverá escolher o documento ERP PRIMAVERA correspondente.

Após escolher os documentos, deverá clicar em Criar séries para que, tal como a opção indica, seja criada uma
série para o terminal.

Nota importante: Para o mapeamento de documentos de compra e de venda apenas estão disponíveis os
documentos que não são de liquidação automática, uma vez que a liquidação desses documentos será
realizada pelo movimento de caixa.

Retail Manager 22
Meios de Pagamento
Neste separador, é realizado o mapeamento entre os modos de pagamento do Pssst!/Tlim e os movimentos
bancários do ERP PRIMAVERA.

Este mapeamento pode ser realizado manualmente, basta selecionar o movimento a receber e a pagar do ERP
PRIMAVERA nos diferentes modos de pagamento.

Alternativamente, poderá clicar em Criar e mapear para criar automaticamente o mapeamento entre os
modos de pagamento do Pssst!/Tlim e os movimentos bancários do ERP PRIMAVERA. Este processo é realizado
da seguinte forma:

• Para cada um dos modos de pagamento não mapeados, a aplicação verifica através da descrição do
modo de pagamento se existe no ERP PRIMAVERA um modo correspondente ao pagamento e
recebimento. Por exemplo, para o modo de pagamento Numerário, a aplicação verifica se existem
modos de pagamento cuja descrição seja Numerário a Receber e Numerário a Pagar e, caso não
existam, cria-os;

• A aplicação preenche a grelha com cada um dos mapeamentos realizados;

• Os mapeamentos previamente existentes não são sobrepostos.

Unidades
Para mapear as unidades, é necessário clicar na coluna “Cód. POS” ou “Descrição no POS” e escolher a unidade
no terminal que deverá ser mapeada para a respetiva unidade do ERP PRIMAVERA.

IVA

Retail Manager 23
No separador de IVA, deverá definir as taxas de IVA existentes no terminal Pssst!/Tlim e associá-las às taxas de
IVA do ERP PRIMAVERA.

De referir que as taxas de IVA isentas não são mapeadas, uma vez que o mapeamento é realizado
automaticamente pelo motivo de isenção.

Impostos Especiais
Neste separador, são apresentados os impostos e encargos existentes no terminal.

Motivos Estorno
No separador Motivos Estorno, são mapeados os motivos de emissão de uma nota de crédito do terminal com
os motivos de estorno/crédito do ERP PRIMAVERA.

Sincronização
Ao clicar no ícone Sincronização, é possível obter uma visão detalhada do estado das sincronizações dos
diversos terminais.

Sincronização Manual
Para sincronizar os terminais, deverá clicar em Sincronizar no canto superior esquerdo.

Caso pretenda saber ao pormenor o estado de sincronização de um terminal em específico, deverá clicar no
respetivo ícone da coluna “Detalhes”. Na grelha de baixo, poderá também consultar a informação detalhada de
cada operação realizada durante o processo de sincronização.

Se ocorrer algum erro durante este processo, é apresentada uma mensagem de alerta que fica visível até que
clique em Fechar. Para saber mais sobre o erro, deverá clicar na seta orientada para baixo disponível no lado
direito da caixa da mensagem.

Retail Manager 24
Sincronização Automática
Recorrendo às Tarefas agendadas do Windows, é possível correr o processo de sincronização de forma
automática.

Para que a sincronização inicie automaticamente, deverá ser passado o parâmetro AUTO na linha de comandos
(Primavera.POSI.UI.exe AUTO). Se estiver configurado o envio automático de mensagens de correio
eletrónico, será enviada uma mensagem com o relatório de sincronização.

No ERP, em Configurações | Integração poderá definir o tipo de integração nomeadamente o início

automático, o encerramento da aplicação após sincronização e a integração contínua. De salientar que, se
estiver ativa a integração contínua, o Retail Manager não efetua o pedido de recolha de dados aos terminais.
Contudo, se ativar a opção relativa ao início automático, este pedido de recolha de dados é realizado.

Por exemplo, se ativar as opções Início automático e Integração contínua, na primeira sincronização é
efetuada a recolha de dados dos terminais, mas nas sincronizações seguintes, que ocorrem periodicamente, o
pedido de dados dos terminais já não é realizado.

Quando está ativa a integração contínua, no menu de sincronização é possível saber o tempo que falta para a
próxima sincronização, sendo possível Parar a contagem. Caso pretenda retomá-la, basta clicar em
Sincronizar.

Consulta ao Sistema Central

Através do terminal, é possível consultar informação individualizada referente a vendas, artigos e
clientes/fornecedores recorrendo à bases de dados do Retail Manager e do ERP PRIMAVERA. Poderá
personalizada esta consulta de acordo com a informação pretendida, sendo também possível personalizar por
grupo de operador.

Para aceder à informação centralizada, deverá personalizar os botões da área de registo definindo o botão de
acesso aos menus para administradores e operadores. Para tal, é necessário:

1. Aceder a Sistema | > | Configurações | Botões Área de Registos;

Retail Manager 25
 2. Na coluna “Descrição”, introduzir o o texto a visualizar no botão;

3. Na coluna “Toque Rápido” ou “Toque Prolongado, escolher o código do comando. Ao tocar nestas
colunas, será apresentada a tabela de Comandos;

4. Nesta tabela, pesquisar por Consultar Central.

Ficheiros distribuídos no Pssst!/Tlim

Definição dos filtros

Os filtros utilizados para consultar o sistema central encontram-se na pasta “…/mnsg/wsfunc/”, disponível na
pasta de instalação do Pssst! ou Tlim. No ficheiro tokens estão apresentados todos os filtros disponíveis para
utilizar nos ficheiros.

Nesta pasta deverão permanecer os ficheiros que farão a correspondência com o ecrã de consulta ao sistema
central. O nome do ficheiro é o número utilizado no botão do ecrã de consulta ao sistema central e no seu
conteúdo consta(m) o(s) filtro(s) necessário(s) à pesquisa.

Retail Manager 26
Exemplo: Ficheiros distribuídos 700 e 900 que são distribuídos. No ficheiro 700 são usados dois filtros do tipo
data, que serão necessários à escolha das datas inicial e final necessárias para a expressão SQL criada. Por
outro lado, no ficheiro 900 é utilizado apenas um filtro e corresponde ao código de cliente.

Para evitar a sobreposição de ficheiros é aconselhável utilizar apenas os números compreendidos entre 1 e
500.

Ecrãs de consulta ao sistema central

Na pasta “.../ecrg/por/”, disponível na pasta de instalação do Pssst! ou Tlim, estão disponíveis para edição os
ficheiros wsconsul e wsconsulX, cujo X corresponde ao código do grupo de operador (1 a 3 correspondem aos
grupos de operadores existentes por defeito.

Quando não existem ficheiros wsconsulX, os menus visualizados correspondem aos ecrãs editados no ficheiro
wsconsul. É recomendável que edite este ficheiro através da ferramenta gratuita NotePad++.

Nestes ficheiros está desenhado um ecrã com três separadores diferentes: Geral, Artigos e
Clientes/Fornecedores. Em cada separador do ecrã é organizado pelo desenho do separador, seguido da
definição dos seus campos:

Cada botão é identificado com o texto #xx, sendo que xx tem início no valor 00 e termina em 05. No separador
é definida a posição do botão. Nas definições de cada campo é possível editar o texto do botão e na última
coluna (id) o código que corresponde ao nome do ficheiro usado para a criação da query de seleção no Web
Service e o ficheiro com os tokens correspondentes.

Ficheiros distribuídos no Web Service

A pasta “…/PeT100/Web/PeTRest/bin/cfg/sql”, disponível na pasta de instalação do Retail Manager, apresenta
os ficheiros com a query sql utilizada para visualizar a informação. De referir que para o correto funcionamento
devem possuir os mesmos nomes que os ficheiros da pasta “…/mnsg/wsfunc/” criados no Pssst! e Tlim.

Exemplo:

1. Criar o ficheiro 100 na pasta “…/mnsg/wsfunc/”, existente na pasta de instalação do Pssst! ou Tlim;

2. Adicionar-lhe o seguinte conteúdo: |CAE;Codigo Artigo ERP;

3. No ficheiro wsconsul2, existente na pasta “.../mnsg/por/”, alterar o id botão Stock artigo, no separador
Consultar centralizada – Artigos, para 100;

Retail Manager 27
 ;pos,campo ,tipo, dec, tamj, tamr, editavel, core, cori, id
00, Stock artigo , 51, 0, 20, 20, 1, 0, 0, 100
4. Criar um ficheiro 100.sql na pasta “…/PeT100/Web/PeTRest/bin/cfg/sql” com o seguinte conteúdo:

Select Artigo, cast(StkActual as decimais(10,2)) as StkActual, Lote, Localizacao, Armazem,

EstadoStock

from PRI[EMP]..V_INV_ArtigoArmazem

where Artigo = '[1]'

Através destes passos, é possível visualizar no ecrã do Pssst!/Tlim a informação do Artigo ‘[1]’, sendo que [1]
corresponde ao filtro inserido no ficheiro correspondente na pasta “…/mnsg/wsfunc/”, disponível na pasta de
instalação do Pssst! ou Tlim.

Neste caso, os diferentes parâmetros serão substituídos pela ordem referida [1] -> primeiro parâmetro, [2]->
segundo parâmetro, etc. O número de parâmetros deve ser idêntico.

Nota: [EMP] não precisa de estar nos parâmetros, uma vez que se refere à empresa e é um parâmetro
automático.

Neste caso concreto, no ecrã da consulta central se clicar em Stock Artigo do separador Artigos será
apresentada a Tabela de Artigos.

Deverá selecionar o artigo que pretende visualizar clicando em cima do mesmo. Posteriormente, deverá clicar
na tecla verde.

Retail Manager 28
Retail Manager 29
Anexo 1 – Imagens de artigos
Para simplificar e agilizar a gestão da sincronização de imagens apresentadas no POS e vísiveis na ficha do
artigo, é possível criar uma sincronização entre a pasta de imagens dos artigos, bem como uma diretoria
centralizada.

Para tal, podemos utilizar a ferramenta OneDrive aplicado em Windows e o Tlim como software de POS.

Nota: Podem ser utilizadas outras ferramentas como DropBox, GoogleDrive, Partilha de rede, etc.

Na pasta da aplicação, localizar a pasta img: (“C:\Program Files (x86)\PRIMAVERA\Tlim810\img\”).

De seguida, na OneDrive criar uma diretoria que permita colocar uma pasta que será sincronizada com o
caminho referido anteriormente, como por exemplo: (“%UserProfile%\OneDrive - GRUPO PRIMAVERA\pos\”). De
salientar que não foi criada a pasta img. Esta será criada quando for criada a ligação.

Para formalizar esta ligação, deverá abrir a linha de comandos (botão iniciar + “cmd”) e executar como
administrador. Depois, deverá inserir o comando: mklink /j “Caminho da onedrive + \img" "Caminho da pasta
img no TLIM"

O resultado será similar a: mklink /j "%UserProfile%\OneDrive - GRUPO PRIMAVERA\pos\img" "C:\Program

Files (x86)\PRIMAVERA\Tlim810\img"

Ao clicar na teclar Enter, será apresentada uma mensagem indicando que a ligação foi efetuada e na pasta da
OneDrive | POS estará visível a pasta img sincronizada com a pasta img do TLIM.

Como mencionado no tópico Configurações, poderá aceder às configurações de integração e selecione uma
das duas opções para extensão de imagens:

• Png;

• Jpeg;

Estas são as duas extensões válidas e reconhecidas pelo software POS.

Retail Manager 30
Ao criar artigos no ERP, estes terão um código do artigo. Este código será composto pelo nome do ficheiro da
imagem a utilizar e, ao sincronizar, pelo nome da extensão previamente selecionada. Esta pasta será então
disseminada por todos os postos que tenham a sincronização com a mesma.

Por exemplo, foi criado o artigo “Galão” no ERP com o código 007007. Este artigo foi definido na Família 1 >
SF1.2. Ao sincronizar, no Retail Manager o campo na tabela artigos que sincroniza com o POS ficará com o
campo img com o nome 007007.png (extensão selecionada no RM).

Após sincronizar o POS, podemos então verificar que o artigo Galão se encontra disponível e que a imagem
colocada na pasta centralizada foi transferida corretamente para o POS.

Se for necessário alterar imagens, basta colocar as novas imagens, manter a nomenclatura e extensão na pasta
do OneDrive.

Retail Manager 31