Strumenti · Aziende residenti

Le Aziende residenti con l'assistente: registrare l'azienda con il contratto, modificare, chiudere, vedere la tua azienda, il team, invitare via e-mail, seguire, accettare e rifiutare inviti, segnare l'admin dell'azienda e rimuovere. Sono 14 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

I ruoli sono quelli delle rotte: l'assistente non fa mai più di quanto la persona collegata farebbe sullo schermo. Il proprietario e l'admin vedono tutti e 14; il moderatore e la finanza, 10 (i due di lettura del team della community e gli otto aperti a qualsiasi ruolo); il membro, 8 (get_my_resident_company, list_resident_company_members, invite_resident_company_member, remove_resident_company_member, list_resident_company_invitations, list_my_company_invitations, accept_company_invitation e decline_company_invitation).

Otto strumenti compaiono per qualsiasi ruolo perché l'admin di un'azienda di solito è un membro comune, e chiunque può ricevere un invito. L'API decide in base al legame: il team lo legge solo il team della community o le persone dell'azienda stessa, e invitano e rimuovono solo il proprietario, l'admin o l'admin di quell'azienda (finché è attiva). Gli altri ricevono "nessun permesso".

L'invito dell'admin dell'azienda dipende dall'accettazione. Non collega mai subito, nemmeno chi è già nella community: la persona riceve l'invito via e-mail ed entra nel team solo quando accetta (accept_company_invitation). Il proprietario e l'admin della community continuano a collegare direttamente.

Il contratto resta alla gestione. Il valore mensile e le date arrivano al proprietario, all'admin e alla finanza; il moderatore legge le aziende senza quelle chiavi, e get_my_resident_company non le restituisce mai. Il valore mensile è una registrazione, senza addebito.

Uscire dal team sospende l'addebito. Quando rimuovi qualcuno o chiudi l'azienda con il team, il riepilogo avvisa che l'addebito alla persona rimossa viene sospeso; l'abbonamento resta registrato finché non viene annullato, cosa che si fa in Abbonamenti.

#list_resident_companies

Solo lettura

