Escolar Documentos
Profissional Documentos
Cultura Documentos
Integração
POS Integrator
v8.30
Versão 2.0
Janeiro de 2016
(última atualização em 18.01.2016)
Manual de Integração
Índice
Índice............................................................................................................................ 2
Configuração .............................................................................................................. 7
Importação ............................................................................................................... 18
Esta integração poderá ser feita de duas formas distintas: integração financeira ou integração
financeira e logística. Estes tipos de integração são diferentes no seu processo e configurações e
têm objetivos finais diferentes.
Integração Financeira
A integração financeira tem como objetivo a integração de 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 POS Integrator é necessário garantir a existência das versões do software
PRIMAVERA compatíveis com o mesmo.
Atenção:
Devem ser criados documentos específicos para a integração. Não devem ser usados documentos
já existentes no ERP PRIMAVERA.
As liquidações de documentos só podem ser geridas numa das aplicações, ou no Pssst! e Tlim ou no
ERP PRIMAVERA.
Após a primeira integração, todas as alterações efetuadas no Pssst! ou Tlim devem ser
cuidadosamente refletidas no POS Integrator.
Regras de configuração
1. Armazém/Localização
Para cada loja existente deve ser criado no ERP PRIMAVERA um armazém e uma localização do
armazém. O armazém é necessário para a integração de documentos de compras.
Uma vez que este conceito não existe com o mesmo formato no ERP PRIMAVERA, para fins de
integração são criados no ERP os seguintes elementos para cada loja:
a) Caixa da loja;
b) Conta de “Cliente”;
c) Séries de documentos.
3. Documentos
O mapeamento dos documentos do Pssst! ou Tlim com os do ERP PRIMAVERA é feito manualmente.
Ou seja, para cada tipo de documento do Pssst! ou Tlim é indicado qual o documento correspondente
no ERP.
Para além dos documentos existentes no Pssst! ou Tlim é sempre necessária a indicação de alguns
documentos específicos do ERP PRIMAVERA, bem como do processo de integração. A configuração
destes documentos depende também do tipo de integração selecionada.
Documentos Gerais
Tesouraria;
Abertura de Caixa;
Fecho de Caixa;
Entrada em Caixa;
Saída de Caixa.
Integração Financeira
Conta Corrente;
Documentos financeiros de cliente;
Regularização (Rec. / Pag.);
Compra;
Documentos financeiros de fornecedor.
Venda;
Compra;
Documentos financeiros de cliente;
Documentos de tesouraria;
Movimentos de stock;
Documentos de stock.
Atenção: Todos os documentos de integração financeira devem estar configurados no Pssst! ou Tlim
para movimentar caixa. No caso de uma integração financeira e logística este requisito não se aplica.
A integração dos modos de pagamento no ERP PRIMAVERA é feita com base nos códigos do Pssst!
ou Tlim, adicionando o sufixo “P” ou “R” consoante no ERP PRIMAVERA se trate de um modo de
pagamento a pagar (P) ou a receber (R), uma vez que no Pssst! ou Tlim a direção do movimento é
determinada pelo documento ao qual está associado. Ou seja, para cada modo de pagamento do
Pssst! ou Tlim existem dois movimentos bancários no ERP PRIMAVERA.
Todos os modos de pagamento no ERP PRIMAVERA devem ter a sua identificação de movimento
configurada como Numerário, com exceção dos cheques. Na passagem são também identificados
os cheques pré-datados e tratados de acordo com as suas especificidades.
Para o processo de passagem é também necessária a criação de dois movimentos bancários no ERP
PRIMAVERA que servem para o tratamento das caixas das Lojas, normalmente designados por
Genérico a Crédito e Genérico a Débito.
5. IVA
Mapeamento das diversas taxas de IVA entre o Pssst! ou Tlim e o ERP PRIMAVERA.
6. Moedas
Mapeamento das diversas moedas entre o Pssst! ou Tlim e o ERP PRIMAVERA. Para mapear as
moedas automaticamente deve selecionar mapear moedas, tendo em atenção que caso as
abreviaturas (código ISO) sejam diferentes entre o Pssst! ou Tlim e o ERP PRIMAVERA não será
possível fazer o mapeamento automático.
Atenção: A moeda base utilizada no Pssst! ou Tlim deve ser a mesma da empresa utilizada no ERP
PRIMAVERA.
Esta ligação é sempre configurada manualmente pois indica, por loja, em que Caixa ou Banco do
ERP PRIMAVERA são lançados os movimentos bancários.
8. Clientes
A integração de Clientes no ERP PRIMAVERA é feita através do código do Cliente do Pssst! ou Tlim.
Esse código é composto por 3 elementos:
Por exemplo, o cliente nº 2983 da loja 1 do Pssst! ou Tlim será assim o cliente “L00100002983” do
ERP PRIMAVERA.
Sempre que um novo cliente for criado no Pssst! ou Tlim, deverá ser integrado no ERP PRIMAVERA.
Quando um novo cliente for integrado no ERP PRIMAVERA, será verificada a existência prévia de
algum cliente com o mesmo NIF. Caso não exista ou o cliente do Pssst! ou Tlim não possuir NIF,
será criada uma nova ficha de cliente no ERP PRIMAVERA. Caso o NIF exista no ERP, então o cliente
criado no Pssst! ou Tlim será mapeado para o cliente já existente e os seus dados atualizados.
Todas as alterações feitas no Pssst! ou Tlim são refletidas no ERP PRIMAVERA numa integração
seguinte, quando houver novos movimentos do cliente em questão. As eventuais alterações dos
dados do cliente feitas no ERP PRIMAVERA são sobrepostas.
9. Artigos
Mapeamento entre os artigos Pssst! ou Tlim e artigos ERP PRIMAVERA. Este mapeamento poderá
ser criado de uma forma automática ou manualmente.
Artigos não mapeados podem ser configurados para ser criados no ERP PRIMAVERA ou criados no
Pssst!/Tlim, sendo que nesta última opção é possível eliminar todos os artigos existentes no
Pssst!/Tlim.
11. Famílias
12. Unidades
13. Fornecedores
O mapeamento é feito pelo NIF do fornecedor, caso exista no ERP PRIMAVERA. Caso não exista é
criado um novo fornecedor. Por predefinição só são abertos no ERP fornecedores que tenham
movimentos no Pssst! ou Tlim.
Todas as alterações feitas no Pssst! ou Tlim serão refletidas no ERP PRIMAVERA numa integração
seguinte, quando houver novos movimentos do fornecedor em questão. As eventuais alterações dos
dados do fornecedor realizadas no ERP PRIMAVERA são sobrepostas.
Configuração
É necessário configurar os seguintes elementos no POS Integrator:
Bases de dados:
o ERP PRIMAVERA
o BD de Ligação
Empresa:
o Documento de Liquidação;
o Documento de Tesouraria;
o Modo de pagamento de passagem;
o Modo de pagamento de regularização;
o Artigo p/ Compras;
o Formato da conta contabilística das entidades;
o Divisa;
o Tipo de Integração.
Loja:
o Código da loja;
o Endereço ou IP;
o Loja inativa;
o Nome;
o Morada;
o Localidade;
o Tamanho dos Códigos de Artigos e Famílias;
o Conta Corrente;
o Caixa;
o Armazém;
o Localização do Armazém.
Artigos:
o Unidades;
o Seleção de Famílias;
o Famílias.
Documentos:
o Pssst! ou Tlim;
o ERP PRIMAVERA.
Tabelas:
o Modos de pagamento;
o IVA;
o Centros de custo.
Antes de efetuar as configurações no POS Integrator, é necessário criar, para cada empresa do
ERP PRIMAVERA, os seguintes documentos:
Tesouraria
Entrada em Caixa
o Movimento em Conta;
o 1 Série.
Saída de Caixa
o Movimento em Conta;
o 1 Série.
Abertura de Caixa
o Movimento em Conta;
o 1 Série.
Fecho de Caixa
o Movimento em Conta;
o 1 Série.
o Movimento em Conta;
o 1 Série.
Conta corrente
o Permitido a: Clientes;
o Natureza: a pagar;
o 1 Série.
o Permitido a: Clientes;
o Natureza: a receber;
o 1 Série.
o Natureza: Recebimento;
o Ligação à Tesouraria;
o 1 Série.
o Permitido a: Fornecedores;
o Natureza: Pagamento;
o Ligação à Tesouraria;
o 1 Série.
Compra
o Permitido a: Fornecedores;
o Natureza: a pagar;
o Sujeito a conversão;
o 1 Série.
o Permitido a: Fornecedores;
o Natureza: a pagar;
o Sujeito a conversão;
o 1 Série.
o Permitido a: Fornecedores;
o Natureza: a receber;
o Sujeito a conversão;
o 1 Série.
o Permitido a: Fornecedores;
o Natureza: a receber;
o Sujeito a conversão;
o 1 Série.
Tesouraria
Entrada em Caixa;
Saída de Caixa;
Abertura de Caixa;
Fecho de Caixa;
o Movimento em conta;
o 1 Série.
Vendas
o Permitido a: Clientes;
o Natureza: a pagar;
o Estado: Pendente;
o 1 Série.
o Permitido a: Clientes;
o Natureza: a receber;
o Estado: Pendente;
o 1 Série.
Compra
o Permitido a: Fornecedores;
o Natureza: a pagar;
o Sujeito a conversão;
o 1 Série.
Conta corrente
o Natureza: Recebimento;
o Ligação à Tesouraria;
o 1 Série.
o Permitido a: Fornecedores;
o Natureza: Pagamento;
o Ligação à Tesouraria;
o 1 Série.
Configurações comuns
Artigo
CPR:
o Deduz IVA;
o Sujeito a Devolução;
Movimentos Bancários
GC:
o Tipo: Crédito;
GD:
o Tipo: Débito;
ERP PRIMAVERA
Para finalizar a configuração carregar no botão “Gravar”. Após gravar, carregar no botão
“Configurar” apresentado na janela do POS Integrator.
A janela de configuração apresenta do lado esquerdo a lista das empresas criadas no ERP
PRIMAVERA. Selecionando uma das empresas é apresentado o primeiro quadro de configuração
onde têm de ser escolhidas as seguintes opções:
Atenção: O tipo de integração define o comportamento da aplicação. Deve ser dada especial
atenção a esta configuração. Assim que o processo de integração for iniciado esta configuração não
pode ser alterada.
O passo seguinte é associar cada loja do Pssst! ou Tlim à sua Conta Corrente (cliente aberto no ERP
PRIMAVERA) e à sua Caixa. Para tal, carregar no botão “+” ao lado esquerdo da Empresa, escolher
a loja do lado direito da janela e configurar o quadro apresentado:
No ERP PRIMAVERA, deve ser feita uma abertura de caixa para a conta caixa definida.
Nos casos em que são usados IPs dinâmicos, nos pontos remotos podem ser usados serviços como
o DynDns ou o NoIP para assegurar uma configuração estável do endereço da loja.
De seguida selecionar a opção “Artigos”. Nesta opção pode ser feito o mapeamento das seguintes
entidades:
1. Artigos: Para cada artigo existente no Pssst! ou no Tlim poderá ser indicado qual o artigo
correspondente no ERP PRIMAVERA. Este mapeamento poderá ser feito de duas formas:
automática ou manualmente:
iv. Todas as palavras que compõem a descrição do artigo no Pssst! ou Tlim fazem
parte da descrição do artigo no ERP PRIMAVERA.
Os três primeiros critérios criam o mapeamento e definem a coluna “Incluir” com o valor
“verdadeiro”. O critério iv coloca a coluna “Incluir” com o valor “falso”, uma vez que os mapeamentos
encontrados podem não ser os mais corretos. Desta forma, e tendo em conta que poderá haver
artigos não mapeados após este processamento, será sempre necessária a intervenção do utilizador
para corrigir ou adaptar os mapeamentos criados.
Após preencher o campo “Procurar”, clicar em “Filtrar” para que sejam apresentados
os artigos encontrados. Para finalizar clicar no artigo e em seguida aplicar. Apenas
os artigos selecionados na coluna “Incluir” serão processados.
Na aba artigos deve também ser definido qual o comportamento para os artigos não
mapeados:
2. Unidades: Para cada unidade do Pssst! ou Tlim indicar a unidade correspondente do ERP
PRIMAVERA e carregar em “Adicionar”. Para finalizar clicar em “Gravar”. Para remover,
escolher a unidade Pssst! ou Tlim e carregar em “Remover”;
3. Seleção de Famílias: Para indicar quais as famílias do ERP PRIMAVERA que serão usadas para
mapear e integrar com Pssst! ou Tlim, escolher a família em “Família ERP PRIMAVERA” e em
seguida carregar em “Adicionar”. Para finalizar a configuração clicar em “Gravar”. Para
remover, escolher a família ERP PRIMAVERA e carregar em “Remover”.
4. Famílias: Para cada família do Pssst! ou Tlim indicar a subfamília correspondente do ERP
PRIMAVERA e carregar em “Adicionar”. Para finalizar clicar em “Gravar”. Para remover,
escolher a família Pssst! ou Tlim e carregar em “Remover”. Caso existam subfamílias ERP
PRIMAVERA sem mapeamento, estas serão integradas automaticamente com o Pssst! ou Tlim.
Atenção: Antes da primeira integração deve ter em atenção o mapeamento das famílias. Estas
devem ser corretamente mapeadas entre o ERP PRIMAVERA e o Pssst! ou Tlim.
Repetir os passos 1 a 3 para todos os documentos e clicar em “Gravar” para terminar. Efetuar esta
configuração para todas as lojas.
Escolher, de seguida, o item “Tabelas” na árvore do lado esquerdo e configurar as tabelas dos
separadores:
Para cada um dos níveis definir também o formato, ou seja o número de dígitos com o qual devem
ser criadas as contas.
As contas são criadas automaticamente pelo POS Integrator à medida que vai sendo necessário.
Atenção: Para que seja possível criar os Planos de Centros corretamente, todos os elementos
escolhidos no Pssst! ou Tlim devem ter sido criados com códigos numéricos.
Para finalizar a configuração da empresa é necessário 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
lançado. Assim, devem ser preenchidos os seguintes campos:
Por omissão, todos os modos de pagamento são lançados na Caixa da loja. Para alterar uma
definição basta escolher o “Modo de Pagamento” a alterar, a “Caixa / Banco” de destino e carregar
no botão “Adicionar”. Caso já exista a definição será perguntado se a quer substituir.
Integração automática
O processo de integração pode funcionar de forma automática, usando as “Tarefas agendadas”
do Windows. É possível configurar uma tarefa para correr de acordo com as necessidades. Para que
o POS Integrator funcione automaticamente deve ser passado o parâmetro “AUTO” na linha de
comandos (POSIntegrator800.exe AUTO). Neste caso a integração será efetuada sem intervenção
humana e, se o processo correr até ao fim, o programa encerra. Se existir algum conflito durante a
integração, a janela fica ativa para que se possa visualizar o problema. Em qualquer um dos casos,
todas as operações realizadas são gravadas num ficheiro alojado na pasta onde a aplicação está
instalada, com o nome: “POSIntegratorddmmaaaa.log”.
Pssst! e Tlim
Assim que é iniciado o primeiro processo de integração, o Pssst! ou Tlim entrará automaticamente
em modo integrado. Com este modo ativo, apenas será possível editar alguns campos de Famílias
e Artigos. A criação e edição dos Artigos e Famílias passará a ser gerida exclusivamente pelo ERP
PRIMAVERA.
Importação
O processo de importação é responsável pela transferência de dados das lojas para a base de dados
de ligação. Para que a importação funcione corretamente, são necessário os seguintes requisitos: