Páginas filhas
  • APIs Integrações - Politica de desconto

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • 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
Aviso
titleImportante

Quando não houver preenchimento do campo DATA, exemplo (data de cadastro, data de alteração), nossas APIs retornará por padrão a informação "1900-01-01T00:00:00".

Caso necessário, realizar o ajuste nos cadastros para que a API apresente a data desejada.

Integração


Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04
idspasso1,passo2,passo3

A integração consiste em enviar todo estoque disponível que serão utilizados no E-Commercetodas as regras de politica de desconto cadastradas na 561 por filial.

PCEMBALAGEM.DTOFERTAFIM
Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

tagwinthortipo/ taminglesobs
codigoCampanhapcdesconto.coddescontonumber(8,0)campaignId
codigoFilialpcdesconto.codfilialvarchar2(2)branchIdpode ser nulo
numeroRegiaopcdesconto.numregiaonumber(4)regionId
codigoProdutopcdesconto.codprodnumber(6,0)productId
codigoBarraspcdesconto.codauxiliarnumber(20,0)barCode
codigoProdutoPrincipalpcdesconto.codprodprincnumber(6)mainProductId
codigoPlanoPagamentopcdesconto.codplpagnumber(4)paymentTermId
codigoGrupoRestricaoPlanoPagtopcdesconto.codgruponumber(10)groupClientId
codigoPracapcdesconto.codpracanumber(4)squareId
codigoRamoAtividadepcdesconto.codativnumber(6)branchActivityId
usaClientePrincipalpcdesconto.utlizadescredevarchar2(1)useFeeClientNet
aplicaDescontoAutomaticopcdesconto.aplicadescontovarchar2(1)taxApplied
origempcdesconto.origempedvarchar2(1)orderOriginO - Todos | A - Varejo
codigoFornecedorpcdesconto.codfornecnumber(6)supplierId
percentualTaxaFornecedorpcdescontofornec.percdescnumber(10,4)supplierFeePercentage
prioritariapcdesconto.prioritariageralvarchar2(1)priority
usaProdutoPrincipalpcdesconto.alteraptabelavarchar2(1) useMainProductIdativa a promoção para produtos principais
codigoClientepcdesconto.codclinumber(9)clientId
codigoGrupoClientepcdesconto.codgruponumber(10)groupClientId
codigoRedeClientepcdesconto.codredenumber(4)clientNetId
qtdInicialpcdesconto.qtininumber(10,4)startQtd
qtdFinalpcdesconto.qtfimnumber(10,4)endQtd
dataIniciopcdesconto.dtiniciodatestartDate
dataFimpcdesconto.dtfimdateendDate
percentualTaxapcdesconto.percdescnumber(10,4)feePercentageSe valor positivo é desconto, senão , acréscimo
percentualValuepcdesconto.percdescnumber(10,4)PercentageValueCampo sem o Sinal de - ou +
tipoCalculadoInteirotypeTipo de aplicação sendo:   0 = desconto ,1 = acréscimo
Se valor positivo é desconto=0 , senão - é acréscimo
situacao

situation
dataCadastropcdesconto.datalancdateregistrationDate
dataUltimaAlteracaopcdesconto.dataultalterdatelastChangeDate
codigoRestricaoPlanoPagtopcdesconto.codgruporestnumber(9)restrictionId
codigoTipoRestricaoPlanoPagtopcdesconto.tipogruporestvarchar2(2)restrictionTermTypeCode'CL' - Cliente
codigoDepartamentopcdesconto.codepto


codigoSecaopcdesconto.codsec


codigoCategoriapcdesconto.codcategoria


codigoSubCategoriapcdesconto.subcategoria


