A integração consiste em enviar todo estoque disponível que serão utilizados no E-CommerceAPI 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: | API | Winthor (Rotina 201) | Winthor (Rotina 2017) - ATACADO | Winthor (Rotina 2017) - VAREJO |
---|
branchId | PCEMBALAGEM.CODFILIAL | PCEMBALAGEM.CODFILIAL | PCEMBALAGEM.CODFILIAL | erpReferenceKey | PCTABPR.CODPROD | PCTABPR.CODPROD | PCTABPR.CODPROD | fixedPrice | PCPRODUT.PRECOFIXO | PCPRODUT.PRECOFIXO | PCPRODUT.PRECOFIXO | lastChange | PCEMBALAGEM.DTULTALTPVENDA | PCEMBALAGEM.DTULTALTPVENDA | PCEMBALAGEM.DTULTALTPVENDA | origin | 201 | 2017 | 2017 | price | PCTABPR.PVENDA1 | PCEMBALAGEM.PVENDAATAC1 | PCEMBALAGEM.PVENDA | PCTABPR.PVENDA2 | PCEMBALAGEM.PVENDAATAC | PCTABPR.PVENDA3 | PCEMBALAGEM.PVENDAATAC | PCTABPR.PVENDA4 | PCEMBALAGEM.PVENDAATAC | PCTABPR.PVENDA5 | PCEMBALAGEM.PVENDAATAC | PCTABPR.PVENDA6 | PCEMBALAGEM.PVENDAATAC | PCTABPR.PVENDA7 | PCEMBALAGEM.PVENDAATAC | pricingIpi | PCTABPR.VLIPI | PCTABPR.VLIPI | PCTABPR.VLIPI | pricingSt | PCTABPR.VLST | PCTABPR.VLST | PCTABPR.VLST | skuId | PCPRODUT.CODAUXILIAR, PCPRODUT.CODPROD | PCPRODUT.CODAUXILIAR, PCPRODUT.CODPROD | PCPRODUT.CODAUXILIAR, PCPRODUT.CODPROD | taxFigureId | PCTABPR.CODST | PCTABPR.CODST | PCTABPR.CODST | unitMultiplier | PCEMBALAGEM.QTUNIT | PCEMBALAGEM.QTUNIT | PCEMBALAGEM.QTUNIT | gnreST | campo calculado* | campo calculado* | campo calculado* | st | campo calculado* | campo calculado* | campo calculado* | calculationBaseFecp | campo calculado* | campo calculado* | campo calculado* | calculationBaseIpi | campo calculado* | campo calculado* | campo calculado* | calculationBaseST | campo calculado* | campo calculado* | campo calculado* | internalSTAliquot | campo calculado* | campo calculado* | campo calculado* | ipi | campo calculado* | campo calculado* | campo calculado* | ipiAliquot | campo calculado* | campo calculado* | campo calculado* | externalSTAliquot | campo calculado* | campo calculado* | campo calculado* | fecp | campo calculado* | campo calculado* | campo calculado* | fecpAliquot | campo calculado* | campo calculado* | campo calculado* | offerPrice | PCEMBALAGEM.POFERTA | PCEMBALAGEM.POFERTA | PCEMBALAGEM.POFERTA | offerStartDate | PCEMBALAGEM.DTOFERTAINI | PCEMBALAGEM.DTOFERTAINI | PCEMBALAGEM.DTOFERTAINI | 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.
offerEndDate | PCEMBALAGEM.DTOFERTAFIM | PCEMBALAGEM.DTOFERTAFIM | PCEMBALAGEM.DTOFERTAFIM
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ódigoquantidade de Clienteregistros
productSKUERPReferenceKeypor :página 0(se não informar, assume o padrão)
lastChange : 1900-01- Código do Produto
providerId : 0 - Código do Fornecedor
departmentId : 0 - Código do Departamento
sectionId01T00: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
categoryIdcampanha. 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 - Origem
order : lastChange - ordenação
lastChange : 1900-01-01T00:00:00 - data da última alteração
page : 1Código do produto (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": "string",
"calculationBaseFecp": 0,
"calculationBaseIpi": 0,
"calculationBaseST": 0,
"erpReferenceKey": 0,
"externalSTAliquot": 0,
"fecp": 0,
"fecpAliquot": 0,
"fixedPrice": false,
"internalSTAliquot": 0,
"ipi": 0,
"ipiAliquot": 0,
"lastChange": "2021-07-23T15:25:19",
"noTaxesPrice": 0,
"origin": 201,
"price": 129.25,
"pricingIpi": 0,
"pricingSt": 0.0,
"skuId": "000-0",
"st": 0,
"taxFigureId": 10,
"unitMultiplier": 0,
"offerPrice": 0,
"offerStartDate": "",
"offerEndDate": "",
"gnreST": false {
"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,
"priceRegionbrandcode": 10
}
],
"hasNext": false false
} |
|
|