Introdução

O integrador SysPDV é responsável pela troca de informações entre o Guarani ERP e o sistema de frente de caixa SysPDV.

Essa integração é feita por meio do FTP em arquivos TXT, onde nosso integrador gera os arquivos dos cadastrados do Guarani ERP e recebe os movimentos de vendas realizados pelos caixas, sempre baseado no layout fornecido pelo SysPDV.

Toda a configuração dentro do Guarani ERP é semelhante ao que é feito para o Guarani PDV, ou seja, parâmetros, configuração de ECF, Tipo de ordens, Terminais e configurações fiscais.

Nesse manual, vamos explicar a instalação e utilização do integrador.

O que é integrado?

Integração é feita a todo minuto, onde o integrador verifica se algo que foi alterado no Guarani ERP precisa ser enviado ao SysPDV, com base no agendamento do script feito em Configuração dos Layouts explicado mais a frente, e verifica também se existe algum movimento enviado pelo SysPDV que precisa ser importado para o Guarani ERP.

Arquivos Enviados

Hoje são enviadas as seguintes informações do Guarani ERP para o SysPDV, baseado no Layout fornecido pelo próprio SysPDV no formato de arquivo TXT:

15 - Funcionário (SYSPFUN): Script que exporta os representantes marcados como funcionários no Guarani ERP;
25 - Ramo (SYSPRAM): Gera a exportação de todos os ramos de atividades cadastrados no ERP;
06 - Clientes (SYSPCLI): Realiza a exportação de todos os clientes do ERP;
28 - Seção (SYSPSEC): Exporta nosso cadastro de “Linha” dos produtos como sendo a “Seção” para o SysPDV;
12 - Grupo de Produto (SYSPGRP): Exporta nosso cadastro de grupos de produtos, porém combinado ao cadastro de “Linha” do produto, pois para o SysPDV, um grupo de produtos deve estar amarrado a uma “Seção”;
30 - Subgrupo de Produto (SYSPSBG): O script gera todo o cadastro de Subgrupos de produtos amarrados ao Grupo e Linha de produtos do Guarani ERP;
21 - Produto (SYSPPRO): Exporta todo o cadastro de produtos do Guarani ERP, levando consigo as informações de tributação do mesmo e preços baseados nas tabelas de preços dos parâmetros do ERP;
07 - Código Auxiliar do Produto, EAN e referências (SYSPAUX): Nesse script são exportados todos os códigos auxiliares do cadastro de produtos do Guarani ERP e suas quantidades, uma vez que na exportação de produtos só é enviado o nosso código interno do produto.
- A referencia do produto é enviada com o status “R” e é de extrema importância, pois a mesma é quem deve sair nos documentos fiscais emitidos pelo SysPDV, tanto que foi criado um parâmetro do lado do SysPDV especialmente para Guarani, localizado na retaguarda do SysPDV > Sistemas > Parâmetros SysPDV - PDV > Integração > Utilizar código auxiliar do tipo Referência como código do produto no cupom e arquivos xml dos documentos ficais”.
- Para enviar um EAN tributado de um produto do Guarani para o SysPDV, é necessário que o mesmo esteja marcado como GTIN válido no Guarani. Caso algum produto não tenha GTIN válido porém esteja marcado no Guarani, o mesmo será enviado para o SysPDV, porém como não é válido pode ocorrer rejeição pela Sefaz.
10 - Estoque (SYSPEST): Esse script exporta a soma dos estoques físicos dos produtos, onde os locais de estoque são da empresa ou multi-empresa;
05 - CFOP (SYSPCFO): Realiza a exportação de todo o cadastro de CFOP do Guarani ERP;
24 - Promoção por Desconto (SYSPPDCN): Exporta as promoções do tipo Percentual ou Valor do cadastro de promoções do Guarani ERP;
23 - Promoção Pague e Leve (SYSPPPL): Exporta as promoções do tipo Bonificação do cadastro de promoções do Guarani ERP;
09 - Contas a Receber (SYSPCRC): Exporta todos os recebimentos em crediários que estão em abertos gerados pelo SysPDV, assim uma venda em crediário feita no SysPDV pode ser recebida em outra loja do grupo com SysPDV. O campo “NUMERO_DOCUMENTO” desse script é de extrema importância e sua lógica não deve ser alterada, pois é através dele que o integrador vai conseguir realizar a baixa no Guarani quando o mesmo for recebido no SysPDV.

