Abaixo apresento a documentação para o gerenciamento de estoque, utilizando o padrão de estilização e estrutura solicitado:
Apresentamos abaixo os endpoints para o gerenciamento de estoque dos produtos da plataforma. Através destes recursos, é possível consultar os saldos atuais e realizar atualizações de estoque de forma individual ou em lote.
Responses
| Retorno | Descrição |
|---|---|
| 200 | Sucesso (OK) |
| 401 | Sem autorização |
| 403 | Acesso Negado |
| 404 | Recurso não encontrado |
| 422 | Erro de validação (ex: ID inexistente) |
Editar Estoque
PUT https://api.dooca.store/stocks
A edição do registro pode ser parcial ou total. O limite é de 150 objetos por requisição dentro do array.
[
{ "variation_id": 1, "balance": 10 },
{ "variation_id": 2, "balance": 5 }
]
Explicação dos campos de envio:
- variation_id: ID único da variação do produto que terá o estoque alterado.
- balance: A nova quantidade total em estoque para esta variação.
Listar Estoque
GET https://api.dooca.store/stocks
Obs: No momento, não existem parâmetros de filtro específicos para este endpoint.
Interface de retorno:
{
"data": [
{
"variation_id": number,
"product_id": number,
"external_id": string|null,
"sku": string|null,
"balance": number,
"name": string,
"variation": string,
"options": array,
"image": {
"id": number,
"src": string,
"alt": string|null
},
"reserved": number,
"has_movement": boolean,
"sell_out_of_stock": boolean
}
],
"meta": {
"current_page": number,
"total": number
}
}
Os campos de retorno principais são:
| Campo | Descrição | Tipo |
|---|---|---|
| variation_id | ID único da variação | number |
| balance | Quantidade disponível em estoque | number |
| reserved | Quantidade de itens reservados (em pedidos pendentes) | number |
| sell_out_of_stock | Indica se o produto pode ser vendido sem estoque | boolean |
Com estes endpoints, você consegue manter o estoque da sua loja Dooca sincronizado com sistemas externos de ERP ou PDV.
Comentários
0 comentário
Por favor, entre para comentar.