Sugestões de compras e transferências

É possível enviar sugestões para pedidos de compra de mercadorias junto aos fornecedores do supermercado. Também de solicitar transferências de mercadorias para as lojas. 

Endpoints para enviar esses dados:

 

Sugestão de compra

### Listar sugestões de compra por pacote sem filtros opcionais
# Retorna somente sugestões do usuário autenticado. HasNext indica o próximo pacote.
GET {{url}}v1/sugestoes/sugestaocompra?page=1&pageSize=25
Authorization: Bearer {{token}}

### Listar sugestões com produtos, lojas e período de data_sugestao
GET {{url}}v1/sugestoes/sugestaocompra?ProdutoIds=123&ProdutoIds=456&LojaIds=1&LojaIds=2&Periodo.DataInicial=2026-10-01&Periodo.DataFinal=2026-10-31&page=1&pageSize=25
Authorization: Bearer {{token}}

### Inserir ou atualizar sugestões de compra em pacote
# Aceita de 1 a 500 itens e retorna a quantidade gravada.
# Se (lojaId, produtoId) já existir, atualiza quantidade, fornecedor, usuário, data e hora.
# usuarioId vem do usuário autenticado; data_sugestao e hora_sugestao vêm do banco.
POST {{url}}v1/sugestoes/sugestaocompra/pacote
Authorization: Bearer {{token}}
Content-Type: application/json

{
"itens": [
{
"lojaId": 1,
"produtoId": 123,
"qtdUnitaria": 10.500,
"fornecedorId": 2
}
]
}

### Remover sugestões de compra por filtros
# Informe ao menos um campo. Exemplo: remove todas as sugestões do produto 123.
# Filtros disponíveis: lojaId, produtoId, qtdUnitaria, fornecedorId,
# usuarioId, dataSugestao (AAAA-MM-DD) e horaSugestao (HH:MM:SS).
DELETE {{url}}v1/sugestoes/sugestaocompra
Authorization: Bearer {{token}}
Content-Type: application/json

{
"produtoId": 123
}

 

Sugestões de transferência

### Listar sugestões de transferência por pacote sem filtros opcionais
# Retorna somente sugestões do usuário autenticado. HasNext indica o próximo pacote.
# LojaOrigemIds, LojaDestinoIds, ProdutoIds e Periodo aceitam null.
GET {{url}}v1/sugestoes/sugestoestransferencia?page=1&pageSize=25
Authorization: Bearer {{token}}

### Listar sugestões com lojas de origem, destino, produtos e período de data_sugestao
# Repita os parâmetros de array para informar vários valores.
GET {{url}}v1/sugestoes/sugestoestransferencia?LojaOrigemIds=1&LojaOrigemIds=2&LojaDestinoIds=2&LojaDestinoIds=3&ProdutoIds=123&ProdutoIds=456&Periodo.DataInicial=2026-10-01&Periodo.DataFinal=2026-10-31&page=1&pageSize=25
Authorization: Bearer {{token}}

### Inserir ou atualizar sugestões de transferência em pacote
# Aceita de 1 a 500 itens e retorna a quantidade gravada.
# Se (lojaOrigemId, lojaDestinoId, produtoId) já existir, atualiza quantidade, usuário, data e hora.
# usuarioId vem do usuário autenticado; data_sugestao e hora_sugestao vêm do banco.
POST {{url}}v1/sugestoes/sugestoestransferencia/pacote
Authorization: Bearer {{token}}
Content-Type: application/json

{
"itens": [
{
"lojaOrigemId": 1,
"lojaDestinoId": 2,
"produtoId": 123,
"qtdUnitaria": 10.500
}
]
}

### Remover sugestões de transferência por filtros
# Informe ao menos um campo. Exemplo: remove todas as sugestões do produto 123.
# Filtros disponíveis: lojaOrigemId, lojaDestinoId, produtoId, qtdUnitaria,
# usuarioId, dataSugestao (AAAA-MM-DD) e horaSugestao (HH:MM:SS).
DELETE {{url}}v1/sugestoes/sugestoestransferencia
Authorization: Bearer {{token}}
Content-Type: application/json

{
"produtoId": 123
}

 

 


 

No sistema Market Gestor, as sugestões precisam ser aceitas, clique aqui para saber mais sobre isso.

 


Gestor \ Integração

Escrito por Josué Diniz Lourenço e revisado por Josué Diniz Lourenço em 21/11/2026.


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