Histórico da Página

...

• Necessário a instalação do  serviço winthor-pedido-venda. 
• Definir o "Caso o atributo "seller" não seja enviado na requisição, a API consultará o RCA definido no parâmetro "4012 - Código do RCA para cadastro de clientes na Ciashop"  na opção 4012-CODRCACIASHOP da rotina 132- Parâmetros da Presidência.
• A região padrão de preço deverá ser informada na opção 4257-CODREGIAOPRECOCIASHOP da rotina 132- Parâmetros da Presidência.
• A precificação deverá ser realizada por Filial no parâmetro 2277 - Tipo de precificação selecionando o tipo de precificação conforme necessidade.
• A tabela PCLOGPEDIDOAPI, é responsável por guardar os retornos dos pedidos importados via integração, sendo Operação (I - inclusão, A - alteração, C - cancelamento) e Status (A - Aceito, R - Rejeitado, P - Processando).
• Através da lista de pedidos é possível pesquisar por Filial ou Multifiliais (separado por vírgula) para obter os dados.
• Os dados de Razão social do intermediador e CNPJ do intermediador serão representados pelos campos, "intermediaryCompanyName" e  "idIntermediaryEmployer" respectivamente.
• Considera-se na totalização do pedido frete e outras despesas.
• Ao inserir um pedido através da API, o campo "PCPEDI.PBASERCA" gravará de acordo com o campo “PCPEDI.PTABELA”, não é necessário enviá-lo pela API.
• Será persistidos os dados de cartão que a operadora do cartão retorna como o NSU e DTNSU (data de aprovação do cartão).
• No envio do JSON deve-se enviar no campo productSKUERPReferenceKey o código auxiliar seguido do código do produto. Exemplo: 100-1 
• Ao inserir um pedido, deverá enviar a informação do atributo  acceptOrderWithoutTax. As figuras tributárias consideradas são referente a rotina 271 ou rotina 514 em caso de tributação por estado (parâmetro 1092 - Usar tributação por estado (UF), rotina 132) para o item. Caso não tenha a informação da figura tributária em alguma das rotinas e o atributo "acceptOrderWithoutTax" esteja sendo enviado com "false" , o pedido será rejeitado, do contrário se o parâmetro não for enviado, ou for enviado como "true", mesmo que não haja tributação vinculada o pedido será registrado, porém com o valor "0" na coluna PCPEDI.CODST e demais colunas de imposto.
• Caso o processo de desconto por item seja utilizado, o valor do desconto deve ser informado no campo listOfOrderItem.discountValue no body do json de envio do pedido. O campo sellPrice deve conter o valor correspondente ao valor tabela - valor do desconto. O preço tabela corresponderá ao preço de venda + o valor do desconto, e o percentual do desconto será calculado automaticamente. É necessário que haja uma política de desconto cadastrada na Rotina 561 para o conjunto de dados que serão enviados, de forma a controlar o percentual de desconto aplicado. Caso não haja política cadastrada, o pedido será integrado com a posição "Bloqueado".
• Ainda sobre o processo de desconto por item, a API está validando o parâmetro 1463 - % Máximo de desconto Médio nos Orçamentos e Pedidos de Venda da Rotina 132, de forma que mesmo havendo política de desconto que permita o percentual informado, o pedido não será integrado se o percentual for superior ao informado no parâmetro. Caso o parâmetro esteja com o valor "0", essa validação será desconsiderada e o pedido será integrado bloqueado.
• Ao enviar os atributos "deductionsCmv": {"discountsCofins": 0,"discountsIcms":  0,"discountsPis": 0}  no corpo da requisição, será reduzido o valor do CMV considerando os descontos de: PIS, COFINS e ISENÇÃO de ICMS  (Rotina 514- Figura triutária) os valores enviados serão apenas gravados. Esses mesmos dados serão retornados na API de consulta de pedido.
• Sugestão do time de produto modificar o parâmetro(4591) para não permitir alterar o Código Auxiliar ver Link DDRET-6481 DT Criar Parâmetro para Edição de CODAUXILIAR
• Para o processo de múltiplas cobranças, o mesmo só poderá ser utilizado caso o parâmetro 3968 - Permite incluir multiplas cobranças? da Rotina 132 esteja marcado como "Sim". Para cobranças do tipo cartão, o envio do campo "nsu" é obrigatório.
• Ao enviar um item no pedido que seja bonificado/brinde o campo "gift" precisa está como "true", além disso o parâmetro 3045 da rotina 132 deve esta liberado (marcado igual a Sim).
• Ao inserir um pedido, é possível passar o parâmetro booleano "acceptSearchAutomaticFreightType" para permitir ou não a definição automática do tipo de frete baseado no que foi cadastrado para o fornecedor daquela venda. Caso você não informe o tipo de frete (parâmetro "freightDispatch"), e você informe o campo do fornecedor (parâmetro "carrierId"), ele consulte qual o tipo de envio é o padrão para aquele fornecedor, e faça a definição da venda com o mesmo tipo.

