Skip to main content

Company

Company (the legal entity) is the record every transaction belongs to. It carries the company’s name, logos and time zone, its addresses and contacts, and the switches that turn company-wide features on: file storage limits, barcode, messaging, the tax authority’s digital invoicing, online-shop links and AI.

Where
Organizational Structure › Enterprise Structure (OSLE)
Who uses it
The implementation consultant
When
Once per company, first thing after the client
Needs first
Client

What it is for​

Every document in Businessflo is saved against the company the user is signed in to. This screen creates that company and holds what is true of it as a whole.

When a new company is saved for the first time, the data formats marked as predefined in the company you are signed in to are copied to the new company (see Application Data Format).

The rule people get wrong: the SMTP fields on the Messaging tab do not send mail. Outgoing mail is set up on the server; filling those fields changes nothing.

Every field in plain words​

The barcode fields are explained on their own page, Legal Entity barcode switch.

General​

FieldWhat it meansWhat to put
Legal EntityThe company code. It is on every document the company saves.Required. Typed on New; locked afterwards.
NameThe company’s name.The registered name.
ClientThe client the company belongs to.Pick the client.
Time zoneThe company’s clock. The scheduler runs this company’s scheduled reports and jobs on this time zone; with none set, it uses another company’s zone, and then the server’s.Pick the time zone the company works in.
ImageThe company logo. Shown in the application and printed on the reports whose layout carries a logo.Upload an image.
Report ImageA second image for reports. Only the layouts that ask for it use it.Upload an image, or leave empty.
BannerA banner image.Nothing reads it today; it can stay empty.

Controlling​

FieldWhat it meansWhat to put
Hide Advertisement From ReportA switch shown on the screen.Nothing in the system reads it today: ticking it changes nothing.
Required Real Estate In JournalShows the real estate fields on a journal whose nature is construction in progress (CIP).Tick only if the company capitalises property under construction.
Required Company Name in Transactions ScreenShows the company name in the header of every entry screen.Tick when users work in several companies and must see which one they are in.
Company Storage Limit (MB)The space the company’s shared folders may use for files, in megabytes.A number. 0 means no limit. Personal folders count against each user’s own quota instead.
Barcode EnabledSee Legal Entity barcode switch.Tick or leave clear.
Default NomenclatureSee Legal Entity barcode switch.Optional.
Barcode PrefixSee Legal Entity barcode switch.Optional.

Messaging​

FieldWhat it meansWhat to put
Allowed Whatsapp IntegrationSwitches on WhatsApp messaging for the company.Tick, then fill the account fields below from the company’s WhatsApp Business account.
WABAIDThe WhatsApp Business account ID.From the WhatsApp Business account.
Phone Number IDThe ID of the sending phone number in that account.From the WhatsApp Business account.
Whatsapp Phone NumberThe sending phone number.The number, with country code.
Whatsapp Access TokenThe access token of the account.From the WhatsApp Business account.
Whatsapp Template NameThe approved message template for documents.The template name as approved in the account.
WhatsApp OTP TemplateThe approved template for one-time passwords.The template name as approved in the account.
WhatsApp Link TemplateThe approved template for signing links.The template name as approved in the account.
Allowed SMS IntegrationSwitches on text messages (SMS) for the company.Tick, then fill the gateway fields below.
SMS ProviderThe SMS gateway the company uses.Pick from the list.
SMS API URLThe gateway’s sending address.From the gateway provider.
SMS API KeyThe gateway account key.From the gateway provider. Shown masked.
SMS API SecretThe gateway account secret.From the gateway provider. Shown masked.
SMS Sender ID (Mask)The sender name (mask) the recipient sees.The mask registered with the telecom regulator, or empty to send from the gateway’s number.
OTP Message TemplateThe text of the one-time password message.Keep the company name in it: some networks show a number instead of the mask.
Signing Link Message TemplateThe text of the message that carries a signing link.Keep the company name in it.
Email AddressA mailbox address field.Nothing reads it. Outgoing mail is set on the server, not here.
Email PasswordA mailbox password field.Nothing reads it.
ServerA mail server field.Nothing reads it.
PortA mail port field.Nothing reads it.
Document Signing Base URLThe public web address used to build document signing links.The address where signers open their link.
OTP ChannelHow one-time passwords are sent.Pick from the list.
OTP Validity (Minutes)How long a one-time password stays valid.Minutes.
OTP Max AttemptsHow many wrong tries a one-time password allows.A number.
OTP Resend Cooldown (Seconds)How long a signer waits before asking for a new code.Seconds.
OTP Max Per HourHow many codes one signer may ask for in an hour.A number.
Signature Window After OTP (Minutes)How long after the code is entered the signature must be given.Minutes.
Signing Link Validity (Days)How long a signing link stays open.Days.
Receipt Link Validity (Days)How long the link to the signed receipt stays open.Days.

