Adiciona SKU/endereço à fila ou lança contagem

POST 
/sku/inventory-summary/:idstockkeepingunitinventorysummary/sku

Endpoint multi-uso, controlado pela query string:

• IDTypeQueue=1 — adiciona endereços na fila de contagem. Com AddAllLocations=1, inclui todos os endereços do armazém do inventário que tenham saldo de lote diferente de zero.
• IDTypeQueue=2 — adiciona SKUs na fila de contagem. Com AddAllSkus=1, inclui todos os SKUs ativos da empresa com saldo de lote no centro de distribuição do inventário.
• Sem IDTypeQueue — lança a quantidade contada de um SKU. Exige IDSku e IDStockKeepingUnitWarehouse; itens sem esses dois campos são ignorados sem erro. QuantityInventory ausente ou vazio é gravado como contagem 0 — não equivale a "não contado". Quando IDStockKeepingUnitLocation vem na query, os itens daquele endereço que não foram enviados no corpo são automaticamente zerados (uso pelo coletor).

O corpo aceita um objeto único ou um array de objetos. Em array, itens inválidos não interrompem o processamento: a resposta vem com a lista de erros. Em objeto único, o primeiro erro vira 400.

Atenção — recontagem destrutiva: quando a estratégia de quantidade em vigor é 2 (enviada em IDTypeQuantity ou herdada do cadastro do inventário), todos os itens já lançados no inventário são apagados antes de processar a requisição, e a remoção fica registrada no histórico.

Draft=1 guarda o corpo como rascunho temporário (4 dias) sem persistir nada — nesse modo a resposta vem vazia e o rascunho é recuperado no detalhe do inventário com Draft=1.

Ao receber a primeira contagem, o sistema atribui o usuário autenticado como colaborador da 1ª conferência e muda o status para 3 (Em andamento). Enviar QuantityInventorySecond ou QuantityInventoryThird apenas assume a 2ª/3ª conferência — atribui o colaborador e muda o status para 9 ou 10; a quantidade gravada continua sendo a de QuantityInventory.

Quando o SKU ainda não tem nenhum lote no armazém informado, o sistema cria um lote para receber a contagem — e, se o armazém não tiver nenhum endereço, cria também o endereço padrão Principal.

Request

Responses

200

Lista atualizada de itens contados do inventário. Como o detalhe passou a ser paginado, vem no máximo a primeira página — 5000 registros; para inventários maiores, o restante é obtido pelo detalhe do inventário com Page.

Com Draft=1 a resposta é vazia: o rascunho é apenas gravado, sem devolver a lista de itens.

Quando o corpo é um array e ocorrem erros parciais, a resposta é a lista de erros.

400

Mensagens (prefixo [BadRequest]): Inventário não existe; Inventário já está finalizado; Inventário está cancelado; Sku não existe; Armazém não existe; Lote não existe; Endereço não existe para armazém.

As três de item (Sku não existe, Armazém não existe, Lote não existe) só viram erro 400 quando o corpo é um objeto único; com o corpo em array, elas voltam no 200 como erros parciais.

500

Erro interno.