Inicia a coleta (status 1 → 2)
POST/fulfillment/picking/picking-list/:idpickinglist/start
Inicia a coleta de uma picking-list: marca a lista como iniciada, registra o colaborador e o horário de início (horário de Brasília) e move todos os pedidos da lista para 2 Iniciado picking.
Pré-requisito de status dos pedidos, que varia com o tipo da lista:
- Lista comum (
IDTypePickingListdiferente de4): todos os pedidos precisam estar em3Pré picking-list. - Lista colméia filha (
IDTypePickingList4com lista pai): os pedidos podem estar em2Iniciado picking,3Pré picking-list ou4Finalizado picking. - Lista colméia pai (
IDTypePickingList4sem lista pai): não há validação de status dos pedidos.
Regra de exclusividade do colaborador: uma lista ainda pendente que já tenha colaborador atribuído só pode ser iniciada por esse mesmo colaborador. Além disso, o colaborador não pode ter outra lista em coleta — salvo quando a empresa está parametrizada para permitir mais de uma lista simultânea por colaborador.
Emissão de nota fiscal: quando a empresa, ou a integração de origem do pedido, está parametrizada para faturar ao iniciar a coleta, a emissão da nota fiscal de cada pedido da lista é disparada automaticamente neste momento.
Quando a picking-list informada não existe ou não pertence à empresa, a resposta é 200 com lista vazia.
Request
Responses
- 200
- 400
Detalhe da picking-list iniciada (linhas de coleta). Devolve [] quando a picking-list informada não existe ou não pertence à empresa — esse caso deixou de ser erro.
Mensagens [BadRequest]:
Picking List não existe— a lista existe mas não tem nenhum pedido amarrado (em lista colméia filha, nenhum movimento de item amarrado). Lista inexistente ou de outra empresa devolve200com[].Essa lista está vinculada a outro colaborador— atribuída a outro usuário.Você precisa finalizar a lista X antes de iniciar uma nova— regra de uma lista iniciada por colaborador.Pedido (s) X, Y, Z com status errado— algum pedido fora do status exigido pelo tipo da lista:3Pré picking-list em lista comum;2Iniciado picking,3Pré picking-list ou4Finalizado picking em lista colméia filha.