sHub: Integração fácil com tecnologias Synapse

Ao executar o sHub pela primeira vez, a tela de configuração se abrirá.

Essa tela se abre automaticamente sempre que iniciar o sHub e o mesmo não conseguir se conectar ao banco de dados.

Caso já tenha configurado o sHub, mas deseja alterar algo na configuração, basta executar o sHub pelo prompt de comandos com o parâmetro -config

Nessa aba, você deve selecionar o banco de dados do software da loja e configurar o acesso ao mesmo.

Todas as opções de banco de dados possuem o botão para testar a conexão com o banco de dados.

Em caso de sucesso, será exibida a seguinte mensagem:

Em caso de erro, será exibida uma mensagem com o erro em questão para que se possa corrigir o mesmo:

Independentemente do banco escolhido, você poderá configurar o intervalo de tempo (em minutos) para que cada sincronização ocorra e também se o sHub deve ou não gerar o arquivo de log do mesmo.

Na seção "Arquivos auxiliares" é detalhada a estrutura desse arquivo de log.

Veja abaixo as opções de configuração de cada tipo de banco de dados compatível com o sHub.

Firebird

• Banco de dados
  Informe o caminho do banco de dados.
  Você pode digitar o caminho ou utilizar o botão para localizar o banco no computador.


• Porta
  Porta utilizada pelo Firebird.
  Vem configurada com a 3050 que é o padrão do Firebird.


• User Name
  Usuário do banco de dados.
  Vem configurado com SYSDBA que é o padrão do Firebird.


• Password
  Senha do banco de dados.
  Vem configurado com masterkey que é o padrão do Firebird.

Interbase

São as mesmas opções de configuração do Firebird.

MySQL

• Server
  Informe o server do banco de dados.
  Você pode informar o IP ou nome do computador.
  O botão pega o nome do computador local, porém para funcionamento local, basta informar localhost ou o IP 127.0.0.1.


• Porta
  Porta utilizada pelo MySQL.
  Vem configurada com a 3306 que é o padrão do MySQL.


• Schema
  Informe o nome do banco de dados.


• User Name
  Usuário do banco de dados.
  Vem configurado com root que é o padrão do MySQL.


• Password
  Senha do banco de dados.

Ao testar a conexão com o banco, pode ocorrer o erro abaixo:

Esse erro ocorre por conta do plugin de autenticação "caching_sha2_password" introduzido no MySQL 8.0.

O sHub não é compatível com tal plugin, então é necessário criar um usuário com o plugin "mysql_native_password" para ser utilizado pelo sHub.

Execute os comandos abaixo no MySQL para criar tal usuário:

mysql> CREATE USER 'shub'@'%' IDENTIFIED WITH mysql_native_password BY 'sua_senha';
mysql> GRANT ALL PRIVILEGES ON *.* TO 'shub'@'%' WITH GRANT OPTION;
mysql> FLUSH PRIVILEGES;

Nesse caso, o User Name será shub e a Password será a senha informada em 'sua_senha'.

MariaDB

São as mesmas opções de configuração do MySQL.

Ao testar a conexão com o banco, pode ocorrer o erro abaixo:

Esse é um problema que ocorre no cache de algumas versões do MariaDB.

Para corrigir esse problema, é necessário editar o arquivo de configurações do MySQL.

Procure a seção [mysqld] e acrescente a linha abaixo:

[mysqld]
table_definition_cache=4000

Salve o arquivo e reinicie o serviço do MySQL/MariaDB.

Arquivo de exemplo

SQL Server

• Server
  Informe o server do banco de dados.
  Você pode informar o IP ou nome do computador.
  O botão pega o nome do computador local, porém para funcionamento local, basta informar localhost ou o IP 127.0.0.1.


• Schema
  Informe o nome do banco de dados.


• User Name
  Usuário do banco de dados.
  Vem configurado com sa que é o padrão do SQL Server.


• Password
  Senha do banco de dados.


• Autenticação do Windows
  Utilize essa opção ao invés de "User Name" e "Password" quando o SQL Server estiver configurado para acessar via autenticação do Windows.

PostgreSQL

• Server
  Informe o server do banco de dados.
  Você pode informar o IP ou nome do computador.
  O botão pega o nome do computador local, porém para funcionamento local, basta informar localhost ou o IP 127.0.0.1.


