Manual de

Integrao
Solues Pssst! e Tlim
v8.0

Verso 1.0
junho 2013

Manual de Integrao

ndice
ndice............................................................................................................................ 2
Integrao com o ERP PRIMAVERA ................................................................................ 3
Configurao .............................................................................................................. 5
Integrao ................................................................................................................ 13

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

Integrao com o ERP

PRIMAVERA
A aplicao POS Integrator destina-se a integrar os dados de Faturao,
Caixas, Bancos, Contas Correntes de Clientes e Contas Correntes de
Fornecedores introduzidos no Pssst! ou Tlim, e integr-los no ERP
PPRIMAVERA. Para tal foi concebido um conjunto de regras e mapeamentos
para facilitar a integrao.

Ateno:

Devem ser criados documentos especficos para a integrao. No devem

ser usados documentos j existentes no ERP PRIMAVERA.

As liquidaes de documentos s podem ser geridas numa das

aplicaes, ou no Pssst! e Tlim ou no ERP PRIMAVERA.

Aps a 1 integrao todas as alteraes efetuadas no Pssst! ou Tlim

devem ser cuidadosamente refletidas no POS Integrator.

O POS Integrator instalado na diretoria da aplicao.

Apenas possvel a integrao com o ERP v8.0 ou superior. Para tal, usar o
POSIntegrator800.exe.

1.

Armazm/Localizao
Para cada loja existente tambm deve ser criado no ERP PRIMAVERA um
armazm e uma localizao do armazm. O armazm necessrio para a
integrao de documentos de compras.

2.

Lojas do Pssst! ou Tlim

Visto este conceito no existir com o mesmo formato no ERP PRIMAVERA,
para a integrao so criados no PRIMAVERA os seguintes elementos para
cada loja:
a)

Caixa da loja

b)

Conta de Cliente

c)

Sries de documentos

A regra de utilizao de Sries de Documentos do ERP PRIMAVERA pelo

Pssst! ou Tlim assenta na necessidade de identificar a loja do Pssst! ou
Tlim no ERP PRIMAVERA. Logo, para cada loja do Pssst! ou Tlim criada
uma srie no ERP PRIMAVERA com o formato acima, pois a numerao
dos documentos do Pssst! ou Tlim por loja.

3.

Documentos
O mapeamento dos documentos do Pssst! ou Tlim aos do ERP PRIMAVERA
feito manualmente. Ou seja, para cada tipo de documento do Pssst! ou
Tlim indicado qual o documento correspondente no ERP PRIMAVERA.
Alm dos documentos existentes no Pssst! ou Tlim sempre necessria a
indicao de alguns documentos especficos do ERP PRIMAVERA e do

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

processo de integrao, que podem ser ou criados para o efeito ou os j

existentes no ERP PRIMAVERA.
Os documentos a criar so os seguintes:

Tesouraria
o
Abertura de Caixa
o
Fecho de Caixa
o
Entrada em Caixa
o
Sada de Caixa

Conta Corrente
o
Documentos financeiros de cliente
o
Regularizao (Rec. / Pag.)

Compra
o
Documentos financeiros de fornecedor

Ateno: Todos os documentos a serem integrados devem estar configurados

no Pssst! ou Tlim para movimentar caixa.

As parametrizaes necessrias no ERP PRIMAVERA esto escritas no

pargrafo de configurao.

4.

Modos de pagamento (Movimentos bancrios)

A integrao dos modos de pagamento no ERP PRIMAVERA feita com
base nos cdigos do Pssst! ou Tlim, adicionando um P ou um R
consoante no ERP PRIMAVERA seja um modo de pagamento a pagar ou a
receber, pois no Pssst! ou Tlim a direo do movimento determinada
pelo documento ao qual est associado. Ou seja, para cada modo de
pagamento do Pssst! ou Tlim existem 2 movimentos bancrios no ERP
PRIMAVERA.
Os modos de pagamento so todos considerados como numerrio no ERP
PRIMAVERA, com exceo dos cheques. Na passagem so tambm
identificados os cheques pr-datados e tratados de acordo com as suas
especificidades.
Para o processo de passagem tambm necessria a criao de dois
movimentos bancrios no ERP PRIMAVERA que servem para o tratamento
das caixas das Lojas, normalmente designados por Genrico a Crdito e
Genrico a Dbito.