Integrations​

FieldWhat it meansWhat to put
DigitalizationSwitches on digital invoicing with the tax authority (FBR in Pakistan) for the company.Tick to start. With it on, Digitalization Token becomes required, Item in Legal Entity insists on an HS Code, and customer invoices in the local currency on a journal that allows it are sent to the authority.
Digitalization StatusWhether the link is in testing or live.Pick Testing or Live. Testing ticks Use Sandbox; Live clears it.
Digitalization Scenario IDThe test scenario the authority asks invoices to carry while testing.The scenario ID given by the authority.
Digitalization TokenThe access token issued by the authority.Required when Digitalization is ticked.
Integration Start FromThe first posting date that is sent to the authority.A date. Invoices posted earlier are not sent.
Allowed IntegrationSwitches on the link with an online shop (Shopify).Tick, then fill the store fields.
Webhooks SecretsThe secret the shop signs its notifications with.From the shop’s admin.
Store URLThe shop’s address.From the shop’s admin.
Access TokenThe shop’s access token.From the shop’s admin.
Allowed IntegrationSwitches on the link with a restaurant point-of-sale system (Syrve).Tick, then fill the fields below.
Base URLThe point-of-sale system’s address.From the provider.
User NameThe user the link signs in with.From the provider.
PasswordThat user’s password.From the provider.
Walking CustomerThe walk-in customer the point-of-sale sales are booked to.Pick a customer.
Invoice JournalThe journal the point-of-sale invoices are saved on.Pick a journal.
AccountThe ledger account used by the link.Pick an account.
NameThe account’s name.Fills itself.
Tax ZoneThe tax zone given to point-of-sale invoices.Pick a tax zone.
Tax GroupThe tax group given to point-of-sale invoices.Pick a tax group.
Collection JournalThe journal the point-of-sale collections are saved on.Pick a journal.
Payment TermThe payment term given to point-of-sale invoices.Pick a payment term.
Inventory UnitThe unit given to items created by the link.Pick a unit.
Item CategoryThe item category given to items created by the link.Pick a category.
Storage StructureThe storage structure given to items created by the link.Pick one.
Tracking StructureThe tracking structure given to items created by the link.Pick one.
Item PostingThe item posting profile given to items created by the link.Pick one.
Item ValuationThe valuation given to items created by the link.Pick one.
Integration Beep EnabledSwitches on a monitoring link (Integration Beep).Tick, then fill project and customer.
Integration Beep ProjectThe project in the monitoring service.From the service.
Integration Beep CustomerThe customer in the monitoring service.From the service.

AI Agents​

FieldWhat it meansWhat to put
Enable AISwitches the AI agents on for the company.Tick to allow screens to use AI; then list the tools and features below.
Claude API KeyThe company’s key for Claude (Anthropic).From the provider. Shown masked.
Claude Default ModelThe Claude model used when a feature names none.A model name from the provider.
GPT (OpenAI) API KeyThe company’s key for GPT (OpenAI).From the provider. Shown masked.
GPT Default ModelThe GPT model used when a feature names none.A model name.
Gemini API KeyThe company’s key for Gemini (Google).From the provider. Shown masked.
Gemini Default ModelThe Gemini model used when a feature names none.A model name.

AI tools (models) this company can use. Each line is one tool: a code, a provider and a model. Save refuses a line missing any of the three, and the same tool code twice.

ColumnWhat it meansWhat to put
AI ToolA short code for an AI tool the company may use (a provider and model pair).Optional.
AI Tool NameIts name.Optional.
ProviderThe provider.Optional. Pick from the list.
ModelThe model.Optional.

Which AI each feature uses. One line per feature; the same feature may not appear twice.

ColumnWhat it meansWhat to put
AI FeatureA feature of the application that uses AI.Optional. Pick from the list.
FeatureIts name; fills itself.Optional.
AI ToolA short code for an AI tool the company may use (a provider and model pair).Optional. Pick from the list.
AI Tool NameIts name.Optional.
Context / Instructions SentExtra instructions sent with every request of this feature.Optional.

Address​

Address tab. The company’s addresses. Save refuses a second Primary Address, or a second Primary For Country in the same country, and a Primary For Country line with no country.

