POSTEstoque
Lançar movimentação
Registra uma movimentação de estoque (entrada, saída ou ajuste) para um produto/variante.
POST
/inventory/{productId}/movementsAutenticaçãoPainel admin
Cookie de sessão do painel (ecom_token) + permissão RBAC.
Parâmetros de caminho
productIduuidobrigatórioIdentificador do produto.
Corpo da requisição
tipostringobrigatórioentrada | saida | ajuste.
quantidadeintegerobrigatórioQuantidade movimentada.
motivostringopcionalMotivo/observação.
Cabeçalhos
CookiestringobrigatórioCookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).
Requisição
curl -X POST "https://api.ecomplataforma.com.br/inventory/p_12/movements" \
-b cookies.txt -H "Content-Type: application/json" \
-d '{"tipo":"entrada","quantidade":50}'Resposta201
200 OK
{ "success": true, "data": { "id": "mv_2", "saldo": 92 } }Respostas de erro
401Não autenticado
401 Não autenticado
{
"success": false,
"error": "Sessão ausente ou expirada."
}403Sem permissão
403 Sem permissão
{
"success": false,
"error": "Você não tem permissão para acessar este recurso."
}404Não encontrado
404 Não encontrado
{
"success": false,
"error": "Recurso não encontrado."
}422Falha de validação
422 Falha de validação
{
"success": false,
"error": "O campo 'email' é obrigatório."
}