Exibir origem

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração do Preço dos produtos.

Pré-Requisitos e Restrições

Necessário a instalação do serviço winthor-pedido-venda.
De acordo com as parametrizações feitas na (Rotina 132 - Parâmetro 2277) é possível expor preço referente a rotina 201 – Precificar Produto ou 2017 – Precificação Por Embalagem.
Caso exista política de preço fixo cadastrada na rotina 357 que se aplique ao conjunto de dados informados (cliente, região, filial, produto, plano de pagamento, etc), o preço a ser exposto será o cadastrado na rotina 201 e política de preço fixo.
A parametrização de venda por embalagem e preço de venda por embalagem será por filial.
Com o uso do Tipo de precificação Atacado será empregado o preço cadastrado da (Rotina 2017) - Precificação Por Embalagem, gravando o campo (PCEMBALAGEM.PVENDAATAC).
Com o uso do Tipo de precificação Varejo será empregado o preço cadastrado da (Rotina 2017) - Precificação Por Embalagem, gravando o campo (PCEMBALAGEM.PVENDA).
Com o uso do Tipo de precificação Padrão será empregado o preço cadastrado da (Rotina 201) - Precificar Produto, gravando o campo (PCTABPR.PVENDA1).
Deve-se preencher o parâmetro 4257 – Código da região para preço CIASHOP (CODREGIAOPRECOCIASHOP) com a Região que será utilizada por Filial.
Caso parâmetro 4257 Não esteja preenchido, é utilizada a região informada no parâmetro 2832 – Número da região utilizada pelo e-commerce (REGIAOECOMMERCE).
Quando se tratar de produto de Origem Web e/ou E-commerce a API não irá calcular o preço de venda com Impostos. O preço de venda válido será sempre o preço vindo do E-commerce.
Quando o parâmetro 2277 - Tipo de Precificação da rotina 132 estiver cadastrado como Atacado (A) ou Varejo (V) , o retorno da requisição terá os atributos "offerPrice", "offerStartDate" e "offerEndDate", que correspondem respectivamente as colunas POFERTA, DTOFERTAINI e DTOFERTAFIM da tabela PCEMBALAGEM. Do contrário, se o parâmetro estiver como Padrão (P) estes atributos retornarão 0 e vazio.
Será considerado o desconto da rotina 561, exceto cadastros onde possui Informações por Cliente, apenas considerado no retorno da API Informações relevantes ao Produto.
Ao mover a politica para o logs será retornado na API de desconto o campo deleted = true, com está ação será enviado um novo registro para o PDVOMINI desabilitar o desconto enviando anteriormente.
No filtro employeeRegistration (Matricula do funcionário) será considerado a informação do parâmetro CODFUNCCXINTEGRACAOPDV, caso não informado.
O filtro typeOfMerchandise pode ser enviado separado por virgula, exemplo typeOfMerchandise: KT, CB,PA,L

Quando não houver preenchimento do campo DATA, exemplo (data de cadastro, data de alteração), nossas APIs retornará por padrão a informação "1900-01-01T00:00:00".

Caso necessário, realizar o ajuste nos cadastros para que a API apresente a data desejada.

Integração

A integração consiste em retornar os dados de preço com politica de desconto

Os dados retornados são os mesmo da API de preço, somente com o acréscimo dos campos de desconto: APIs Integrações - Preço de Produto

Os dados de descontos são:

API	CAMPO
discountPolicy.id	PCDESCONTO.CODDESCONTO
discountPolicy.automaticDiscountPercentage	PCDESCONTO.PERDESC
discountPolicy.startDate	PCDESCONTO.DTINICIO
discountPolicy.endDate	PCDESCONTO.DTFIM
discountPolicy.discount	campo calculado*

Exemplo do envio da requisição:

method: 'GET',
url: '/api/wholesale/v1/price/discount-policy'

branchId  		 : 0					- Código da Filial/Multifilial(separado por vírgula)  *requerido
productSKUERPReferenceKey : 0       	- Código do Produto
lastChange  	 : 1900-01-01T00:00:00	- data da última alteração
page			 : 1					- número de página
pageSize		 : 10					- quantidade por página
orderOrigin		 : A					- Origem padrão
resale			 : true / false			- Informar Revenda 
typeOfMerchandise: KT					- Tipo de Mercadoria
employeeRegistration: 1					- Matricula do funcionário (Parametro: CODFUNCCXINTEGRACAOPDV)

