A integração API consiste em enviar todas buscar as regras de politica de desconto cadastradas na 561 por filial. | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Os dados integrados são: Tag| Winthor | Tipo/ Tam | Tag JSON | ObscodigoCampanha | | 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 produtocodigoBarras | | pcdesconto.codauxiliar | number(20,0) | barCode | Código auxiliar | | codigoProdutoPrincipal | pcdesconto.codprodprinc | number(6) | mainProductId | Código do produto principalcodigoPlanoPagamento | | pcdesconto.codplpag | number(4) | paymentTermId | Código do plano de pagamentocodigoGrupoRestricaoPlanoPagto | | pcdesconto.codgrupo | number(10) | groupClientIdcodigoPraca | Código do Grupo de Cliente cadastrado na Rotina 3311 | | pcdesconto.codpraca | number(4) | squareId | Código da praçacodigoRamoAtividade | | pcdesconto.codativ | number(6) | branchActivityId | Código do ramo de atividadeusaClientePrincipal | | 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) | supplierFeePercentageprioritaria | Percentual de desconto aplicado ao fornecedor na Rotina 4161 | | pcdesconto.prioritariageral | varchar2(1) | priorityusaProdutoPrincipal | Forçar Aplicação de Política Prioritária | | pcdesconto.alteraptabela | varchar2(1) | useMainProductId | Ativa a promoção para produtos principaiscodigoCliente | | pcdesconto.codcli | number(9) | clientIdcodigoGrupoCliente | Código do Cliente | | pcdesconto.codgrupo | number(10) | groupClientId |
| | codigoRedeCliente | pcdesconto.codrede | number(4) | clientNetIdqtdInicial | Código da rede | | pcdesconto.qtini | number(10,4) | startQtdqtdFinal | Quantidade inicial | | pcdesconto.qtfim | number(10,4) | endQtddataInicio | Quantidade final | | pcdesconto.dtinicio | date | startDate | Data de inicio da campanhadataFim | | pcdesconto.dtfim | date | endDate | Data de fim da campanha | | percentualTaxa | pcdesconto.percdesc | number(10,4) | feePercentage | Se valor positivo é desconto, senão  , acréscimopercentualValue | | 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 active | I = Cadastro inativo A = Cadastro ativo dataCadastro | | pcdesconto.datalanc | date | registrationDate | Data de cadastrodataUltimaAlteracao | | pcdesconto.dataultalter | date | lastChangeDate | Ultima alteração | | codigoRestricaoPlanoPagto | pcdesconto.codgruporest | number(9) | restrictionIdcodigoTipoRestricaoPlanoPagto | Código do Grupo de Cliente cadastrado na Rotina 3311 | | pcdesconto.tipogruporest | varchar2(2) | restrictionTermTypeCode | 'CL' - ClientecodigoDepartamento | | pcdesconto.codepto | Inteiro | codeDepartment | Data de inicio da campanhacodigoSecao | | pcdesconto.codsec | Inteiro | codeSection | Código da seção | | codigoCategoria | pcdesconto.codcategoria | Inteiro | codeCategory | Código da categoria codigoSubCategoria | | pcdesconto.subcategoria | Inteiro | codeSubCategory | Código da sub categoria | | codigoMarca | 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 deda 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": [
{
"situationactive": "Atrue",
"campaignId": 4899,
"branchId": "1",
"regionId": 0,
"productId": 2996,
"skuId": "7899917123826-2996",
"productIdbarCode": 16587899917123826,
"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-06T0006T23:0059:0059",
"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
} |
|
|
