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: | 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 | Código do Grupo de Cliente cadastrado na Rotina 3311 | | 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 | Percentual de desconto aplicado ao fornecedor na Rotina 4161 | | pcdesconto.prioritariageral | varchar2(1) | priority | Forçar Aplicação de Política Prioritária | | pcdesconto.alteraptabela | varchar2(1) | useMainProductId | Ativa a promoção para produtos principais | | pcdesconto.codcli | number(9) | clientId | Código do Cliente | | pcdesconto.codgrupo | number(10) | groupClientId |
| | pcdesconto.codrede | number(4) | clientNetId | Código da rede | | pcdesconto.qtini | number(10,4) | startQtd | Quantidade inicial | | pcdesconto.qtfim | number(10,4) | endQtd | Quantidade final | | 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 | active | I = Cadastro inativo A = Cadastro ativo | | pcdesconto.datalanc | date | registrationDate | Data de cadastro | | pcdesconto.dataultalter | date | lastChangeDate | Ultima alteração | | pcdesconto.codgruporest | number(9) | restrictionId | Código do Grupo de Cliente cadastrado na Rotina 3311 | | pcdesconto.tipogruporest | varchar2(2) | restrictionTermTypeCode | 'CL' - Cliente | | pcdesconto.codepto | Inteiro | codeDepartment | Data de inicio da campanha | | pcdesconto.codsec | Inteiro | codeSection | Código da seção | | pcdesconto.codcategoria | Inteiro | codeCategory | Código da categoria | | pcdesconto.subcategoria | Inteiro | codeSubCategory | Código da sub categoria | | pcdesconto.codmarca | Inteiro | brandcode | Código da marca |
Sobre a Resposta da Requisição na apresentação dos seguintes campos listados: SkuId - Se o campo PCDESCONTO.CODAUXILIAR estiver preenchido, o retorno será formado por:
PCPRODUT.CODAUXILIAR + "-" + PCEMBALAGEM.CODPROD,
onde PCPRODUT é obtido pela busca: PCPRODUT.CODPROD = PCEMBALAGEM.CODPROD. - Se o campo PCDESCONTO.CODPROD estiver preenchido, o retorno será:
PCPRODUT.CODAUXILIAR + "-" + PCDESCONTO.CODPROD,
onde PCPRODUT é obtido pela busca: PCPRODUT.CODPROD = PCDESCONTO.CODPROD.
PackingId - Quando o campo PCDESCONTO.CODAUXILIAR estiver preenchido, o retorno será:
PCDESCONTO.CODAUXILIAR + "-" + PCEMBALAGEM.CODPROD.
AllPackages - Se PCDESCONTO.CODAUXILIAR estiver preenchido, o retorno será false.
- Se PCDESCONTO.CODAUXILIAR não estiver preenchido, o retorno será true.
Regras para entender os campos de desconto e acréscimo Campo percdesc (taxa de desconto ou acréscimo) - Valores positivos: Representam desconto.
Exemplo: 10,0000 significa um desconto de 10%. - Valores negativos: Representam acréscimo.
Exemplo: -10,0000 significa um acréscimo de 10%.
Campo percentageValue (valor da porcentagem) - Mostra somente o número, sem sinal de positivo (+) ou negativo (-).
Exemplo: Se o valor for 10,0000, ele pode ser um desconto ou acréscimo, dependendo de como o sistema interpretar.
Campo type (tipo de aplicação) - Indica se o valor é desconto ou acréscimo:
- 0: É um desconto.
- 1: É um acréscimo.
Como tudo funciona junto: - Se o número no campo percdesc for positivo, ele será tratado como um desconto e o
type será 0. - Se o número no campo percdesc for negativo, ele será tratado como um acréscimo e o
type será 1.
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Exemplo do envio da requisição: | Bloco de código |
|---|
| method: 'GET',
url: '/winthor/precos/v1/politica-desconto' -> Poderá informar todos os PARAMS abaixo.
|
| Bloco de código |
|---|
| page : 1 - número da página (se não informar, assume o padrão)
pageSize : 10 - quantidade de registros por página (se não informar, assume o padrão)
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. caso não informado trazer todos
branchId : String - Código da Filial (lista separado por virgula). Não obrigatório. Se for nulo, tratar como 99
regionId : 0 - Código da região (lista separado por virgula), caso não informado trazer todos
productId : 0 - Código do produto (lista separado por virgula), caso não informado trazer todos
barCodeId : 0 - Código de barras, caso não informado trazer todos
suppierId : 0 - Código do fornecedor, caso não informado trazer todos
active : true/false - Somente cadastros ativos, caso não informado trazer todos |
|
| 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": [
{
"active": "true",
"campaignId": 4899,
"branchId": "1",
"regionId": 0,
"productId": 2996,
"skuId": "7899917123826-2996",
"barCode": 7899917123826,
"packingId": "7899917123826-2996",
"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-06T23:59:59",
"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
} |
|
|