• Porta
  Porta utilizada pelo PostgreSQL.
  Vem configurada com a 5432 que é o padrão do PostgreSQL.


• Schema
  Informe o nome do banco de dados.


• User Name
  Usuário do banco de dados.
  Vem configurado com postgres que é o padrão do PostgreSQL.


• Password
  Senha do banco de dados.

Nessa aba, você deve informar os dados de acesso ao Delivery Pharmacy.

• Sincronizar
  Marque essa opção para que o sHub sincronize os dados com o Delivery Pharmacy.


• ID ERP
  ID único por ERP fornecido pela Synapse Tecnologia.
  Representa o software do banco de dados.


• ID Empresa
  ID único por empresa fornecido pela Synapse Tecnologia.


• Token
  Token único por empresa fornecido pela Synapse Tecnologia.


• Última sincronização
  Exibe a data e hora da última sincronização do Delivery Pharmacy pelo sHub.
  Esse campo é somente leitura.

sHub /?

ou

sHub /ajuda

ou

sHub /help

Será exibida a seguinte tela com os comandos disponíveis:

Executa uma sincronização.

Esse parâmetro exige um segundo parâmetro que representa a plataforma a ser sincronizada.

Se executado sem o parâmetro de plataforma, ele exibe a seguinte tela:

sHub /sync -all

sHub /sync -"nome da plataforma"

Exemplo: sHub /sync -delivery_pharmacy

Se executado com uma plataforma inválida é exibida a seguinte tela:

sHub /sync -helio

O parâmetro de plataforma deve ser antecipado pelo caracter “-“ (menos), caso ele não seja informado, será exibida a seguinte tela:

sHub /sync helio

Abre a tela de configuração do sHub explicada na seção "Configuração".

sHub -config

Ao informar um parâmetro inválido no sHub, a seguinte tela será exibida:

sHub helio

Se o sHub estiver habilitado para gerar log de sincronização, ele criará o arquivo “Log sHub.txt” e esse arquivo possui a seguinte estrutura:

00130072024144025759024 Delivery Pharmacy - Sincronização iniciada em 30/07/2024 14:14:25
00130072024144025759024     --> 11 pedido(s) importado(s) para sdp_pedidos com produtos em sdp_pedidos_produtos
00130072024144025759024     --> 1 registro(s) de sdp_pedidos_cancelados sincronizado(s)
00130072024144025759024     --> 1 registro(s) de sdp_formas_pagto sincronizado(s)
00130072024144025759024     --> 5 registro(s) de sdp_produtos sincronizado(s)
00130072024144025759024     --> 1 registro(s) de sdp_promocoes sincronizado(s)
00130072024144025759024     --> 2 registro(s) de sdp_promocoes_produtos sincronizado(s)
00130072024144025759024 Delivery Pharmacy - Sincronização finalizada em 30/07/2024 14:14:29
03430072024143942258026 Delivery Pharmacy - Sincronização iniciada em 30/07/2024 14:39:42
03430072024143942258026 Delivery Pharmacy - Sincronização não finalizada
				

Cada linha começa com uma sequência numérica (ID único) que identifica aquela sincronização específica.

O ID pode ser utilizado para localizar informações sobre a sincronização tanto no arquivo de log quanto no de exceções, que será explicado mais adiante.

Após o ID, vem o nome da plataforma da sincronização seguido pelo status do registro.

Em caso de sincronização não finalizada, o motivo da "não finalização" estará registrado no arquivo de exceções, sendo possível localizá-lo pesquisando pelo ID da sincronização.

Exceção é o termo técnico para um erro em um sistema.

O sHub cria o arquivo “Excecoes sHub.txt” em sua primeira exceção.

Nesse arquivo são registradas todas as exceções ocorridas no sHub no formato do exemplo abaixo:

03430072024143942258026       –> ID da sincronização
30/07/2024 14:39:42           –> Data e hora da exceção

Build.....: 2024.1.0.0        –> Versão do sHub
Plataforma: Delivery Pharmacy –> Plataforma da sincronização

Exceção do sHub:              –> Origem da exceção (do sHub ou da plataforma)

