Tools · Ansässige Unternehmen

Die ansässigen Unternehmen mit dem Assistenten: das Unternehmen mit Vertrag anlegen, bearbeiten, abschließen, dein Unternehmen sehen, das Team, per E-Mail einladen, Einladungen verfolgen, annehmen und ablehnen, den Unternehmens-Admin markieren und entfernen. Es sind 14 Tools.

Jedes Tool hat ein Abzeichen: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.

#Auf einen Blick

Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person auf dem Bildschirm tun könnte. Eigentümer und Administrator sehen alle 14; Moderator und Finanzen 10 (die zwei Lese-Tools des Community-Teams und die acht, die jeder Rolle offenstehen); das Mitglied 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 und decline_company_invitation).

Acht Tools erscheinen für jede Rolle, weil der Admin eines Unternehmens meist ein normales Mitglied ist und jede Person eine Einladung bekommen kann. Die API entscheidet nach der Zugehörigkeit: Das Team lesen nur das Community-Team oder die Leute des eigenen Unternehmens, und einladen und entfernen dürfen nur Eigentümer, Administrator oder der Admin dieses Unternehmens (solange es aktiv ist). Alle anderen erhalten „keine Berechtigung“.

Die Einladung des Unternehmens-Admins hängt von der Annahme ab. Sie verbindet nie sofort, auch nicht, wer schon in der Community ist: Die Person erhält die Einladung per E-Mail und kommt erst ins Team, wenn sie annimmt (accept_company_invitation). Eigentümer und Administrator der Community verbinden weiterhin direkt.

Der Vertrag bleibt bei der Verwaltung. Monatlicher Betrag und Daten gehen an Eigentümer, Administrator und Finanzen; der Moderator liest die Unternehmen ohne diese Felder, und get_my_resident_company liefert sie nie. Der monatliche Betrag ist nur ein Eintrag, ohne Abrechnung.

Wer das Team verlässt, wird nicht mehr abgerechnet. Beim Entfernen oder beim Abschließen mit Team weist die Zusammenfassung darauf hin, dass die Abrechnung für die entfernte Person ausgesetzt wird; das Abo bleibt erfasst, bis es gekündigt wird, was unter Abonnements geht.

#list_resident_companies

Nur lesen

Die ansässigen Unternehmen, nach Namen, mit Art der Nutzung, Status (active, oder ended, wenn abgeschlossen oder der Auszug vorbei ist) und wie viele Personen im Team sind. Unternehmen sind keine Mitglieder und erscheinen nie in Mitgliederlisten. Eigentümer, Administrator und Finanzen erhalten auch den Vertrag (monatlicher Betrag, Beginn, Auszug und Abschlussdatum); der Moderator nicht. Mindestrolle: Moderator (oder Finanzen).

Frag so: „Welche Unternehmen sind heute ansässig?“

#get_resident_company

Nur lesen

Ein Unternehmen. Mit Vertrag für Eigentümer, Administrator und Finanzen. Unternehmen einer anderen Community: „nicht gefunden“. Der Admin eines Unternehmens nutzt get_my_resident_company. Mindestrolle: Moderator (oder Finanzen).

Frag so: „Bis wann läuft der Vertrag von Acme?“

#get_my_resident_company

Nur lesen

Dein Unternehmen. Das Unternehmen, in dem die verbundene Person ist (ohne Vertrag), ob sie Unternehmens-Admin ist, das Team und canManageTeam, wahr für den Admin eines aktiven Unternehmens (falsch nach dem Abschluss). Ohne Unternehmen kommt company: null zurück; offene Einladungen stehen in list_my_company_invitations. Mindestrolle: alle.

Keine Parameter.

Frag so: „Wer ist in meinem Unternehmen?“

#create_resident_company

Ändert

Ein Unternehmen anlegen, mit Vertrag. Das Unternehmen bekommt keinen Login; Personen kommen mit invite_resident_company_member dazu. Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Lege Acme Tecnologia an, privates Büro, R$ 4.800 im Monat, seit 1.11.“

#update_resident_company

Ändert

Bearbeiten. Nur, was du schickst: Name, Art, Betrag, Beginn oder Auszug (ends_at: null löscht den Auszug). Zum sofortigen Abschließen nutze close_resident_company. Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Acme zieht am 31.12. aus. Aktualisiere den Vertrag.“

#close_resident_company

Mit Bestätigung

Die Residenz jetzt beenden. Das Unternehmen nimmt keine Einladungen mehr an; Eintrag und Vertrag bleiben gespeichert. Es gibt kein Wiedereröffnen. Mit remove_members (Standard: wahr) verlassen alle das Team, und wer über das Unternehmen in die Community kam und noch Mitglied ist, verlässt auch die Community. Die Zusammenfassung nennt, wer geht, und weist darauf hin, dass ihre Abrechnung ausgesetzt wird und das Abo erfasst bleibt, bis es gekündigt wird. Schon abgeschlossenes Unternehmen: abgelehnt. Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Schließe Acme ab und nimm das Team heraus.“

#list_resident_company_members

Nur lesen

Das Team eines Unternehmens, Admins zuerst: Name, Position, ob Unternehmens-Admin, ob über das Unternehmen beigetreten und, für das Community-Team und den Unternehmens-Admin, die E-Mail. Lesen dürfen das Community-Team oder die Leute des eigenen Unternehmens. Mindestrolle: alle (die API prüft die Zugehörigkeit).

