Ferramentas · Encomendas

O módulo Encomendas pelo assistente: registrar a encomenda com foto e avisar o membro, acompanhar a fila, mexer nas fotos, marcar a retirada, devolver, descartar, reabrir e excluir, e o membro perguntar se tem algo esperando. São 16 ferramentas.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

#Em resumo

O espaço se cria com create_space e module: "parcels", com o argumento parcels para a configuração; update_space muda só o que você mandar e mantém o resto.

A equipe, aqui, é o proprietário, o administrador, o moderador e o financeiro. Os papéis são os das rotas: o assistente nunca faz mais do que a pessoa conectada faria na tela. O proprietário e o administrador veem as 16 ferramentas; o moderador e o financeiro, 13 (sem descartar, reabrir e excluir); o membro, 4 (get_parcels_overview, get_parcel, do_i_have_parcels e mark_parcel_picked_up, nas próprias encomendas).

O código do locker é um segredo. Nenhuma resposta da equipe o traz, e ele fica oculto no registro de auditoria do MCP; só do_i_have_parcels e get_parcel o mostram, ao próprio destinatário. Quem registra ou corrige pode definir o código, nunca lê-lo, e o assistente não o repete.

#A configuração do espaço

O argumento parcels de create_space e update_space aceita:

#get_parcels_overview

Só consulta

O espaço de relance. A configuração (modo de locker e se o membro confirma a própria retirada), quantas encomendas aguardam você (mine.pendingCount) e, para a equipe, quantas estão pendentes e paradas. Papel mínimo: qualquer que veja o espaço.

Peça assim: "Quantas encomendas estão paradas na Unidade Centro?"

#get_parcel

Só consulta

Uma encomenda. Com as fotos, em links assinados que valem 1 hora. A equipe lê qualquer encomenda da comunidade, sem o código; o destinatário lê a sua, com o local e o código enquanto ela aguarda. Qualquer outra pessoa recebe "não encontrada". Papel mínimo: qualquer.

Peça assim: "Mostre a encomenda da Maria."

#do_i_have_parcels

Só consulta

"Tenho encomenda?" Só as suas: as pendentes (todas) e o histórico (as últimas), com onde retirar, o código do locker enquanto aguarda e as fotos (links de 1 hora). Mostre o código só à própria pessoa. Papel mínimo: qualquer.

Peça assim: "Tenho alguma encomenda esperando?"

#mark_parcel_picked_up

Altera

Marcar a retirada. A equipe marca como STAFF (padrão, com o nome de quem veio em picked_up_by_name, que por padrão é o destinatário) ou THIRD_PARTY (o nome é obrigatório). O próprio destinatário marca como SELF, só se o espaço não exige a confirmação da equipe (senão, recusado). O código do locker é apagado. É idempotente: numa encomenda já encerrada, devolve already_closed: true. Papel mínimo: qualquer (a sua); moderador ou financeiro (de outros).

Peça assim: "Marque como retirada a encomenda da Maria." · "Já peguei a minha encomenda."

#search_parcel_recipients

Só consulta

Quem recebe. Os membros do espaço cujo nome começa com q (pelo menos 3 letras, até 8 resultados), só com id, nome e iniciais. O id é o recipient_profile_id de register_parcel. Papel mínimo: moderador (ou financeiro).

Peça assim: "Procure a Maria Souza para registrar uma encomenda."

#register_parcel

Altera

Registrar a encomenda. Para um membro com acesso ao espaço. Envia ao destinatário o e-mail de aviso (com a miniatura, se o espaço está assim), no fuso da comunidade: o assistente diz isso. kind é LETTER, PACKAGE ou OTHER (este pede kind_label). locker_label e locker_pickup_code (de 4 a 12 caracteres, um segredo) só valem se o espaço permite. client_request_id faz uma chamada repetida devolver a mesma encomenda, sem segundo e-mail. Mesmo destinatário, tipo e rastreio em 24 horas é recusado (409), a menos que force seja verdadeiro. Papel mínimo: moderador (ou financeiro).

