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

Versões comparadas

Chave

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

...

Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04Ví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
categoryIdpcprodut.codcategoria
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
volumepcprodut.volume
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",
            "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.   

Image Added

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

...