5.

IVA
Mapeamento das diversas taxas de IVA entre o Pssst! ou Tlim e o ERP
PRIMAVERA.

6.

Destinos dos meios

Esta ligao sempre configurada manualmente pois indica, por loja, em
que Caixa ou Banco do ERP PRIMAVERA que so lanados os
movimentos bancrios.

7.

Clientes

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

A integrao de Clientes no ERP PRIMAVERA feita atravs do cdigo do

Cliente do Pssst! ou Tlim. Esse cdigo composto por 3 elementos:
a.
b.
c.

Tipo de Entidade (Loja) - Caracter L

Cdigo de Entidade (1, 2 ) - 3 carateres
Cdigo do cliente (00000001,00000002,00000003,00000004)
- 8 dgitos

Por exemplo, o cliente n 2983 da loja 1 do Pssst! ou Tlim ser assim o

cliente L00100002983 do ERP PRIMAVERA.
Por defeito s so abertos no ERP PRIMAVERA Clientes que tenham
movimentos no Pssst! ou Tlim.
Todas as alteraes feitas no Pssst! ou Tlim sero refletidas no ERP
PRIMAVERA numa integrao seguinte, quando houver novos
movimentos do cliente em questo. As eventuais alteraes dos dados do
cliente feitas no ERP PRIMAVERA sero sobrepostas.

8.

Fornecedores
O mapeamento feito pelo NIF do fornecedor, caso exista no ERP
PRIMAVERA. No caso de no existir, criado um novo fornecedor.
Por predefinio s so abertos no ERP PRIMAVERA Fornecedores que
tenham movimentos no Pssst! ou Tlim.
Todas as alteraes feitas no Pssst! ou Tlim sero refletidas no ERP
PRIMAVERA numa integrao seguinte, quando houver novos
movimentos do fornecedor em questo. As eventuais alteraes dos
dados do fornecedor feitas no ERP PRIMAVERA sero sobrepostas.

Configurao
necessrio configurar os seguintes elementos:

POS Integrator
o Bases de dados


ERP PRIMAVERA


BD de Ligao
o Empresa

Documento de Liquidao
Documento de Tesouraria
Modo de pagamento de passagem
Modo de pagamento de regularizao
Artigo p/ Compras
Formato da conta contabilstica das entidades
Divisa

o Loja

Cdigo da loja
Endereo ou IP
Loja inativa
Nome

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

Morada
Localidade
Conta Corrente
Caixa
Armazm
Localizao do Armazm

o Documentos


Pssst! ou Tlim


ERP PRIMAVERA


Srie
o Tabelas

Modos de pagamento
IVA
Centros de custo

o Destino dos meios

Modo de pagamento (Pssst! ou Tlim)


Caixa / Banco (ERP PRIMAVERA)
Antes de efetuar as configuraes no POS Integrator, necessrio criar para
cada empresa do ERP PRIMAVERA os seguintes documentos:

Tesouraria

Entrada em Caixa

Movimento em Conta

1 Srie

Sada de Caixa

Movimento em Conta

1 Srie

Abertura de Caixa

Movimento em Conta

1 Srie ex: 2008

Fecho de Caixa

Movimento em Conta

1 Srie

Documento de Tesouraria ERP PRIMAVERA

Movimento em conta

1 Srie

Conta corrente

Documentos Financeiros de Clientes a Crdito (Ex: Nota de

crdito)

Tipo Documento: Pendentes

Permitido a: Clientes

Natureza: a pagar

Utilizado em: Conta Clientes Pendentes

1 Srie

Documentos Financeiros de Clientes a Dbito (Ex: Fatura

simplificada)

Tipo Documento: Pendentes

Permitido a: Clientes

Natureza: A Receber

Utilizado em: Conta Clientes Pendentes

1 Srie

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

Documento de Liquidao ERP PRIMAVERA

Tipo Documento: Liquidao

Permitido a: Clientes, Outros Devedores

Natureza: Recebimento

Ligao Tesouraria

Utilizado em: Conta Clientes Pendentes

1 Srie

