Tools · Unternehmen

Die Unternehmen mit dem Assistenten: das Unternehmen anlegen (und im Coworking Art, die Pläne und Produkte, die es buchen kann, die Rechnungsdaten und die Daten), 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.

Bis zum 2026-10-18 hießen diese Tools *_resident_company* (zum Beispiel get_my_resident_company). Die alten Namen gibt es nicht mehr: Ein Assistent, der sie noch aufruft, bekommt „unbekanntes Tool“ und sollte die Namen dieser Seite verwenden.

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_company, list_company_members, invite_company_member, remove_company_member, list_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 Coworking-Block bleibt bei der Verwaltung. Art der Nutzung, Daten, Angebote (offers), Rechnungsdaten (billing) und der Kauflink (purchaseLink) gehen an Eigentümer, Administrator und Finanzen; der Moderator erfährt nur, ob das Unternehmen Coworking hat (coworking). get_my_company liefert die Angebote und den Link an das ganze Team, die Abrechnung nur an den Unternehmens-Admin.

Das Unternehmen abonniert und zahlt, aber nicht über den Assistenten. Angebote und Rechnungsdaten einzutragen kostet nichts. Kaufen tut der Unternehmens-Admin, in der App, über den purchaseLink (der Assistent nimmt nie eine Karte an): Der Assistent gibt den Link weiter. Danach kümmert sich der Unternehmens-Admin mit den Tools unter Abonnements um die Abrechnung (list_my_subscriptions und list_my_purchases mit company_id, pay_my_subscription_now, quote_my_add_on und add_my_add_on, quote_plan_change und change_my_plan, manage_my_subscription), per PIX oder Boleto, und liest das Credit-Guthaben unter Credits (get_company_credit_balance, list_company_credit_entries).

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_companies

Nur lesen

Die Unternehmen, nach Namen, mit coworking (ob der Coworking-Block eingeschaltet ist), Status (active, oder ended, wenn abgeschlossen oder der geplante 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 Block (Art der Nutzung, Beginn und Auszug), das Abschlussdatum, die Angebote, die Rechnungsdaten und den purchaseLink, alles leer bei ausgeschaltetem Coworking; der Moderator erhält nur coworking. Mindestrolle: Moderator (oder Finanzen).

Frag so: „Welche Unternehmen sind heute aktiv?“

#get_company

Nur lesen

Ein Unternehmen. Mit Coworking-Block, Angeboten, Rechnungsdaten und purchaseLink für Eigentümer, Administrator und Finanzen, die auch die Abonnements des Unternehmens (subscriptions) und den Stand des Credit-Guthabens (credit_balance) erhalten; die Käufe des Unternehmens stehen in list_purchases (buyer.companyId). Der Moderator erhält nur coworking. Unternehmen einer anderen Community: „nicht gefunden“. Der Admin eines Unternehmens nutzt get_my_company. Mindestrolle: Moderator (oder Finanzen).

Frag so: „Ist Acme mit dem Plan auf dem Laufenden? Wie viele Credits hat das Unternehmen?“

#get_my_company

Nur lesen

Dein Unternehmen. Das Unternehmen, in dem die verbundene Person ist ob sie Unternehmens-Admin ist, das Team und canManageTeam, wahr für den Admin eines aktiven Unternehmens (falsch nach dem Abschluss), dazu die Angebote, canPurchase und purchaseLink. Für jede Person im Team eines aktiven Unternehmens liefert es benefits: was sie über das Unternehmen hat, ohne Preise. In items die aktiven Pläne und Produkte des Unternehmens (aktives Abonnement oder aktiver Kauf: title, isPlan, kind, source, plan) mit den spaces und contents, die jedes freischaltet; in credits der Stand des Guthabens (balance) und der nächste Verfall (expiringSoon). Bei einem abgeschlossenen Unternehmen ist benefits null. Für den Unternehmens-Admin auch die Rechnungsdaten (billing), die Abonnements (subscriptions, mit der offenen Verlängerung), die Käufe (purchases) und den Credit-Stand (credit_balance); bei einem überfälligen Abonnement ist der vorgeschlagene nächste Schritt pay_my_subscription_now. Ohne Unternehmen kommt company: null zurück; offene Einladungen stehen in list_my_company_invitations. Mindestrolle: alle.

Keine Parameter.

Frag so: „Was habe ich über mein Unternehmen?“ · „Wer ist in meinem Unternehmen?“ · „Ist das Abonnement meines Unternehmens bezahlt?“

#create_company

Ändert

Ein Unternehmen anlegen. Nur der Name ist Pflicht: Ohne die Coworking-Felder ist das Unternehmen nur Name und Team. Im Coworking-Block listet offer_product_ids die Pläne und Produkte, die das Unternehmen buchen kann (nur digitale Produkte), und billing die Rechnungsdaten. Hier wird nichts abgerechnet und nicht nach Bestätigung gefragt: Die Antwort enthält den purchaseLink, die Seite, auf der der Unternehmens-Admin bucht, und der Assistent gibt den Link weiter. Produkt einer anderen Community: „nicht gefunden“; Produkt, das nicht digital ist: abgelehnt. Das Unternehmen bekommt keinen Login; Personen kommen mit invite_company_member dazu. Mit parcel_notice_admins_only erhalten nur die Admins des Unternehmens den Hinweis auf ein Paket (Voreinstellung: alle Mitarbeitenden mit Zugriff auf den Bereich). Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Lege Acme Tecnologia im Coworking an, privates Büro, seit 1.11., mit dem Plan Privates Büro monatlich zum Buchen. Firmenname Acme Tecnologia Ltda, Rechnungs-E-Mail [email protected].“ · „Lege das Unternehmen Steuerbüro Silva an.“

#update_company

Ändert

Bearbeiten. Nur, was du schickst: Name, coworking, Art, Angebote, Rechnungsdaten, Beginn oder Auszug. Die gesendete Liste offer_product_ids ersetzt die vorherige ([] oder null leert sie). null löscht ein Feld des Blocks; ein ausgefülltes Feld schaltet Coworking ein; coworking: false schaltet es aus und löscht den ganzen Block. Zum sofortigen Abschließen nutze close_company. Mindestrolle: Administrator (Eigentümer oder Administrator).

Frag so: „Acme zieht am 31.12. aus. Aktualisiere den geplanten Auszug.“ · „Bei Acme nur die Admins informieren, wenn ein Paket ankommt.“

#close_company

Mit Bestätigung

Das Unternehmen jetzt abschließen. Das Unternehmen nimmt keine Einladungen mehr an, gibt dem Team keinen Zugang mehr und wird nicht mehr abgerechnet; Eintrag und Coworking-Block 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_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_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_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_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_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 mit den Angeboten anlegen (create_company), den purchaseLink weitergeben, die Person einladen, die sich darum kümmert (invite_company_member), und sie als Unternehmens-Admin markieren (update_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_company_member) und verfolgt das in list_company_invitations; die eingeladene Person sieht die Einladung (list_my_company_invitations) und nimmt sie an (accept_company_invitation).
• Was ich über das Unternehmen habe: Jede Person im Team fragt, und der Assistent antwortet mit benefits aus get_my_company (Pläne, Inhalte und Credits des Unternehmens, ohne Preise).

#Verwandt

• Unternehmen
• Tools
• Tools · Mitglieder
• Werkzeuge · Abonnements
• Werkzeuge · Credits
• Geld und Bestätigung
• Rezepte