TOTVS Distribuição e Varejo - linha Winthor

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

Versões comparadas

Versão antiga 16

changes.mady.by.user Usuário desconhecido (murillo.jorge)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Bruna de Brito Alves

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   ProdutoProdutos.

Pré-Requisitos e Restrições

  • Necessário a instalação do  serviçodo serviço winthor-compras-produto. O 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.

Image Added


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.

Image Added

...

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

Image Added

...

  • 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 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 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.

Image Added


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
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.   

...