codigoMarcapcdesconto.codmarca
API Winthor (Rotina 201)Winthor (Rotina 2017) - ATACADOWinthor (Rotina 2017) - VAREJO
branchIdPCEMBALAGEM.CODFILIALPCEMBALAGEM.CODFILIALPCEMBALAGEM.CODFILIAL
erpReferenceKeyPCTABPR.CODPRODPCTABPR.CODPRODPCTABPR.CODPROD
fixedPricePCPRODUT.PRECOFIXOPCPRODUT.PRECOFIXOPCPRODUT.PRECOFIXO
lastChangePCEMBALAGEM.DTULTALTPVENDAPCEMBALAGEM.DTULTALTPVENDAPCEMBALAGEM.DTULTALTPVENDA
origin20120172017
pricePCTABPR.PVENDA1PCEMBALAGEM.PVENDAATAC1PCEMBALAGEM.PVENDA
PCTABPR.PVENDA2PCEMBALAGEM.PVENDAATACPCTABPR.PVENDA3PCEMBALAGEM.PVENDAATACPCTABPR.PVENDA4PCEMBALAGEM.PVENDAATACPCTABPR.PVENDA5PCEMBALAGEM.PVENDAATACPCTABPR.PVENDA6PCEMBALAGEM.PVENDAATACPCTABPR.PVENDA7PCEMBALAGEM.PVENDAATAC
pricingIpiPCTABPR.VLIPIPCTABPR.VLIPIPCTABPR.VLIPI
pricingStPCTABPR.VLSTPCTABPR.VLSTPCTABPR.VLST
skuIdPCPRODUT.CODAUXILIAR, PCPRODUT.CODPRODPCPRODUT.CODAUXILIAR, PCPRODUT.CODPRODPCPRODUT.CODAUXILIAR, PCPRODUT.CODPROD
taxFigureIdPCTABPR.CODSTPCTABPR.CODSTPCTABPR.CODST
unitMultiplierPCEMBALAGEM.QTUNITPCEMBALAGEM.QTUNITPCEMBALAGEM.QTUNIT
gnreST campo calculado*campo calculado*campo calculado*
stcampo calculado*campo calculado*campo calculado*
calculationBaseFecpcampo calculado*campo calculado*campo calculado*
calculationBaseIpicampo calculado*campo calculado*campo calculado*
calculationBaseSTcampo calculado*campo calculado*campo calculado*
internalSTAliquotcampo calculado*campo calculado*campo calculado*
ipicampo calculado*campo calculado*campo calculado*
ipiAliquotcampo calculado*campo calculado*campo calculado*
externalSTAliquotcampo calculado*campo calculado*campo calculado*
fecpcampo calculado*campo calculado*campo calculado*
fecpAliquotcampo calculado*campo calculado*campo calculado*
offerPricePCEMBALAGEM.POFERTAPCEMBALAGEM.POFERTAPCEMBALAGEM.POFERTA
offerStartDatePCEMBALAGEM.DTOFERTAINIPCEMBALAGEM.DTOFERTAINIPCEMBALAGEM.DTOFERTAINI
offerEndDatePCEMBALAGEM.DTOFERTAFIMPCEMBALAGEM.DTOFERTAFIM































































































Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/api/wholesale/v1/price/list'     -> 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
languagejs
titleParams
branchId  		 : 0					- Código da Filial  *requerido
customerId 		 : 0					- Código Cliente 
productSKUERPReferenceKey : 0       	- Código do Produto
providerId		 : 0					- Código do Fornecedor
departmentId	 : 0					- Código do Departamento
sectionId		 : 0					- Código da Seção
categoryId		 : 0					- 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	 : 0					- Código do Plano de Pagamento
measuredUnit	 : string				- Unidade de medida
imported  		 : true/false			- Importado
callOrigin  	 : W					- Origem
order  			 : lastChange			- ordenação
lastChange  	 : 1900-01-01T00:00:00	- data da última alteração
page			 : 1					- número de página
pageSize		 : 10					- quantidade por página
multiRegionPrice : true/false           - Trazer as regiões configurados para o E-commerce (rotina 519) API list
useMultiplePricesPerProductPackage: true/false - Retornar os preços por embalagens 
Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody 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,
            "priceRegion": 1
         }
    ],
    "hasNext": false
}

...