> For the complete documentation index, see [llms.txt](https://suporte-conttrade.gitbook.io/instalacoes-reinstalacoes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://suporte-conttrade.gitbook.io/instalacoes-reinstalacoes/instalacao-plug-sales/plug-web-e-plug-service.md).

# Plug Web e Plug Service 

## 1 º Passo: Criando a pastas padrões

Criar a pasta "PlugSales" dentro da "CONTTRADE.Util" que se encontra no (C:\  ou D:\ ou E:\\) se não tiver a existente no C:\\.

* C:\CONTTRADE.Util\PlugSales ou 
* D:\CONTTRADE.Util\PlugSales ou 
* E:\CONTTRADE.Util\PlugSales

Dentro da pasta Criar "?:\CONTTRADE.Util\PlugSales"<br>

**?**:\CONTTRADE.Util\PlugSales \PlugSalesService

**?**:\CONTTRADE.Util\PlugSales \PlugSalesWeb

## 2º Passo: Transferindo os arquivos necessários

&#x20;Copiar todos os arquivos necessários para instalação e utilização, e colocá-los na pasta criada(existente) acima.

Endereço Externo: [Google Drive](https://drive.google.com/drive/folders/10ckJ6eqsEEL_4QbMsT7ao-K1uPjOuKSl?usp=sharing)\
Endereço Interno: \\\192.168.11.200\AreaCONTTRADE\Prog\_PlugSales

* aaaa.mm.dd\_PlugSalesWeb.exe
* aaaa.mm.dd\_PlugSalesService.exe
* Config.RAR

Descompactar o aaaa.mm.dd\_PlugSalesWeb.exe na pasta PlugSalesWeb criada anteriormente;

Descompactar o aaaa.mm.dd\_PlugSalesService.exe na pasta PlugSalesService criada anteriormente;

Descompactar o CONTTRADEConfig.rar na pasta \CONTTRADE.Util\\&#x20;

## 3º Passo:  Instalação do PostgreSQL <mark style="color:red;">(Caso não tenha)</mark>&#x20;

Instalar o gerenciador de bando de dados PostgreSQL e PgAdmin e Criar o banco de dados "dbPlugSales".\
&#x20;<mark style="color:red;">**(Atenção por que pode ja estar instalado)**</mark>\
\
\# Criar o banco de dados "dbPlugSales" no PostgreSQL

## 4 º Passo:  Criando o PlugSales.config, para apontar o banco, adicionando a porta correta para a aplicação rodar

Arquivo de configuração do banco de dados do PlugSales criado no passo anterior.\
Executar de dentro da pasta CONFIG o "conttrade.config.exe" \
Realizar as configurações do banco fazendo o apontamento com os dados necessários.&#x20;

Este arquivo deverá ser criado em ambas as pastas

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FQtUyYGmB2v0Jh9VQLkum%2Fimage.png?alt=media&amp;token=adea586b-e656-4bbc-96be-3aa6641727df" alt=""><figcaption></figcaption></figure>

Editar o arquivo pluagsales.config (criado anteriormente) em ambas as pastas e incluir a linha abaixo de \<appSettings>

`<add key="App-Port" value="8888" />`&#x20;

Salve o arquivo!

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FEb3SE5aoA9T2JxVAMWqM%2Fimage.png?alt=media&amp;token=06dcddb9-8c3c-4802-b705-0bc8eafb3061" alt=""><figcaption></figcaption></figure>

## 5º Passo:  Configurando o caminho da pasta verbose

Criar a pasta VERBOSE na pasta "**?**:\CONTTRADE.Util\PlugSales \PlugSalesWeb\\"

Configurar o caminho completo da pasta no arquivo "?:\CONTTRADE.Util\PlugSales\PlugSalesService\plugsales.service.exe.config" na tag:\
Como esta:

{% code fullWidth="true" %}

```
<appSettings>
    <add key="DirLog" value="C:\ProjetosJose\DESENVOLVIMENTO\PlugSales\PlugSales\bin\Debug\net5.0\verbose" />
```

{% endcode %}

Como fica:

{% code fullWidth="true" %}

```
<appSettings>
    <add key="DirLog" value="D:\CONTTRADE.Util\PlugSales\PlugSalesWeb\verbose" />
```

{% endcode %}

## 6º Passo: Criando os campos do PlugSalesWeb

Executar o  "?:\CONTTRADE\PlugSales\PlugSalesWeb\plugsales.exe"<br>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FW6tShOU6H1oJWLnEf7ei%2Fimage.png?alt=media&amp;token=561d3009-caaa-4aa8-82b9-322838b5102a" alt=""><figcaption><p>Com isso a primeira reorganização será feita</p></figcaption></figure>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FtvZ0Imrxig4nI3VgWrhE%2Fimage.png?alt=media&amp;token=a5c49601-0c1d-4fdf-930a-fcde0e3858ce" alt=""><figcaption><p>Observe que ele vai gerar este arquivo na pasta</p></figcaption></figure>

## 7º Passo:  Criando o serviço e realizando a reorganização do banco de dados

Acesse o "?:\CONTTRADE.Util\PlugSales\PlugSalesService\\" execute como administrador o plugsales.service.exe.\
\
Executar:\
&#x20;"R - Executar Reorg" para rodar a REORG e criar as tabelas no banco.\
"I - Install" instalação do serviço PlugSales. (Faz a sincronização automaticamente)<br>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FkjfAozb3hIWd5h6UOJuy%2Fimage.png?alt=media&amp;token=19565277-12c5-4fbd-ad57-15222ed9303c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FEAQKGNIaJ4ePZYrYUdDE%2Fimage.png?alt=media&amp;token=1529225c-0540-478a-8aa3-283655884377" alt=""><figcaption><p>Resultado ao clicar em 'I - Install"</p></figcaption></figure>

Verificar no PostgreSQL, no banco dbPlugSales se as tabelas foram criadas corretamente.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FbLJmN8x4vTxik96qyUtt%2Fimage.png?alt=media&amp;token=0712175c-5b18-4746-ba04-e8942070966b" alt=""><figcaption></figcaption></figure>

## 8º Passo: Abrindo o plugsales.exe da pasta PlugSalesWeb

Execute o arquivo:  "?:\CONTTRADE.Util\PlugSalesWeb\plugsales.exe"\
Com isso será possível acessar através do navegador o painel de configurações.\
\
Através do enderenço: 127.0.0.1:8888 ou localhost:8888

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FcX60ofohiMWvPdfMdOJl%2Fimage.png?alt=media&amp;token=742045ec-188b-4afc-bfcd-60845f7c3e71" alt=""><figcaption></figcaption></figure>

Deixar o CMD que abriu minimizado, pois as configurações só podem ser realizadas e finalizadas com o aplicativo em execução.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2Fswr8Qg7Kjkj5PtKI5q1Y%2Fimage.png?alt=media&amp;token=933c1a70-0bcc-4885-ba62-e503900f02b2" alt=""><figcaption></figcaption></figure>

## 9º Passo: Acessando a pagina web do Plug Sales

Abrir o navegador de internet e testar a execução da aplicação, abriu a pagina abaixo esta funcional.\
Informar no navegador: localhost:8888

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FjfkoVlXQ1lLZXir5HoZV%2Fimage.png?alt=media&amp;token=04b3d7be-8fb1-4064-82b9-a7f3bc411094" alt=""><figcaption></figcaption></figure>

## 10º Passo: Criando o cadastro na aplicação do PlugSales.

Criar o cadastro na aplicação.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FQ8mqF0cFEJaX3GFfL8aF%2Fimage.png?alt=media&amp;token=933262b1-0852-4eaa-98ef-65aeab6041d9" alt=""><figcaption></figcaption></figure>

Usuario: <suporte@conttrade.com.br>\
Senha:\*\*\*\*\* (verificar internamente)

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FS9AEJ3LwFc7Y0KtLlr0N%2Fimage.png?alt=media&amp;token=86b06b1e-fd5b-4214-85e1-66c90572f889" alt=""><figcaption></figcaption></figure>

## 11º Passo - Conectar na aplicação e realizar o cadastro da empresa e configurações.

Entrar com o usuário criado anteriormente.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FcsybV8cZtXBhK80FXQap%2Fimage.png?alt=media&amp;token=fc3c32c9-52d2-4339-b367-66ec48cd36f0" alt=""><figcaption></figcaption></figure>

Em Configurações cadastrar os dados da empresa conforme o ERP.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2F9ZHoqWyrhVoOI0YRriWo%2Fimage.png?alt=media&amp;token=6d9f576f-9720-4ac4-ab5b-4abd40e10171" alt=""><figcaption></figcaption></figure>

Adicionar tipo de integração através do botão verde "Adicionar e-commerce"  selecione "Plug Sales Api" e preencha os dados conforme instruções a seguir.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FLv7lq7QejbRq4pRMtlX7%2Fimage.png?alt=media&amp;token=2c88ac15-d057-46d8-94c6-0f0d61af88ca" alt=""><figcaption></figcaption></figure>

* Link para criar a chave: <https://guidgenerator.com/>\
  Gerar guid sem hifen - "Hypens"

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FrpNPu45HOsBUTIqf8lhF%2Fimage.png?alt=media&amp;token=f46908c9-a8d6-4e7e-97ca-6b27ec0d9e38" alt=""><figcaption></figcaption></figure>

Chave = guid gerado ( Copiar e Colar )\
Segredo = guid gerado no campo chave\
Usuario = conttrade\
Senha = \*\*\*\*\* (verificar internamente)\
URL: <http://api.conttrademais.com.br/v1>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FUsMyLlyigAobypQRDbHf%2Fimage.png?alt=media&amp;token=52a68497-08d6-4e03-84dc-e17d79f1ada3" alt=""><figcaption></figcaption></figure>

Clique em SALVAR.\ <br>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FTuE0KszhlLI4W06UjmHz%2Fimage.png?alt=media&amp;token=b90da1eb-b070-46f7-aa8c-356212463b54" alt=""><figcaption></figcaption></figure>

## 12º Passo: Configurar a comunicação com o banco de dados do ERP

Mesmo usuário e senha que loga no ERP, ou seja, mesmo banco de dados que está configurado o sistema de gestão do cliente.

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2F6YHrtWf1dkaDy01dxK5z%2Fimage.png?alt=media&amp;token=d2a28748-85a1-458d-ba63-44184cff0831" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FMwag4aZYfGi5YqcDvfIc%2Fimage.png?alt=media&amp;token=9172b6b7-3a38-491f-a376-73e21ff06738" alt=""><figcaption></figcaption></figure>

## 13º Passo:  Configurando as querys para ler os dados do banco do ERP

Cada uma das abas abaixo tem uma finalidade, com isso precisamos configurar para que o aplicativo de força de venda leia os dados.

Importante:

<mark style="color:blue;">**Utilizar sincronização:**</mark> Obrigatórios sempre marcar a opção Utilizar sincronização (em azul), nas abas obrigatórias, caso contrario dará problema.\
\ <mark style="color:purple;">**Tempo:**</mark> É o tempo que o serviço lê as informações no banco do ERP, compara com os dados da nuvem e em caso de modificação altera para ser atualizado os aplicativos dos vendedores.\
Exemplo: \
Comecei o dia com 50 und do produto X, vendi 10.\
Quando chegar o nessa contagem de tempo em relação a última atualização ele vai ler, entender que houve mudança e atualizar para os dados de estoque.

\ <mark style="color:green;">**Usar origem SQL:**</mark> Quando vamos utilizar selects ou insert para ler ou inserir registros no banco de dados. (Hoje é a opção que utilizamos).

\ <mark style="color:yellow;">**Inserir | Atualizar | Deletar:**</mark> São as funções que vamos usar quando compararmos as informações do ERP com a NUVEM.\
Exemplos: \
Inserir: Cadastrei um novo produto, se tiver marcado ele atualiza esse novo.\
Atualizar: Mudei algo no cadastro ele vai atualizar.\
Deletar: Inativei um produto no ERP ele tiraria do AFV. (Caso o select filtre apenas os produtos ativos)\ <br>

\
![](https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FW0pWXRSGeE5OYGTD4Ytu%2Fimage.png?alt=media\&token=3a00ad3e-6bba-4728-ad75-6cf2a0c606d7)

\
\
A origem da informação é o banco do ERP nas leituras (Selects).\
Somente serão destinos quando forem realizados as inserções (INSERTs).<br>

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FwK3MISNWk1l3479LdFma%2Fimage.png?alt=media&amp;token=33bcce2b-6ba9-414f-9f70-690e1df4c43b" alt=""><figcaption></figcaption></figure>

Obrigatórios:\
Usuários = Usuários do sistema que terão acesso ao AFV.\
Produto = Cadastro de produtos com seus dados relevantes para venda.\
Cliente = Cadastro dos clientes.\
Tabela de Preço ou Preço: É o preço dos itens em cada tabela, pode subir de 3 formas, a mais comum é em tabela de preço e ler o preço de venda e o preço mínimo de cada uma delas.\
Forma de Pagamento = São os planos de pagamentos disponiveis.\
Tipo de Operação = Operação de venda realizada pela empresa.\
Pedido = Retorno do pedido feito no aplicativo de força de venda, sendo inserido no banco de dados do ERP.

Opcionais:\
Fotos = Muito interessante o cliente subir as fotos, dá outra visão para os vendedores externos.\
Preço = Sobre de outras formas\
Categoria = Não utilizada no AFV.\
Financeiro = Sobe os títulos em aberto de empresa e exibe para o vendedor.

## 14º Passo: Rodando a primeira carga&#x20;

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FObmtIAUQyOlBh2eDJjM1%2Fimage.png?alt=media&amp;token=2ce68b64-d300-4130-a18b-37c2041c347c" alt=""><figcaption><p>Aguardar terminar de rodar, vai demorar caso, tenha imagem e dependendo da quantidade de dados.</p></figcaption></figure>

## 15º Passo: Star do serviço do PlugSales

Inicie o serviço do Plug Sales

<figure><img src="https://1872949069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhBQVBIBQxcQsCXe7jUWv%2Fuploads%2FxKEHwp0ci8MJOZcPlEWA%2Fimage.png?alt=media&amp;token=b4cfa651-7020-445f-b5fe-0ea006a079f9" alt=""><figcaption></figcaption></figure>

## 17º Passo: Criar o serviço do Plug Sales Web&#x20;

```
SC CREATE "Plug Sales Web" binpath= "D:\CONTTRADE\PlugSales\PlugSalesWeb\plugsales.exe"
```

## Vídeos Auxiliares

{% embed url="<https://youtu.be/w26JTL40V2Q>" %}

* Select da tabela PEDIDO tem uma particularidade, informar no select primeiro a instrução select 1, 'AAA' PedidoID, 'CANCELADO' Status, conforme vídeo abaixo.&#x20;

{% embed url="<https://youtu.be/6LMbjXQiEwY>" %}

{% embed url="<https://youtu.be/p3A9RK5pzMo>" %}