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

Versões comparadas

Chave

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

...

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 contexto deverá ser criado uma nova embalagem e nova associação.


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.   

...