Histórico da Página

...

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 COMERCIALdesconto comercial).
2 - NVL(A coluna PCDESCONTO.ORIGEMPED ,'O') IN ('deverá ser 'A' ,ou 'O').
3 - A coluna PCDESCONTO.APLICADESCONTO = deverá ser 'S' (APLICA DESCONTO AUTOMATICAMENTE)aplica desconto automaticamente).
4 - As colunas PCDESCONTO.CODAUXILIAR IS NOT NULL OR PCDESCONTO.CODPROD NÃO DEVE SER NULOnão pode ser nulo.
5 - SE, NVL(Se a coluna PCDESCONTO.APENASPLPAGMAX ,'N') = for igual a 'S' , E, a coluna PCDESCONTO.CODPLPAG NÃO DEVE SER NULOnão deve ser nula.
6 - Se a coluna PCDESCONTO.TIPOGRUPOREST IN (for igual a 'CL' ) ENTAO a coluna PCDESCONTO.CODGRUPOREST NÃO PODE SER NULOnão deve ser nula.

Integração

Totvs custom tabs box

tabs	Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04
ids	passo1,passo2,passo3

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

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

Tag	Winthor	Tipo/ Tam	JSON	Obs
codigoCampanha	pcdesconto.coddesconto	number(8,0)	campaignId	Código da campanha
codigoFilial	pcdesconto.codfilial	varchar2(2)	branchId	Código da filial
numeroRegiao	pcdesconto.numregiao	number(4)	regionId	Código da região
codigoProduto	pcdesconto.codprod	number(6,0)	productId	Código do produto
codigoBarras	pcdesconto.codauxiliar	number(20,0)	barCode	Código auxiliar
codigoProdutoPrincipal	pcdesconto.codprodprinc	number(6)	mainProductId	Código do produto principal
codigoPlanoPagamento	pcdesconto.codplpag	number(4)	paymentTermId	Código do plano de pagamento
codigoGrupoRestricaoPlanoPagto	pcdesconto.codgrupo	number(10)	groupClientId
codigoPraca	pcdesconto.codpraca	number(4)	squareId	Código da praça
codigoRamoAtividade	pcdesconto.codativ	number(6)	branchActivityId	Código do ramo de atividade
usaClientePrincipal	pcdesconto.utilizadescrede	varchar2(1)	useFeeClientNet
aplicaDescontoAutomatico	pcdesconto.aplicadesconto	varchar2(1)	taxApplied
origem	pcdesconto.origemped	varchar2(1)	orderOrigin	O - Todos \| A - Varejo
codigoFornecedor	pcdesconto.codfornec	number(6)	supplierId	Código do fornecedor
percentualTaxaFornecedor	pcdescontofornec.percdesc	number(10,4)	supplierFeePercentage
prioritaria	pcdesconto.prioritariageral	varchar2(1)	priority
usaProdutoPrincipal	pcdesconto.alteraptabela	varchar2(1)	useMainProductId	Ativa a promoção para produtos principais
codigoCliente	pcdesconto.codcli	number(9)	clientId
codigoGrupoCliente	pcdesconto.codgrupo	number(10)	groupClientId
codigoRedeCliente	pcdesconto.codrede	number(4)	clientNetId
qtdInicial	pcdesconto.qtini	number(10,4)	startQtd
qtdFinal	pcdesconto.qtfim	number(10,4)	endQtd
dataInicio	pcdesconto.dtinicio	date	startDate	Data de inicio da campanha
dataFim	pcdesconto.dtfim	date	endDate	Data de fim da campanha
percentualTaxa	pcdesconto.percdesc	number(10,4)	feePercentage	Se valor positivo é desconto, senão , acréscimo
percentualValue	pcdesconto.percdesc	number(10,4)	PercentageValue	Campo sem o Sinal de - ou +
tipo	Calculado	Inteiro	type	Tipo de aplicação pcdesconto.percdesc sendo: 0 = desconto ,1 = acréscimo Se valor positivo é desconto=0 , senão - é acréscimo
situacao		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).
dataCadastro	pcdesconto.datalanc	date	registrationDate	Data de cadastro
dataUltimaAlteracao	pcdesconto.dataultalter	date	lastChangeDate	Ultima alteração
codigoRestricaoPlanoPagto	pcdesconto.codgruporest	number(9)	restrictionId
codigoTipoRestricaoPlanoPagto	pcdesconto.tipogruporest	varchar2(2)	restrictionTermTypeCode	'CL' - Cliente
codigoDepartamento	pcdesconto.codepto	Inteiro		Data de inicio da campanha
codigoSecao	pcdesconto.codsec	Inteiro		Código da seção
codigoCategoria	pcdesconto.codcategoria	Inteiro		Código da categoria
codigoSubCategoria	pcdesconto.subcategoria	Inteiro		Código da sub categoria
codigoMarca	pcdesconto.codmarca	Inteiro		Código da marca

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

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

Bloco de código

language	js
title	Params

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

Totvs custom tabs box items

default	no
referencia	passo3

Exemplo JSON da resposta:

Bloco de código

language	js
title	Body Response

{
    "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
}

...

Páginas filhas

Versões comparadas

Versão antiga 24

Nova versão 25

Chave

Integração