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 tamingles | obs | codigoCampanha| Tag JSON | Obs | | pcdesconto.coddesconto | number(8,0) | campaignId |
codigoFilial| Código da campanha | | pcdesconto.codfilial | varchar2(2) | branchId |
pode ser nulo | numeroRegiao| Código da filial | | pcdesconto.numregiao | number(4) | regionId |
codigoProduto| Código da região | | pcdesconto.codprod | number(6,0) | productId |
codigoBarras| Código do produto | | pcdesconto.codauxiliar | number(20,0) | barCode |
codigoProdutoPrincipal| Código auxiliar | | pcdesconto.codprodprinc | number(6) | mainProductId |
codigoPlanoPagamento| Código do produto principal | | pcdesconto.codplpag | number(4) | paymentTermId |
codigoGrupoRestricaoPlanoPagto| Código do plano de pagamento | | pcdesconto.codgrupo | number(10) | groupClientId |
codigoPraca| Código do Grupo de Cliente cadastrado na Rotina 3311 | | pcdesconto.codpraca | number(4) | squareId |
codigoRamoAtividade| Código da praça | | pcdesconto.codativ | number(6) | branchActivityId |
usaClientePrincipal| Código do ramo de atividade | | pcdesconto. |
utlizadescrede| 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 |
percentualTaxaFornecedor| Código do fornecedor | | pcdescontofornec.percdesc | number(10,4) | supplierFeePercentage |
prioritaria| Percentual de desconto aplicado ao fornecedor na Rotina 4161 | | pcdesconto.prioritariageral | varchar2(1) | priority |
usaProdutoPrincipal| Forçar Aplicação de Política Prioritária | | pcdesconto.alteraptabela | varchar2(1) | useMainProductId |
ativa | Ativa a promoção para produtos principais |
codigoCliente | | pcdesconto.codcli | number(9) | clientId |
codigoGrupoCliente| Código do Cliente | | pcdesconto.codgrupo | number(10) | groupClientId |
codigoRedeCliente |
| | pcdesconto.codrede | number(4) | clientNetId |
qtdInicial| Código da rede | | pcdesconto.qtini | number(10,4) | startQtd |
qtdFinal| Quantidade inicial | | pcdesconto.qtfim | number(10,4) | endQtd |
dataInicio| Quantidade final | | pcdesconto.dtinicio | date | startDate |
dataFim| Data de inicio da campanha | | pcdesconto.dtfim | date | endDate |
percentualTaxa| Data de fim da campanha | | 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 | situation | dataCadastro
| String | active | I = Cadastro inativo A = Cadastro ativo | | pcdesconto.datalanc | date | registrationDate |
dataUltimaAlteracao| Data de cadastro | | pcdesconto.dataultalter | date | lastChangeDate |
codigoRestricaoPlanoPagto| Ultima alteração | | pcdesconto.codgruporest | number(9) | restrictionId |
codigoTipoRestricaoPlanoPagto| Código do Grupo de Cliente cadastrado na Rotina 3311 | | pcdesconto.tipogruporest | varchar2(2) | restrictionTermTypeCode | 'CL' - Cliente |
codigoDepartamentocodigoSecao | Inteiro | codeDepartment | Data de inicio da campanha | | pcdesconto.codsec |
codigoCategoria| Inteiro | codeSection | Código da seção | | pcdesconto.codcategoria |
codigoSubCategoria | Inteiro | codeCategory | Código da categoria | | pcdesconto.subcategoria |
codigoMarca | 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: '/apiwinthor/wholesaleprecos/v1/price/listpolitica-desconto' -> Poderá informar todos os PARAMS abaixo.
OU
url: '/api/wholesale/v1/price/' -> Passar os dados do produto e Filial, e opcionalmente o cliente e plano de pagamento. |
| Bloco de código |
|---|
| branchId page : 01 - Códigonúmero da Filial *requerido
customerId página (se não informar, assume o padrão)
pageSize : 010 - Código Cliente
productSKUERPReferenceKey : 0 - Código do Produto
providerId : 0 - Código do Fornecedor
departmentId : 0 - Código do Departamento
sectionId 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 Seção
categoryId campanha. caso não informado trazer todos
branchId : 0String - Código da Categoria
subcategoryId : 0 - Código da SubCategoria
productSegmentId : 0 - Código do Segmento do produto
brandId : 0 - Código da Marca
paymentPlanId Filial (lista separado por virgula). Não obrigatório. Se for nulo, tratar como 99
regionId : 0 - Código do Plano- de Pagamento
measuredUnit : string - Unidade de medida
imported : true/false - Importado
callOrigin : WCódigo da região (lista separado por virgula), caso não informado trazer todos
productId : 0 - Código Origem
orderdo produto : lastChange - ordenação
lastChange : 1900-01-01T00:00:00 - data da última alteração
page : 1(lista separado por virgula), caso não informado trazer todos
barCodeId : 0 - númeroCódigo de página
pageSize : 10 barras, caso não informado trazer todos
suppierId : 0 - quantidade por página
multiRegionPrice- :Código true/falsedo fornecedor, caso não informado trazer todos
active - Trazer as regiões configurados para o E-commerce (rotina 519) API list
useMultiplePricesPerProductPackage: true/false - Retornar os preços por embalagens: 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": [
{
"branchId {
"active": "string",
"calculationBaseFecp": 0,
"calculationBaseIpi"true",
"campaignId": 4899,
"branchId": "1",
"regionId": 0,
"calculationBaseST
"productId": 02996,
"erpReferenceKey "skuId": 0,
"externalSTAliquot"7899917123826-2996",
"barCode": 07899917123826,
"fecp "packingId": 0,
"fecpAliquot"7899917123826-2996",
"mainProductId": 0,
"fixedPrice "paymentTermId": false1,
"internalSTAliquot "groupClientId": 0,
"ipi "squareId": 0,
"ipiAliquot "branchActivityId": 0,
"lastChange": "2021-07-23T15:25:19",
"noTaxesPrice "useFeeClientNet": "N",
"taxApplied": "S",
"orderOrigin": "O",
"supplierId": 0,
"supplierFeePercentage": 0,
"origin "priority": 201"N",
"price "useMainProductId": 129.25,
"pricingIpi"N",
"clientId": 0,
"pricingSt "clientNetId": 0.0,
"skuId": "000-0",
"st": 0,
"taxFigureId": 10,
"unitMultiplier": 0,
"offerPrice": 0,
"offerStartDate": "",
"offerEndDate": "",
"gnreST": false,
"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,
"priceRegionbrandcode": 10
}
],
"hasNext": false false
} |
|
|
