/bff/organisation/profile

Organisation about text / profile description. Shown in admin organisation lists. Optional free-form text for internal reference.

Visual emoji icon for the organisation. Displayed next to the org name in account details, org switcher, and terminal output. If not set manually, the system auto-generates one using AI based on the org configuration.

Czech company registration number (IČO). Printed on invoices and receipts as "IČO: {value}". Used for ARES address lookup, Firmy.cz feed integration, and invoice export data for accounting.

Tax identification number (DIČ). Printed on invoices and receipts as "DIČ: {value}". Used for address lookup validation and included in invoice exports for accounting software.

Organisation logo URL displayed in the header of all outgoing email templates. Rendered as an tag in the default email layout. If not set, the logo section is hidden. Also shown in the account organisation list for the logged-in user.

Organisation logo URL optimized for print use (invoices, receipts, contracts, PDF documents). If not set, the standard logoUrl is used as fallback when generating print documents.

Primary brand hex color of the organisation (e.g. "#1a2b3c"). Used for branding customization. Must be a valid 3 or 6 digit hex color with leading #.

Secondary brand hex color of the organisation (e.g. "#f0f0f0"). Used for branding customization. Must be a valid 3 or 6 digit hex color with leading #.

Default "From" email address for all transactional emails: order confirmations, calendar event notifications, account registration, password resets, member invitations, credit/voucher notifications, and system alerts. If not configured, falls back to the organisation's internal contact email, then to "info@brj.cz".

Override "From" email address used only for newsletter and marketing bulk emails. Allows separating marketing sender identity from transactional emails (different IP reputation, branding). If not set, marketing emails use the transactional supportEmail instead.

Custom HTML footer appended to the bottom of all outgoing emails (transactional, marketing, newsletters). Typically contains company info, legal disclaimers, and unsubscribe links. If not set, a default footer is auto-generated with the organisation name.

Custom HTML email template wrapper using Handlebars syntax. Wraps all outgoing email content. Supported variables: {{ htmlBody }} (email content), {{ logoUrl }} (org logo), {{ footer }} (footer HTML). Supports conditionals: {{ if logoUrl }}…{{ /if }}. If not set, uses the built-in default template with logo header, content area, and footer.

SMTP server hostname for transactional email delivery (e.g. "smtp.gmail.com"). Required to enable any email sending. Without SMTP configured, the organisation cannot send emails. Validated by sending a test email during initial setup via /bff/emailer/setup-smtp.

SMTP server port. Use "587" for STARTTLS (recommended) or "465" for implicit SSL. Port 465 enables secure: true in the SMTP connection; all other ports use STARTTLS upgrade.

SMTP authentication username for transactional email delivery. Usually the email address itself (e.g. "info@example.com").

Separate SMTP server for newsletter and marketing bulk emails. Allows using a dedicated email service (SendGrid, Mailchimp SMTP, etc.) with different rate limits and IP reputation. If not configured, marketing emails fall back to the transactional SMTP above.

SMTP port for marketing email server. Same port logic as transactional: "587" for STARTTLS, "465" for SSL.

SMTP authentication username for marketing email server.

URL where users are redirected after clicking the newsletter subscription confirmation link. For example "/newsletter-thanks" or a specific blog post. If not set, no redirect happens and the API just returns a success response.

sms-sluzba.cz account login (username). Required together with the password for outgoing SMS via the apixml30 gateway.

Optional default sender label (numeric msisdn or alphanumeric brand) attached to outgoing SMS when the caller does not pass one explicitly.

Comma-separated email addresses that receive BCC copies of all order status notification emails. Internal team members listed here get notified whenever an order changes status (new, paid, shipped, cancelled, etc.). Emails are deduplicated and validated before sending.

Default refund strategy when an order is cancelled (storno). "credit" = money returned as store account credit (default). "cash" = triggers credit note generation and manual bank transfer refund. "none" = no refund issued. Can be overridden per individual storno request.

Controls automatic credit note generation during cash refunds. "auto" or "always" = credit note (tax document) is auto-generated with storno items linked to the original invoice. "never" = skips credit note, requires manual accounting. Only applies when refund strategy is "cash" and the order was paid. Defaults to "auto".

Comma-separated email addresses that receive system error alert emails. Added as BCC on: (1) Daily log report — aggregated CRITICAL/ERROR/WARNING logs from the past 24 hours grouped by severity; (2) Individual critical error notifications triggered in real-time. Separate from order notification emails.

Number of days between automatic digest sends. The cron job checks: if (now - lastSentDate) >= intervalDays, send a new digest. Defaults to 14 days if not set. The timer resets even if no posts are found or no subscribers exist, to prevent retry storms.

ISO 8601 timestamp of the last digest send attempt. Managed automatically by the system — updated after each run (whether successful, no posts found, or no subscribers). Can be manually cleared to force an immediate next send. Read-only in the UI.

Email subject line template for digest newsletters. Supports Handlebars variables: {{ postCount }} (number of articles in this digest) and {{ intervalDays }} (configured interval). Default: "Nové články ({{ postCount }})" → renders as e.g. "Nové články (5)".

Custom HTML text inserted before the article list in the digest email body. Rendered as raw HTML without sanitization. Use for welcome messages, promotional text, or instructions. If empty, the email starts directly with the post list.

Override locale code (e.g. "cs", "en") for selecting which posts appear in the digest. Only posts in this locale are included. If not set, falls back to the organisation's primary locale. Useful for multilingual organisations that want to send Czech-only or English-only digests.

Maximum number of posts to include in a single digest email. Posts are selected by: starred first, then most recently updated. Defaults to 20 if not set. Controls email length — lower values keep digests concise.

Default expiration period for newly created customer account credit (e.g. from refunds or manual additions). Value in days (e.g. "365" for 1 year). Expired credit cannot be used for purchases. If not set, credit records are created without expiration. Applied automatically when credit is issued via storno refund or manual addition.

Email address of the organisation's own internal contact (shop__contact joined via internal_customer_id). Minted at org creation as a synthetic -org-<random>@ alias so it never collides with the founder's mailbox. Historically used as the fallback From/Reply-To for outgoing transactional mail — now superseded by adminContact.email for that role and kept only as a legal / accounting artefact (IČO/DIČ mirror). Read-only.