Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
  • Eficiência Operacional
    • Permitir gestão centralizada e automatizada das regras de precificação entre o ERP Winthor e o PDV.
  • Flexibilidade e Escalabilidade
    • Permitir futuras expansões e ajustes nas políticas de preços, suportando promoções, preços fixos e dinâmicos de forma flexível e escalável

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

  • Endpoint: /api/retaguarda/v3/dadosdinamicos/down/28/{versaoJson}
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda
  • Microserviço: PDVSync.Core.Preco

Este endpoint recebe uma lista de preços promocionais para que possam ser enviados vários na mesma requisição

...

Para que a baixa do Preço Promocional criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 28 = Preço Promocional

...

    • .
Identificador do inquilino
Deck of Cards
idversções

Exemplo de body da requisição

[
    {
        "idInquilino":"string",
        "idRetaguarda":"string",
        "idProprietario": "string",
        "IdRetaguardaLoja": "string",
        "loteOrigem": "string",
        "DataHoraVigenciaInicial":"2024-09-30 12:00:00.000",
        "DataHoraVigenciaFinal":"2024-10-01 12:00:00.000",
        "IdRetaguardaCliente":"string",
        "IdRetaguardaClientePrincipal":"string",
        "IdRetaguardaGrupoCliente":"string",
        "IdRetaguardaPagamentoCondicao":"string",
        "IdRetaguardaProduto":"string",
        "IdRetaguardaRamoAtividade":"string",
        "IdRetaguardaPraca":"string",
        "IdRetaguardaRedeCliente":"string",
        "Prioritaria":true,
        "UsarTodasEmbalagens":true,
        "Valor":0.0,
        "Situacao":1
    }
]

Definições dos campos do body

Sim
Card
labelidV3.1card1
labelDescrição dos campos e regras
InformaçãoCampo Banco PDVCampo Json APIObrigatórioTipoTamanhoDescriçãoObservações
Situacao

situacao

Situacao

Sim

int

1

Requisição

Section
Column
width50%
Column
width50%

Campo

Tipo

Descrição

Obrigatório

Observações

SituacaointSituação cadastral


0 - Inativo, 1 - Ativo 

Caso não enviado será cadastrado com 0 


IdInquilino
string

N/A

IdInquilino

Sim

string




IdRetaguarda
stringIdentificador do perfil na retaguarda 

id_retaguarda

IdRetaguarda

Sim

string

100

Sim


Tamanho máximo de 100 caracteres

DataHoraVigenciaInicial

data_vigencia_inicial

DataHoraVigenciaInicial

Não

Datetime


Data de inicio da vigência do preço

Não


DataHoraVigenciaFinal

data_vigencia_final

DataHoraVigenciaFinal

Não

Datetime


Data de termino da vigência do preço

Não


IdProprietario
stringIdentificador do proprietário

N/A

IdProprietario

Sim

string




LoteOrigem
stringLote vinculado ao dado

N/A

LoteOrigem

Sim

IdRetaguardaLojaNão

string

ID Retaguarda da loja

100



Tamanho máximo de 100 caracteres.

 IdRetaguardaCliente

IdRetaguardaLoja

id_retaguarda_loja

IdRetaguardaLoja

Não

string

100

Identificador do




Cliente

id_cliente

N/A

Não

inteiro

Tamanho máximo de 100 caracteres.



FK tabela de cliente

N/A

IdRetaguardaCliente

Não

string

100


O IdRetaguarda do

Cliente

cliente precisa já existir no banco

do PDV para ser atrelada no envio, caso não será preenchida em branco.IdRetaguardaClientePrincipalstringIdentificador do Cliente PrincipalNãoTamanho máximo de 100 caracteres. O IdRetaguarda do Cliente Principal precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.IdRetaguardaGrupoClientestringIdentificador do Grupo de ClienteNãoTamanho máximo de 100 caracteres. O IdRetaguarda do Grupo de Cliente precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.

