feat(bpdm-gate): Extend error states

[kunyao-cofinity-x]

Description

Enhance the error handling mechanism for the orchestrator and gate components by extending the list of available error codes. This will improve the visibility and detail of error information, particularly beneficial for the customer dashboard to understand why a data set could not be processed.

Currently, the orchestrator and gate components have a limited set of error codes. Extending these error codes will provide more granular information on processing failures, aiding in quicker diagnosis and resolution. This feature will update both the orchestrator and gate components to support a more comprehensive list of error codes.

The new enums add to the BusinessPartnerSharingError:

• NaturalPersonError,
• BpnErrorMissingParent,
• BpnErrorNotFound,
• BpnErrorTooManyOptions,
• MandatoryFieldValidationFailed,
• BlacklistCountryPresent,
• InvalidSpecialCharacters,
• MandatoryFieldMissing,
• BpnlChanged,
• UnclearEntity,
• UnknownSpecialCharacters,
• MatchBasedOnProvidedNameOrIdentifier

https://github.com/eclipse-tractusx/sig-release/issues/727

Pre-review checks

Please ensure to do as many of the following checks as possible, before asking for committer review:

• [ ] DEPENDENCIES are up-to-date. Dash license tool. Committers can open IP issues for restricted libs.
• [ ] Copyright and license header are present on all affected files