Arquivos Recebidos

Os seguintes movimentos são recebidos do SysPDV e importados pelo integrador para o Guarani ERP dentro dos arquivos SYSPCLA e SYSPMOV:

Arquivo SYSPCLA: Clientes enviados pelo SysPDV;
SYSPMOV
- 01 - Item Vendido: Contém os itens das vendas;
- 02 - Finalização: Contém as formas de pagamento de uma venda;
- 03 - Redução Z: Redução Z dos caixas;
- 04 - Item de Troca: Item de troca/devolução registrado no SysPDV, o mesmo é registrado como uma ocorrência dentro da venda de origem se for informada corretamente no SysPDV, caso o integrador não consiga vincular a devolução a uma venda no Guarani, a mesma fica disponível na tela “Geração da Nota de Reentrada Devolução PDV > Devoluções Sem Pedido” do ERP. A nota de reentrada dessas devoluções/trocadas devem ser feitas pela tela “Geração da Nota de Reentrada Devolução PDV” no ERP;
- 06 - Cancelamento de Item: Item de uma venda cancelada antes de ser finalizada;
- 07 - Cancelamento de Finalização: Formas de pagamentos de uma venda cancelada antes de ser finalizada;
- 08 - Plano de Pagamento: Plano de pagamento usado na finalização de uma venda, utilizado para geração das parcelas de crediário no ERP;
- 09 - Recebimento: Baixa de recebimentos dos crediários;
- 13 - Cancelamento cupom anterior: Venda cancelada após ser finalizada;
- 18 - Pagamento: Pagamentos avulsos feitos pelo caixa e que são importados como sangria para o Guarani ERP;
- 19 - Sangria: Sangrias geradas pelo caixa;
- 20 - Reforço de Caixa: Entradas realizadas como suprimento de caixa;

Considerações Importantes dos movimentos importados

O SysPDV não gera movimento de fechamento de caixa, então no Guarani ERP é necessário colocar o caixa em conferência de forma manual na tela “PDV retaguarda - conferência de caixa”, clicando com o botão direto do mouse sobre o caixa em aberto, assim é possível fazer o fechamento do caixa no ERP transferindo os valores dos caixas para as contas correntes desejadas.
A abertura do caixa no Guarani ERP é feita através do primeiro reforço de caixa enviado juntos aos movimentos, uma vez que não existe registro especifico da abertura do caixa.
O serviço do SysPDV que gera a exportação para o Guarani ERP só realizada a exportação em um único horário programado, então é necessário que o mesmo esteja aberto nesse horário, do contrário o movimento dera ser gerado manualmente pela Retaguarda do SysPDV.
Esse horário programado o serviço do SysPDV funciona da seguinte forma: se estiver agendado para fazer até as 09h59min, o movimento exportado será do dia anterior, posterior a esse horário será exportado o movimento do dia uma única vez e de forma incompleta. Nossa recomendação é deixar programado para exportar as 09h00min, assim será gerado o arquivo com o movimento completo do dia anterior. Caso o cliente queria acompanhar as vendas do SysPDV no Guarani durante o dia, a exportação do movimento deve ser feita de forma manual no Retaguarda do SysPDV.
O integrador do Guarani precisa estar aberto e ativo sempre, uma vez que a todo minuto o mesmo verifica se algo precisa ser importado/exportado.

Parâmetros e configurações do Guarani ERP

No guarani ERP é necessário que as configurações ficais esteja cadastradas corretamente, conforme é feito para nosso PDV. O integrador precisa delas para enviar ao SysPDV o comportamento tributário e alíquotas dos produtos. Na importação dos movimentos o integrador checa essa configurações como se o documento fiscal fosse gerado pelo Guarani afim de que seja escriturado corretamente no fiscal.

No caso de ECF/SAT é necessário fazer o cadastro e configuração da impressora no ERP, como é feito hoje no nosso PDV, para que essas informações sejam geradas para o SPED.

É necessário no ERP fazer o cadastro correto dos terminais e de turnos dos usuários para que a movimentação de caixa possa ser gerada no ERP.

Parâmetros Guarani ERP

