Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Onde deverá conter as informações de loja, inquilino, parâmetros, etc.

Cadastrados 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:

...

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

Incluir Authorization OAuth2.0 conforme token:

URL: https://pdvsync-core-controle-qa-aadivv24nq-ue.a.run.app.varejo.totvs.com.br/controle/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
    "envioDado": "", → dependendo do tipo de envio preencher a informação relevante.
    "connectionString": "", → está relacionado com a informação anterior.
    "lote": "0" → não utilizado ainda, utilizar 0 por enquanto., }

 

     "IdInquilino": ""  →  O código do IdInquilino é fornecido automaticamente pelo Totvs RAC após o envio do serviço.
}

 

Response:

{
    "success": true,
    "message": "",
    "data": {
        "idIdentificacaoExterna": "Tupan", 
        "nome": "Tupan",
        "situacao": 1,
        "envioDadoTipo": 0,
        "envioDado": "",
        "connectionString": "",
        "clientId": null,
        "clientSecret": null,
        "usuario": null,
        "senha": null,
        "tokenUrl": null,
        "id": "4rlMuI3YwrWO8NKtvE8V", → código gerado pelo TOTVS RAC
        "idInquilino": null,
        "dataAtualizacao": "2022-10-04T14:50:25.2424018Z",
        "dataCadastro": "2022-10-04T14:50:25.2424462Z",
        "_expandables": []
    }
}

...

Post

{
    "idInquilino": "LAxcSC2vkgynDwGtWreo", → O código do IdInquilino conforme usado na API de inquilino.
    "QuantidadeRegistros": 100,
    "TempoChamada": 2,
    "TempoExpurgoLogs": 130000,
    "TipoDado": {
        "CodigoTipo": 14,
        "DescricaoTipo": "Estoque",
        "TipoUtilizador": 1
    },
    "TipoProcesso": 1
}

Lista de Parâmetros:

 

codigoTipo

descricaoTipotipoUtilizador

tipo47

0

AlteracaoNcm

1ClienteDown
91

PisCofins

1LojaDown23

VendaCustodiaXml

2OnlineMotivo0Down
Cliente30PerfilOnlineDown
204CaixaUsuario2Down

Up

6Compartilhamento

40

AlteracaoCliente

1Down
137

Preco

1ImpostoDown
18

Loja

1NcmDown
89NcmPisCofins

1

Down
312PerfilProduto

1

Down
1613

DadoComplementar

1PrecoDown
14Estoque1Down
1815FormaPagtoOperadora

1

Down
1916VendaDadoComplementar2Down

Up

17CondicaoPagto

15

Operadora

1Down

2

Motivo

1

Down

6

Compartilhamento

1

Down

18FormaPagtoDown
19VendaUp
20CaixaUp

4

Usuario

1

Down
22TrocaUp
23VendaCustodiaXml2Up
25ClienteUp
542AlteracaoEstoqueUpDown

Exemplo response:

{
    "success": true,
    "message": "",
    "data": [
        {
            "tipoProcesso": 1,
            "quantidadeRegistros": 10000,
            "tempoChamada": 2.0,
            "tempoExpurgoLogs": 130000.0,
            "tipoDado": {
                "id": null,
                "codigoTipo": 14,
                "descricaoTipo": "AlteracaoNcmEstoque",
                "tipoUtilizador": 1,
                "tipoProcesso": 0,
                "_expandables": []
            },

            "id": "6eYL6pa5dsvQsKbKwIXy",
            "idInquilino": "YchOUFQPn2i7plLpsay9",
            "dataAtualizacao": "2022-08-05T15:10:21.604886Z",
            "dataCadastro": "2022-08-05T15:10:21.604888Z",
            "_expandables": []
 }

...

3º - Abrir Lote com Parâmetro 06 - Compartilhamento

Incluir Authorization OAuth2.0 conforme token:

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

Response:

{
    "success": true,
    "message": "",
    "data": {
        "loteOrigem": "20221004175001554",
        "mensagem": null,
        "status": 0,
        "tipoLote": [
            6
        ],
        "id": "DLoi3SX5HDoPOcDlyf0m",
        "idInquilino": "4rlMuI3YwrWO8NKtvE8V",
        "dataAtualizacao": "2022-10-04T17:50:01.6441804Z",
        "dataCadastro": "2022-10-04T17:50:01.6442468Z",
        "_expandables": []
    }
}


...

[
    {
        "IdRetaguardaLoja": "",
        "IdRetaguarda": "32796d0b-8399-490e-b972-1db212c514fa",
        "IdProprietario": "32796d0b-8399-490e-b972-1db212c514fa",
        "IdInquilino": "4rlMuI3YwrWO8NKtvE8V",
        "NomeCompartilhamento": "PDV Lupan Master",
        "Nivel": 0,
        "IdRetaguardaPai": "",
        "loteOrigem": "20221004175001554"
    },
    {
        "IdRetaguardaLoja": "3f054f05-ee67-407b-935d-9db0fc5e7c58",
        "IdRetaguarda": "3f054f05-ee67-407b-935d-9db0fc5e7c58",
        "IdProprietario": "3f054f05-ee67-407b-935d-9db0fc5e7c58",
        "IdInquilino": "4rlMuI3YwrWO8NKtvE8V",
        "NomeCompartilhamento": "PDV Lupan Loja",
        "Nivel": 1,
        "IdRetaguardaPai": "32796d0b-8399-490e-b972-1db212c514fa",
        "loteOrigem": "20221004175001554"
    }
]

...

{
    "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:00\",\"_expandables\":[]}].",
    "data": null
}

 

5º - Fechar o Lote 

https://pdvsync-core-controle-qaprd-aadivv24nqq6yz66olca-uerj.a.run.app/api/retaguarda/inquilinolotesexternos/{idInquilino}/{loteOrigem}


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

...

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

 

7º - Cadastro de uma Loja

...

 

8º - Fechar lote de loja

https://pdvsync-core-controle-qaprd-aadivv24nqq6yz66olca-uerj.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.varejo.totvs.com.br/comercial/api/pdvsyncserver/parametros

Post

[
  {
    "idInquilino": "vAh0y1bKvHMfwsZxDKfW", - Gerado no passo 01
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 1,
    "tipo": 1,
    "valor": "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",
    "dataAtualizacao": "2022-10-07T18:59:54.530Z",
    "dataCadastro": "2022-10-07T18:59:54.530Z",
    "codigo": 3,
    "tipo": 3,
    "valor": "10"
  },
  {
    "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-qaprd-aadivv24nqq6yz66olca-uerj.a.run.app/api/stub/historicovenda"
  }

Serviços Clients

  •  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.

...