Column unknown                –> Mensagem da exceção
VRTOTAL
At line 6, column 31
				

SQL para criar a View (adaptar de acordo com a estrutura do seu banco de dados):

CREATE VIEW sdp_produtos AS
SELECT
    campo1 as codigo,
    campo2 as nome,
    campo3 as valor,
    campo4 as descricao,
    campo5 as indisponivel,
    campo6 as quantidade_caixa,
    campo7 as inativo,
    campo8 as codigo_barras,
    campo9 as valor_promocao,
    campo10 as estoque,
    campo11 as principio_ativo
FROM
    sua_tabela_produtos;
				

Todos os códigos de barras do produto no software da loja, inclusive o código de barras informado na view de produtos.

SQL para criar a View (adaptar de acordo com a estrutura do seu banco de dados):

CREATE VIEW sdp_codigos_barras AS
SELECT
    campo1 as codigo_produto,
    campo2 as codigo_barras
FROM
    sua_tabela_codigos_barras;
				

SQL para criar a View (adaptar de acordo com a estrutura do seu banco de dados):

CREATE VIEW sdp_formas_pagto AS
SELECT
    campo1 as codigo,
    campo2 as nome,
    campo3 as pedir_troco
FROM
    sua_tabela_formas_pagamento;
				

Crie essa tabela caso queira receber os pedidos feitos no Delivery Pharmacy.

O sHub vai gravar os dados dos pedidos nessa tabela.
Utilize tais dados para processar os pedidos no seu software de acordo com suas regras de negócio.

CREATE TABLE sdp_pedidos (
    id_pedido VARCHAR(50) PRIMARY KEY,
    id_cliente VARCHAR(50),
    cliente_cpf VARCHAR(14),
    cliente_email VARCHAR(100),
    cliente_nome VARCHAR(100),
    cliente_endereco_logradouro VARCHAR(100),
    cliente_endereco_numero VARCHAR(20),
    cliente_endereco_complemento VARCHAR(100),
    cliente_endereco_referencia VARCHAR(100),
    cliente_endereco_bairro VARCHAR(50),
    cliente_endereco_cidade VARCHAR(50),
    cliente_endereco_uf CHAR(2),
    cliente_endereco_cep VARCHAR(9),
    cliente_telefone VARCHAR(14),
    forma_entrega INTEGER,
    forma_pagamento VARCHAR(50),
    nao_precisa_troco INTEGER,
    troco_para DECIMAL(10, 2),
    status_efetuado TIMESTAMP,
    status_separacao TIMESTAMP,
    status_pronto_entrega TIMESTAMP,
    status_saiu_entrega TIMESTAMP,
    status_entrega TIMESTAMP,
    status_sincronizado TIMESTAMP,
    status_cancelado TIMESTAMP,
    status_motivo_cancelamento VARCHAR(200),
    cupom VARCHAR(50),
    valor_cupom DECIMAL(10, 2),
    valor_taxa_entrega DECIMAL(10, 2),
    valor_produtos DECIMAL(10, 2),
    valor_total DECIMAL(10, 2),
    numero_pedido INTEGER,
    vendedor_email VARCHAR(100),
    id_vendedor VARCHAR(50)
);

CREATE TABLE sdp_pedidos (
    id_pedido VARCHAR(50) PRIMARY KEY,
    id_cliente VARCHAR(50),
    cliente_cpf VARCHAR(14),
    cliente_email VARCHAR(100),
    cliente_nome VARCHAR(100),
    cliente_endereco_logradouro VARCHAR(100),
    cliente_endereco_numero VARCHAR(20),
    cliente_endereco_complemento VARCHAR(100),
    cliente_endereco_referencia VARCHAR(100),
    cliente_endereco_bairro VARCHAR(50),
    cliente_endereco_cidade VARCHAR(50),
    cliente_endereco_uf CHAR(2),
    cliente_endereco_cep VARCHAR(9),
    cliente_telefone VARCHAR(14),
    forma_entrega INT,
    forma_pagamento VARCHAR(50),
    nao_precisa_troco INT,
    troco_para DECIMAL(10, 2),
    status_efetuado TIMESTAMP,
    status_separacao TIMESTAMP,
    status_pronto_entrega TIMESTAMP,
    status_saiu_entrega TIMESTAMP,
    status_entrega TIMESTAMP,
    status_sincronizado TIMESTAMP,
    status_cancelado TIMESTAMP,
    status_motivo_cancelamento VARCHAR(200),
    cupom VARCHAR(50),
    valor_cupom DECIMAL(10, 2),
    valor_taxa_entrega DECIMAL(10, 2),
    valor_produtos DECIMAL(10, 2),
    valor_total DECIMAL(10, 2),
    numero_pedido INT,
    vendedor_email VARCHAR(100),
    id_vendedor VARCHAR(50)
);