Os seguintes parâmetros do Guarani ERP são usado diretamente dentro do integrador, porém existem outros parâmetros usados indiretamente e por isso a configuração do Guarani ERP deve estar completa e correta.

Opção padrão para campo "Comercial :: Q/V" no cadastro de clientes [CM_CLI_MODO_PERC]: Integrador utiliza na importação de novos clientes;
Configuração Padrão para comportamento da ST (Clientes Novos) [FN_COMPORTAMENTO_PADRAO_ST]: Integrador utiliza na importação de novos clientes;
Configuração Padrão para comportamento do IPI (Clientes Novos) [FN_COMPORTAMENTO_PADRAO_IPI]: Integrador utiliza na importação de novos clientes;
SysPDV - CFOP padrão para fabricação própria [SYSPDV_CFOP_FAB_PROPRIA]: CFOP utilizado para buscar as configurações ficais dos produtos no envio do cadastro de produtos;
SysPDV - CFOP padrão para produtos de terceiros [SYSPDV_CFOP_FAB_TERC]: CFOP utilizado para buscar as configurações ficais dos produtos no envio do cadastro de produtos;
Define a tabela de preco a ser utilizada. [PDV_TABELA_PRECO]: Tabela de preço principal que será usada para levar o preço junto da exportação dos produtos;
Define a tabela de preco 2 a ser utilizada. (SysPDV) [PDV_TABELA_PRECO_2]: Tabela de preço 2 que será usada para levar o preço desse produto nessa tabela para o campo ”Preço de venda 2” junto da exportação dos produtos para o SysPDV;
Define a tabela de preco 3 a ser utilizada. (SysPDV) [PDV_TABELA_PRECO_3]: Tabela de preço 3 que será usada para levar o preço desse produto nessa tabela para o campo ”Preço de venda 3” junto da exportação dos produtos para o SysPDV;
Codigo do cliente a ser utilizado como consumidor. [PDV_CLIENTE_CONSUMIDOR]: Cliente consumidor utilizado para registrar as vendas importadas para o Guarani;
Define o evento de entradas atraves de venda no caixa. [PDV_CAIXA_EVE_VENDAS]: Evento para adicionar as movimentações de vendas na contas correntes do terminais do ERP;
Evento Contas Pagar Entrada [FN_EVECONTAS_PAGAR_ENTRADA]: Evento usado para registrar a taxa de cartão na conta corrente;
Define o evento de entrada de caixa. [PDV_CAIXA_EVE_ENTRADA]: Evento para registrar os suprimentos do caixas no ERP;
Define o evento de sangria de caixa. [PDV_CAIXA_EVE_SANGRIA]: Evento usado para registrar as sangrias dos caixas no ERP;
Evento Contas Receber Saida [FN_EVECONTAS_RECEBER_SAIDA]: Evento usado no estorno de uma parcela do recebimento pago, utilizado no cancelamento dos pedidos;
Quando ocorre geração da comissão para o representante? (FATURAMENTO/RECEBIMENTO) [CM_TIPO_COMISSAO]: Evento usado no estorno de uma parcela do recebimento pago, utilizado no cancelamento dos pedidos;
Estorna comissao de cheque devolvido mesmo que comissao paga no faturamento? [CM_COMISSAO_ESTORNO_CHEQUE_DEV]: Evento usado no estorno de uma parcela do recebimento pago, utilizado no cancelamento dos pedidos;
Lança comissão quando gerar título manual? [CM_COMISSAO_PEDIDO_MANUAL]: Evento usado no estorno de uma parcela do recebimento pago, utilizado no cancelamento dos pedidos;
Gerar verba em que momento? (FATURAMENTO / RECEBIMENTO) [CM_VERBA_GERACAO]: Evento usado no estorno de uma parcela do recebimento pago, utilizado no cancelamento dos pedidos;

Instalação

A instalação deve ser feita no servidor do cliente através do SETUP que se encontra no FTP em “FTP\Sistemas\Guarani Integrador SysPDV\Setup\Setup_IntegradorSysPDV_vX.X.X.X.exe”.

O integrador será instalado em “C:\Guarani\Integrador SysPDV”. Será gerado um atalho na área de trabalho da configuração do integrador “Guarani Integrador SysPDV”.

Atualização é feita atualmente de forma manual, substituindo o executável do integrador pela versão mais nova encontrada na pasta “Z:\Sistemas\Guarani Integrador SysPDV\Executável”.