Documento de Pagamento ERP PRIMAVERA

Tipo Documento: Liquidao

Permitido a: Fornecedores

Natureza: Pagamento

Ligao Tesouraria

Utilizado em: Conta Fornecedores Pendentes

1 Srie

Compra

Documentos Financeiros de Fornecedores a Crdito (Ex: Compra)

Tipo Documento: Financeiro

Permitido a: Fornecedores

Natureza: A Pagar

Sujeito a converso

Ligao contas correntes

1 Srie

Documentos de Fornecedores a Crdito (Ex: Guia de remessa de

fornecedor)

Tipo Documento: Stock / Transf.

Permitido a: Fornecedores

Natureza: A Pagar

Sujeito a converso

1 Srie

Documentos Financeiros de Fornecedores a Dbito (Ex: Nota de

crdito de fornecedor)

Tipo Documento: Financeiro

Permitido a: Fornecedores

Natureza: A Receber

Sujeito a converso

1 Srie

Documentos de Fornecedores a Dbito (Ex: Guia de remessa de

fornecedor)

Tipo Documento: Stock / Transf.

Permitido a: Fornecedores

Natureza: A Receber

Sujeito a converso

1 Srie

Artigo

CPR

Descrio: Artigo de Compra

Tipo de artigo: Mercadoria
Deduz IVA
Sujeito a Devoluo
No movimenta stocks

Movimentos Bancrios

GC

Descrio: Genrico a Receber

Tipo: Crdito

Aplicvel a: Contas Caixa

Identificao do movimento: Numerrio

Srie usada: Baseada na data do movimento Bancrio

GD

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

Descrio: Genrico a Pagar

Tipo: Dbito
Aplicvel a: Contas Caixa
Identificao do movimento: Numerrio
Srie usada: Baseada na data do movimento Bancrio

A primeira vez que se entra no POS Integrator pedido que se configure as

ligaes s bases de dados e ao ERP PRIMAVERA. possvel tambm criar aqui
a Base de Dados de Ligao.
Seguir os seguintes passos para efetuar a configurao:
1.

ERP PRIMAVERA
a. Utilizador: O utilizador do ERP PRIMAVERA;
b. Password: A password do utilizador indicado no ponto a;
c. Plataforma: Tipo de plataforma do ERP PRIMAVERA
Instalada.

2.

Base de dados de ligao

a. Servidor: O servidor SQL onde est a base de dados de
ligao;
b. Segurana Integrada: Marcar caso a ligao ao servidor
SQL use a autenticao Windows;
c. Utilizador: O utilizador do servidor SQL (no caso de no ser
usada a autenticao Segura);
d. Password: A password do utilizador indicado no ponto c;
e. Base de Dados: O nome da base de dados de ligao;
f. Criar BD de Ligao: carregando neste boto cria a base de
dados de ligao no servidor.

Para finalizar a configurao carregar no boto Gravar. Aps gravar, carregar

no boto Configurar que apresentado na janela do POS Integrator.
A janela de configurao apresenta do lado esquerdo a lista das empresas
criadas no ERP PRIMAVERA. Escolhendo uma das empresas apresentado o
primeiro quadro de configurao onde tm que ser escolhidas as seguintes
opes:
1.

Documento de Liquidao PRIMAVERA: Documento de Conta

Corrente a usar para liquidao de documentos.

2.

Documento de Pagamento PRIMAVERA: Documento de Conta

Corrente a usar para pagamentos a fornecedores.

3.

Documento de Tesouraria PRIMAVERA: Documento

Tesouraria usado para lanar os movimentos bancrios.

4.

Movimento bancrio genrico a pagar: Modo de pagamento

genrico para pagamentos.

5.

Movimento bancrio genrico a receber: Modo de pagamento

usado para regularizao.

6.

Artigo p/ Compras: Artigo genrico usado para lanamento das

Compras e transferncias entre empresas.

7.

Formato da conta contabilstica das entidades: Nmero de

dgitos usado para a criao das entidades na Contabilidade (para a
contar contemplar 6 dgitos preencher com 000000).

PRIMAVERA Business Software Solutions, S.A

de

Manual de Integrao

8.

Divisa: Moeda base da empresa

9.