'

 Integração

• Para validar se o pedido já existe, a api utiliza os campos orderIdHube e orderIdMktplace da requisição (correspondente aos campos pcpedc.numpedhube e pcpedc.numpedmktplace do banco). É utilizada a combinação dos dois campos para validar se o pedido já existe, portanto só serão integrados os pedidos se os dois campos forem distintos de algum registro já existente no banco.

• Sobre o preenchimento do campo de percentual de IPI, esse valor é preenchido quando o método da API busca as informações do produto, com valores cadastrados na rotina 271.
  A partir da versão 1.2.14.4, ao passar pela rotina de cálculo de IPI, será verificado o valor do parâmetro 4753 - Define o valor do percentual do IPI configurado no produto (BUSCAVALORPERCENTUALIPIAPIPEDIDO) , que tem o valor padrão "Sim". Se mantido como "Sim", o sistema continuará definindo o valor preenchido para o percentual de IPI na rotina 271. Caso seja definido como "Não", o sistema atribuirá o valor do percentual de IPI como 0.

• Para recalculo do valor do IPI o parâmetro  4681 - Habilita cálculo reverso para impostos dos itens de valor agregado no pedido de venda deve está marcado igual a sim, o valor de IPI será calculado caso o campo sellPriceIPI não seja informado. 

• Importante:

  • Para que seja calculado o valor do IPI, é necessário as seguintes condições:
    • Não tenha valor de IPI já calculado ou enviado no JSON pelo campo sellPriceIPI.
    • Tenha percentual de IPI Venda, isso é cadastrado na rotina 271.
    • Tenha preço de venda.
    • O parâmetro 4681 - Habilita cálculo reverso para impostos dos itens de valor agregado no pedido de venda (FIL_CALCREVERSOPEDIDOVENDA) esteja com valor "Sim".
  • Se for enviado valor de IPI pelo campo sellPriceIPI na API, esse valor será gravado na tabela normalmente.
• Observação sobre a utilização do processo de múltiplas cobranças:
  • Mesmo enviando a lista de múltiplas cobranças (listPayment) faz-se necessário o envio dos atributos chargingId e paymentPlanId no cabeçalho do pedido. Essas informações serão gravadas na tabela PCPEDC, mas no momento de faturar o pedido serão desconsideradas, pois será considerado o que está gravado na tabela PCFORMAPGTOPEDIDO.
• Será inserido a data atual no campo PCPEDC.DTCALCFRETE sempre que o valor de frete PCPEDC.VLFRETE referente ao campo do JSON "valueFreight" for maior que zero.

 Integração

method: 'POST',
url: '/api/wholesale/v1/orders/'

