Histórico da Página

...

Necessário a instalação do serviço winthor-compras-produto.
O produto deve estar com o campo Enviar para E-commerce igual Sim (Rotina 203).
A categoria precisa estar previamente integrada ao E-commerce, caso contrário a integração não ocorrerá.
A Marca precisa estar previamente integrada ao E-commerce, caso contrário a integração não ocorrerá.
O produto precisa estar vinculado a uma Categoria.

Aviso

title	Importante

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

tabs	Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Vídeo de Demonstração
ids	passo1,passo2,passo3,passo4

A integração consiste em enviar todos produtos que serão utilizados no E-Commerce.

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

PRODUCT	PCPRODUT
API	Referência Winthor
id	pcprodut.codprod
name	pcprodut.descricao
categoryId	pcprodut.codcategoria
webDepartmentId	pcprodut.coddeptoweb
webSectionId	pcprodut.codsecaoweb
webCategoryId	pcprodut.codcategoriaweb
webSubcategoryId	pcprodut.codsubcategoriaweb
brandId	pcprodut.codmarca
linkId	pcprodut.linkid
isVisible	pcprodut.enviaecommerce
description	pcprodut.nomeecommerce
descriptionShort	pcprodut.descricao1
releaseDate	pcprodut.dtcadastro
keywords	pcpalavraschave.descricao
title	pcprodut.descricao
isActive	pcprodut.dtexclusao
supplierId	pcprodut.codfornec
showWithoutStock	pcprodut.exibesemestoqueecommerce
	pcprodfilial.liststoreid
adWordsRemarketingCode	pcprodut.codadwords
lomadeeCampaignCode	pcprodut.codcamplomadee
lastChange	pcprodut.dtultalter
technicalInformation	pcprodut.informacoestecnicas
technicalData	pcprodut.dadostecnicos
idoriginal	pcprodut.numoriginal
description	pcprodut.nomeecommerce
merchandiseType	pcprodut.tipomerc
sectionId	pcprodut.codsec
departmentId	pcprodut.codepto
rawMaterialBasicBasketProductId	pcformprod.codprodacab
rawMaterialBasicBasketQuantity	pcformprod.qtprodmp
brandId	pcformprod.codfilial
realHeight3	pcprodut.Alturam3
width3	pcprodut.larguram3
length3	pcprodut.comprimentom3
realWeightKg:	pcprodut.pesobruto
netWeightKg:	pcprodut.pesoliq
subcategoryId:	pcprodut.codsubcategoria
subcategoryDescription	pcsubcategoria.subcategoria
productionLineId	pcprodut.codlinhaprod
productionLineDescription	pclinhaprod.descricao
volume	pcprodut.volume
factoryId	pcprodut.codfab

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

method: 'GET',
url: '/api/purchases/v1/products/'     -> Será apresentada a lista de produtos 

OU

url: '/api/purchases/v1/products/{Código do produto}'  -> Apresenta o produto indicado.

Bloco de código

language	js
title	Params

order  		: 0						- Informar ordenação 
branchId	: 0						- Informar a filial 
lastChange  : 1900-01-01T00:00:00	- Informar data da última alteração
page		: 1						- Informar número de página
pageSize	: 10					- Informar quantidade por página
callOrigin	: W						- Origem padrão para e-commerce

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": [
	{
            "name": "string",
            "active": true,
            "visible": true,
            "brandId": 0,
            "categoryId": 0,
            "description": "",
            "description7": "string",
            "descriptionShort": "string",
            "ecommerceTitle": "string",
            "id": 0,
            "isActive": true,
            "isVisible": true,
            "lastChange": "2021-07-23T15:25:19",
            "length3": 0,
            "NCM": "string",
			"webDepartmentId": 0,
    		"webSectionId": 0,
    		"webCategoryId": 0,
   	 		"webSubcategoryId  ": 0,
            "netWeightKg": 0,
            "observation": "string",
            "principalProductId": 0,
            "productionLineDescription": "string",
            "productionLineId": 0,
            "productSKUId": "000-0",
            "realHeight3": 0,
            "realWeightKg": 0,
            "releaseDate": "2012-01-01T00:00:00",
            "sectionId": 0,
            "showWithoutStock": false,
            "subcategoryDescription": "string",
            "subcategoryId": 0,
            "supplierDescription": "string",
            "supplierId": 0,
            "technicalData": "",
            "technicalInformation": "",
            "merchandiseType": "string",
            "title": "string",
            "volume": 0,
            "width3": 0
        }
 ],
 "hasNext": true
}

Totvs custom tabs box items

default	no
referencia	passo4

Demonstração utilizando o Postman para realizar as requisições na API.

...

Páginas filhas

Versões comparadas

Versão antiga 18

Nova versão 19

Chave

Integração