Frag so: „Zeig mir das Team von Acme.“

#invite_resident_company_member

Ändert

Per E-Mail ins Team aufnehmen. Durch Eigentümer oder Administrator verbindet es sofort: Wer schon in der Community ist, bekommt nur die Verbindung, ohne E-Mail (linked); alle anderen kommen als Mitglied in die Community und erhalten die Einladung per E-Mail (invited): Der Assistent sagt das vorher. Durch den Unternehmens-Admin verbindet es nie: Die Antwort ist immer invited mit pending: true und der invitation_id, egal wer die Person ist, und der Assistent sagt „Einladung gesendet. Die Person kommt ins Team, sobald sie annimmt.“, ohne zu behaupten, ob sie schon in der Community war. Abgelehnt, wenn die Community keine neuen Mitglieder aufnimmt, die Person nicht teilnehmen möchte, schon in diesem Team ist oder das Unternehmen abgeschlossen ist; bei Eigentümer und Administrator auch, wenn sie schon in einem anderen Unternehmen ist. Einladen dürfen Eigentümer, Administrator und der Admin dieses Unternehmens (solange es aktiv ist); is_admin nur Eigentümer und Administrator. Der Unternehmens-Admin verschickt bis zu 30 Einladungen pro Stunde (darüber 429 mit Retry-After); Eigentümer und Administrator haben kein solches Limit. Mindestrolle: alle (die API prüft die Zugehörigkeit).

Frag so: „Lade [email protected] ins Team meines Unternehmens ein.“

#update_resident_company_member

Ändert

Den Unternehmens-Admin markieren oder die Markierung zurücknehmen. Der Unternehmens-Admin lädt sein eigenes Team ein und entfernt es. Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Mach Maria zur Admin von Acme.“

#remove_resident_company_member

Mit Bestätigung

Jemanden aus dem Team nehmen. Kam die Person über das Unternehmen in die Community und ist noch Mitglied, verlässt sie auch die Community und verliert den Zugang; war sie schon in der Community, verliert sie nur die Verbindung. Die Zusammenfassung sagt, welcher Fall vorliegt, und weist darauf hin, dass die Abrechnung für die entfernte Person ausgesetzt wird und das Abo erfasst bleibt, bis es gekündigt wird. Entfernen dürfen Eigentümer, Administrator und der Admin dieses Unternehmens (solange es aktiv ist). Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. Mindestrolle: alle (die API prüft die Zugehörigkeit).

Frag so: „Nimm João aus dem Team von Acme; er hat das Unternehmen verlassen.“

#list_resident_company_invitations

Nur lesen

Die offenen Einladungen des Unternehmens: die der Unternehmens-Admin geschickt hat und auf die noch niemand geantwortet hat, die neuesten zuerst, mit der eingegebenen E-Mail und dem Datum. Sie sagt nie, wer die Person ist oder ob sie schon in der Community war. Einladungen von Eigentümer und Administrator verbinden sofort und erscheinen hier nicht. Lesen dürfen das Community-Team und der Admin dieses Unternehmens, solange es aktiv ist. Mindestrolle: alle (die API prüft die Zugehörigkeit).

Frag so: „Wen habe ich in mein Unternehmen eingeladen, der noch nicht angenommen hat?“

#list_my_company_invitations

Nur lesen

Deine Einladungen. Die offenen Einladungen der verbundenen Person in ein Team („du wurdest in das Unternehmen X eingeladen“), die neuesten zuerst, mit Unternehmen, einladender Person und Datum. Nur aktive Unternehmen dieser Community; ohne Einladungen eine leere Liste. Mindestrolle: alle.

Keine Parameter.

Frag so: „Habe ich eine Unternehmenseinladung?“

#accept_company_invitation

Ändert

Deine Einladung annehmen. Die Person kommt ins Team (nicht als Unternehmens-Admin). Ohne Bestätigung. Einladung einer anderen Person, schon beantwortet oder aus einer anderen Community: „nicht gefunden“. Unternehmen nach der Einladung abgeschlossen oder Person schon im Team eines anderen Unternehmens: abgelehnt, mit der Meldung der API. Mindestrolle: alle (die eigene Einladung).

Frag so: „Nimm die Einladung von Acme an.“

#decline_company_invitation

Mit Bestätigung

Deine Einladung ablehnen. Es entsteht keine Verbindung, und die Einladung ist endgültig weg: Um später beizutreten, braucht es eine neue Einladung. Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. Mindestrolle: alle (die eigene Einladung).

Frag so: „Lehne die Einladung von Acme ab.“

#Vorgeschlagene Rezepte

• Ein Unternehmen anlegen: das Unternehmen anlegen (create_resident_company), die Person einladen, die sich darum kümmert (invite_resident_company_member), und sie als Unternehmens-Admin markieren (update_resident_company_member, oder is_admin gleich in der Einladung).
• Der Admin lädt ein, die Person nimmt an: Der Unternehmens-Admin lädt die Kollegin oder den Kollegen ein (invite_resident_company_member) und verfolgt das in list_resident_company_invitations; die eingeladene Person sieht die Einladung (list_my_company_invitations) und nimmt sie an (accept_company_invitation).

#Verwandt

• Ansässige Unternehmen
• Tools
• Tools · Mitglieder
• Geld und Bestätigung
• Rezepte