Skip to main content

Data Modification and Update

This section outlines the business logic and processes governing how an End User updates their user and corporate data within the DEUSS ecosystem. The primary system handling these updates directly from the user is the Whitelabel Backend (specifically the Company Service).

User Data Modification​

An End User can update their personal user profile (e.g., First Name, Last Name). These updates are processed immediately without requiring manual validation.

Corporate Data and Document Updates​

An End User (acting on behalf of an SME or Investor company) can update corporate details such as Company Name, VAT Number, IBAN, Website, and Headcount. They can also upload or delete corporate documents (KYC/KYB files).

Validation States and Editability​

The ability to edit corporate data depends on the company's current VerificationState:

  • Allowed States: NOT_SUBMITTED, TASKED_WITH_ADDING_INFO, and VERIFIED.
  • Restricted States: If the company is in WAITING_FOR_VALIDATION or REJECTED, updates are blocked to prevent mid-review changes.

Auditing and Re-verification​

When an End User updates corporate data for a company that is already VERIFIED:

  1. The update is applied directly in the Whitelabel Backend.
  2. The verification state remains VERIFIED.
  3. An audit record (CompanyEditHistory) is generated to track the specific fields changed.
  4. The edit history is synced to the Validator Backoffice (Distributor).
  5. A Validator (Compliance) is notified of the changes. The Validator can review the Edit History and, if necessary, revert the changes or change the company's VerificationState (e.g., back to WAITING_FOR_VALIDATION or REJECTED).

Data Update Sequence​

Bond Entity Updates​

Throughout the bond structuring lifecycle, the Bond terms (often referred to as an Issuance Draft) are continuously iteratively updated.

  1. Issuer (SME) Updates: The Issuer can update the IssuanceDraft (such as adjusting the required target amount or uploading new marketing materials) directly from their Broker interface as long as the draft is in a mutable state.
  2. Validator (Placement Agent) Updates: The Placement Agent can intercept and patch the Bond Draft (adminPatchBondDraft) to finalize the exact parameters (such as ISIN, final coupon rate, and issue date) before the bond is formally issued.

System & Partner Configuration Updates​

The DEUSS Core platform exposes specialized endpoints for overarching platform administration, utilized exclusively by the DEUSS Backoffice.

  • Partner / Broker Updates: The DEUSS Governance Backoffice manages and updates Partner entities (updatePartner). This includes adjusting integration endpoints, changing assigned roles (e.g., granting Guarantor privileges), or pausing a broker's network access.
  • Platform Fee Schedule Updates: The platform allows the DEUSS Backoffice to update global or broker-specific fee parameters (updatePlatformFeeSchedule), dictating the commercial terms of transactions and bond issuances.

Administrative Interventions​

Certain critical overrides and corrections are reserved for direct administrative intervention:

  • Change Company Manager: A broker admin can re-assign the primary controlling user of a corporate entity (adminChangeCompanyManager) in cases of lost access or employee termination.
  • Freeze/Unfreeze Actions: If malicious activity is suspected, the DEUSS Backoffice can freeze investor profiles, issuer profiles, or explicit blockchain wallets directly in the Registry Service to halt trading and asset transfers.
  • Toggle Visibility: A company's network visibility can be manually toggled between PUBLIC and PRIVATE (adminSetCompanyVisibility).
  • Identity & AML Overrides: While typically handled via the Validator flow, DEUSS Backoffice administrators possess fallback capabilities to manually override the KYC/KYB states directly in the Registry Service (adminSetIdentityVerificationState / adminSetAmlVerificationState).
  • User Wallet Recovery: If a user loses their private keys, DEUSS Backoffice administrators can initiate a wallet recovery process to update the assigned blockchain address for that End User (adminRecoverUser).