Exemplo JSON da resposta politica de desconto 561:

{
    "first": false,
    "items": [
        {              "branchId": "1",
            "calculationBaseFecp": 0,
            "calculationBaseIpi": 0,
            "calculationBaseST": 0,
            "erpReferenceKey": 13,
            "externalSTAliquot": 0,
            "fecp": 0,
            "fecpAliquot": 0,
            "fixedPrice": false,
            "fixedPriceId": 0,
            "ean": "303",
            "internalSTAliquot": 0,
            "ipi": 0,
            "ipiAliquot": 0,
            "lastChange": "2023-12-22T18:11:16",
            "noTaxesPrice": 0,
            "origin": 201,
            "active": true,
            "price": 6.47,
            "pricingIpi": 0,
            "pricingSt": 0,
            "skuId": "303-13",
            "st": 0,
            "taxFigureId": 17,
            "unitMultiplier": 1,
            "priceRegion": 7,
            "offerPrice": 0.00,
            "offerStartDate": "2001-01-01T00:00:01",
            "offerEndDate": "2999-12-31T23:59:59",
            "discountPolicy": {
                "id": 1561,
                "automaticDiscountPercentage": 1,
                "startDate": "2023-12-22T00:00:00",
                "endDate": "2023-12-23T23:59:59",
                "discount": 6.41,
                "deleted": false
            },
            "useSaleWithPackaging": false,
            "principalSKUId": "303-13",
            "gnreST": false }
    ],
    "hasNext": false
}

Exemplo JSON da resposta preço fixo 357:

{
    "first": false,
    "items": [
        {
            "branchId": "1",
            "calculationBaseFecp": 0,
            "calculationBaseIpi": 0,
            "calculationBaseST": 0,
            "erpReferenceKey": 13,
            "externalSTAliquot": 0,
            "fecp": 0,
            "fecpAliquot": 0,
            "fixedPrice": false,
            "fixedPriceId": 0,
            "ean": "303",
            "internalSTAliquot": 0,
            "ipi": 0,
            "ipiAliquot": 0,
            "lastChange": "2023-12-22T18:11:16",
            "noTaxesPrice": 0,
            "origin": 201,
            "active": true,
            "price": 6.47,
            "pricingIpi": 0,
            "pricingSt": 0,
            "skuId": "303-13",
            "st": 0,
            "taxFigureId": 17,
            "unitMultiplier": 1,
            "priceRegion": 7,
            "offerPrice": 0.00,
            "offerStartDate": "2001-01-01T00:00:01",
            "offerEndDate": "2999-12-31T23:59:59",
            "useSaleWithPackaging": false,
            "principalSKUId": "303-13",
            "gnreST": false
        },
        {
            "branchId": "1",
            "calculationBaseFecp": 0,
            "calculationBaseIpi": 0,
            "calculationBaseST": 0,
            "erpReferenceKey": 13,
            "externalSTAliquot": 0,
            "fecp": 0,
            "fecpAliquot": 0,
            "fixedPrice": true,
            "fixedPriceId": 2628,
            "ean": "303",
            "internalSTAliquot": 0,
            "ipi": 0,
            "ipiAliquot": 0,
            "lastChange": "2023-12-22T18:11:16",
            "noTaxesPrice": 0,
            "origin": 357,
            "active": true,
            "price": 10.0000,
            "pricingIpi": 0,
            "pricingSt": 0,
            "skuId": "303-13",
            "st": 0,
            "taxFigureId": 17,
            "unitMultiplier": 1,
            "priceRegion": 0,
            "offerPrice": 0.0000,
            "offerStartDate": "2023-12-22T00:00:01",
            "offerEndDate": "2023-12-24T23:59:59",
            "useSaleWithPackaging": false,
            "principalSKUId": "303-13",
            "gnreST": false
        }
    ],
    "hasNext": false
}

Obs.: Na busca de preços, deverá ser ordenado o preço para trazer o preço da 357 por último para cada um dos produtos. Ordem correta -> 201, 561, 357.