Exibir origem

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração de Produto.

Pré-Requisitos e Restrições

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.

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

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

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

Exemplo do envio da requisição:

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.

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

Exemplo JSON da resposta:

{
   "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
}

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

TOTVS Distribuição e Varejo - linha Winthor > APIs Integrações - Produtos > Listar-IDProduto.gif

Para que seja realizada uma nova integração atualizando um registro já integrado, o sistema verifica a data de última atualização do registro. Portanto, ao realizar alguma alteração no registro de produtos, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerce.