Strumenti · Pacchi

Il modulo Pacchi tramite l'assistente: registrare il pacco con foto e avvisare il membro, seguire la coda, gestire le foto, segnare il ritiro, restituire, scartare, riaprire ed eliminare, e il membro che chiede se c'è qualcosa ad aspettarlo. Sono 16 strumenti.

Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.

#In sintesi

Lo spazio si crea con create_space e module: "parcels", con l'argomento parcels per la configurazione; update_space cambia solo ciò che invii e mantiene il resto.

Il team, qui, è il proprietario, l'amministratore, il moderatore e la finanza. I ruoli sono quelli delle rotte: l'assistente non fa mai più di quanto la persona connessa farebbe nella schermata. Il proprietario e l'amministratore vedono tutti e 16 gli strumenti; il moderatore e la finanza, 13 (senza scartare, riaprire ed eliminare); il membro, 4 (get_parcels_overview, get_parcel, do_i_have_parcels e mark_parcel_picked_up, sui propri pacchi).

Il codice dell'armadietto è un segreto. Nessuna risposta del team lo riporta, e resta nascosto nel registro di audit dell'MCP; solo do_i_have_parcels e get_parcel lo mostrano, al destinatario stesso. Chi registra o corregge può impostare il codice, mai leggerlo, e l'assistente non lo ripete.

#La configurazione dello spazio

L'argomento parcels di create_space e update_space accetta:

#get_parcels_overview

Solo lettura

Lo spazio a colpo d'occhio. La configurazione (modalità armadietto e se il membro conferma il proprio ritiro), quanti pacchi aspettano te (mine.pendingCount) e, per il team, quanti sono in attesa e fermi. Ruolo minimo: chiunque veda lo spazio.

Chiedi così: "Quanti pacchi sono fermi nella Sede Centro?"

#get_parcel

Solo lettura

Un pacco. Con le foto, in link firmati che valgono 1 ora. Il team legge qualsiasi pacco della community, senza il codice; il destinatario legge il suo, con il posto e il codice finché è in attesa. Chiunque altro riceve "non trovato". Ruolo minimo: qualsiasi.

Chiedi così: "Mostrami il pacco di Maria."

#do_i_have_parcels

Solo lettura

"Ho un pacco?" Solo i tuoi: quelli in attesa (tutti) e lo storico (gli ultimi), con dove ritirarli, il codice dell'armadietto finché è in attesa e le foto (link di 1 ora). Mostra il codice solo alla persona stessa. Ruolo minimo: qualsiasi.

Chiedi così: "Ho qualche pacco in attesa?"

#mark_parcel_picked_up

Modifica

Segnare il ritiro. Il team segna come STAFF (predefinito, con il nome di chi è venuto in picked_up_by_name, che per impostazione predefinita è il destinatario) o THIRD_PARTY (il nome è obbligatorio). Il destinatario stesso segna come SELF, solo se lo spazio non richiede la conferma del team (altrimenti viene rifiutato). Il codice dell'armadietto viene cancellato. È idempotente: su un pacco già chiuso, restituisce already_closed: true. Ruolo minimo: qualsiasi (il tuo); moderatore o finanza (di altri).

Chiedi così: "Segna come ritirato il pacco di Maria." · "Ho già preso il mio pacco."

#search_parcel_recipients

Solo lettura

Chi riceve. I membri dello spazio il cui nome inizia con q (almeno 3 lettere, fino a 8 risultati), solo con id, nome e iniziali. L'id è il recipient_profile_id di register_parcel. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Cerca Maria Rossi per registrare un pacco."

#register_parcel

Modifica

