Exibir origem

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração da Marcas.

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:

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.

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

A integração consiste em enviar todas as marcas, cadastradas na rotina 564, que serão utilizados no E-Commerce.

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 Distribuição e Varejo - linha Winthor > APIs Integrações - Marcas > image-2024-9-12_11-30-30.png

Exemplo do envio da requisição:

method: 'GET',
url: '/api/purchases/v1/productBrands/'

branchId	: 1						- Informar a filial *(requerido)
companyId	: 1						- 					*(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

{
    "first": false,
    "items": [
        {
            "active": false,
            "avaiable": false,
            "kit": false,
            "brandId": 0,
            "categoryId": 0,
            "createDate": "2008-08-02T00:00:00",
            "departmentId": 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.