Exibir origem

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.

TOTVS Distribuição e Varejo - linha Winthor > APIs Integrações - Departamento > image2023-2-10_12-14-42.png

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.