{
    "createData": "2020-03-23T13:24:36.955102+13:24",
    "orderIdHube": "string",
    "orderIdMktplace": "string",
    "orderStatus": "string",
    "chargingId": "string",
    "carrierId": 0,
	"seller": 0,
    "paymentPlanId": 0,
	"observation": 0,
    "saleType": 0,
	"freightDispatch": "string",
    "branchId": "string",
	"TotalPrice": 0,
    "saleOrigin": "W",
    "uniqueSequentialNumber": "string",
    "dateUniqueSequentialNumber": "string",
    "intermediaryCompanyName": "string",
    "idIntermediaryEmployer": "string",
    "valueFreight": 0,
	"CustomerVendorInternalId": "string",
	"position": 0,
    "otherExpenses": 0
	"deliveryAddressId":0,
    "shippingTrackingCodeSale": "AA1234567892",    

    "customer": {
        "id": 0
    },
	"permissions": {
        "acceptOrderWithoutTax": true,
	 	"acceptSearchAutomaticFreightType": false
    },
	/** Somente enviado para a utilização do cenário de múltiplas cobranças **/
	"listPayment": [
        {
            "chargingId" : "string",
            "paymentPlanId" : 0,
            "expirationDate" : "0000-00-00T00:00:00",
            "value" : 0.0,
            "nsu" : 0
        }
    ],
	"listOfOrderItem": [
       

method: 'POST',
url: '/api/wholesale/v1/orders/'

{
    "createData": "2020-03-23T13:24:36.955102+13:24",
    "orderIdHube": "string",
    "orderIdMktplace": "string",
    "orderStatus": "string",
    "chargingId": "string",
    "carrierId": 0,
    "paymentPlanId": 0,
    "saleType": 0,
	"freightDispatch": "string",
    "branchId": "string",
	"TotalPrice": 0,
    "saleOrigin": "W",
    "uniqueSequentialNumber": "string",
    "dateUniqueSequentialNumber": "string",
    "intermediaryCompanyName": "string",
    "idIntermediaryEmployer": "string",
    "valueFreight": 0,
	"CustomerVendorInternalId": "string",
	"position": 0,
    "otherExpenses": 0
    "customer": {
            "idproductSKUERPReferenceKey": 0"string",
    },
	"permissions": {
        "acceptOrderWithoutTaxsellPrice": true0,
	 		"acceptSearchAutomaticFreightTypediscountValue": false0,
    },
	/** Somente enviado para a utilização do cenário de múltiplas cobranças **/
	"listPayment"quantity": [
0.0,
             {"realCost": 0.0,
            "chargingIdwarehouseBranchId" : "string",
            "paymentPlanIdgift" : 0true,
            "expirationDategiftPrice" : "0000-00-00T00:00:00"0,
            "valuetaxFigureId" : 0.0,                   
            "nsudeliveryType" : 0"RI"
        }
     ],
	"listOfOrderItemdeductionsCmv": [
 {
                 {"discountsCofins": 0,
                "productSKUERPReferenceKeydiscountsIcms":  "string"0,
                "sellPricediscountsPis": 0,
			"discountValue":0,

            
  "quantity": 0.0,
          }   "realCost": 0.0,
        }
   ]
}

{
    "warehouseBranchIdbranchId": "string",
    "carrierId": 0,
       "giftchargingId": true"string",
    "createData": "2021-08-06T15:40:00.000000+15:40",
       "giftPricecustomer": 0,{
            "taxFigureIdactivityId": 0,
        }
      "addressInfo": "",
        "deductionsCmvbillingAddress": {
       "",
         "discountsCofinsbillingZipCode": 0"",
        "businessDistrict": "",
        "discountsIcmscityId":  0,
        "commercialAddress": "",
        "discountsPiscommercialZipCode": 0"",
            
  "corporate": false,
   }    
   ]
}