O integrador só deve ser instalado e iniciado em apenas uma máquina, afim de evitar duplicação de dados.

Tela Principal

Botões de Controle

Os botões “Iniciar” e “Parar” são responsáveis por iniciar ou parar a sincronização automática. Por padrão, assim que o integrador é aberto a sincronização é iniciada automaticamente, porém se houver alguma configuração faltando o mesmo não poderá ser iniciado até que seja resolvido. Para ver as configurações faltantes basta olhar na aba logs, a abaixo estão as explicações das configurações.

Aba “Logs”

Nessa aba serão registradas todas as ocorrências e detalhes das sincronizações feitas, é muito importante manter o monitoramento dessa aba para verificar o funcionamento da integração.

Clicando duas vezes sobre o registro de um log, o mesmo será exibido como mensagem de forma completa.

Entendendo alguns Logs

O log que contiver os dizeres “Relacionamento para … não encontrado!“ significa que o sistema não conseguiu encontrar na configuração “De → Para”, explicada abaixo, o cadastro correspondente no Guarani, então fazendo essa configuração resolve o problema.
Quando houver log escrito “Total da Venda .. ficará diferente do …” é devido alguma informação/item faltante no arquivo, muitas vezes ao importar o arquivo novamente resolve o problema, outras vezes é preciso analisar o movimento no SysPDV e no arquivo enviado para verificar possíveis erros. Esses erros não devem ocorrer com frequência, só em casos esporádicos de algum problema na geração do arquivo. Caso no arquivo esteja certo, verifique o campo “Chave” esta marcado de forma correta para tornar o arquivo único, explicado abaixo na configuração do layout, pois alguns itens podem não ser importados se não estiver com o layout configurado de forma correta.
Se existir a mensagem “Já existe uma NF com a combinação EMPRESA|TERMINAL|MODELO|SERIE|NUMERO emitida para o pedido …” é necessário mudar a serie do SAT/ECF que esta no Cadastro da Empresa no Guarani ERP, uma vez que a serie do SAT/ECF são extraídas desse cadastro.
Havendo a mensagem “Situação Tributária não informada em um dos itens!”, é necessário verificar o CST de ICMS que esta na venda e informar ao suporte da Guarani para ser corrigido direto no banco do integrador, uma vez que o SysPDV mandou o campo em banco. Esse é um erro muito raro de acontecer, mas não impossível e precisa ser resolvido através de solicitação.

Aba “Erros”

A aba “Erros” mostra um resumo dos erros ocorridos na importação dos movimentos, podendo o usuário ignorar a movimentação clicando com o botão direito sobre o registro do erro, é útil quando o SysPDV manda algum movimento errôneo que não deve ser importado para o Guarani (Venda sem número de documento fiscal, por exemplo).

Aba “Ignorados”

Na aba “Ignorados” são apresentados os movimentos que foram ignorados através da aba “Erros”, podendo o usuário voltar esse movimento para a fila de importação clicando com o botão direito sobre o registro.

Aba “Total Importado”

A aba “Total Importado” é útil para que o usuário possa verificar os valores importados para o integrador e os valores que constam no Guarani ERP, assim verificando por dia e empresa se esses valores batem com os valores constantes no SysPDV.

Menu Arquivo

Atualizar Log

Atualiza a aba de logs da tela principal. Pode ser acessado em “Arquivos > Atualizar Log”:

Carga Completa

A carga completa existe para enviar de forma completa os dados do Guarani para o SysPDV. A sincronização automática já faz isso, porém apenas para os registros alterados depois da primeira sincronização, se algum parâmetro ou configuração fiscal for alterado, é importante realizar uma carga completa para garantir que foram enviados todos os registros afetados por essa mudança. No dia a dia, apenas a sincronização automática já faz o necessário para enviar as mudanças feitas nos registros do Guarani para o SysPDV. Pode ser acessado em “Arquivos > Carga Completa”:

Na tela aberta é possível selecionar as empresas para qual a carga será feitas e os arquivos desejados e depois em clicar em “Gerar Carga”. O log da geração da carga será exibido no quadro “Log” para saber se a carga pode ser gerada e gravada na pasta corretamente.

Menu Configurações

Configuração Banco, FTP e E-mail

