TOTVS Distribuição e Varejo - linha Winthor

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

Versões comparadas

Versão antiga 10

changes.mady.by.user Helen Crystina Godinho Amorim

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Rodrigo da Silva Ribeiro

Gravado em

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 deda 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:

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
titleImportante

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
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04
idspasso1,passo2,passo3

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

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

MARCAS (BRANDS)PCMARCADESCRIÇÃOREFERENCIA PRINT
APIReferência WinthorDetalhe
idpcmarca.codmarcaCódigo da marca1
namepcmarca.marcaDescrição da marca2
titlepcmarca.tituloTítulo da marca4
descriptionpcmarca.descricaoecommerce

keywordspchave.descricao

isActivepcmarca.ativoSituação 3
adwordsRemarketingCodepcmarca.codadwords
5
lomadeeCampaignCodepcmarca.codcamplomadee
6
lastChangepcmarca.dtultalter

dtcreatepcmarca.dtcadastro


Image Added

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/productBrands/'
Bloco de código
languagejs
titleParams
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
Totvs custom tabs box items
defaultno
referenciapasso3

{
    "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
}

...