TOTVS Distribuição e Varejo - linha Winthor

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

Versões comparadas

Versão antiga 25

changes.mady.by.user Rafael Schettini Dantas

Gravado em

comparado com

Nova versão 26

changes.mady.by.user Rafael Schettini Dantas

Gravado em

Chave

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

Objetivo

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

Pré-Requisitos e Restrições

  • Necessário a instalação do serviço winthor-compras-produto. Para realizar a instalação desse serviço, segue link com as devidas explicações:

Comece por aqui -> Parametrizações WTA

  • Para realizar o cadastro de produtos no WinThor, acesse o link abaixo:

Como realizar o cadastro de produtos no WinThor?

O produto cadastrado deve estar com o campo Enviar para E-commerce igual a Sim.

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?

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.

Recomendamos marcar como não o parâmetro 4591 - Permite editar o do código auxiliar do cadastro de embalagem da rotina 2014 (PERMTEDITCODAUX2014) na rotina 132 para não editar o CodAuxiliar do produto. 

Desta forma não incorre o risco de alterar um produto e perder a referencia no Ecommerce e não receber pedidos por exemplo.

Neste cenário deverá ser criado uma nova embalagem e nova associação de produto além de desabilitar o produto\sku antigo no Sistema de ecommerce.


Integração


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
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": "",
            "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
defaultno
referenciapasso4

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

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.