Sincronizando produtos

Este artigo faz parte do Manual do Integrador.

Nesse artigo vamos ver como sincronizar os atributos do produto cadastrado no Market Gestor.

1 Cadastro

Para acessar o cadastro dos produtos use a URL indicada no exemplo abaixo:

### consultar produtos

GET {{url}}produtos

Authorization: Bearer {{token}}

1.1 Filas de alterações do cadastro

Para evitar sincronizar sempre todos os produtos sem necessidade, temos a disposição filas de produtos alterados. Sempre que o cadastro do produto tiver alguma alteração um registro de fila será gerado e pode ser consultado conforme o exemplo abaixo:

### consultar fila de sincronização com o CADASTRO alterado

GET {{url}}produtos/fila/cadastro

Authorization: Bearer {{token}}

 

Para remover da fila siga o exemplo abaixo:

### Marcar o produto como sincronizado removendo ele da fila até a próxima alteração em seu cadastro. DEVE SER ENVIADO O MESMO RETORNO DA FILA

DELETE {{url}}produtos/fila/cadastro/itens

Content-Type: application/json

Authorization: Bearer {{token}}

 

{

"itens": [

{

"produtoId": 123,

"ultimaAlteracao": "2026-01-09T14:59:03"

},

{

"produtoId": 30115,

"ultimaAlteracao": "2026-01-08T11:05:29"

},

]

}

O sistema trabalha com listas de preços, durante a integração com o cadastro do produto o que é obtido são listas de preços. Elas podem se referir aos preços de uma loja específica ou a pautas de preço.

Dica: Utilize o parâmetro SomenteAtivos=true para reduzir o número de produtos processados.

2 Preços

Para otimizar o sincronismo dos preços foi desenvolvido uma consulta apenas dos preços praticados. Para acessar os preços use a URL do exemplo abaixo:

### consultar produtos somente preços

GET {{url}}precos

Authorization: Bearer {{token}}

 

2.1 Fila dos preços alterados 

Para controlar a fila das alterações dos preços utilize essas URLs:

### consultar fila de sincronização dos preços alterados

GET {{url}}produtos/fila/preco

Authorization: Bearer {{token}}

Para remover da fila siga o exemplo abaixo:

### Marcar o PREÇO do produto como sincronizado removendo ele da fila até a próxima alteração. DEVE SER ENVIADO O MESMO RETORNO DA FILA

DELETE {{url}}produtos/fila/preco/itens

Content-Type: application/json

Authorization: Bearer {{token}}

 

{

"itens": [

{

"produtoId": 15234,

"ultimaAlteracao": "2025-12-29T00:00:00"

},

{

"produtoId": 16463,

"ultimaAlteracao": "2025-12-29T00:00:00"

},

]

}

 

3 Estoque

O estoque dos produtos são alterados em tempo real, leve em conta isso ao sincronizar. Para consultar o saldo temos duas opções:

Para consultar apenas o saldo dos produtos use a URL do exemplo abaixo:

### consultar ESTOQUE dos produtos

GET {{url}}estoques

Authorization: Bearer {{token}}

Para consultar o saldo e mais algumas informações sobre pedidos pendentes, ultima entrada e venda, use a URL do exemplo abaixo:

### consultar detalhes das compras pendentes do produto  

GET {{url}}estoques/compras/pendentes?LojaId=1&ProdutoId=78

Authorization: Bearer {{token}}

 

3.1 Fila dos produtos com o saldo alterado

Consulte os produtos que tiveram o seu saldo alterado conforme o exemplo abaixo:

### consultar fila de sincronização com o ESTOQUE alterado

GET {{url}}produtos/fila/estoque

Authorization: Bearer {{token}}

Remova da fila conforme o exemplo da URL abaixo:

### Marcar o ESTOQUE do produto como sincronizado removendo ele da fila até a próxima alteração. DEVE SER ENVIADO O MESMO RETORNO DA FILA

DELETE {{url}}produtos/fila/estoque/itens

Content-Type: application/json

Authorization: Bearer {{token}}

 

{

"itens": [

{

"produtoId": 26101,

"ultimaAlteracao": "2025-12-15T14:12:12"

},

{

"produtoId": 26105,

"ultimaAlteracao": "2025-12-15T14:12:12"

},

]

}

 

4 Imagem

A imagem do produto pode ser baixada apenas uma por vez, e para isso use a URL do exemplo abaixo:

### baixar a imagem do produto

GET {{url}}produtos/{id}/imagem

Authorization: Bearer {{token}}

 

4.1 Fila da imagem do produto alterada

### consultar fila de sincronização com A IMAGEM alterado

GET {{url}}produtos/fila/imagem?SomenteMeusProdutos=true

Authorization: Bearer {{token}}

Para remover o produto da fila:

### Marcar o produto como sincronizado removendo ele da fila até a próxima alteração na IMAGEM. DEVE SER ENVIADO O MESMO RETORNO DA FILA

DELETE {{url}}produtos/fila/imagem

Content-Type: application/json

Authorization: Bearer {{token}}

 

{

"produtoId": 34534,

"ultimaAlteracao": "2024-12-14T11:29:44.302554"

}

 

 

 


Gestor \ Integração

Escrito por Josué Diniz Lourenço e revisado por Josué Diniz Lourenço em 03/02/2026.


Link público: www.conhecimento.market.com.br/artigo/965