TOTVS Varejo PDV Omni

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Ianara Santos Rocha

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user William da Silva Sombra

Gravado em

Chave

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

...

Definições dos campos do body

Retorno

Deck of Cards
iddk1
Card
idcard1
labelDescrição dos campos e regras
InformaçãoCampo Banco PVCampo Json APIObrigatórioTipoTamanhoDescriçãoObservação
Identificação no retaguardaid_retaguarda
NãoTexto100


Data inicial da vigência da regra de desconto e acréscimodata_vigencia_inicial
SimData
Data cadastrada no ERP/Retaguarda para o início da vigência da regra de desconto e acréscimo. Exemplo "2024-03-20 20:56:43.15725".
Data final da vigência da regra de desconto e acréscimodata_vigencia_final
SimData
Data cadastrada no ERP/Retaguarda para o final da vigência da regra de desconto e acréscimo. Exemplo "2024-03-20 20:56:43.15725".
Desconto ou Acréscimotipo
SimTexto
Informação obsoleta, sendo:
0 - Desconto
1- Acréscimo
Percentual do desconto ou acréscimovalor
SimNúmerico
Percentual a ser aplicado no item no carrinho de venda cadastrado no ERP/Retaguarda
Identificação da condiçãoid_retaguarda_pagamento_condicao
NãoTexto100Identificação da condição no erp
Identificação da restrição condiçãoid_retaguarda_restricao_pagamento_condicao
NãoTexto100Identificação da restrição da condição no erp
Quantidade inicialquantidade_inicial
NãoNúmerico
Quantidade inicial é a configuração da quantidade mínima para utilizar o valor do desconto ou acréscimo.
Quantidade finalquantidade_final
NãoNúmerico
Quantidade final é a configuração da quantidade máxima para utilizar o valor do desconto ou acréscimo.
Identificação da regiãoid_regiao
NãoTexto
Identificação da região
Identificação da praçaId_retaguarda_praca
Não

Identificação da praça no erp
Identificação do ramo de atividadeid_ramo_atividade
Não

Identificação do ramo de atividade
Identificação da redeid_retaguarda_rede
Não

Identificação da rede no erp
Identificação do clienteid_cliente
Não

Identificação do cliente
Identificação do produtoId_produto
Não

Identificação do produto
Identificação do fornecedorId_retaguarda_fornecedor
Não

Identificação do fornecedor no erp
Identificação da categoriaid_retaguarda_categoria
Não

Identificação da categoria no erp
Identificação da subcategoriaid_retaguarda_subcategoria
Não

Identificação da subcategoria no erp
identificação produto emabalagemid_produto_embalagem
Não

Identificação do produto embalagem no EPP
Prioritáriaprioritaria
NãoBoleano
Prioritária é a configuração para definir qual promoção será utilizada em casos de mais de uma promoção cadastrada para o mesmo item.
Identificação do departamentoid_retaguarda_departamento
NãoTexto100

Identificação do departamento no erp


identificação da marcaid_retaguarda_marca
NãoTexto100Identificação da marca no erp
identificação da seçãoid_retaguarda_secao
NãoTexto100Identificação da seção no erp
Situaçãosituacao
SimInteiro
Define se o o vinculo em questão está ativo ou inativo. 0 - Inativo
1 - Ativo
Data de cadastrodata_cadastro
SimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacao
SimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.

Este método é responsável pela criação de um novo grupo

  • Endpoint: /api/retaguarda/v3/dadosdinamicos/down/21/{versão}
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda
  • Microserviço: PDVSync.Core.Cliente
Este endpoint recebe uma lista de grupos permitindo vários em uma mesma requisição

Requisição

Card
labelComo integrar
Aviso

Para que a baixa do grupo criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 21 = grupo

É necessário que o inquilino tenha o parametro 21 - grupo cadastrado no controle.

Todo grupo deve estar vinculado a um cliente cadastrado no PDV para que seja baixado, clique aqui para acessar a documentação do envio de cliente.

Deck of Cards
idversoes2
Card
labelV3.1
Section
Column
width50%

Exemplo de body da requisição

[
    {
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "idRetaguardaCliente": "string",
        "idRetaguardaLoja": "string",
        "loteOrigem": "string",
        "situacao": 1
    }
]

Column
width50%

Campo

Tipo

Descrição

Obrigatório

Observações

idInquilino

string

Identificador do inquilinoSimidProprietariostringIdentificador do proprietárioSim
idRetaguardastringIdentificador do grupo na retaguardaSimTamanho máximo: 100 caracteres
idRetaguardaClientestringIdentificador do cliente na retaguardaSimEste cliente deve estar cadastrado no PDV para que o grupo seja baixado.
idRetaguardaLojastringIdentificador da loja na retaguardaNãoTamanho máximo: 100 caracteres
loteOrigemstringIdentificador do loteSim
situacaoIntSituação do grupoSim0 - Inativo , 1 - ativo
Deck of Cards
idretornos
Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "data": null,
    "errors": null,
    "message": null,
    "numberOfRecords": 8,
    "success": true,
    "totalTime": 2061
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

dataObjetoRetorno dos dados caso tenhaerrorsObjeto

Objeto contendo todos os erros encontrados.

messageString

Descrição do erro

numberOfRecordsIntNúmero de arquivos processadossuccessBoolStatus da requisiçãototalTimeIntTempo total Card
label400 - Bad Request
Column
width50%

Exemplo de body de retorno

{
    "data": null,
    "errors": {
        "0": {
            "IdRetaguarda": [
                ""
            ]
        }
    },
    "message": null,
    "numberOfRecords": 9,
    "success": false,
    "totalTime": 4077
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

dataObjetoRetorno dos dados caso tenhaerrorsObjeto

Objeto contendo todos os erros encontrados.

Cada propriedade desse objeto é o índice do grupo enviado que está com erro.

messageString

Descrição do erro

numberOfRecordsIntNúmero de arquivos processadossuccessBoolStatus da requisiçãototalTimeIntTempo total

Para maiores informações de como integrar a Regra Desconto Acréscimo, clique aqui.