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:
method: 'GET', url: '/api/purchases/v1/productSections'
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:
{ "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.