| Card |
|---|
| label | Descrição dos campos e regras |
|---|
| Informação | Coluna | Obrigatório | Tipo | Tamanho | Descrição |
|---|
| Vinculo entre a tabela preço e a tabela produto | produto_id | Não | Inteiro |
| Código de identificação do item na tabela produto (ID) | | Data inicial da vigência do preço | data_vigencia_inicial | Sim | Data |
| Data cadastrada no ERP/Retaguarda para o início da vigência do preço cadastrado. Exemplo "2024-03-20 20:56:43.15725". | | Data final da vigência do preço | data_vigencia_final | Sim | Data |
| Data cadastrada no ERP/Retaguarda para o final da vigência do preço cadastrado. Exemplo "2024-03-20 20:56:43.15725". | | Valor vigente do item | valor | Sim | Numérico |
| Valor a ser cobrado do item no carrinho de venda cadastrado no ERP/Retaguarda | | Situação do registro | situacao | Sim | Inteiro |
| Define se o preço em questão está ativo ou inativo. | | Data de cadastro do registro | data_cadastro | Sim | Data |
| Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente. | Data de atualização do registro
| data_atualizacao | Sim | Data |
| Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente. | | Identificação no retaguarda | id_retaguarda | Não | Texto | 100 |
|
| sincronizado_etiqueta_eletronica | Sim | Inteiro |
| Defasado | | Preço promocional do item | preco_promocional | Não | Numérico |
| Preço promocional do item. Quando esse campo possui valor, o PDV irá "ignorar" o campo "valor" e irá aplicar ao carrinho o preço promocional para cada unidade. Ele também irá calcular o valor - preco_promocional e apresentar em tela como um desconto no item, para que o usuário saiba que aquele item está em promoção. | | Motivo do preço promocional do item | motivo_desconto | Não | Texto | 150 | Descrição da promoção em que o item está vinculado | | MD5 PAF | md5_paf | Não | Texto | 64 |
|
| id_produto_embalagem | Não | Inteiro |
|
| | Vinculo entre a tabela preço e a tabela região | id_regiao | Não | Inteiro |
| Código de identificação da região na tabela região (ID) | | Valor de atacado do item | valor_atacado | Não | Numérico |
| Valor de atacado do item. Quando o item possui valor no campo quantidade_valor_atacado na tabela produto, o PDV irá "ignorar" o campo "valor" e irá aplicar ao carrinho o valor de atacado do item. | | Margem do produto | margem | Não | Numérico |
| Margem do produto | | Preço principal | preco_principal | Não | Inteiro |
|
| | Preço origem | preco_origem | Não | Texto | 150 | (em andamento) | | Custo do produto | custo |
| Numérico |
| Custo do produto | | Indice preço | indice_preco | Não | Texto | 100 | Indice preço é o campo para vinculo entre a condição de pagamento e o preço a ser utilizado da tabela de preço. |
|
| Card |
|---|
| Este método é responsável pela criação de novos preço - Endpoint:
- /api/retaguarda/v2/precos
- /api/retaguarda/v3/precos
- /api/retaguarda/v3/dadosdinamicos/down/13/{Versão Dado}
- Método: Post
- Autenticação: Bearer token
- Permissão: Retaguarda
- Microserviço: PDVSync.Core.Preco
Este endpoint recebe uma lista de preços para que possam ser enviados vários na mesma requisição | Aviso |
|---|
Para que a baixa do Preço criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 13 = preco |
| Deck of Cards |
|---|
| | Card |
|---|
| Requisição| Section |
|---|
| Column |
|---|
| Exemplo de body da requisição[
{
"codigoProduto": "string",
"dataHoraVigenciaFinal": "2024-03-28T19:26:14.977Z",
"dataHoraVigenciaInicial": "2024-03-28T19:26:14.977Z",
"idInquilino": "string",
"idProprietario": "string",
"idRetaguarda": "string",
"idRetaguardaProduto": "string",
"idRetaguardaProdutoEmbalagem": "string",
"loteOrigem": "string",
"precoPromocional": "string",
"sincronizadoEtiquetaEletronica": 0,
"situacao": 0,
"valor": "string"
}
] |
| Column |
|---|
| Definições dos campos do bodyCampo | Tipo | Descrição | Obrigatorio | Observações |
|---|
dataHoraVigenciaInicial | datetime | Data inicial da vigência do preço | Sim |
| | codigoProduto | string | Código do produto | Não |
| | dataHoraVigenciaFinal | datetime | Data final da vigência do preço | Sim |
| | idInquilino | string | Identificador do inquilino | Sim |
| | idProprietario | string | Identificador do proprietário | Sim | Enviar apenas o proprietário da loja. Este campo não é uma lista e não aceita mais de um proprietário. | | idRetaguarda | string | Identificador do preço na retaguarda | Sim | Tamanho máximo: 100 caracteres | | idRetaguardaProduto | string | Identificador do produto na retaguarda | Sim | Tamanho máximo: 100 caracteres | | idRetaguardaProdutoEmbalagem | string | Identificador na embalagem na retaguarda | Não | Tamanho máximo: 100 caracteres | | loteOrigem | string | Identificador do lote que os dados serão enviados | Sim |
| | precoPromocional | string | Preço promocional | Não |
| | sincronizadoEtiquetaEletronica | int |
| Não |
| | situacao | int | Situação do preço | Sim | 0 - Inativo, 1 - Ativo | | valor | string | Valor | Sim |
|
|
|
Retorno| Deck of Cards |
|---|
| | Card |
|---|
| | Column |
|---|
| Exemplo de body de retorno{
"success": true,
"message": "Requisição inserida com sucesso!",
"data": null,
"errors": null,
"totalTime": 0,
"numberOfRecords": 0
} |
| Column |
|---|
| Definições dos campos do retornoCampo | Tipo | Descrição |
|---|
| Success | bool | Indica se a criação do compartilhamento foi feita com sucesso | | Message | string | Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo | | Data | objeto | Objeto compartilhamento criado | | Errors | Lista | Listas com os erros encontrados no processo | | TotalTime | int | tempo da requisição | | NumberOfRecords | int | número de dados inseridos |
|
|
| Card |
|---|
| | Column |
|---|
| Exemplo de body de retorno{
"code": "string",
"message": "string",
"detailedMessage": "string",
"helpUrl": "string",
"details": [
{
"guid": "string",
"code": "string",
"message": "string",
"detailedMessage": "string"
}
]
} |
| Column |
|---|
| Definições dos campos do retornoCampo | Tipo | Descrição |
|---|
| code | string | Código de erro | | message | string | Mensagem do erro | | detailedMessage | string | Detalhamento do erro | | helpUrl | string | url de ajuda | | TotalTime | string | Tempo total de busca | | details | lista de objeto | Lista de objeto de erros | | details.guid | string | Identificador do erro | | details.code | string | Código do erro | | details.message | string | Mensagem do erro | | details.detailedMessage | string | Detalhamento do erro |
|
|
|
|
| Card |
|---|
| | Informações |
|---|
Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição. |
Requisição| Section |
|---|
| Column |
|---|
| Exemplo de body da requisição[
{
"codigoProduto": "string",
"dataHoraVigenciaFinal": "2024-03-28T19:26:14.977Z",
"dataHoraVigenciaInicial": "2024-03-28T19:26:14.977Z",
"idInquilino": "string",
"idProprietario": "string",
"idRetaguarda": "string",
"idRetaguardaProduto": "string",
"idRetaguardaProdutoEmbalagem": "string",
"loteOrigem": "string",
"motivoDesconto": "string",
"precoPromocional": 0.0,
"situacao": 0,
"valor": 0.0,
"idRetaguardaRegiao": "string",
"margem": 0.0,
"PrecoOrigem": "string",
"PrecoPrincipal": true,
"ValorAtacado": 0.0,
"IndicePreco": "string",
"custo": 0.0
}
] |
| Column |
|---|
| Definições dos campos do bodyCampo | Tipo | Descrição | Obrigatorio | Observações |
|---|
| dataHoraVigenciaInicial | datetime | Data inicial da vigência do preço | Sim |
| | dataHoraVigenciaFinal | datetime | Data final da vigência do preço | Sim |
| | codigoProduto | string | Código do produto | Não |
| | idRetaguardaProduto | string | Identificador do produto na retaguarda | Sim |
| | valor | numérico | Valor a ser cobrado do item no carrinho de venda cadastrado no ERP/Retaguarda | Sim |
| | situacao | int | Situação do preço | Sim | 0 - Inativo, 1 - Ativo | | sincronizadoEtiquetaEletronica | int | DEFASADO | Não |
| | precoPromocional | numérico | Preço promocional | Não |
| | idRetaguardaProdutoEmbalagem | string | Identificador da embalagem na retaguarda | Não |
| | idInquilino | string | Identificador do inquilino | Sim |
| | idRetaguarda | string | Identificador do preço na retaguarda | Sim | Tamanho máximo: 150 caracteres | | idProprietario | string | Identificador do proprietário | Sim | Enviar apenas o proprietário da loja. Este campo não é uma lista e não aceita mais de um proprietário. | | loteOrigem | string | Identificador do lote que os dados serão enviados | Sim |
| | motivoDesconto | string | Descrição da promoção em que o item está vinculado | Não | Tamanho máximo: 150 caracteres | | idRetaguardaRegiao | string | Identificador da região na retaguarda | Não | Tamanho máximo: 100 caracteres | | Margem | numérico |
| Não |
| | PrecoOrigem | string |
| Não | Tamanho máximo: 150 caracteres | | PrecoPrincipal |
|
| Não |
| | ValorAtacado | numérico |
| Não |
| | IndicePreco | string |
| Não | Tamanho máximo: 100 caracteres | | Custo | numérico |
| Não |
|
|
|
Retornos| Deck of Cards |
|---|
| | Card |
|---|
| | Column |
|---|
| Exemplo de body de retorno{
"success": true,
"message": "Requisição inserida com sucesso!",
"data": null,
"errors": null,
"totalTime": 0,
"numberOfRecords": 0
} |
| Column |
|---|
| Definições dos campos do retornoCampo | Tipo | Descrição |
|---|
| Success | bool | Indica se a criação do compartilhamento foi feita com sucesso | | Message | string | Caso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo | | Data | objeto | Objeto compartilhamento criado | | Errors | Lista | Listas com os erros encontrados no processo | | TotalTime | int | tempo da requisição | | NumberOfRecords | int | número de dados inseridos |
|
|
| Card |
|---|
| | Column |
|---|
| Exemplo de body de retorno{
"code": "string",
"message": "string",
"detailedMessage": "string",
"helpUrl": "string",
"details": [
{
"guid": "string",
"code": "string",
"message": "string",
"detailedMessage": "string"
}
]
} |
| Column |
|---|
| Definições dos campos do retornoCampo | Tipo | Descrição |
|---|
| code | string | Código de erro | | message | string | Mensagem do erro | | detailedMessage | string | Detalhamento do erro | | helpUrl | string | url de ajuda | | TotalTime | string | Tempo total de busca | | details | lista de objeto | Lista de objeto de erros | | details.guid | string | Identificador do erro | | details.code | string | Código do erro | | details.message | string | Mensagem do erro | | details.detailedMessage | string | Detalhamento do erro |
|
|
|
|
|
|
|
