Páginas filhas
  • APIs Integrações - Produtos

Versões comparadas

Chave

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

...

Como Realizar Gerenciamento de Produtos pela rotina 2009? (Opcional)

Caso necessite que o preduto retorne os campos "webDepartmentId", "webSectionId", "webCategoryId" e "webSubcategoryId", o produto cadastrado deve estar com os camposda aba Web preenchidos para que sejam apresentados do retorno da API: campos "webDepartmentId", "webSectionId", "webCategoryId" e "webSubcategoryId".

Aviso
titleImportante
  • O produto precisa estar vinculado a uma categoria.

  • A categoria precisa estar previamente integrada ao e-commerce, caso contrário a integração não ocorrerá.

Caso tenha dúvidas, acessar o link abaixo:

Como realizar o cadastro de categoria no WinThor?

  • A marca precisa estar previamente integrada aoe-commerce, caso contrário a integração não ocorrerá.

Caso tenha dúvidas, acessar o link abaixo:

Como realizar o cadastro de marcas no WinThor?

...

Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Vídeo de Demonstração
idspasso1,passo2,passo3,passo4

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

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

PRODUCTPCPRODUT
APIReferência Winthor
idpcprodut.codprod
namepcprodut.descricao
categoryId

pcprodut.codcategoria

webDepartmentIdpcprodut.coddeptoweb
webSectionIdpcprodut.codsecaoweb
webCategoryIdpcprodut.codcategoriaweb
webSubcategoryIdpcprodut.codsubcategoriaweb
brandIdpcprodut.codmarca
linkIdpcprodut.linkid
isVisiblepcprodut.enviaecommerce
descriptionpcprodut.nomeecommerce
descriptionShortpcprodut.descricao1
releaseDatepcprodut.dtcadastro
keywordspcpalavraschave.descricao
titlepcprodut.descricao
isActivepcprodut.dtexclusao
supplierIdpcprodut.codfornec
showWithoutStockpcprodut.exibesemestoqueecommerce

pcprodfilial.liststoreid
adWordsRemarketingCodepcprodut.codadwords
lomadeeCampaignCodepcprodut.codcamplomadee
lastChangepcprodut.dtultalter
technicalInformationpcprodut.informacoestecnicas
technicalDatapcprodut.dadostecnicos
idoriginalpcprodut.numoriginal
descriptionpcprodut.nomeecommerce
merchandiseTypepcprodut.tipomerc
sectionIdpcprodut.codsec
departmentIdpcprodut.codepto
rawMaterialBasicBasketProductIdpcformprod.codprodacab
rawMaterialBasicBasketQuantitypcformprod.qtprodmp
brandIdpcformprod.codfilial
realHeight3pcprodut.Alturam3
width3pcprodut.larguram3
length3pcprodut.comprimentom3
realWeightKg:pcprodut.pesobruto
netWeightKg:pcprodut.pesoliq
subcategoryId:pcprodut.codsubcategoria
subcategoryDescriptionpcsubcategoria.subcategoria
productionLineIdpcprodut.codlinhaprod
productionLineDescriptionpclinhaprod.descricao
volume

pcprodut.volume

factoryIdpcprodut.codfab
description1pcprodut.descricao1
description2pcprodut.descricao2
description3pcprodut.descricao3
description4pcprodut.descricao4
description5pcprodut.descricao5
description6pcprodut.descricao6
resalepcprodut.revenda
observation2pcprodut.obs2
exceptionMercosulIdpcprodut.codncmex
colorIdpcprodut.codcor
gridIdpcprodut.codgrade
gridSizepcprodut.colunagrade
barCodepcprodut.codauxiliar
unitypcprodut.unidade
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
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
languagejs
titleParams
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
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
   "first": false,
   "items": [
	{
            "name": "string",
            "active": true,
            "visible": true,
            "brandId": 0,
            "categoryId": 0,
            "description": "",
		 	"description1": "string",
            "description2": "string",
            "description3": "string",
            "description4": "string",
            "description5": "string",
            "description6": "string",
            "description7": "string",
            "descriptionShort": "string",
            "ecommerceTitle": "string",
            "id": 0,
            "isActive": true,
            "isVisible": true,
            "lastChange": "2021-07-23T15:25:19",
            "length3": 0,
            "NCM": "string",
			"exceptionMercosulId": "string",    
			"webDepartmentId": 0,
    		"webSectionId": 0,
    		"webCategoryId": 0,
   	 		"webSubcategoryId  ": 0,
            "netWeightKg": 0,
            "observation": "string",
			"observation2": "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,
		 	"resale": "string",
            "colorId": 0,
            "gridId": 0,
            "gridSize": 0,
            "barCode": 0,
            "unity": "string"
        }
 ],
 "hasNext": true
}
Totvs custom tabs box items
defaultno
referenciapasso4

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

...