APIs Integrações - Seção

Objetivo

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

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 Seções no WinThor, acesse o link abaixo:

Como realizar o cadastro de seção no WinThor?

A seção cadastrada deve estar com o campo Enviar para E-commerce igual a Sim.

Importante

Quando não houver preenchimento do campo DATA, exemplo (data de cadastro, data de alteração), nossas APIs retornarão 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 todas as categorias que serão utilizados no E-Commerce.

Os dados integrados são:

SECTIONS \| PCSECAO
API	Referência Winthor
department	pcdepto.codepto
id	pcsecao.codsec
description	pcsecao.descricao
id	pcdepto.codepto
name	pcdepto.descricao
fatherCategoryId	pcdepto.coddeptoprinc
title	pcdepto.titulo
description	pcdepto.descricaoecommerce
keywords	pcpalavraschave.descricao
lastChange	pcdepto.dtultalter
updateStockGeneral	pcdepto.atualizainvgeral
typeMerchandise	pcdepto.tipomerc
dtcreate	pcdepto.dtcadastro
active	pcdepto.enviaecommerce
title	pcdepto.titulo
keywords	pchave.descricao
adWordsRemarketingCode	pcdepto.codadwords
lastChange	pcsecao.dtultalter
dtcreate	pcsecao.dtcadastro

Exemplo do envio da requisição:

URI

method: 'GET',
url: '/api/purchases/v1/productSections'

Params

order  		: lastChange			- ordenação
lastChange  : 1900-01-01T00:00:00	- data da última alteração
page		: 1						- número da página
pageSize	: 10					- quantidade por página

Exemplo JSON da resposta:

Body Response

{
    "first": false,
    "items": [
        {
            "_expandables": [
                "department"
            ],
            "id": 0,
            "description": "string",
            "department": {
                "id": 9,
                "name": "string",
                "fatherCategoryId": 0,
                "title": "",
                "description": "",
                "keywords": "",
                "lastChange": "1900-01-01T00:00",
                "updateStockGeneral": true,
                "typeMerchandise": "string",
                "dtcreate": "1900-01-01T00:00",
                "active": false
            },
            "title": "",
            "keywords": "",
            "adWordsRemarketingCode": "",
            "lastChange": "2020-11-16T12:29:50",
            "dtcreate": "1900-01-01T00:00:00"
        } 
 ],
 "hasNext": true
}

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, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerce.

Páginas filhas

APIs Integrações - Seção

Objetivo

Pré-Requisitos e Restrições

Integração