Le aziende residenti, per nome, con il tipo di residenza, lo stato (active, o ended quando chiusa o con l'uscita nel passato) e quante persone ci sono nel team. Le aziende non sono membri e non compaiono mai negli elenchi dei membri. Il proprietario, l'admin e la finanza ricevono anche il contratto (valore mensile, inizio, uscita e data di chiusura); il moderatore no. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Quali aziende sono residenti oggi?"

#get_resident_company

Solo lettura

Un'azienda. Con il contratto per il proprietario, l'admin e la finanza. Azienda di un'altra community: "non trovata". L'admin di un'azienda usa get_my_resident_company. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Fino a quando dura il contratto di Acme?"

#get_my_resident_company

Solo lettura

La tua azienda. L'azienda in cui è la persona collegata (senza il contratto), se è admin dell'azienda, il team e canManageTeam, vero per l'admin di un'azienda attiva (falso dopo la chiusura). Senza azienda, restituisce company: null; gli inviti in sospeso sono in list_my_company_invitations. Ruolo minimo: qualsiasi.

Nessun parametro.

Chiedi così: "Chi c'è nella mia azienda?"

#create_resident_company

Modifica

Registrare un'azienda con il contratto. L'azienda non ha un accesso proprio; le persone entrano con invite_resident_company_member. Ruolo minimo: admin (proprietario o admin).

Chiedi così: "Registra Acme Tecnologia, ufficio privato, R$ 4.800 al mese, dal 1/11."

#update_resident_company

Modifica

Modificare. Solo ciò che invii: nome, tipo, valore, inizio o uscita (ends_at: null cancella l'uscita). Per chiudere adesso, usa close_resident_company. Ruolo minimo: admin (proprietario o admin).

Chiedi così: "Acme esce il 31/12. Aggiorna il contratto."

#close_resident_company

Chiede conferma

Chiudere la residenza adesso. L'azienda smette di accettare inviti; l'anagrafica e il contratto restano registrati. Non c'è riapertura. Con remove_members (predefinito: vero), tutti escono dal team, e chi è entrato nella community tramite l'azienda ed è ancora membro esce anche dalla community. Il riepilogo elenca chi esce e avvisa che il loro addebito viene sospeso e l'abbonamento resta registrato finché non viene annullato. Azienda già chiusa: rifiutato. La prima chiamata restituisce il riepilogo e il codice di conferma. Ruolo minimo: admin (proprietario o admin).

Chiedi così: "Chiudi Acme e togli il suo team."

#list_resident_company_members

Solo lettura

Il team di un'azienda, con gli admin per primi: nome, ruolo lavorativo, se è admin dell'azienda, se è entrato tramite l'azienda e, per il team della community e l'admin dell'azienda, l'e-mail. Lo leggono il team della community o le persone dell'azienda stessa. Ruolo minimo: qualsiasi (l'API verifica il legame).

Chiedi così: "Mostrami il team di Acme."

#invite_resident_company_member

Modifica

Aggiungere al team via e-mail. Dal proprietario o admin, collega subito: chi è già nella community riceve solo il legame, senza e-mail (linked); chi non c'è entra nella community come membro e riceve l'invito via e-mail (invited): l'assistente lo dice prima. Dall'admin dell'azienda, non collega mai: la risposta è sempre invited con pending: true e l'invitation_id, chiunque sia la persona, e l'assistente dice "Invito inviato. La persona entra nel team quando accetta.", senza affermare se era già nella community. Rifiutato se la community non accetta nuovi membri, se la persona ha chiesto di non partecipare, se è già in questo team o se l'azienda è chiusa; per il proprietario e l'admin, anche se è già in un'altra azienda. Invitano il proprietario, l'admin e l'admin di quell'azienda (finché è attiva); is_admin solo il proprietario e l'admin. L'admin dell'azienda invia fino a 30 inviti all'ora (oltre, 429 con Retry-After); il proprietario e l'admin non hanno questo limite. Ruolo minimo: qualsiasi (l'API verifica il legame).

Chiedi così: "Invita [email protected] nel team della mia azienda."

#update_resident_company_member

Modifica

Segnare o togliere l'admin dell'azienda. L'admin dell'azienda invita e rimuove il proprio team. Ruolo minimo: admin (proprietario o admin).

Chiedi così: "Rendi Maria admin di Acme."

#remove_resident_company_member

Chiede conferma

Togliere qualcuno dal team. Se la persona è entrata nella community tramite l'azienda ed è ancora membro, esce anche dalla community e perde l'accesso; se era già nella community, perde solo il legame. Il riepilogo dice quale dei due e avvisa che l'addebito alla persona rimossa viene sospeso e l'abbonamento resta registrato finché non viene annullato. Rimuovono il proprietario, l'admin e l'admin di quell'azienda (finché è attiva). La prima chiamata restituisce il riepilogo e il codice di conferma. Ruolo minimo: qualsiasi (l'API verifica il legame).

Chiedi così: "Togli João dal team di Acme; ha lasciato l'azienda."

#list_resident_company_invitations

Solo lettura

Gli inviti in sospeso dell'azienda: quelli che l'admin dell'azienda ha inviato e a cui nessuno ha risposto, dal più recente, con l'e-mail digitata e la data. Non dice mai chi è la persona né se era già nella community. Gli inviti del proprietario e dell'admin collegano subito e non compaiono qui. Lo leggono il team della community e l'admin di quell'azienda finché è attiva. Ruolo minimo: qualsiasi (l'API verifica il legame).

Chiedi così: "Chi ho invitato nella mia azienda e non ha ancora accettato?"

#list_my_company_invitations

Solo lettura

I tuoi inviti. Gli inviti in sospeso della persona collegata per entrare in un team ("sei stato invitato nell'azienda X"), dal più recente, con l'azienda, chi ha invitato e la data. Solo aziende attive di questa community; senza inviti, elenco vuoto. Ruolo minimo: qualsiasi.

Nessun parametro.

Chiedi così: "Ho qualche invito aziendale?"

#accept_company_invitation

Modifica

Accettare il tuo invito. La persona entra nel team (non come admin dell'azienda). Non chiede conferma. Invito di un'altra persona, già risposto o di un'altra community: "non trovato". Azienda chiusa dopo l'invito, o persona già nel team di un'altra azienda: rifiutato, con il messaggio dell'API. Ruolo minimo: qualsiasi (il proprio invito).

Chiedi così: "Accetta l'invito di Acme."

#decline_company_invitation

Chiede conferma

Rifiutare il tuo invito. Nessun legame viene creato e l'invito sparisce per sempre: per entrare in seguito serve un nuovo invito. La prima chiamata restituisce il riepilogo e il codice di conferma. Ruolo minimo: qualsiasi (il proprio invito).

Chiedi così: "Rifiuta l'invito di Acme."

#Ricette suggerite

• Registrare un'azienda: registrare l'azienda (create_resident_company), invitare chi se ne occuperà (invite_resident_company_member) e segnarla come admin dell'azienda (update_resident_company_member, o is_admin già nell'invito).
• L'admin invita e la persona accetta: l'admin dell'azienda invita il collega (invite_resident_company_member) e lo segue in list_resident_company_invitations; il collega vede l'invito (list_my_company_invitations) e lo accetta (accept_company_invitation).

#Correlati

• Aziende residenti
• Strumenti
• Strumenti · Membri
• Denaro e conferma
• Ricette