Exibir origem

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração de politica de desconto da rotina 561.

Pré-Requisitos e Restrições

Necessário a instalação do serviço winthor-integracao-preco. Para realizar a instalação desse serviço, segue link com as devidas explicações:

Comece por aqui -> Parametrizações WTA

A rotina 561 - Cadastrar Política de Desconto tem como objetivo possibilitar o cadastro de políticas de desconto. É utilizada quando a empresa tem interesse em conceder descontos em determinadas situações nos quais poderão ser delimitados por período de vigência, podendo ocorrer também por regiões, clientes, RCA's, supervisores, departamentos, seções ou produtos. Para mais informações 561 - Cadastrar Política de Desconto - DR
Para uma política de desconto/ acréscimo está apta para retornar nessa API deverá atender as condições abaixo:
1 - A coluna PCDESCONTO.TIPO deverá ser 'C' (desconto comercial).
2 - A coluna PCDESCONTO.ORIGEMPED deverá ser 'A' ou 'O'.
3 - A coluna PCDESCONTO.APLICADESCONTO deverá ser 'S' (aplica desconto automaticamente).
4 - As colunas PCDESCONTO.CODAUXILIAR OR PCDESCONTO.CODPROD não pode ser nulo.
5 - Se a coluna PCDESCONTO.APENASPLPAGMAX for igual a 'S' a coluna PCDESCONTO.CODPLPAG não deve ser nula.
6 - Se a coluna PCDESCONTO.TIPOGRUPOREST for igual a 'CL' a coluna PCDESCONTO.CODGRUPOREST não deve ser nula.

Integração

A API consiste em buscar as regras de politica de desconto cadastradas na 561.

Os dados integrados são:

Winthor	Tipo/ Tam	Tag JSON	Obs
pcdesconto.coddesconto	number(8,0)	campaignId	Código da campanha
pcdesconto.codfilial	varchar2(2)	branchId	Código da filial
pcdesconto.numregiao	number(4)	regionId	Código da região
pcdesconto.codprod	number(6,0)	productId	Código do produto
pcdesconto.codauxiliar	number(20,0)	barCode	Código auxiliar
pcdesconto.codprodprinc	number(6)	mainProductId	Código do produto principal
pcdesconto.codplpag	number(4)	paymentTermId	Código do plano de pagamento
pcdesconto.codgrupo	number(10)	groupClientId
pcdesconto.codpraca	number(4)	squareId	Código da praça
pcdesconto.codativ	number(6)	branchActivityId	Código do ramo de atividade
pcdesconto.utilizadescrede	varchar2(1)	useFeeClientNet
pcdesconto.aplicadesconto	varchar2(1)	taxApplied
pcdesconto.origemped	varchar2(1)	orderOrigin	O - Todos \| A - Varejo
pcdesconto.codfornec	number(6)	supplierId	Código do fornecedor
pcdescontofornec.percdesc	number(10,4)	supplierFeePercentage
pcdesconto.prioritariageral	varchar2(1)	priority
pcdesconto.alteraptabela	varchar2(1)	useMainProductId	Ativa a promoção para produtos principais
pcdesconto.codcli	number(9)	clientId
pcdesconto.codgrupo	number(10)	groupClientId
pcdesconto.codrede	number(4)	clientNetId
pcdesconto.qtini	number(10,4)	startQtd
pcdesconto.qtfim	number(10,4)	endQtd
pcdesconto.dtinicio	date	startDate	Data de inicio da campanha
pcdesconto.dtfim	date	endDate	Data de fim da campanha
pcdesconto.percdesc	number(10,4)	feePercentage	Se valor positivo é desconto, senão , acréscimo
pcdesconto.percdesc	number(10,4)	PercentageValue	Campo sem o Sinal de - ou +
Calculado	Inteiro	type	Tipo de aplicação pcdesconto.percdesc sendo: 0 = desconto ,1 = acréscimo Se valor positivo é desconto=0 , senão - é acréscimo
	String	situation	I = Cadastro inativo A = Cadastro ativo Para validar se uma política está válida, deverá verificar se a mesma não foi movida para o log (PCDESCONTOLOG).
pcdesconto.datalanc	date	registrationDate	Data de cadastro
pcdesconto.dataultalter	date	lastChangeDate	Ultima alteração
pcdesconto.codgruporest	number(9)	restrictionId
pcdesconto.tipogruporest	varchar2(2)	restrictionTermTypeCode	'CL' - Cliente
pcdesconto.codepto	Inteiro		Data de inicio da campanha
pcdesconto.codsec	Inteiro		Código da seção
pcdesconto.codcategoria	Inteiro		Código da categoria
pcdesconto.subcategoria	Inteiro		Código da sub categoria
pcdesconto.codmarca	Inteiro		Código da marca

Exemplo do envio da requisição:

method: 'GET',
url: '/winthor/precos/v1/politica-desconto'     -> Poderá informar todos os PARAMS abaixo.

page			 : 1					   - número de página
pageSize		 : 10					   - quantidade por página
lastChange  	 : 1900-01-01T00:00:00	   - data da última alteração
startDate        : 1900-01-01T00:00:00	 - data de inicio do pedido
endDate          : 1900-01-01T00:00:00	 - data de fim do pedido
id      		 : 0					   - Código da campanha  
branchId  		 : String				   - Código da Filial (lista separado por virgula)
regionId         : 0					     - Código da região (lista separado por virgula) 
productId        : 0					   - Código do produto (lista separado por virgula)
barCodeId        : 0					   - Código de barras 
suppierId        : 0					   - Código do fornecedor
active           : true/false			     - Somente cadastros ativos

Exemplo JSON da resposta:

{
    "first": false,
    "items": [
        {
            "situation": "A",
            "campaignId": 4899,
            "branchId": "1",
            "regionId": 0,
            "productId": 1658,
            "mainProductId": 0,
            "paymentTermId": 1,
            "groupClientId": 0,
            "squareId": 0,
            "branchActivityId": 0,
            "useFeeClientNet": "N",
            "taxApplied": "S",
            "orderOrigin": "O",
            "supplierId": 0,
            "supplierFeePercentage": 0,
            "priority": "N",
            "useMainProductId": "N",
            "clientId": 0,
            "clientNetId": 0,
            "startDate": "0024-11-06T00:00:00",
            "endDate": "0025-11-06T00:00:00",
            "feePercentage": -10,
            "percentageValue": 10,
            "type": 1,
            "registrationDate": "2024-11-06T17:10:19",
            "lastChangeDate": "0024-11-06T00:00:00",
            "restrictionId": 1,
            "restrictionTermTypeCode": "CL",
            "codeDepartment": 0,
            "codeSection": 0,
            "codeCategory": 0,
            "codeSubCategory": 0,
            "brandcode": 0
        }
    ],
    "hasNext": false
}

Para que seja realizada uma nova integração atualizando um registro já integrado, o sistema verifica a data de última atualização do registro. Portanto, ao realizar alguma alteração no registro, ele será encaminhado novamente para manter a integridade dos dados.