{
    "branchId"corporatePhone": "string",
        "carrierIdcountryId": 0,
        "chargingIdemail": "string",
        "createDatafinalCostumer": "2021-08-06T15:40:00.000000+15:40"false,
        "customerid": {0,
        "activityIdpaymentPlanId": 0,
        "addressInfosellerId": ""0,
        "billingAddresssquareId": ""0,
        "billingZipCodestateInscription": "",
        "businessDistricttradeName": "",
    },
    "lastChange": "cityId": 0,
        "commercialAddress": "",2021-08-06T15:40:00",
	/** Somente retornado em caso de utilização do cenário de múltiplas cobranças **/
	"listPayment": [
        "commercialZipCode": "",{
        "corporate": false,
        "corporatePhonechargingId" : "string",
            "countryIdpaymentPlanId" : 0,
            "emailexpirationDate" : "0000-00-00T00:00:00",
        "finalCostumer": false,
        "idvalue" : 0.0,
            "paymentPlanIdnsu" : 0,
        "sellerId": 0,}
    ],      
	"squareIdlistOfOrderItem": 0,[
        {
   "stateInscription": "",
        "tradeNameaccountingCost": ""
0.0,
        },
    "lastChangebasePriceRCA": "2021-08-06T15:40:00",
	/** Somente retornado em caso de utilização do cenário de múltiplas cobranças **/
	"listPayment": [
        {0.0,
            "comissionPercent": 0,
			"discountPercentage": 0,             
			"fecp": 0,
            "chargingIdfinancialCost" : "string"0.0,
            "paymentPlanIdgift" : 0false,
            "expirationDategiftPrice" : "0000-00-00T00:00:00": 0,
            "packingId": 0,
            "valueposition" : 0.0,
            "nsuproductId" : 0,
        }
     ],     
	"listOfOrderItem": [
"productSKUERPReferenceKey": "00000-00",
            {"quantity": 0.0,
            "accountingCostrealCost": 0.0,
            "basePriceRCAreplacementCost": 0.0,
            "comissionPercentresourceValueCMV": 0,
			"discountPercentage": 0,             
			"fecp            "resourceValueCustumerCMV": 0,
            "financialCostsellPrice": 0.0,
            "giftsellPriceBaseST": false0,
            "giftPricesellPriceIPI": 0,
            "packingIdsellPriceST": 0,
            "positionstGNRE": 0,
            "productIdtablePrice": 0.0,
            "productSKUERPReferenceKeytablePriceIPI": "00000-00"0,
            "quantitytablePriceST": 0.0,
            "realCosttaxFigureId": 0.0,
            "replacementCosttruncItem": 0.0false,
            "resourceValueCMVwantageQuantity": 0,
            "resourceValueCustumerCMVwarehouseBranchId": 0"string",
            "sellPricedeliveryType": 0.0"RI",
            "sellPriceBaseSTdeliveryStatus": 0, "R"         
        }
    ],
	"sellPriceIPIpermissions": 0,
     {
        "sellPriceSTacceptOrderWithoutTax": 0true,
	 	"acceptSearchAutomaticFreightType": false
    },
      "stGNREorderId": 0"string",
    "orderIdHube":    "string",
	"orderIdMktplace: "string",
    "tablePriceorderStatus": 0.0"string",
            "tablePriceIPIotherExpenses": 0,
            "tablePriceSTpaymentPlanId": 0,
        "saleOrigin": "W",
    "taxFigureIdsaleType": 0,
    "saleTypePayment": "string",
       "truncItem"totalValue": "0.0",
	"observation": false"string",
    "shippingTrackingCodeSale":          "wantageQuantity": 0,
            "warehouseBranchId": "string"
"string" }

method: 'GET',
url: '/api/wholesale/v1/orders/'      -> Passar }
    ],
	"permissions": {
        "acceptOrderWithoutTax": true,
	 	"acceptSearchAutomaticFreightType": false
    },
    "orderId": "string",
    "orderIdHube": "string",
	"orderIdMktplace: "string",
    "orderStatus": "string",
    "otherExpenses": 0,
    "paymentPlanId": 0,
    "saleOrigin": "W",
    "saleType": 0,
    "saleTypePayment": "string",
    "totalValue": "0.0"
}

no Parms o campo orderId, para obter dados do pedido.

