@spec add_authorized_person(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Adds an authorized person to a business account.

Requires a change request unless the authorized person is a legal representative. The change request must be completed by a legal rep with ALONE or nil representation type.

@spec add_signee(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Adds a person as a signee for a business.

@spec create(
  map(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Creates a new business.

Required fields (vary by country)

• :name — Legal name
• :legal_form — e.g. "GmbH", "AG", "SOLE_PROPRIETOR"
• :registration_number
• :registration_issuer — Issuing authority
• :address
• :tax_country

Examples

{:ok, business} = Solaris.Onboarding.Businesses.create(%{
  name: "Acme GmbH",
  legal_form: "GMBH",
  registration_number: "HRB 12345",
  registration_issuer: "Amtsgericht Berlin",
  address: %{
    line_1: "Unter den Linden 1",
    postal_code: "10117",
    city: "Berlin",
    country: "DE"
  },
  tax_country: "DE"
})

@spec create_annual_turnover(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Records the annual turnover for a business.

Examples

{:ok, _} = Solaris.Onboarding.Businesses.create_annual_turnover("cbac_123", %{
  amount: 500_000_00,
  currency: "EUR",
  year: 2023
})

@spec create_beneficial_owner(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Creates a beneficial owner record for a business.

The linked person must have: salutation, first_name, last_name, birth_date.

Examples

{:ok, owner} = Solaris.Onboarding.Businesses.create_beneficial_owner("cbac_123", %{
  person_id: "cper_789",
  ownership_percentage: 25,
  is_silent_partner: false
})

@spec create_identification_number(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Creates a Wirtschafts-Identifikationsnummer (Germany-specific business ID).

Examples

{:ok, widnr} = Solaris.Onboarding.Businesses.create_identification_number("cbac_123", %{
  number: "DE123456789",
  country: "DE"
})

@spec create_legal_representative(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Creates a legal representative for a business.

Required fields

• :person_id — ID of a previously created person

• :representation_type — "ALONE" | "JOINTLY" | "SINGLE_POWER_OF_ATTORNEY"

Examples

{:ok, rep} = Solaris.Onboarding.Businesses.create_legal_representative("cbac_123", %{
  person_id: "cper_456",
  representation_type: "ALONE"
})

@spec create_tax_identification(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Creates a tax identification for a business.

Examples

{:ok, tax_id} = Solaris.Onboarding.Businesses.create_tax_identification("cbac_123", %{
  country: "DE",
  number: "29/815/08152",
  primary: true
})

@spec delete_legal_representative(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Removes a legal representative.

@spec download_document(String.t(), String.t(), keyword()) ::
  {:ok, binary()} | {:error, Solaris.Error.t()}

Downloads a document's raw binary content.

@spec find_registration(keyword(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Finds a commercial registration by registration number and issuer.

Examples

{:ok, reg} = Solaris.Onboarding.Businesses.find_registration(
  registration_number: "HRB 12345",
  registration_issuer: "Amtsgericht Berlin",
  country: "DE"
)

@spec get(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific business by ID.

@spec get_authorized_person(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific authorized person.

@spec get_beneficial_owner(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific beneficial owner.

@spec get_identification_number(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves the identification number for a business.

@spec get_tax_identification(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific tax identification.

@spec list(keyword()) :: {:ok, map()} | {:error, Solaris.Error.t()}

Lists all businesses for the authenticated partner.

@spec list_authorized_persons(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists authorized persons on a business account.

@spec list_beneficial_owners(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists all beneficial owners of a business.

@spec list_documents(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists all documents for a business.

@spec list_legal_representatives(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists all legal representatives of a business.

@spec list_signees(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists all signees for a business.

@spec list_tax_identifications(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists all tax identifications for a business.

@spec remove_authorized_person(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Removes an authorized person from a business.

@spec remove_signee(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Removes a signee from a business.

@spec search_registration(keyword(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Searches for a commercial registration by company name and country.

Examples

{:ok, results} = Solaris.Onboarding.Businesses.search_registration(
  name: "Acme",
  country: "DE"
)

@spec stream(keyword()) :: Enumerable.t()

Streams all businesses across all pages.

@spec update(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates a business. May return 202 with change_request_id for SCA.

@spec update_beneficial_owner(String.t(), String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates a beneficial owner.

@spec update_document(String.t(), String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates document attributes.

@spec update_identification_number(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates the identification number.

@spec update_legal_representative(String.t(), String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates a legal representative.

@spec update_tax_identification(String.t(), String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Updates a tax identification.

@spec upload_document(String.t(), binary(), keyword()) ::
  {:ok, map()} | {:error, Solaris.Error.t()}

Uploads a document for a business.

Options

• :document_type — e.g. "ARTICLES_OF_ASSOCIATION", "FINANCIAL_STATEMENT", "OTHER"
• :customer_accessible — boolean
• :filename, :content_type