Histórico da Página

...

Quando enviar o parâmetro na utilizarTodasEmbalagensuseAllPackages="SY" (Parâmetro não obrigatório) na URL e o parâmetro da rotina 132 FIL_UTILIZAVENDAPOREMBALAGEM= Sim a API retornará todas as embalagens do produto dos produtos que estiverem com o campo "Envia" marcados das rotina 292/2014.

...

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 embalagens que serão utilizados no E-Commerce.

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

SKU	PCEMBALAGEM
Retorno API	Campos Banco Winthor
id	pcembalagem.codauxiliar
lastChange	pcembalagem.dtultalt
createDate	pcprodut.dtcadastro
brandId	pcprodut.codmarca
categoryId	pcprodut.codcategoria
webDepartmentId	pcprodut.coddeptoweb
webSectionId	pcprodut.codsecaoweb
webCategoryId	pcprodut.codcategoriaweb
webSubcategoryId	pcprodut.codsubcategoriaweb
description2	pcprodut.descricao2
description3	pcprodut.descricao3
description4	pcprodut.descricao4
description5	pcprodut.descricao5
description6	pcprodut.descricao6
description7	pcprodut.descricao7
departmentId	pcprodut.codepto
isActive	pcembalagem.enviaecommerce
isAvaiable	pcembalagem.excluido
isKit
listOfEAN	pcembalagem.codauxiliar
name	pcembalagem.embalagem
nameproduct	pcprodut.descricao
price	pcembalagem.pvenda
productRootId	pcembalagem.codprod
productSKUId	pcembalagem.codauxiliar + pcembalagem.codprod
productOriginalSKUId	pcembalagem.codauxiliaranterior + pcembalagem.codprod Obs. Caso o codauxiliaranterior não esteja preenchido, será retornado o codauxiliar; Obs 2. O codauxiliaranterior é o campo destinado a armazenar o valor original do código auxiliar da embalagem, em caso de alteração do mesmo.
realWidth	pcembalagem.largura
realWeightKg	pcembalagem.pesobruto
realLength	pcembalagem.comprimento
realHeight	pcembalagem.altura
sectionId
merchandiseType	pcprodut.tipomerc
unitMultiplier	pcembalagem.qtunit
width	pcprodut.largura
weightKg	pcprodut.pesobruto
length	pcprodut.comprimento
height	pcprodut.altura
volume	pcprodut.volume
rawMaterialBasicBasketProductId	pcformprod.codprodacab
rawMaterialBasicBasketQuantity	pcformprod.qtprodmp
branchId	pcformprod.codfilial

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Requisição para listar SKUs

Bloco de código

language	js

method:  'GET',
url:  '/api/purchases/v1/skus/'   -> retorno da lista, inserindo os parâmetros conforme abaixo.

		OU 

url: '/api/purchases/v1/skus/id/{código auxiliar}/branchId/{código da filial}'  -> retorno da embalagem informada na própria requisição.
		
       OU

url: '/api/purchases/v1/skus/id/{código auxiliar}/branchId/{código da filial}/utilizarTodasEmbalagens/{utilizarTodasEmbalagens}'  -> retorno da embalagem informada na própria requisição. de SKUs

Parâmetros:

Bloco de código

language	js
title	Params

companyId	   : 1 					    - campo requerido
lastChange     : 1900-01-01T00:00:00	- Informar data da última alteração (opcional)
page		   : 1						- Informar número de página (opcional)
pageSize	   : 10					    - Informar quantidade por página (opcional)
branchId	   : 1						- Informar o código da filial
useAllPackages : N						- retorna embalagens do produto cadastradas e ativas (Y= Sim N= Não) (opcional)
callOrigin	   : W 					    - retorna embalagens de acordo com o campo enviaEcommerce (W equivale a "enviaEcommerce" = S, W equivale a "enviaEcommerce" = N)(opcional)
productId      : 1						- Informar o código do produto (opcional)

Quando o parâmetro 2291 FIL_UTILIZAVENDAPOREMBALAGEM da rotina 132 estiver como Sim e passar na URL o parâmetro utilizarTodasEmbalagensuseAllPackages=S a Y a API irá retornar todas as embalagens do produto cadastradas na rotinas de cadastro de embalagens 292 e 2014

Obs: o parâmetro useAllPackages não é obrigatório.

-------------------------------------------------------------------------------------------------------------------------------------------------------------------

Requisição para buscar SKU por ID

Bloco de código

language	js
title	Params

url: '/api/purchases/v1/skus/id/{código auxiliar}/branchId/{código da filial}'  -> retorno da embalagem de acordo com o código auxiliar e filial.

Parâmetros:

Bloco de código

language	js
title	Params

callOrigin	: W ou A companyId	: 1 					- campo requerido
lastChange  : 1900-01-01T00:00:00	- Informar data da última alteração
page		: 1						 - Informarretorna númeroembalagens de página
pageSize	: 10					- Informar quantidade por página
branchId	: 1						- Informar o código da filial acordo com o campo enviaEcommerce (W equivale a "enviaEcommerce" = S, W equivale a "enviaEcommerce" = N)(opcional)

Totvs custom tabs box items

default	no
referencia	passo3

Exemplo JSON da resposta:

Bloco de código

language	js
title	Body Response

{
    "active": false,
    "avaiable": false,
    "kit": false,
    "brandId": 0,
    "categoryId": 0,
    "webDepartmentId": 0,
    "webSectionId": 0,
    "webCategoryId": 0,
    "webSubcategoryId  ": 0,
    "createDate": "2012-01-01T00:00:00",
    "departmentId": 0,
    "description2": "string",
    "description3": "string",
    "description4": "string",
    "description6": "string",
    "description7": "string",
    "height": 0,
    "id": 0,
    "isActive": false,
    "isAvaiable": false,
    "isKit": false,
    "lastChange": "2021-07-23T15:25:19",
    "length": 0,
    "listOfEAN": [
        0
    ],
    "name": "string",
    "nameProduct": "string",
    "price": 0,
    "productRootId": 0,
    "productSKUId": "000-0",
    "productOriginalSKUId": "000-0",     
    "realHeight": 0,
    "realLength": 0,
    "realWeightKg": 0,
    "realWidth": 0,
    "sectionId": 0,
    "merchandiseType": "string",
    "unitMultiplier": 0,
    "volume": 0,
    "weightKg": 0,
    "width": 0
}

...

Páginas filhas

Versões comparadas

Versão antiga 30

Nova versão 39

Chave

Requisição para listar SKUs

Requisição para buscar SKU por ID