Páginas filhas
  • APIs Integrações - Atualizar flag enviaecommerce produto - HOMOLOGAÇÃO

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros/Resposta da Requisição
idspasso1,passo2

Este documento tem como objetivo explicar o funcionamento para atualizar a flag de envio de ecommerce dos produtos.

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

APIReferência Winthor DescriçãoTipoObrigatórioDefault
supplierIdPCPRODUT.CODFORNECCódigos do fornecedor List<Long>NÃO
supplierCNPJPCFORNEC.CGCCNPJs do fornecedorList<String>NÃO
brandIdPCPRODUT.CODMARCACódigos das MarcasList<Long>NÃO
departmentIdPCPRODUT.CODEPTOCódigos dos DepartamentosList<Long>NÃO
sectionIdPCPRODUT.CODSECCódigos das Seçãos List<Long>NÃO
categoryIdPCPRODUT.CODCATEGORIACódigos das CategoriasList<Long>NÃO
subcategoryIdPCPRODUT.CODSUBCATEGORIACódigos das SubcategoriasList<Long>NÃO
webDepartmentIdPCPRODUT.CODDEPTOWEBCódigos dos Departamento WEBList<Long>NÃO
webSectionIdPCPRODUT.CODSECAOWEBCódigos das Seções WEBList<Long>NÃO
webCategoryIdPCPRODUT.CODCATEGORIAWEBCódigos das Categorias WEBList<Long>NÃO
webSubcategoryIdPCPRODUT.CODSUBCATEGORIAWEBCódigos das Subcatergorias WEBList<Long>NÃO
typeOfMerchandisePCPRODUT.TIPOMERC

Tipos de mercadoria.

Ex. de tipos:

  • PA
  • KT
  • BD
  • EM
  • L
  • ME
  • PB
  • MP
  • M
  • MA
  • PL
  • RE
  • SA
  • SP
  • SF
  • VA
List<String>NÃO
branchPCEMBALAGEM.CODFILIALFiliais List<String>SIM
resalePCPRODUT.REVENDARevendaBooleanNÃO
minYearOfSales
Mínimo de anos para filtrar as vendas, para verificar os produtos mais vendidos IntegerNÃO1
maxTopProductsSold
Limita a quantidade dos produtos mais vendidosIntegerNÃO
percentageTopSellingProducts
Verifica a quantidade de produtos mais vendidos pelo percentual do total de produtos cadastrado na base do clienteDoubleNÃO
productIdPCPRODUT.CODPRODCódigo do produtoLongNÃO
updatedQuantity

Quantidade de produtos atualizados

Este campo somente é usado na resposta da API

LongNÃO
sendToECommercePCPRODUT.ENVIAECOMMERCEAtualiza o produto para enviar para ecommerceBooleanNãotrue
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo JSON do envio da requisição e dados do retorno:

Bloco de código
languagejs
titleURI - Cadastrar Cliente
method: 'PATCH',
url: '/api/purchases/v1/products/e-commerce'
Bloco de código
languagejs
titleBody
{
    "branch": ["1"],
    "supplierId": [0],
    "supplierCNPJ": ["0000000000000"],
    "brandId": [0],
    "departmentId": [0],
    "sectionId": [0],
    "categoryId": [0],
    "subcategoryId": [0],
    "webDepartmentId": [0],
    "webSectionId": [0],
    "webCategoryId": [0],
    "webSubcategoryId": [0],
    "typeOfMerchandise": ["PA"],
    "resale": true,
    "minYearOfSales": 5/*Consulta vendas dos ultimos 5 anos*/,
    "maxTopProductsSold": 50,
    "percentageTopSellingProducts": 10,
    "productId": 1
}


Exemplo JSON da resposta:  

Bloco de código
languagejs
titleBody Response
{
    "branch": ["1"],
    "supplierId": [0],
    "supplierCNPJ": ["0000000000000"],
    "brandId": [0],
    "departmentId": [0],
    "sectionId": [0],
    "categoryId": [0],
    "subcategoryId": [0],
    "webDepartmentId": [0],
    "webSectionId": [0],
    "webCategoryId": [0],
    "webSubcategoryId": [0],
    "typeOfMerchandise": ["PA"],
    "resale": true,
    "minYearOfSales": 5,
    "maxTopProductsSold": 50,
    "percentageTopSellingProducts": 10,
    "productId": 1,
    "updatedQuantity": 250 /*250 produtos atualizados*/
} 

...