Registrare il pacco. Per un membro con accesso allo spazio. Invia al destinatario l'e-mail di avviso (con la miniatura, se lo spazio è impostato così), nel fuso della community: l'assistente lo dice. kind è LETTER, PACKAGE o OTHER (quest'ultimo richiede kind_label). locker_label e locker_pickup_code (da 4 a 12 caratteri, un segreto) valgono solo se lo spazio lo permette. client_request_id fa sì che una chiamata ripetuta restituisca lo stesso pacco, senza una seconda e-mail. Stesso destinatario, tipo e tracking entro 24 ore viene rifiutato (409), a meno che force sia vero. Ruolo minimo: moderatore (o finanza).

Chiedi così: "È arrivato un pacco di Amazon per Maria Rossi, nell'armadietto 12. Foto: [link]."

#list_pending_parcels

Solo lettura

La coda. Quelli in attesa di ritiro, dal più recente al più vecchio, con destinatario, tipo, mittente, posto, da quanto tempo aspettano e stalled_days quando hanno superato il termine. Filtri: kind, q (destinatario, mittente, corriere o tracking), stalled, recipient_profile_id, from e to (AAAA-MM-GG, nel fuso della community). Mai il codice (solo has_locker_code). Ruolo minimo: moderatore (o finanza).

Chiedi così: "Cosa è fermo alla reception da più di 3 giorni?"

#list_parcels

Solo lettura

Lo storico. Come list_pending_parcels, ma con qualsiasi stato (RECEIVED, PICKED_UP, RETURNED, DISCARDED), filtrabile per status. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Quali pacchi sono stati restituiti questo mese?"

#update_parcel

Modifica

Correggere. Tipo, mittente, corriere, tracking, nota, posto e codice dell'armadietto (che si imposta di nuovo, mai si legge) di un pacco in attesa. Un pacco chiuso lo corregge solo il proprietario o l'amministratore, e mai il codice. Ogni correzione entra nel registro. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Correggi il tracking del pacco di Maria in BR123456789."

#add_parcel_photo

Modifica

Aggiungere una foto. Fino a 5 per pacco, in un archivio privato. Il team; su un pacco chiuso, solo il proprietario e l'amministratore. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Allega questa foto al pacco di Maria."

#replace_parcel_photo

Modifica

Sostituire una foto. Sostituisce una foto con il nuovo file; quello vecchio viene cancellato. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Sostituisci la prima foto del pacco con questa."

#return_parcel

Modifica

Restituire al mittente. Richiede il motivo. Nulla viene cancellato: il pacco resta nello storico come RETURNED e il codice dell'armadietto viene cancellato. Un pacco già chiuso risponde 409. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Restituisci al mittente il pacco di Maria: rifiutato."

#remove_parcel_photo

Chiede conferma

Rimuovere una foto. Il file viene cancellato definitivamente. Alla prima chiamata restituisce il riepilogo e il codice di conferma. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Rimuovi la seconda foto del pacco; mostra l'indirizzo."

#discard_parcel

Modifica

Scartare. Per quello che nessuno ha ritirato. Richiede il motivo. Nulla viene cancellato: resta come DISCARDED nello storico, e reopen_parcel lo annulla. Non chiede conferma, perché è reversibile. Ruolo minimo: amministratore (proprietario o amministratore).

Chiedi così: "Scarta il pacco di Maria: scaduto senza ritiro."

#reopen_parcel

Modifica

Riaprire. Annulla un ritiro, una restituzione o uno scarto fatti per errore: torna a RECEIVED, con il motivo. Il codice cancellato non torna; impostane un altro con update_parcel. Ruolo minimo: amministratore (proprietario o amministratore).

Chiedi così: "Riapri il pacco di Maria: il ritiro è stato segnato per errore."

#delete_parcel

Chiede conferma

Eliminare un registro fatto per errore. Esce dagli elenchi e le foto vengono cancellate; il registro conserva chi e perché. Per chiudere davvero un pacco, usa mark_parcel_picked_up, return_parcel o discard_parcel. Alla prima chiamata restituisce il riepilogo e il codice di conferma. Ruolo minimo: amministratore (proprietario o amministratore).

Chiedi così: "Elimina il registro del pacco di Giovanni: l'ho registrato per la persona sbagliata."

#Correlati

• Pacchi
• Strumenti
• Denaro e conferma
• Ricette