Este documento tem como objetivo explicar o funcionamento para atualizar a flag enviaecommerce do cadastro de produtos. Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Os dados integrados são: API | Referência Winthor | Descrição | Tipo | Obrigatório | Default |
---|
branch | PCEMBALAGEM.CODFILIAL | Filiais | List<String> | SIM |
| supplierId | PCPRODUT.CODFORNEC | Códigos do fornecedor | List<Long> | NÃO |
| supplierCNPJ | PCFORNEC.CGC | CNPJs do fornecedor | List<String> | NÃO |
| brandId | PCPRODUT.CODMARCA | Códigos das Marcas | List<Long> | NÃO |
| departmentId | PCPRODUT.CODEPTO | Códigos dos Departamentos | List<Long> | NÃO |
| sectionId | PCPRODUT.CODSEC | Códigos das Seçãos | List<Long> | NÃO |
| categoryId | PCPRODUT.CODCATEGORIA | Códigos das Categorias | List<Long> | NÃO |
| subcategoryId | PCPRODUT.CODSUBCATEGORIA | Códigos das Subcategorias | List<Long> | NÃO |
| webDepartmentId | PCPRODUT.CODDEPTOWEB | Códigos dos Departamento WEB | List<Long> | NÃO |
| webSectionId | PCPRODUT.CODSECAOWEB | Códigos das Seções WEB | List<Long> | NÃO |
| webCategoryId | PCPRODUT.CODCATEGORIAWEB | Códigos das Categorias WEB | List<Long> | NÃO |
| webSubcategoryId | PCPRODUT.CODSUBCATEGORIAWEB | Códigos das Subcatergorias WEB | List<Long> | NÃO |
| typeOfMerchandise | PCPRODUT.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 |
| resale | PCPRODUT.REVENDA | Revenda | Boolean | NÃO |
| minYearOfSales |
| Mínimo de anos para filtrar as vendas, para verificar os produtos mais vendidos | Integer | NÃO | 1 | maxTopProductsSold |
| Limita a quantidade dos produtos mais vendidos | Integer | NÃO |
| percentageTopSellingProducts |
| Verifica a quantidade de produtos mais vendidos pelo percentual do total de produtos cadastrado na base do cliente | Double | NÃO |
| productId | PCPRODUT.CODPROD | Código do produto | Long | NÃO |
| updatedQuantity |
| Quantidade de produtos atualizados Este campo somente é usado na resposta da API | Long | NÃO |
| sendToECommerce | PCPRODUT.ENVIAECOMMERCE | Atualiza o produto para enviar para ecommerce | Boolean | NÃO | true | minStockAvailable | PKG_ESTOQUE.ESTOQUE_DISPONIVEL | Verifica o estoque mínimo do produto | Integer | NÃO |
|
Obs: campos com o tipo "List" aceita 1 ou mais valores |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Exemplo JSON do envio da requisição e dados do retorno: Bloco de código |
---|
language | js |
---|
title | URI - Cadastrar Cliente |
---|
| method: 'PATCH',
url: '/api/purchases/v1/products/e-commerce' |
Bloco de código |
---|
| {
"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,
"sendToECommerce": true,
"minStockAvailable": 50 /*Produtos com estoque maior ou igual a 50*/
} |
Exemplo JSON da resposta: Bloco de código |
---|
language | js |
---|
title | Body 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*/
} |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Exemplo JSON do envio da requisição e dados do retorno: Bloco de código |
---|
language | js |
---|
title | URI - Cadastrar Cliente |
---|
| method: 'PATCH',
url: '/api/purchases/v1/products/e-commerce/totals' |
Bloco de código |
---|
| {
"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,
"sendToECommerce": true,
"minStockAvailable": 50 /*Produtos com estoque maior ou igual a 50*/
} |
Exemplo JSON da resposta: Bloco de código |
---|
language | js |
---|
title | Body 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*/
} |
|
|