ColumnWhat it meansWhat to put
Name of AddressA short name for the address, such as Head office.Required.
PurposeWhat the address is for (billing, delivery…). The list comes from Required Address Type on Organizational Structure Setting.Optional. Pick from the list.
PurposeOpens a small grid of further purposes for the address.Optional.
AddressThe address itself.Optional.
Country RegionThe country region.Optional. Pick from the Region list.
CountryThe country.Optional. Pick from the list.
StateThe state or province.Optional. Pick from the list.
CityThe city.Optional. Pick from the list.
PrivateMarks the address as private.Optional.
Primary For CountryThe company’s main address in that country. Only one per country.Optional.
Primary AddressThe company’s main address. Only one.Optional.
Applicant IDUsed only by the HR product.Optional.
Sales RegionThe sales region of the address.Optional. Pick from the Sales Region list.
Sales AreaThe sales area of the address.Optional. Pick from the Sales Area list.
Sales TerritoryThe sales territory of the address.Optional. Pick from the Sales Territory list.
Tax ZoneThe tax zone of the address.Optional. Pick from the Tax Zone list.
TimezoneThe time zone of the address.Optional. Pick from the list.
LatitudeMap position.Optional.
DistanceA distance noted for the address.Optional.
KilometerA distance in kilometres.Optional.
Expiration DateThe date the address stops being valid.Optional.
Effective FromThe date it starts.Optional.
LongitudeMap position.Optional.
PersonThe person at this address.Optional.
MobileMobile number.Optional.
PhonePhone number.Optional.
EmailEmail.Optional.

Contacts​

Contacts tab. Save refuses a line with no Contact Nature, and a second Primary for the same contact nature.

ColumnWhat it meansWhat to put
ProjectA project the contact belongs to.Optional.
PersonThe person.Required.
Contact NatureThe kind of contact (phone, email, mobile…). The list comes from Required Contact Type on Organizational Structure Setting.Optional. Pick from the list.
ContactThe number or address itself.Required.
ExtensionPhone extension.Optional.
PrimaryThe main contact of that kind. Only one per kind.Optional.
SiteThe site the contact belongs to.Optional.
Applicant IDUsed only by the HR product.Optional.

Authentication Control​

Authentication Control tab. Lists screens, with what must be confirmed and by whom.

ColumnWhat it meansWhat to put
ScreenA screen.Optional. Pick from the list.
Transaction NameIts name; fills itself.Optional.
Authentication Scope CodeWhat must be confirmed.Optional.
Authentication ScopeIts name.Optional. Pick from the list.
Authentication By CodeWho confirms.Optional.
Authentication ByIts name.Optional. Pick from the list.
User NameA user.Optional.
NameThe user’s name.Optional. Pick from the list.

How to configure it​

  1. Sign in to an existing company whose data formats you want copied, open Company and press New.
  2. Type the company code, press Create, then fill the name, client, time zone and logo.
  3. Add at least the head office on the Address tab and tick Primary Address.
  4. Leave the Integrations and AI tabs for later; switch each one on only when the company has the outside account it needs.
  5. Save. The predefined data formats of the company you are in are copied to the new one.

The Purpose list on the address grid and the Contact Nature list on the contacts grid come from Organizational Structure Setting.

Scenarios​

  • A group runs three companies on one installation and staff work in all three. Create each company here, and tick Required Company Name in Transactions Screen on each, so every entry screen shows which company the user is in.
  • The company must send its sales invoices to the tax authority (FBR in Pakistan). On Integrations, tick Digitalization, choose Testing, type the token and scenario, and the start date. When the authority approves, switch the status to Live. Items then need an HS Code.
  • Staff fill shared folders with scanned files. Set Company Storage Limit (MB). Shared folders then stop accepting files beyond the limit; 0 lifts it.
  • The company prints and scans its own barcodes. See Switch barcode on.

What it is connected to​

If something looks wrong​

  • “Address - only one address can be marked primary” Two addresses are ticked Primary Address. Clear one.
  • “Address - only one address can be marked as primary for country, based on Country” Two addresses in the same country are ticked Primary For Country. Clear one.
  • “country cannot be empty” A line ticked Primary For Country has no Country. Pick it.
  • “Line ID: … - Contact Nature cannot be empty.” A contact line has no Contact Nature. Pick one.
  • “Contact - only one contact can be marked as primary, based on Contact Nature” Two contacts of the same kind are ticked Primary. Clear one.
  • “AI Agents - feature … is listed more than once.” / “AI Agents - tool … is listed more than once.” The same AI feature or tool code is on two lines. Remove one.
  • “AI Agents - Line ID: … - an AI tool needs a code, a provider and a model.” An AI tool line is missing its code, provider or model.
  • “User Quota - … is listed more than once.” A user appears twice in the user quota list.
  • Mail is not arriving although the SMTP fields are filled. Those fields are not used. Outgoing mail is configured on the server by the support team.
  • Digitalization Token became required. Digitalization is ticked; the token is needed while it is on.