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 |
---|
|
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 |
---|
tabs | Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Vídeo de Demonstração |
---|
ids | passo1,passo2,passo3,passo4 |
---|
|
A integração consiste em enviar todos departamentos que serão utilizados no E-Commerce. Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| 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 |
|
|
...
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Exemplo do envio da requisição: Bloco de código |
---|
| method: 'GET',
url: '/api/purchases/v1/productDepartments' |
Bloco de código |
---|
| 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 |
---|
default | no |
---|
referencia | passo3 |
---|
| Exemplo JSON da resposta: Bloco de código |
---|
language | js |
---|
title | Body 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 |
---|
default | no |
---|
referencia | passo4 |
---|
| 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 Tree |
---|
root | Integração Pedidos de Vendas