O primeiro passo após a instalação é realizar a configuração do banco do ERP, FTP e E-mail para recebimento dos erros. Isso deve ser feito em “Configurações > Fonte de Dados”:

Aba “Banco Guarani ERP”

Nessa aba precisamos configurar o banco de dados do Guarani ERP, informando o endereço do servidor, usuário, senha e caminho do banco de dados. É recomendável criar um usuário no ERP e usar esse usuário para acesso ao banco no integrador, assim é possível rastrear os registros alterados pelo integrado.

Aba “FTP”

Na aba “FTP” precisamos configurar o servidor FTP responsável pela troca dos arquivos. O campo “Pasta trash” seve ser preenchido com o caminho da pasta do FTP que será usada para armazenar uma cópia dos arquivos recebidos, uma vez que o arquivo será excluído após ser processado.

Aba “E-mail”

Aqui será feita a configuração do envio de e-mails dos logs, baseado no intervalo definido “Checar a cada (minuto)”, o sistema envia um e-mail para o destinatário definido com os erros que estão nos logs do integrador para que o mesmo possa resolver. Se a opção “Enviar mesmo sem erro” estiver marcada, será enviado um e-mail no intervalo definido mesmo que não existam erros, assim o usuário sabe ao receber o e-mail que o integrador esta ativo.

Configuração dos Layouts

A configuração dos layouts dos arquivos de importação/exportação pode ser feita acessando “Configurações > Query Builder (Layouts)”:

Essa tela contém todos os scripts para geração dos arquivos, bem como o layout em que o mesmo será gerado.

É importante tomar cuidado ao alterar essa tela, uma vez que os scripts já estão em funcionamento no cliente e são baseados nos layouts do SysPDV abaixo:

Aba “Query”

Nessa aba contém o script do banco necessário para a exportação do arquivo, o mesmo pode conter parâmetros pré-definidos no código, onde o mais comum é o parâmetro “LASTUPDATE”, onde o integrador preenche com a data e hora da ultima integração desse arquivo, buscando assim somente os registros que foram modificados desde da ultima integração. Podemos definir se esse layout esta ativo e o intervalo em que ele será gerado. Essa aba só será preenchida nos script s de Exportação, uma vez que importação não depende de um script e sim do layout.

O botão “Testar” funciona apenas para Exportação, ele serve para realizar um teste no script exatamente como a rotina automática fará, onde será solicitado o código da empresa para extração dos dados, após executar, o sistema muda para a aba “Resultado (Query)” com o retorno do script.

Aba “Layout”

Nessa aba é onde será montado o layout em que o script será exportado/importado.

Comportamento da criação do Layout:
- Tipo Layout: É necessário definir como será o tipo do Layout, sendo “Texto com Tamanho Fixo” ou “Texto com Separadores”, onde esse segundo habilita o campo “Separador” para informar qual caractere separador será usado. No SysPDV usamos o tipo “Texto com Tamanho Fixo” em todos os layouts;
- Usar Identificador: Esse campo deve ser marcado quando o layout exigir algum tipo de identificador, usado geralmente quando existe um cabeçalho e detalhes, assim o sistema consegue pelo identificador saber qual linha é qual tipo de registro.
  - Para correto funcionamento, quando existir identificador do registro, acrescente na query o identificador com o nome de campo "IDENT", como primeiro campo, assim separando os registros na mesma query.
  - Os arquivos SYSPPPL e SYSPCRC são exemplos de uso do identificador.
  - Será habilitado um grid para informar o identificador:
    - Nesse grid serão criados os identificadores e para cada identificador será necessário informar os campos que o compõe no grid “Campos”.
Grid Campos:
- Posição: Como o Layout é por posição do texto, é extremante importante que verificar se o campo esta na posição correta e com seu tamanho correto;
- Campo:
  - Layout Exportação: será possível escolher o nome do campo que esta no script da aba “Query”, se for selecionado :BLANK ou deixar vazio, será preenchido o espaço do tamanho definido nesse campo.
  - Layout Importação: Será informado o nome do campo que esta no layout do SysPDV, o nome não pode se repetir entre os campos informado e não deve conter espaços, uma vez que o mesmo será criado na tabela que armazena os registros importados.
