Histórico da Página

...

14. Fila Sync para o ERP

15. Dados Síncronos

16.

...

Pré-requisitos

Pre-Requisitos para instalação do Client:

• Configuração de variáveis de ambiente DOTNET_ENVIRONMENT e ASPNETCORE_ENVIRONMENT. Elas servem para definir qual é o ambiente para o qual o Client irá apontar (Produção = Production, Homologação = Quality, ou Desenvolvimento = Development):
•         Node.Js - Fazer o download do instalador do Node.Js em https://nodejs.org/en/download/. Instalar a versão 16.0 ou superior. Seguir os passos da instalação até a conclusão.
•         .NET - Fazer o download do instalador do .NET em https://dotnet.microsoft.com/en-us/download. Instalar a versão 6.0. Seguir os passos da instalação até a conclusão.

17. Instalação/Configuração

Este documento tem por objetivo orientar a instalação e configuração do PDVSync. Esse processo deve ser realizado em dois ambientes Server e Client:

• Server

Onde deverá conter as informações de loja, inquilino, parâmetros, etc cadastrados e configurados corretamente para realizar a troca de informações com o Client, segue abaixo os passos para configuração do ambiente no Server:

1° - Criação Inquilino

O inquilino é criado normalmente no início de um contrato com uma retaguarda através da API de controle conforme exemplo abaixo:

URL: https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/pdvsyncserver/inquilinos

Post

{
    "idIdentificacaoExterna": " ", → Identificação do inquilino>
    "nome":

...

Este documento tem por objetivo orientar a instalação e configuração do PDVSync. Esse processo deve ser realizado em dois ambientes Server e Client:

• Server

Onde deverá conter as informações de loja, inquilino, parâmetros, etc cadastrados e configurados corretamente para realizar a troca de informações com o Client, segue abaixo os passos para configuração do ambiente no Server:

1° - Criação Inquilino

O inquilino é criado normalmente no início de um contrato com uma retaguarda através da API de controle conforme exemplo abaixo:

URL: https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/pdvsyncserver/inquilinos

Post

{
    "idIdentificacaoExterna": " ", → Identificação do inquilino>
    "nome": " ", → <Nome do inquilino>
    "situacao": " ", → Podem seguir os seguintes status "Inativo(0)", "Ativo(1)", "Pendente(2)"
    "envioDadoTipo": "0", → tipo de envio do dado para a retaguarda em caso de retornos, utiliza 0 por enquanto ?????
    "envioDado": "", → dependendo do tipo de envio preencher a informação relevante, vazio por enquanto ???
    "connectionString": "", → está relacionado com a informação anterior, vazio por enquanto ???
    "lote": "0" → não utilizado ainda, utilizar 0 por enquanto.
}

...

{
    "success": true,
    "message": "compartilhamento inserido com sucesso: [{\"IdRetaguarda\":\"32796d0b-8399-490e-b972-1db212c514fa\",\"IdProprietario\":\"32796d0b-8399-490e-b972-1db212c514fa\",\"NomeCompartilhamento\":\"PDV Lupan Master\",\"Nivel\":0,\"IdRetaguardaPai\":\"\",\"LoteOrigem\":\"20221004175001554\",\"Lote\":null,\"IdRetaguardaLoja\":\"\",\"Id\":null,\"IdInquilino\":\"4rlMuI3YwrWO8NKtvE8V\",\"DataAtualizacao\":\"0001-01-01T00:00:00\",\"DataCadastro\":\"0001-01-01T00:00:00\",\"_expandables\":[]},{\"IdRetaguarda\":\"3f054f05-ee67-407b-935d-9db0fc5e7c58\",\"IdProprietario\":\"3f054f05-ee67-407b-935d-9db0fc5e7c58\",\"NomeCompartilhamento\":\"PDV Lupan Loja\",\"Nivel\":1,\"IdRetaguardaPai\":\"32796d0b-8399-490e-b972-1db212c514fa\",\"LoteOrigem\":\"20221004175001554\",\"Lote\":null,\"IdRetaguardaLoja\":\"3f054f05-ee67-407b-935d-9db0fc5e7c58\",\"Id\":null,\"IdInquilino\":\"4rlMuI3YwrWO8NKtvE8V\",\"DataAtualizacao\":\"0001-01-01T00:00:00\",\"DataCadastro\":\"0001-01-01T00:00:0032796d0b-8399-490e-b972-1db212c514fa\",\"_expandablesLoteOrigem\":[]}].\"20221004175001554\",
    "data": null
}

5º - Fechar o Lote 

https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/retaguarda/inquilinolotesexternos/{idInquilino}/{loteOrigem}

...

\"Lote\":null,\"IdRetaguardaLoja\":\"3f054f05-ee67-407b-935d-9db0fc5e7c58\",\"Id\":null,\"IdInquilino\":\"4rlMuI3YwrWO8NKtvE8V\",\"DataAtualizacao\":\"0001-01-01T00:00:00\",\"DataCadastro\":\"0001-01-01T00:00:00\",\"_expandables\":[]}].",
    "data": null
}

5º - Fechar o Lote 

https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/retaguarda/inquilinolotesexternos/{idInquilino}/{loteOrigem}

{idInquilino} - Gerado no passo 01
{loteOrigem} - Gerado no passo 03

6º - Abrir lote com Parâmetro 01 - Loja

Post

{
    "status": 0,
    "tipoLote": [
        1
    ],
    "idInquilino": "4rlMuI3YwrWO8NKtvE8V",
}

7º - Cadastro de uma Loja

Post

