Skip to main content
o processamento das atualizações de estoque é assíncrono. as requisições são adicionadas a uma fila e processadas conforme disponibilidade. o tempo de processamento pode variar de acordo com o volume do payload.

​
estoque de pronta entrega

atualiza o estoque disponível imediatamente para venda.

​
endpoint

PATCH /v1/stock/sync/{skuCode}
​
skuCode
string
required
código do SKU.

​
payload

{
  "totalAmount": 0,
  "availabilityStartDate": "2025-01-28T15:22:57.748Z",
  "availabilityEndDate": "2025-01-28T15:22:57.748Z",
  "availability": true
}
​
totalAmount
integer
required
quantidade total disponível em estoque.
​
availabilityStartDate
string
data de início da disponibilidade (ISO 8601).
​
availabilityEndDate
string
data de fim da disponibilidade (ISO 8601).
​
availability
boolean
indica se o SKU está disponível para venda.

​
resposta de sucesso

{
  "message": "Stock update sent to queue"
}
para mais informações, consulte o swagger.

​
estoque futuro (pré-venda)

atualiza o estoque futuro de um SKU, usado para pedidos de pré-venda vinculados a janelas de entrega.

​
endpoint

PATCH /v1/future-stock/sync/{skuCode}
​
skuCode
string
required
código do SKU.

​
payload

{
  "deliveryWindowCode": "Abr25",
  "totalAmount": 10,
  "availableForSale": true,
  "availabilityStartDate": "2025-01-28T15:35:48.813Z",
  "availabilityEndDate": "2025-01-28T15:35:48.813Z"
}
​
deliveryWindowCode
string
required
código da janela de entrega (ex: Abr25 para abril de 2025).
​
totalAmount
integer
required
quantidade total disponível para esta janela.
​
availableForSale
boolean
indica se o SKU está disponível para venda nesta janela.
​
availabilityStartDate
string
data de início da disponibilidade (ISO 8601).
​
availabilityEndDate
string
data de fim da disponibilidade (ISO 8601).

​
resposta de sucesso

{
  "message": "stock created with success"
}
para mais informações, consulte o swagger.

​
comparativo

característicapronta entregaestoque futuro
usovendas imediataspré-vendas
janela de entreganão possuiobrigatório
endpoint/v1/stock/sync/{skuCode}/v1/future-stock/sync/{skuCode}