- Descrição: Serve apenas para identificar melhor o campo;
- Tipo: Deve ser informado como esse campo deve ser tratado na importação/exportação do arquivo:
  - Texto: Preenche campo com o texto do script colocando espaços a direita para completar o tamanho do campo;
  - Decimal: Define o campo como sendo um número com casas decimais, onde seve ser informado quantas casas são permitidas no campo “Decimal”, será preenchido o restante do tamanho do campo com zeros a esquerda;
  - Número: Define que esse campo será tratado como um número inteiro, porém o tamanho máximo é 7, caso o conteúdo seja maior que 7, será necessário selecionar a opção “Texto (Apenas Numero)”, será preenchido o restante do tamanho do campo com zeros a esquerda;
  - Data (ddmmaaaa): Usado em campo de data para que seja exportado/importado levando em conta o formato ddmmaaaa;
  - Data (aaaammdd): Usado em campo de data para que seja exportado/importado levando em conta o formato aaaammdd;
  - Data Hora (YYYY-MM-DD HH:MM:SS): Usado em campo de data e hora para que seja exportado/importado levando em conta o formato YYYY-MM-DD HH:MM:SS;
  - Hora (HH:MM): Usado em campo de hora para que seja exportado/importado levando em conta o formato HH:MM;
  - Texto (Sem acento): Preenche campo com o texto do script, removendo os acentos e colocando espaços a direita para completar o tamanho do campo;
  - Texto (Apenas Numero): Usado para campo que deve ser apenas número inteiros maior que 7 dígitos, por exemplo: CPF, CNPJ, IE, etc…. Será preenchido o restante do tamanho do campo com zeros a esquerda;
  - Constante: Preenche com o texto colocado na coluna “Campo”, colocando espaços a direita para completar o tamanho do campo;
  - Sequencial: Preenche com o número que esta na coluna “Posição”, será preenchido o restante do tamanho do campo com zeros a esquerda;
  - Chave: Usado apenas na importação do arquivo, esse campo é responsável por definir quais campo do layout são chaves, ou seja, que tornam o registro importado único, ele é usado para não deixar importar movimentos duplicados quando for enviado o mesmo arquivo duas vezes.
- Tamanho: Informa o tamanho máximo do campo, no caso do tipo “Decimal” deverá considerar a quantidade de caracteres decimais e o ponto que será usado para separar, exemplo: 999.9999 deverá ser informado o tamanho 8;

O botão “Testar”, funciona apenas para Exportação, ele executa o script e gera o resultado no formado do layout na aba “Resultado (Layout)”;

Configuração De->Para

A configuração De->Para é de extrema importância na importação dos arquivos, pois é através dela que o integrador consegue identificar as informações vidas dos SysPDV e traduzi-las para o Guarani ERP, criando assim uma relação entre os dois sistemas, qualquer informação incorreta preenchida pode gerar dados incorretos no Guarani ao importar os movimentos. A configuração pode ser feita acessando “Configurações > De → Para”:

Aba “Lojas”

Nessa aba vamos configurar quais as empresa do Guarani ERP serão integradas ao SysPDV e quais as pastas do FTP estão os arquivos dessa empresa. As pastas devem ser separadas por empresa, uma vez que não existe nada nos arquivos de identificação da loja que estamos mandando ou recebendo arquivos. O sistema cria automaticamente a pasta no FTP, caso não exista. Essa mesma pasta deve ser configurada no SysPDV para recepção e envio dos arquivos, sendo: “FTP Input” será a pasta que armazena os arquivos que o Guarani envia para o SysPDV, “FTP_OUTPUT” a pasta que armazenas os arquivos que o SysPDV envia para o Guarani.

Aba “Caixas”

Aqui vamos definir como cada caixa do SysPDV vai se comportar quando entrar no Guarani. Sendo necessário o preenchimento correto dos campos:

Empresa: Informar a empresa que corresponde ao caixa que esta sendo configurado;
Terminal Guarani: Informar qual terminal do Guarani corresponde ao caixa configurado;
ID Caixa SysPDV: Informar o código do caixa no SysPDV que esta sendo configurado;
Tipo de Ordem: Informar o tipo de ordem do Guarani para registro das vendas realizadas no caixa configurado, é importante criar um tipo de ordem para cada caixa;
Cobrança Padrão: Cobrança padrão que será usada nesse caixa, porém existe uma configuração especifica que será explicada mais abaixo;
Local Estoque: Local de estoque usado para movimentação de estoque dos produtos do caixa configurado;
Vendedor Padrão: Vendedor padrão que será usado nesse caixa, porém existe uma configuração especifica que será explicada mais abaixo;