Criar Sries para as lojas: Este boto serve para criar as sries
para todas as lojas pertencentes empresa que est a ser
configurada no ERP PRIMAVERA em todos os documentos
existentes.

10. Criar Contas e Caixas das Lojas: Cria um Cliente e uma Conta
Caixa no ERP PRIMAVERA para todas as lojas pertencentes
empresa que est a ser configurada.
Para finalizar esta configurao carregar em Gravar.
O passo seguinte da configurao associar cada loja do Pssst! ou Tlim sua
Conta Corrente (Cliente aberto no ERP PRIMAVERA) e sua Caixa. Para isso,
carregar no + que est do lado esquerdo da Empresa, escolher a loja do lado
direito da janela e apresentado um quadro.
Depois deve-se proceder da seguinte forma:
1.
2.

3.
4.
5.
6.
7.

Loja: Loja do Pssst! ou Tlim.

Endereo ou IP: Endereo usado para importao de dados do Pssst!
ou Tlim. O endereo deve ser especificado no formato endereo:porto.
A loja deve estar configurada de forma que com este endereo seja
possvel aceder ao posto remoto.
Loja inativa: Indica se uma loja est ou no inativa.
Nome, Morada, Localidade: Dados da loja
Conta Corrente da Loja: Cliente do ERP que corresponde loja do
Pssst! ou Tlim.
Caixa da Loja: Conta Caixa do ERP correspondente loja do Pssst!
ou Tlim.
Armazm e Localizao do Armazm: Armazm e localizao
utilizados para a criao de documentos de compras.

Aps cada definio carregar no boto Gravar.

No ERP PRIMAVERA, deve ser feita uma abertura de caixa para a conta caixa
definida.

Nos casos em que so usados IPs dinmicos nos pontos remotos podem ser
usados servios como o DynDns ou o NoIP para assegurar uma configurao
estvel do endereo da loja.

Em seguida escolher a opo Documentos. Para efetuar os mapeamentos

proceder da seguinte forma:
1.
2.
3.
4.
5.
6.

Documento Pssst! ou Tlim: Documento do Pssst! ou Tlim.

Documento PRIMAVERA: Documento correspondente no ERP
PRIMAVERA.
Adicionar: Adiciona o mapeamento grelha.
Remover: Remove o mapeamento da grelha.
Srie: A srie que vai ser usada no ERP para identificar esta loja.
Verificar Sries: Verifica se as sries necessrias existem nos
documentos do ERP PRIMAVERA. possvel criar as sries,
automaticamente, para os documentos em que no existirem.

PRIMAVERA Business Software Solutions, S.A

Manual de Integrao

Repetir os passos 1 a 3 para todos os documentos e carregar em Gravar

para terminar. Efetuar esta configurao para todas as lojas.
Escolher, de seguida, o item Tabelas na rvore do lado esquerdo e configurar
as tabelas dos separadores como descrito abaixo:
1.

Modos de Pagamento: Faz-se o mapeamento entre os modos de

pagamento do Pssst! ou Tlim e os movimentos bancrios do ERP
PRIMAVERA. Para efetuar o mapeamento de uma forma manual,
indicar o modo de pagamento Pssst! ou Tlim, PRIMAVERA a
Receber e PRIMAVERA a Pagar. Em seguida, carregar no boto
Adicionar.
Em alternativa, possvel carregar no boto Criar Modos de
Pagamento que cria e faz automaticamente o mapeamento entre os
modos de pagamento do Pssst! ou Tlim e os movimentos bancrios do
ERP PRIMAVERA. Tal processo feito da seguinte forma:
a. Para cada um dos modos de pagamento no mapeados, a
aplicao verifica se existe no ERP PRIMAVERA um modo de
pagamento correspondente para pagamento e recebimento.
Essa verificao feita pela descrio do modo.
Ex: Para o modo de pagamento Numerrio, a aplicao
verifica se existem os modos de pagamento cuja descrio seja
Numerrio a Receber e Numerrio a Pagar e cria-os, caso
no existam.
b.

A aplicao preenche a grelha com cada um dos mapeamentos

feitos.
Os mapeamentos previamente existentes no so sobrepostos.

c.

Seja qual for o mtodo utilizado, quando terminar necessrio