[
  {
    "razaoSocial

6º - Abrir lote com Parâmetro 01 - Loja

Post

{
    "status": 0,
    "tipoLote": [
        1
    ],
    "idInquilino": "4rlMuI3YwrWO8NKtvE8V",
}

7º - Cadastro de uma Loja

Post

[
  {
    "razaoSocial": " ",
    "nomeFantasia": " ",
    "cnpj": " ",
    "inscricaoEstadual": " ", --
    "inscricaoMunicipal": " ",
    "endereco": " ",
    "numero": " ",
    "complemento": " ",
    "bairro": " ",
    "cidade": " ",
    "estado": " ",
    "siglaUf": " ",
    "codigoUFIBGE": " ",
    "codigoMunicipioIbge": " ",
    "cep": "",
    "telefone": "",
    "codigoIdentificacaoLoja": "",
    "modeloFiscal": "",
    "regimeTributario": " ",
    "redenomeFantasia": " ",
    "numeroLojacnpj": " 0 ",
    "idRetaguardaRedeinscricaoEstadual": " ", --
    "codigoMasterinscricaoMunicipal": " ",
    "nomeMasterendereco": " ",
    "situacao": 1,
    "idInquilino"numero": " ", - Gerado no passo 1
    "idRetaguardacomplemento": " 3 ", - Gerado no passo 4
    "idProprietariobairro": " ",- Gerado no passo 4
    "loteOrigemcidade": " " - Gerado no passo 6
  }
]

8º - Fechar lote de loja

https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/retaguarda/inquilinolotesexternos/{idInquilino}/{loteOrigem}

...

9º - Cadastrar os parâmetros comerciais para a consulta de operações de vendas e caixa

URL: https://pdvsync-core-comercial-qa-aadivv24nq-ue.a.run.app/api/pdvsyncserver/parametros

Post

[
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW", - Gerado no passo 01
    "dataAtualizacao": "2022-10-07T18:59:54.530Z" ",
    "estado": " ",
    "siglaUf": " ",
    "codigoUFIBGE": " ",
    "codigoMunicipioIbge": " ",
    "cep": "",
    "telefone": "",
    "codigoIdentificacaoLoja": "",
    "modeloFiscal": "",
    "regimeTributario": "",
    "rede": "",
    "numeroLoja": "0",
    "idRetaguardaRede": "",
    "codigoMaster": " ",
    "dataCadastronomeMaster": "2022-10-07T18:59:54.530Z"," ",
    "situacao": 1,
    "idInquilino": " ", - Gerado no passo 1
    "codigoidRetaguarda": 1,"3 ", - Gerado no passo 4
    "tipoidProprietario": 1," ",- Gerado no passo 4
    "valorloteOrigem": " " - Gerado no passo 6
  }
]

8º - Fechar lote de loja

https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app/api/retaguarda/inquilinolotesexternos/{idInquilino}/{loteOrigem}

{idInquilino} - Gerado no passo 01
{loteOrigem} - Gerado no passo 06

9º - Cadastrar os parâmetros comerciais para a consulta de operações de vendas e caixa

URL: https://pdvsync-core-comercial-qa-aadivv24nq-ue.a.run.app/api/pdvsyncserver/parametros

Post

[10"
  },
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 2,
    "tipo": 2,
    "valor": "10"
  },
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW", - Gerado no passo 01
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 31,
    "tipo": 31,
    "valor": "10"
  },
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 42,
    "tipo": 42,
    "valor": "10"
  },
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 53,
    "tipo": 03,
    "valor": "https://pdvsync-core-fila-qa-aadivv24nq-ue.a.run.app/api/stub/historicovenda10"
  },

• Client

...

  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 4,
    "tipo": 4,
    "valor": "10"
  },
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 5,
    "tipo": 0,
    "valor": "https://pdvsync-core-fila-qa-aadivv24nq-ue.a.run.app/api/stub/historicovenda"
  }

• Client

 Processoresponsável pela leitura dessas informações cadastradas no server e fará a troca das informações entre o PDV e o Server. Ele é dividido basicamente em 4 serviços que devem ser instalados no PDV:

•         API – Responsável pela comunicação entre o PDV e os Serviços de UP e Down.
•         Controle – Responsável por informar aos Serviços de DOWN que existe informações novas para serem baixadas no PDV.
•         Up – Serviço responsável pela subida de informações do PDV para o Server.
•         Down – Serviço responsável pela baixa de informações do Server para o PDV

•         API – Responsável pela comunicação entre o PDV e os Serviços de UP e Down.
•         Controle – Responsável por informar aos Serviços de DOWN que existe informações novas para serem baixadas no PDV.
•         Up – Serviço responsável pela subida de informações do PDV para o Server.
•         Down – Serviço responsável pela baixa de informações do Server para o PDV.

Pre-Requisitos para instalação do Client:

•         Configuração de variáveis de ambiente DOTNET_ENVIRONMENT e ASPNETCORE_ENVIRONMENT. Elas servem para definir qual é o ambiente para o qual o Client irá apontar (Produção = Production, Homologação = Quality, ou Desenvolvimento = Development):

Ex:

•         Node.Js - Fazer o download do instalador do Node.Js em https://nodejs.org/en/download/. Instalar a versão 16.0 ou superior. Seguir os passos da instalação até a conclusão.

•         .NET - Fazer o download do instalador do .NET em https://dotnet.microsoft.com/en-us/download. Instalar a versão 6.0. Seguir os passos da instalação até a conclusão.

Instalação dos Serviços UP, DOWN, CONTROLE e API:

...

Para desinstalar os serviços acima basta acessar a pasta C:\PDVSync executar o arquivo “servicos-delete.bat”.