Aba “Usuários”

Nessa aba vamos configurar o relacionamento dos usuários entre o SysPDV e o Guarani:

Empresa Guarani: Informar a empresa correspondente ao código do usuário que será configurado, se o campo "Empresa Guarani" ficar em branco subentende-se que a configuração é para todas as empresas, ou seja, o usuário possui o mesmo código do SysPDV em todas as lojas.
Nome Usuário Guarani: usuário equivalente no Guarani;
ID Usuário SysPDV: código do usuário que é informado pelo SysPDV;

Aba “Vendedores”

Vamos configurar o relacionamento dos vendedores registrados nas vendas do SysPDV com o Vendedor/Representante do Guarani:

Empresa Guarani: Informar a empresa correspondente ao código do vendedor que será configurado, se o campo "Empresa Guarani" ficar em branco subentende-se que a configuração é para todas as empresas, ou seja, o usuário possui o mesmo código do SysPDV em todas as lojas.
ID Vendedor Guarani: Vendedor/Representante equivalente no Guarani;
ID Vendedor SysPDV: código do vendedor que é informado pelo SysPDV;

Aba “Cobranças”

Nessa aba vamos configurar as cobranças de baixa do Guarani ERP com as Finalizadoras e Planos de Pagamento do SysPDV:

Empresa Guarani: Informar a empresa correspondente a cobrança que será configurada, se o campo "Empresa Guarani" ficar em branco subentende-se que a configuração é para todas as empresas, ou seja, o usuário possui o mesmo código do SysPDV em todas as lojas.
ID Baixa Guarani: Cobrança de baixa para recebimentos dos movimentos registrados no Guarani;
ID Finalizadora SysPDV: código da finalizadora de venda no SysPDV:
- Os clientes costumam criar uma finalizadora para cada adquirente/bandeira de cartão no SysPDV para melhor vincular com as cobranças no Guarani e suas taxas;
ID Plano Pagamento: Informar o id do plano de pagamento do SysPDV, quando houver.
- O plano de pagamento é usado para Cartão e Crediário, é considerado a condição do pagamento, não é obrigatório, mas nossos clientes utilizam para poder vincular com a cobrança do Guarani de forma correta e registrar as taxas dos cartões. Uma vez que no Guarani a taxa de cartão é na cobrança de baixa, assim é necessário ter uma cobrança para cada adquirente, cartão e quantidade de parcelas, para evitar a criação de muitas finalizadoras correspondente no SysPDV, é usado o plano de pagamento para controlar a quantidade de parcelas, sendo necessário ter finalizadora apenas por adquirente/bandeira, porém não para parcelas.

É muito importante que a cobrança de baixa no Guarani esteja configurada corretamente, como os campos:

Cobrança (PDV): Cobrança para Lançamento correspondente a cobrança da baixa.
- Nessa cobrança para lançamento é importante que o campo “Carteira padrão” esteja informado para preenchimento correto do contas a receber;
Cartão - Taxa (PDV): taxa de cartão, quando finalidade = “CARTAO”, para registro da taxa da adquirente;
Cartão - Dias Crédito (PDV): Dias para crédito da parcela, quando finalidade = “CARTAO” ou “FICHA”, importante para colocar corretamente o vencimento da parcela.
Finalidade/Origem*: Tipo de finalidade da cobrança de baixa.

Aba “Bandeira de Cartão”

Aqui configuramos o relacionamento das bandeiras de cartão entre o Guarani e SysPDV.

ID Bandeira Guarani: Informe a bandeira no Guarani correspondente;
ID Bandeira SysPDV: Informe o código da bandeira no SysPDV. Esse código pode ser encontrado no Layout de exportação do SysPDV ou diretamente com o pessoal do SysPDV.

Menu Ferramentas

O menu ferramentas deve ser usado apenas pela equipe Guarani, mediante a senha, pois realiza algumas funções irreversiveis no integrador, como as limpezas de Log, Dados Recebidos e De → Para:

[Manual] Integração SYSPDV