CREATE TABLE sdp_pedidos (
    id_pedido VARCHAR(50) PRIMARY KEY,
    id_cliente VARCHAR(50),
    cliente_cpf VARCHAR(14),
    cliente_email VARCHAR(100),
    cliente_nome VARCHAR(100),
    cliente_endereco_logradouro VARCHAR(100),
    cliente_endereco_numero VARCHAR(20),
    cliente_endereco_complemento VARCHAR(100),
    cliente_endereco_referencia VARCHAR(100),
    cliente_endereco_bairro VARCHAR(50),
    cliente_endereco_cidade VARCHAR(50),
    cliente_endereco_uf CHAR(2),
    cliente_endereco_cep VARCHAR(9),
    cliente_telefone VARCHAR(14),
    forma_entrega INT,
    forma_pagamento VARCHAR(50),
    nao_precisa_troco INT,
    troco_para DECIMAL(10, 2),
    status_efetuado DATETIME,
    status_separacao DATETIME,
    status_pronto_entrega DATETIME,
    status_saiu_entrega DATETIME,
    status_entrega DATETIME,
    status_sincronizado DATETIME,
    status_cancelado DATETIME,
    status_motivo_cancelamento VARCHAR(200),
    cupom VARCHAR(50),
    valor_cupom DECIMAL(10, 2),
    valor_taxa_entrega DECIMAL(10, 2),
    valor_produtos DECIMAL(10, 2),
    valor_total DECIMAL(10, 2),
    numero_pedido INT,
    vendedor_email VARCHAR(100),
    id_vendedor VARCHAR(50)
);

CREATE TABLE sdp_pedidos (
    id_pedido VARCHAR(50) PRIMARY KEY,
    id_cliente VARCHAR(50),
    cliente_cpf VARCHAR(14),
    cliente_email VARCHAR(100),
    cliente_nome VARCHAR(100),
    cliente_endereco_logradouro VARCHAR(100),
    cliente_endereco_numero VARCHAR(20),
    cliente_endereco_complemento VARCHAR(100),
    cliente_endereco_referencia VARCHAR(100),
    cliente_endereco_bairro VARCHAR(50),
    cliente_endereco_cidade VARCHAR(50),
    cliente_endereco_uf CHAR(2),
    cliente_endereco_cep VARCHAR(9),
    cliente_telefone VARCHAR(14),
    forma_entrega INT,
    forma_pagamento VARCHAR(50),
    nao_precisa_troco INT,
    troco_para NUMERIC(10, 2),
    status_efetuado TIMESTAMP,
    status_separacao TIMESTAMP,
    status_pronto_entrega TIMESTAMP,
    status_saiu_entrega TIMESTAMP,
    status_entrega TIMESTAMP,
    status_sincronizado TIMESTAMP,
    status_cancelado TIMESTAMP,
    status_motivo_cancelamento VARCHAR(200),
    cupom VARCHAR(50),
    valor_cupom NUMERIC(10, 2),
    valor_taxa_entrega NUMERIC(10, 2),
    valor_produtos NUMERIC(10, 2),
    valor_total NUMERIC(10, 2),
    numero_pedido INT,
    vendedor_email VARCHAR(100),
    id_vendedor VARCHAR(50)
);

Nessa view devem ser informados os pedidos cancelados no software da loja.

SQL para criar a View (adaptar de acordo com a estrutura do seu banco de dados):

CREATE VIEW sdp_pedidos_cancelados AS
SELECT
    campo1 as id_pedido,
    campo2 as motivo
FROM
    sua_tabela_pedidos
WHERE
    campo_cancelado = 'S';