do PDV. Caso não existir o idretaguarda na tabela cliente do PDV o Sync retornará erro de que o cliente não foi encontrado.


IdRetaguardaClientePrincipal

id_cliente_principal


Não

inteiro



FK tabela de cliente

N/A

IdRetaguardaClientePrincipal

Não

string

100


O IdRetaguarda do cliente principal precisa já existir no banco do PDV. Caso não existir o idretaguarda do cliente principal na tabela cliente do PDV o Sync retornará erro de que o cliente principal não foi encontrado.

Identificação do grupo cliente especifico

id_grupo_cliente

N/A




FK tabela de grupo_cliente - campo id

DEFASADO

Identificação do grupo cliente não especifico

Id_retaguarda_grupo_cliente

IdRetaguardaGrupoCliente

Não

string

100

FK tabela de grupo_cliente - campo id_retaguarda_grupo

O grupo cliente precisa já existir no banco do PDV (tabela grupo_cliente - campo id_retaguarda_grupo). Caso não existir o dado informado, o Sync retornará erro de que o Id_retaguarda_grupo não foi encontrado.

IdRetaguardaPagamentoCondicao

id_pagamento_condicao

IdRetaguardaPagamentoCondicao

Não

string

100


O

IdRetaguardaPagamentoCondicaostringIdentificador da Condição de Pagamento NãoTamanho máximo de 100 caracteres. O

IdRetaguarda da condição de pagamento precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.

IdRetaguardaProduto
string

id_produto

IdRetaguardaProduto

Identificação do Produto

Sim

string

Tamanho máximo de 100 caracteres. O

100


O IdRetaguarda do Produto precisa já existir no banco do PDV para ser atrelada no envio.

IdRetaguardaRamoAtividade
string

id_ramo_atividade

IdRetaguardaRamoAtividade

Identificação do Ramo de Atividade

Não

string

Tamanho máximo de 100 caracteres. O

100


O IdRetaguarda do Ramo de Atividade precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.

IdRetaguardaPraca
string

id_retaguarda_praca

IdRetaguardaPraca

Identificação da Praça

Não

Tamanho máximo de 100 caracteres. O IdRetaguarda da Praça precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.IdRetaguardaRedeClientestringIdentificação da Rede do ClienteNãoTamanho máximo de 100 caracteres. O IdRetaguarda da Rede do Cliente precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.PrioritariaboolNãoUsarTodasEmbalagensboolNãoValordecimalValor do preço promocionalSim

Retorno

Deck of Cards
idretornos

string

100



IdRetaguardaRedeCliente

id_retaguarda_rede_cliente

IdRetaguardaRedeCliente

Não

string

100



Prioritaria

prioritaria

Prioritaria

Não

bool




UsarTodasEmbalagens

usar_todas_embalagens

UsarTodasEmbalagens

Não

bool




Valor

valor

Valor

Sim

decimal




IdRetaguardaProdutoEmbalagem 


IdRetaguardaProdutoEmbalagem 

Não

string

100


O IdRetaguarda do Produto Embalagem precisa já existir no banco do PDV para ser atrelada no envio, caso não será preenchida em branco.




Card
idComoIntegrar
labelComo integrar

Para maiores informações de como integrar o Preço Promocional, clique aqui.

Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do ramo atividade foi feita com sucessoMessagestringCaso ocorra erros durante a criação do ramo atividade eles serão enviados nesse campoDataobjetoObjeto ramo atividade criadoErrorsListaListas com os erros encontrados no processoTotalTimeinttempo da requisiçãoNumberOfRecordsintnúmero de dados inseridos Card
label400 - Bad Request
Column
width50%

Exemplo de body de retorno

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erromessagestringMensagem do errodetailedMessagestringDetalhamento do errohelpUrlstringurl de ajudaTotalTimestringTempo total de buscadetailslista de objetoLista de objeto de errosdetails.guidstringIdentificador do errodetails.codestringCódigo do errodetails.messagestringMensagem do erro details.detailedMessagestringDetalhamento do erro