Objetivo
Este documento tem como objetivo explicar o funcionamento da integração da Departamento.
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 Departamentos no WinThor, acesse o link abaixo:
Como realizar o cadastro de departamento no WinThor?
O departamento cadastrado 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 todos departamentos que serão utilizados no E-Commerce.
Os dados integrados são:
DEPARTMENTS | PCDEPTO |
---|---|
API | Referência Winthor |
id | pcdepto.codepto |
name | pcdepto.descricao |
fatherCategoryId | pcdepto.coddeptoprinc |
title | pcdepto.titulo |
description | pcdepto.descricaoecommerce |
keywords | pcpalavraschave.descricao |
adWordsRemarketingCode | pcdepto.codadwords |
lomadeeCampaignCode | pcdepto.codcamplomadee |
lastChange | pcdepto.dtultalter |
updateStockGeneral | pcdepto.atualizainvgeral |
typeMerchandise | pcdepto.tipomerc |
dtcreate | pcdepto.dtcadastro |
active | pcdepto.enviaecommerce |
Exemplo do envio da requisição:
method: 'GET', url: '/api/purchases/v1/productDepartments'
lastChange : 1900-01-01T00:00:00 - data da última alteração page : 1 - número de página pageSize : 10 - quantidade por página
Exemplo JSON da resposta:
{ "first": false, "items": [ { "id": 0, "name": "string", "fatherCategoryId": 0, "title": "string", "description": "string", "keywords": "", "adWordsRemarketingCode": null, "lomadeeCampaignCode": null, "lastChange": "2020-10-27T08:53:07", "updateStockGeneral": true, "typeMerchandise": "string", "dtcreate": "2020-07-16T00:00:00", "active": true } ], "hasNext": true }
Demonstração utilizando o Postman para realizar as requisições na API.
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.