Peça assim: "Chegou um pacote da Amazon para a Maria Souza, no armário 12. Foto: [link]."

#list_pending_parcels

Só consulta

A fila. As que aguardam retirada, da mais nova à mais antiga, com destinatário, tipo, remetente, local, há quanto tempo esperam e stalled_days quando passaram do prazo. Filtros: kind, q (destinatário, remetente, transportadora ou rastreio), stalled, recipient_profile_id, from e to (AAAA-MM-DD, no fuso da comunidade). Nunca o código (só has_locker_code). Papel mínimo: moderador (ou financeiro).

Peça assim: "O que está parado na recepção há mais de 3 dias?"

#list_parcels

Só consulta

O histórico. Igual a list_pending_parcels, mas com qualquer situação (RECEIVED, PICKED_UP, RETURNED, DISCARDED), filtrável por status. Papel mínimo: moderador (ou financeiro).

Peça assim: "Quais encomendas foram devolvidas este mês?"

#update_parcel

Altera

Corrigir. Tipo, remetente, transportadora, rastreio, observação, local e código do locker (que se define de novo, nunca se lê) de uma encomenda que aguarda. Uma encomenda encerrada só é corrigida por proprietário ou administrador, e nunca o código. Cada correção entra no registro. Papel mínimo: moderador (ou financeiro).

Peça assim: "Corrija o rastreio da encomenda da Maria para BR123456789."

#add_parcel_photo

Altera

Adicionar uma foto. Até 5 por encomenda, em armazenamento privado. A equipe; em encomenda encerrada, só proprietário e administrador. Papel mínimo: moderador (ou financeiro).

Peça assim: "Anexe esta foto à encomenda da Maria."

#replace_parcel_photo

Altera

Trocar uma foto. Troca uma foto pelo arquivo novo; o antigo é apagado. Papel mínimo: moderador (ou financeiro).

Peça assim: "Troque a primeira foto da encomenda por esta."

#return_parcel

Altera

Devolver ao remetente. Exige o motivo. Nada é apagado: a encomenda fica no histórico como RETURNED e o código do locker é apagado. Uma encomenda já encerrada responde 409. Papel mínimo: moderador (ou financeiro).

Peça assim: "Devolva ao remetente a encomenda da Maria: recusada."

#remove_parcel_photo

Pede confirmação

Remover uma foto. O arquivo é apagado de vez. Na primeira chamada devolve o resumo e o código de confirmação. Papel mínimo: moderador (ou financeiro).

Peça assim: "Remova a segunda foto da encomenda; ela mostra o endereço."

#discard_parcel

Altera

Descartar. Para a que ninguém retirou. Exige o motivo. Nada é apagado: fica como DISCARDED no histórico, e reopen_parcel desfaz. Não pede confirmação, por ser reversível. Papel mínimo: administrador (proprietário ou administrador).

Peça assim: "Descarte a encomenda da Maria: vencida sem retirada."

#reopen_parcel

Altera

Reabrir. Desfaz uma retirada, devolução ou descarte por engano: volta a RECEIVED, com o motivo. O código apagado não volta; defina outro com update_parcel. Papel mínimo: administrador (proprietário ou administrador).

Peça assim: "Reabra a encomenda da Maria: a retirada foi marcada por engano."

#delete_parcel

Pede confirmação

Excluir um registro feito por engano. Sai das listas e as fotos são apagadas; o registro guarda quem e por quê. Para encerrar uma encomenda de verdade, use mark_parcel_picked_up, return_parcel ou discard_parcel. Na primeira chamada devolve o resumo e o código de confirmação. Papel mínimo: administrador (proprietário ou administrador).

Peça assim: "Exclua o registro da encomenda do João: registrei para a pessoa errada."

#Relacionados

• Encomendas
• Ferramentas
• Dinheiro e confirmação
• Receitas