carregar no boto Gravar para gravar as alteraes.
2.

IVA: Para cada taxa de IVA do Pssst! ou Tlim indicar a taxa

correspondente do ERP PRIMAVERA e carregar em Adicionar. Para
finalizar carregar em Gravar.

3.

Centros de Custo: No caso de se pretender que a aplicao de

integrao ligue todas as linhas dos documentos lanados a um
Centro de Custo, possvel definir aqui qual a estrutura do Plano de
Centros. Deve-se sempre indicar qual a conta base e qual o formato
(ex. Conta Base: 11 Formato: 00). Para alm da conta base possvel
definir 2 nveis que podem ser baseados nos seguintes campos do
Pssst! ou Tlim:
a.
b.

Loja.
Famlia.

Para cada um dos nveis definir tambm o formato, ou seja o n de dgitos

com o qual quer que sejam criadas as contas.
As contas so criadas automaticamente pelo POS Integrator medida que vai
sendo necessrio.

Ateno: Para que seja possvel criar os Planos de Centros corretamente,

todos os elementos escolhidos no Pssst! ou Tlim devem ter sido criados com
cdigos numricos.

PRIMAVERA Business Software Solutions, S.A

10

Manual de Integrao

Para finalizar a configurao desta empresa necessrio configurar os

Destinos de Meios. Aqui ser indicado por loja qual a conta Caixa ou Banco
no qual um dado modo de pagamento deve ser lanado. Assim, devem ser
preenchidos os seguintes campos:

1.
2.

Modo de Pagamento: Modo de pagamento do Pssst! ou Tlim.

Caixa / Banco: A Caixa ou Banco do ERP PRIMAVERA na qual este
modo de pagamento deve ser lanado.

Por predefinio todos os modos de pagamento so lanados na Caixa da loja.

Para alterar uma definio basta escolher o Modo de Pagamento a alterar, a
Caixa / Banco de destino e carregar no boto Adicionar. Caso j exista a
definio ser perguntado se a quer substituir.
Termina assim a configurao do POS Integrator.
O processo de integrao pode funcionar de uma forma automtica, usando as
Tarefas agendadas do Windows. Pode-se configurar uma tarefa para correr
de acordo com as necessidades. Para que o POS Integrator funcione
automaticamente tem que ser passado o parmetro AUTO na linha de
comandos (POSIntegrator800.exe AUTO). Neste caso a integrao ser
efetuada sem interveno humana e se o processo correr at ao fim o
programa sai. Se existir algum conflito durante a integrao, a janela fica no
ecr para que se possa visualizar o problema. Em qualquer dos casos, todas as
operaes realizadas so gravadas num ficheiro que fica na pasta onde a
aplicao est instalada e com o nome: POSIntegratorddmmaaaa.log.

PRIMAVERA Business Software Solutions, S.A

11

Manual de Integrao

Importao
O processo de importao responsvel pela transferncia de dados das lojas
para a base de dados de ligao. Para que a importao funcione
corretamente, so necessrio os seguintes requisitos:

Ligao TCP/IP disponvel

Porto 8808 acessvel

A ligao sempre feita da sede para a loja, logo e tal como explicado na
configurao necessrio que exista conectividade entre os dois pontos.
A importao pode ser feita a pedido, ao executar a aplicao de importao,
ou de forma automtica, usando as Tarefas agendadas do Windows. Pode-se
configurar uma tarefa para correr de acordo com as necessidades. Para que o
importador do Pssst! ou Tlim funcione automaticamente, tem que ser passado
o parmetro AUTO na linha de comandos (PetImport800.exe AUTO). Neste
caso a importao ser efetuada sem interveno humana e se o processo
correr at ao fim o programa sai. Se existir algum conflito durante a
integrao, a janela fica no ecr para que se possa visualizar o problema. Em
qualquer dos casos, todas as operaes realizadas so gravadas num ficheiro
que fica na pasta onde a aplicao est instalada e com o nome:
PeTImportacaoddmmaaaa.log.

PRIMAVERA Business Software Solutions, S.A

12

Integrao
Para efetuar a integrao com o ERP, carregar no boto Processar. O Processo de Integrao segue o seguinte ciclo: