Integração BDI Catavento - Catálogo de Produtos 

Page / - last modified by WBS Tecnologia on 2021/09/13 12:48 

Catálogo de Produtos 
last modified by WBS Tecnologia
on 2021/09/13 12:48

Table of Contents

Catálogo de Produtos
Abaixo detalhes sobre os campos e informações de produtos
Jobs/Fluxos de Integração
A API conta com vários Endpoints para a consulta do catálogo, é muito importante o desenvolvedor implementar o fluxo correto e utilizar os endpoints para as finalidades corretas, assim o ECommerce ficara atualizado sem atingir os limites da API e sem atrasos com relação há Catavento.
 1.	O Endpoint "/BDIApi/Produto/Listar" dever ser utilizado para uma primeira sincronização com a Loja, este endpoint suporta os parâmetros de Paginação, assim o ECommerce pode realizar uma primeira sincronização do Catálogo Inteiro.
 2.	O Endpoint "/BDIApi/Produto/TodosDesde?horas=x" deve ser utilizado para sincronizações posteriores e com intervalos de no máximo 1 hora. Esse endpoint permite trazer os produtos que sofreram alteração de metadados como Resenha, Descrição, Editora, Capa, Autores.
 3.	O Endpoint "/BDIApi/Produto/EstoqueDesde?horas=x" deve ser utilizado para sincronização posteriores e com intervalos de no máximo 5 minutos. Esse endpoint permite trazer os produtos que sofreram alteração de Estoque, Preço e Situação. E Deve ser utilizado para manter a Loja Atualizada com o Estoque da Catavento.
 4.	A API conta com outros endpoints para consultar um ou mais produtos individualmente, consulte a documentação.
Produto
Nome	Descrição	
Acabamento	Acabamento do produto. Ex.: capa dura, capara mole, costurado.	
AtualizadoEm	Quando o Produto foi Atualizado pelo ERP	
Autores	Lista de Autores Vinculados ao Produto	
Categorias	Categorias do Produto	
CodigoDeBarras	Código de Barras do Produto	
CriadoEm	Quando foi Criado	
Descricao	Descrição/Título do Produto	
Edicao	Edição do Produto	
Editora	Nome da Editora	
Estoque	Quantidade em estoque. (A atualização do estoque do produto é feita toda vez que um pedido é importado para o Winbooks. Também pode ser feita, em intervalo de tempo parametrizado pela Editora, de todos os produtos do cadastro, com exceção dos produtos marcados para não serem atualizado).	
EstoqueMinimo	Estoque Mínimo do Produto	
Formato	Formato do produto. Ex.: 19,5 x 26,5 cm.	
GrupoId	(Herdado de Produto.)	
Id	(Herdado de Entidade.)	
LancadoEm	(Herdado de Produto.)	
Lombada	Lombada do produto. Ex.: 1.2 cm.	
NumeroDePaginas	Numero de Páginas no Livro	
PalavrasChave	Palavras-Chaves separadas por vírgula	
PedacoDoLivro	Pedaco do Livro	
Peso	Peso do Livro em quilogramas Ex.: 0,214	
Preco	Preço de venda do produto.	
PrecoEBook	Valor do produto para quando o tipo do livro for marcado como e-book.	
PublicadoEm	(Herdado de Produto.)	
Resenha	Resenha do Produto	
Situacao	Indica a Situação do Produto:
•	 0 e 4 = Normal
•	 1 = Adotado
•	 2 = Esgotado 
•	3 = Novidade 
•	5 = Promoção 
•	6 = Referência
•	7 = Fora de Catálogo 
•	8 = Prelo	
Subtitulo	Subtitulo do Produto	
Traducao	Tradução, detalhes sobre a tradução, idioma original.	
UrlDaCapa	Url para Acesso a Capa do Produto, se estiver em branco é porque o produto não tem capa definida pela Catavento. 	
Visivel	Indica que se o produto pode estar vísivel na Loja, caso seja falso, é  necessário ocultar o produto da Loja ou remove-lo. Pedidos do produto não poderão ser realizados	
PodeEncomendar	 Indica que se o produto permite Encomenda na Loja, caso seja falso e se produto não tiver estoque é recomendado colocado como Esgotado.	
EncomendaEm	Quantos dias para encomendar o Produto	
Autor
Nome	Descrição	
Biografia	Biografia	
Nome	Nome do Autor	
UrlDaFoto	Url da Foto do Autor	
Desconto
Nome	Descrição	
AtualizadoEm	Quando foi a Ultima Atualização do Produto	
CodigoDeBarras	Código de Barras do Produto	
DescontoDeConsignacao	Campo desconto do produto em percentual, conforme Tabela de Preço no ERP WinBooks. O valor pode ser de 0,00% à 99,999%	
DescontoDeVenda	Campo desconto do produto em percentual, conforme Tabela de Preço no ERP WinBooks. O valor pode ser de 0,00% à 99,999%	
PrecoDeConsignacao	Valor de capa conforme Tabela de Preço no ERP WinBooks. O valor poderá ser .null., devendo ser considerado o Preço Normal do Produto	
PrecoDeVenda	Valor de capa conforme Tabela de Preço no ERP WinBooks. O valor poderá ser .null., devendo ser considerado o Preço Normal do Produto	
Índice
•	Catálogo de Produtos
•	Jobs/Fluxos de Integração
•	Produto
•	Autor
•	Desconto