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

Versões comparadas

Chave

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

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.

Image Added

Aviso
titleImportante

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

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 departamentos que serão utilizados no E-Commerce.

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

DEPARTMENTSPCDEPTO
APIReferência Winthor
idpcdepto.codepto
namepcdepto.descricao
fatherCategoryIdpcdepto.coddeptoprinc
titlepcdepto.titulo
descriptionpcdepto.descricaoecommerce
keywordspcpalavraschave.descricao
adWordsRemarketingCodepcdepto.codadwords
lomadeeCampaignCodepcdepto.codcamplomadee
lastChangepcdepto.dtultalter
updateStockGeneralpcdepto.atualizainvgeral
typeMerchandisepcdepto.tipomerc
dtcreatepcdepto.dtcadastro
activepcdepto

...

.enviaecommerce
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/productDepartments'
Bloco de código
languagejs
titleParams
lastChange  : 1900-01-01T00:00:00	- data da última alteração
page		: 1						- número de página
pageSize	: 10					- quantidade por página
Totvs custom tabs box items
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "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
}
Totvs custom tabs box items
defaultno
referenciapasso4

Demonstração utilizando o Postman para realizar as requisições na API. 

Image Added

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 Page TreerootIntegração Pedidos de Vendas