e-bon
e-bon.ro
Portal

Organization

Manage your e-bon organization from the Portal — company name, CUI/CIF, billing address, plan and locations. Restricted to Owner and Admin roles.

Organization

The Organization page is where the company that owns the e-bon account is configured: the legal name printed on receipts, the tax identification number registered with ANAF, the structured billing address Stripe stamps on every invoice, and the list of business locations under which devices are organised. It does not manage your subscription tier — for that see Billing & plans — and it does not manage individual user accounts (each member edits their own profile from Profile; roles are assigned at invitation time).

Open the Organization page

Open the Portal sidebar and choose Settings → Organization. The page lives at /portal/settings/organization and renders the SettingsOrganization component. The plan badge in the card header (Free / Pro / Enterprise) tells you at a glance which subscription tier the org is on.

Reading this page is open to every authenticated member, but writing — saving the company details, adding, editing or deleting a location — is restricted to the Owner and Admin roles. The same gate is enforced server-side: PATCH /api/v1/org, POST /api/v1/org/locations, PATCH /api/v1/org/locations/{id} and DELETE /api/v1/org/locations/{id} all return 403 Forbidden for the Operator role. If the Save changes button or the Add Location button refuses your changes, ask your organization owner to grant you the right role.

Edit company details

The first card on the page edits the organization record. Five fields are surfaced:

  • Company Name — required. The legal name of the business (placeholder “S.C. Company S.R.L.”). This is what appears on invoices and on every receipt header. The Save changes button is disabled while it is empty and a “Required” error shows on blur.
  • Tax ID (CUI / CIF) — read-only. Set when the organization is registered and cannot be changed from the Portal. The hint “Tax identification number cannot be changed.” sits under the field — if the wrong CUI was entered at registration, contact support.
  • Billing address — a structured group, not a free-form text field. Five sub-fields: Country (a dropdown — currently România is the only option), State / County, City, Postal code and Street address (placeholder “10 Victory St., Bl. A, Sc. 1, Ap. 5”). The address is sent to Stripe at checkout time and printed on every invoice; for a backward-compatible read the API also accepts a legacy single-string address, but every save from this page writes the structured form.

Click Save changes to persist. The form is incremental — the billing address block is only sent when at least one of its sub-fields has a value, which means clearing every cell removes the address rather than overwriting Stripe with empty strings. A success banner “Organization updated successfully.” appears at the top of the card on a 200; a red error banner with a Retry button shows on failure.

Manage locations

The second card on the page is the full Locations CRUD. A location is a physical site (a shop, a warehouse, a counter, a branch) that owns one or more devices — every device on the account is assigned to exactly one location, and reports can be filtered by it. The card lists every location for the org with its name, address and a small badge showing the number of devices currently assigned (when there are any).

When the org has no locations the empty state takes over: an icon, the headline “No locations yet”, the line “Add your first business location to organize your devices.” and a primary Add Location button.

Add a location

Click Add Location

The button sits at the top right of the Locations card (it also appears in the centre of the empty state). It opens the Add Location modal.

Enter the name

A short label such as “Main Store”, “Warehouse — Pipera” or “Counter 2”. Required: the Create button stays disabled while the field is empty.

Pick the address

The Address field is an autocomplete (placeholder “Start typing an address…”). Start typing and pick a suggestion to fill the value, or finish typing manually if your address is not in the index. Required.

Click Create

The new location appears at the top of the list immediately. Devices can then be assigned to it from the Devices page.

Edit a location

Click the pencil icon on any row to open the Edit Location modal. Both the Name and Address fields are editable and required; the autocomplete behaves the same way as on create. Save persists the change in place — no row reorder, no list refresh.

Delete a location

Click the red trash icon on any row to open the Delete Location modal. The behaviour depends on whether the location has any devices assigned:

A location with devices cannot be deleted. The modal switches to a warning state — “Cannot delete this location — it has N device(s) assigned. Move or delete the devices first.” — with a shortcut button to the Devices page where you can reassign or remove them. Only the Cancel button is offered; the destructive action is not available until the location is empty. This guard is enforced both client-side (the warning) and server-side on DELETE /api/v1/org/locations/{id}.

When the location is empty the modal asks the standard “Are you sure you want to delete the location <name>? This action cannot be undone.” Click Delete to confirm. The row disappears immediately and the device-assignment slot is freed.

Continue exploring

  • Profile — your personal account, password, role badge.
  • Notifications — choose which email addresses receive automated notifications and which categories they receive.
  • Billing & plans — manage the organization’s subscription, see invoices and the renewal date.
  • API keys — credentials POS partners and external systems use to call the e-bon API.
  • Webhooks — real-time event push to your own systems.