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 |
|---|
| tabs | Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04 |
|---|
| ids | passo1,passo2,passo3 |
|---|
|
A integração consiste em enviar todas as categorias que serão utilizados no E-Commerce. | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Os dados integrados são: colocar tabela |
| 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/productCategories/productDepartments' |
| Bloco de código |
|---|
| order : lastChange - ordenação
lastChange : 1900-01-01T00:00:00 - data da última alteração
page : 1 - número de página
pageSize : 10 - quantidade por página
sectionId : 1 - código da seção |
|
| 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": [
{
"description": "string",
"dtcreate": "2020-11-16T14:53:16",
" {
"id": 0,
"keywords": "",
"lastChange": "1900-01-01T00:00:00",
" "name": "string",
"section": {
"id": 0,
"description": "string",
"title": "string",
"keywords": "",
"adWordsRemarketingCode": "",
"lastChange": "2020-10-27T09:22:29",
"department": {
"id": 0,
"name": "string",
" "fatherCategoryId": 0,
"title": "string",
"description": "string",
"keywords": "",
"adWordsRemarketingCode": null,
"lomadeeCampaignCode": null,
"lastChange": "2020-10-27T08:53:07",
"updateStockGeneral": boolean,
true,
"typeMerchandise": "string",
"dtcreate": "2020-07-16T00:00:00",
"active": boolean
},
"dtcreate": "2020-07-16T00:00:00"
},
"sectionId": 0,
"subcategories": [],
"title": ""
}
],
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.
...
