Objetivo
Este documento tem como objetivo explicar o funcionamento da integração deda Marcas.
Pré-Requisitos e Restrições
...
Integração
- 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 Marcas no WinThor, acesse o link abaixo:
Como realizar o cadastro de marcas no WinThor?
Caso o cadastro de Marcas não possua a data de última alteração, será considerada a data do cadastro como última alteração.
| Aviso |
|---|
|
Quando não houver preenchimento do campo DATA, exemplo (data de cadastro, data de alteração), nossas APIs retornará 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, Passo 04 |
|---|
| ids | passo1,passo2,passo3 |
|---|
|
A integração consiste em enviar todas as marcas, cadastradas na rotina 564, que serão utilizados |
...
no E-Commerce. | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Os dados integrados são: |
|
...
| MARCAS (BRANDS) | PCMARCA | DESCRIÇÃO | REFERENCIA PRINT |
|---|
| API | Referência Winthor | Detalhe |
|
|---|
| id | pcmarca.codmarca | Código da marca | 1 | | name | pcmarca.marca | Descrição da marca | 2 | | title | pcmarca.titulo | Título da marca | 4 | | description | pcmarca.descricaoecommerce |
|
| | keywords | pchave.descricao |
|
| | isActive | pcmarca.ativo | Situação | 3 | | adwordsRemarketingCode | pcmarca.codadwords |
| 5 | | lomadeeCampaignCode | pcmarca.codcamplomadee |
| 6 | | lastChange | pcmarca.dtultalter |
|
| | dtcreate | pcmarca.dtcadastro |
|
|
| Totvs custom tabs box |
|---|
| tabs | Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04 |
|---|
| ids | passo1,passo2,passo3 |
|---|
|
 Image Added
|
A integração consiste em enviar todas as categorias que serão utilizados no E-Commerce. | Totvs custom tabs box items |
|---|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Os dados integrados são: colocar tabela | | default | no |
|---|
| referencia | passo2 |
|---|
| Exemplo do envio da requisição: | Bloco de código |
|---|
| method: 'GET',
url: '/api/purchases/v1/productCategoriesproductBrands/' |
| Bloco de código |
|---|
| order branchId : 1 - Informar a filial *(requerido)
companyId : lastChange1 - ordenação *(requerido)
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,
false,
"items": [
{
"description": "string",
"dtcreate": "2020-11-16T14:53:16",
"id": 0,
"keywords": "",
"lastChange": "1900-01-01T00
{
"active": false,
"avaiable": false,
"kit": false,
"brandId": 0,
"categoryId": 0,
"createDate": "2008-08-02T00:00:00",
"name
"departmentId":
"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,
"typeMerchandise": "string",
"dtcreate": "2020-07-16T00:00:00",
"active": boolean
},
"dtcreate": "2020-07-16T00:00:00"
},
"sectionId": 0,
"subcategories": [],
"title": ""
}
],
"hasNext": true
}
0,
"description2": "string",
"description3": "string",
"description4": "string",
"description6": "string",
"height": 0,
"id": 0,
"isActive": false,
"isAvaiable": false,
"isKit": false,
"lastChange": "2021-05-12T00:00:00",
"length": 0,
"listOfEAN": [
1
],
"name": "string",
"nameProduct": "string",
"price": 0.00,
"productRootId": 0,
"productSKUId": "0-00000,
"realHeight": 0,
"realLength": 0,
"realWeightKg": 0,
"realWidth": 0,
"sectionId": 0,
"merchandiseType": "string",
"unitMultiplier": 0,
"volume": 0,
"weightKg": 0,
"width": 0
}
],
"hasNext": true
}
|
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 de marcas, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerce.
...
