Histórico da Página

CONTEÚDO

1. Visão Geral
2. Configuração
3. Informações enviadas
4. Exemplo de utilização
5. Detalhes do campo lastChange

01. VISÃO GERAL

Este documento tem a função de disponibilizar informações de como consultar promoção ou preço para o produto(price products) uma tabela de preço para enviar informações para o Totvs Conector Vtex. 

É utilizado o endpoint:  branchpriceproductsgrouppricetable.

02. CONFIGURAÇÃO

Para o preço (price) a tabela de preço ser enviado para o Conector, é necessário que tenham as seguintes configurações:

• Dados de qual o tipo e código de valor serão enviados configurados para o TOTVS Conector Vtex -> Configuração -> Parâmetros
• O mesmo valor informado no parâmetro DS_VALOR_ECOMMERCE_VA deve ser informado ao produto ou grupo no componente PRDFM015 ou PRDFP020.

02.01 Dados

...

da tabela de preço

Os dados do produto de capa da tabela de preço são cadastrados pelo componente PRDFM015 ou PRDFP020 que é chamado pelo componente PRDFM009 clicando no opção "Valor"

...

PEDFM011.

       Image Added

        Neste componente são configuradas as informações do preço do produto(sku) que serão enviadas para o TOTVS Conector.

• Tipo de Preço: O tipo informado para o produto(sku), deve ser o mesmo informado no parâmetro DS_VALOR_ECOMMERCE_VA para o TOTVS Conector Vtex -> Configuração -> Parâmetros.
• Valor: Valor para o produto(sku) configurados para o TOTVS Conector Vtex.

       Image Removed

02.02 Configuração da promoção

       Para o preço de promoção (price) ser enviado para o Conector, é necessário que tenham as seguintes configurações:

• Dados de qual o tipo e código de valor serão enviados configurados para o TOTVS Conector Vtex -> Configuração -> Parâmetros
• Caso possuir promoção cadastrado no componente PRDFM002 o tipo de valor deve ser o mesmo do parâmetro DS_VALOR_ECOMMERCE_VA.

        Image Removed         

        Neste componente são configuradas as informações do preço de promoção para o produto(sku) grupo que serão enviadas para o TOTVS Conector.

...

...

...

...

 Image Added

03. INFORMAÇÕES ENVIADAS

Para utilizar a requisição branchpriceproducts é necessário enviar ao menos os campos obrigatórios:

• BasebranchId: Código da filial.
• LastChange: Data da última modificação.
• BranchId: Código da empresa (O mesmo que o BranchId).
• PriceIdList: BranchIdList: Lista com os tipos de valores conforme configurado no parâmetro DS_VALOR_ECOMMERCE_VA para o TOTVS Conector Vtex -> Configuração -> Parâmetros.códigos da empresa da tabela de preço.
• TablePriceCode: Código da tabela de preçoIspromotion: Quando informado o valor false,  será enviado apenas o preço do produto(sku), quando informado true, retornará preço e promoção.

Esses são os dados de preço enviados ao TOTVS Conector através do endpoint  branchpriceproducts, apenas preço com o isPromotion igual a falsegrouppricetable.

Image RemovedImage Added

Alguns campos do exemplo não foram descritos pois contém valores padrão do TOTVS Conector VTEX:

• companyId: Empresa integrada.
• branchId: Filial integrada (o mesmo que companyId). initialDate: Data inicial para o tipo de valor preço.
• finalDate: Data final para o tipo de valor preço.
• createDate: Data de criação para o tipo de valor preço.
• lastChange: Data da alteração para o tipo de valor preço.
• discountValue: Valor de diferença entre os campos grossValue e netValue.
• minimunSalePrice: Valor default 0.0.
• discountFactor: Valor default 0.0.
• isActive: Valor default true.

Esses são os dados de preço enviados ao TOTVS Conector através do endpoint  branchpriceproducts, apenas preço com o isPromotion igual a true.

Image Removed

Alguns campos do exemplo não foram descritos pois contém valores padrão do TOTVS Conector VTEX:

• discountValue: Valor de diferença entre os campos grossValue e netValue.
• minimunSalePrice: Valor default 0.0.
• discountFactor: Valor default 0.0.
• isActive: Valor default true.

04. EXEMPLO DE UTILIZAÇÃO

Documento de como utilizar a API: https://www30.bhan.com.br:12443/api/ecommerce/v1/swagger/index.html

05. DETALHES DO CAMPO LASTCHANGE

Para apresentar o campo lastchange no retorno do endpoint branchpriceproducts as entidades PRD_PROMOCAO, PRD_PROMOCAOITEM, PRD_VALOR são verificadas, estas entidades são utilizadas respectivamente nos componentes abaixo.

...

grouppricetable as entidades PED_TABPRECOC, PED_TABPRECOG, PED_TABPRECOI são verificadas.

06. DETALHES DOS CAMPOS DISCOUNT VALUE E NET VALUE

Para realização do calculo do campo netValue tambem são considerados os parâmetros:

• "TP_ARREDOND_PRECO_PED"
• "NR_PONTOM_ARRED_PED"
• "NR_DEC_ACIMA_PONTOM_PED"
• "NR_DEC_ABAIXO_PONTOM_PED"
• "NR_INT_ACIMA_PONTOM_PED"
• "NR_INT_ABAIXO_PONTOM_PED"

Os valores configurados nestes parâmetros  são apresentados no campo discountValue

...

.

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...