Á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
idcard1
labelDescrição dos campos e regras
Informação
campo
Campo Banco PDV
campo json
Campo Json APIObrigatórioTipoTamanhoDescriçãoObservações
Descrição

descricao

Sim

Texto

200

Cada produto requer uma descrição, que será utilizada nas operações de consultas, no carrinho de venda e documentos fiscais. 

Imposto

id_imposto

Não

Inteiro

Para que a operação de venda seja realizada todo produto deverá estar associado a um imposto, onde irá determinar a alíquota ICMS que o PDV Omni deverá utilizar na emissão de XML.

Consulte mais detalhes em Imposto

Card
labelV3.1
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


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




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ão

. 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

Tamanho 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ão

. 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

Tamanho 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

(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
stringIdentificador da Condição de Pagamento 

id_pagamento_condicao

IdRetaguardaPagamentoCondicao

Não

string

Tamanho máximo de 100 caracteres. O

100


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

Tamanho máximo de 100 caracteres. O

string

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

string

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.



IdRetaguardaRedeCliente
stringIdentificaçã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
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
}

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.




Definições dos campos do retorno

Card
idComoIntegrar
labelComo integrar

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

Column
width50%

Campo

Tipo

Descrição

SuccessboolIndica se a criação do ramo atividade foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do ramo atividade eles serão enviados nesse campo
DataobjetoObjeto ramo atividade criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnú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