OU 

url: '/api/wholesale/v1/orders/list'  -> Passar na requisição os dados do Parms abaixo.

branchId          : 0					- Código da Filial **requerido
daysOfSearch      : 0					- Dias de Pesquisa (Se não informado, o padrão será 15 dias)
orderId		      : 0					- Número Pedido
lastChange        : 2021-03-02T16:43:00	- Última alteração
viewDocument  	  : true/ false			- Dados da nota fiscal 
saleOrigin   	  : T					- Origem Venda (Todas existentes no Winthor) Padrão W
order		 	  : lastChange			- Ordenação de busca 
orderStatus  	  : C					- Status do Pedido
page		 	  : 1

method: 'GET',
url: '/api/wholesale/v1/orders/'      -> Passar no Parms o campo orderId, para obter dados do pedido.

OU 

url: '/api/wholesale/v1/orders/list'  -> Passar na requisição os dados do Parms abaixo.

branchId          : 0					- Código da Filial **requerido
daysOfSearch      : 0					- Dias de Pesquisa
orderId		      : 0					- Número PedidoPágina
lastChangepageSize     	   : 2021-03-02T16:43:0010					- Tamanho Últimada alteraçãopágina
viewDocument  hasOrderIdHube	  : true/ false			- DadosPedidos daque notacom fiscalid 
saleOriginde Hube - 	Disponível a : T					- Origem Venda (Todas existentes no 
order		 	  : lastChangepartir da versão 1.0.84.229(Winthor-pedido-venda) 
hasOrderIdMktplace: true/ false			- OrdenaçãoPedidos deque buscacom 
orderStatusid de 	Marketplace  : C					- StatusDisponível do Pedido
page		 	  : 1					- Número Página
pageSize     	  : 10					- Tamanho da página
hasOrderIdHube	  : true/ false			- Pedidos que com id de Hube a partir da versão 1.0.84.229(Winthor-pedido-venda)   
integrationOrigin :             		- Filtra pela coluna ORIGEMINTEGRACAO - Disponível a partir da versão 1.3.0.84.22940(Winthor-pedido-venda) 
hasOrderIdMktplace: true/ false			- Pedidos que com id de Marketplace  - Disponível a partir da versão 1.0.84.229(Winthor-pedido-venda)      
 

{
    "branchId": "string",
    "carrierId": 0,
    "chargingId": "string",
    "createData": "2021-08-06T15:40:00.000000+15:40",
    "customer": {
        "activityId": 0,
        "addressInfo": "

{
    "branchId": "string",
        "carrierIdbillingAddress": 0"",
        "chargingIdbillingZipCode": "string",
        "createDatabusinessDistrict": "2021-08-06T15:40:00.000000+15:40",
        "customercityId": {0,
        "activityIdcommercialAddress": 0"",
        "addressInfocommercialZipCode": "",
        "billingAddresscorporate": false,
        "corporatePhone": "",
        "billingZipCodecountryId": ""0,
        "businessDistrictemail": "",
        "cityIdfinalCostumer": 0false,
        "commercialAddressid": ""0,
        "commercialZipCodepaymentPlanId": ""0,
        "corporatesellerId": false0,
        "corporatePhonesquareId": ""0,
        "countryIdstateInscription": 0"",
        "emailtradeName": "",
    },
    "finalCostumerdocument": false,{
        "idcreateData": 0"1900-01-01T00:00:00",
        "paymentPlanIddocumentNumber": 0,
        "sellerIdkeyDocument": 0"",
        "squareIdlastChange": 0,"1900-01-01T00:00:00"
    },
    "stateInscriptionlastChange": "2021-08-06T15:40:00",
	/** Somente retornado em caso de utilização do cenário de múltiplas cobranças **/
	"tradeNamelistPayment": ""[
    },
    "document": {
            "createDatachargingId" : "1900-01-01T00:00:00string",
            "documentNumberpaymentPlanId" : 0,
        "keyDocument": "",
        "lastChangeexpirationDate" : "19000000-0100-01T0000T00:00:00",
            "value" : }0.0,
    "lastChange": "2021-08-06T15:40:00",
	/** Somente retornado em caso de utilização do cenário de múltiplas cobranças **/
	"listPayment        "nsu" : 0
        }
    ],
     "listOfOrderItem": [
        {
            "chargingIdaccountingCost" : "string"0.0,
            "paymentPlanIdbasePriceRCA" : 0.0,
            "expirationDatecomissionPercent" : "0000-00-00T00:00:00",
            "value" 0,
			"discountPercentage": 0.0,
            "nsufecp" : 0,
        }
    ],
     "listOfOrderItemfinancialCost": [
        {0.0,
            "accountingCostgift": 0.0false,
            "basePriceRCAgiftPrice": 0.0,
            "comissionPercentpackingId": 0,
			"discountPercentage": 0,
            "fecpposition": 0,
            "financialCostproductId": 0.0,
            "giftproductSKUERPReferenceKey": false"00000-00",
            "giftPricequantity": 0.0,
            "packingIdrealCost": 0.0,
            "positionreplacementCost": 0.0,
            "productIdresourceValueCMV": 0,
            "productSKUERPReferenceKeyresourceValueCustumerCMV": "00000-00"0,
            "quantitysellPrice": 0.0,
            "realCostsellPriceBaseST": 0.0,
            "replacementCostsellPriceIPI": 0.0,
            "sellPriceST": "resourceValueCMV0,
			"sellPriceIcmsPart": 0,
            "resourceValueCustumerCMVstGNRE": 0,
            "sellPricetablePrice": 0.0,
            "sellPriceBaseSTtablePriceIPI": 0,
            "sellPriceIPItablePriceST": 0,
            "sellPriceSTtaxFigureId": 0,
			"sellPriceIcmsPart": 0,
            "stGNREtruncItem": 0false,
            "tablePricewantageQuantity": 0.0,
            "tablePriceIPIwarehouseBranchId": 0,"string"
            "tablePriceST": 0,}
            "taxFigureIddeductionsCmv": 0,{
                "truncItemdiscountsCofins": false0,
                "wantageQuantitydiscountsIcms":  0,
                "warehouseBranchIddiscountsPis": "string"
0
            }     
   ],
	"permissions": {
        "deductionsCmvacceptOrderWithoutTax": {true,
	 	"acceptSearchAutomaticFreightType": false
    },
    "orderId": "string",
    "orderIdHube": "discountsCofinsstring",
	"orderIdMktplace: 0"string",
    "orderStatus": "string",
       "otherExpenses": 0,
    "discountsIcmspaymentPlanId":  0,
    "saleOrigin": "W",
    "saleType": 0,
    "saleTypePayment": "string",
    "discountsPistotalValue": "0.0",
	"observation": "string",
    "shippingTrackingCodeSale": "string"      }     
   ],
	"permissions": {
} 

method: 'DELETE',
url: '/api/wholesale/v1/orders/'      -> Passar "acceptOrderWithoutTax": true,
	 	"acceptSearchAutomaticFreightType": false
    },
    "orderId": "string",
    "orderIdHube": "string",
	"orderIdMktplace: "string",
    "orderStatus": "string",
    "otherExpenses": 0,
    "paymentPlanId": 0,
    "saleOrigin": "W",
    "saleType": 0,
    "saleTypePayment": "string",
    "totalValue": "0.0"
} no Parms o campo id e Motivo para cancelar o pedido

Id		            : 0					- ID/Número Pedido (Obrigatório)
sendMessageRca      : true/ false		- Enviar mensagem pro RCA? 
reasonCancellation  : C					- Motivo Cancelamento (Obrigatório)   

Observação: Os pedidos com itens do tipomerc = CB (CESTA BASICA) terão os itens da cesta gravados na tabela PCPEDICESTA no campo CODPRODMP.