...
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 | 1Cliente | Down | |||
91 | PisCofins | 1Loja | Down23 | |||
VendaCustodiaXml | 2 | OnlineMotivo | 0Down | |||
Cliente3 | 0Perfil | OnlineDown | ||||
204 | CaixaUsuario | 2Down | Up | |||
6 | Compartilhamento | 40 | AlteracaoCliente | 1 | Down | |
137 | Preco | 1Imposto | Down | |||
18 | Loja | 1Ncm | Down | |||
89 | NcmPisCofins | 1 | Down | |||
312 | PerfilProduto | 1 | Down | |||
1613 | DadoComplementar | 1Preco | Down | |||
14 | Estoque1 | Down | ||||
1815 | FormaPagtoOperadora | 1 | Down | |||
1916 | VendaDadoComplementar | 2Down | Up | |||
17 | CondicaoPagto | 15 | Operadora | 1 | Down | |
2 | Motivo | 1 | Down | |||
6 | Compartilhamento | 1 | Down | |||
18 | FormaPagto | Down | ||||
19 | Venda | Up | ||||
20 | Caixa | Up | 4 | Usuario | 1 | Down |
22 | Troca | Up | ||||
23 | VendaCustodiaXml2 | Up | ||||
25 | Cliente | Up | ||||
54 | 2AlteracaoEstoque | UpDown |
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
...