Organization
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.
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:
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.
Profile
Manage your personal e-bon account from the Portal — display name, phone number, the read-only email and role badge, and how to change your password.
Installing on Android
Install the E-BON Android app, sign in with your Portal account, grant the Bluetooth and location permissions needed for fiscal printers, and take the first-launch tour.