diff --git a/.tractusx b/.tractusx index 4620c25dfd5..29bd32e6ce5 100644 --- a/.tractusx +++ b/.tractusx @@ -7,7 +7,3 @@ repositories: url: "https://github.com/eclipse-tractusx/eclipse-tractusx.github.io" openApiSpecs: - "https://raw.githubusercontent.com/eclipse-tractusx/eclipse-tractusx.github.io/main/openApi/dt/kit_digital-twin-kit-submodel-api_openAPI.yaml" -- "https://raw.githubusercontent.com/eclipse-tractusx/eclipse-tractusx.github.io/main/openApi/bpdm/kit_business-partner-kit-cleaning-dummy_openAPI.yaml" -- "https://raw.githubusercontent.com/eclipse-tractusx/eclipse-tractusx.github.io/main/openApi/bpdm/kit_business-partner-kit-gate_openAPI.yaml" -- "https://raw.githubusercontent.com/eclipse-tractusx/eclipse-tractusx.github.io/main/openApi/bpdm/kit_business-partner-kit-orchestrator_openAPI.yaml" -- "https://raw.githubusercontent.com/eclipse-tractusx/eclipse-tractusx.github.io/main/openApi/bpdm/kit_business-partner-kit-pool_openAPI.yaml" \ No newline at end of file diff --git a/docs-kits/kits/Business Partner Kit/page_changelog.md b/docs-kits/kits/Business Partner Kit/page_changelog.md index aaac21fba3b..497398d7ac6 100644 --- a/docs-kits/kits/Business Partner Kit/page_changelog.md +++ b/docs-kits/kits/Business Partner Kit/page_changelog.md @@ -11,7 +11,9 @@ sidebar_position: 1 All notable changes to this Kit will be documented in this file. -## [7.0.0] - Unreleased +## [7.0.0] - 2024-12-01 + +Compatible for **release 24.12**. ### Added diff --git a/openApi/bpdm/kit_business-partner-kit-cleaning-dummy_openAPI.yaml b/openApi/bpdm/kit_business-partner-kit-cleaning-dummy_openAPI.yaml deleted file mode 100644 index 2d277588d77..00000000000 --- a/openApi/bpdm/kit_business-partner-kit-cleaning-dummy_openAPI.yaml +++ /dev/null @@ -1,10 +0,0 @@ -openapi: 3.0.1 -info: - title: Business Partner Data Management Cleaning Service Dummy - description: Place holder for the cleaning service provider - version: 6.1.0 -servers: - - url: http://localhost:8084 - description: Generated server url -paths: {} -components: {} diff --git a/openApi/bpdm/kit_business-partner-kit-gate_openAPI.yaml b/openApi/bpdm/kit_business-partner-kit-gate_openAPI.yaml deleted file mode 100644 index f125289cd4b..00000000000 --- a/openApi/bpdm/kit_business-partner-kit-gate_openAPI.yaml +++ /dev/null @@ -1,1832 +0,0 @@ -openapi: 3.0.1 -info: - title: Business Partner Data Management Gate - description: A gate for a member to share business partner data with CatenaX - version: 6.1.0 -servers: - - url: http://localhost:8081 - description: Generated server url -paths: - /v6/input/business-partners: - put: - tags: - - business-partner-controller - summary: Create or update business partner with given external ID - description: Create or update generic business partner. Updates instead of creating a new business partner if an already existing external ID is used. The same external ID may not occur more than once in a single request. For a single request, the maximum number of business partners in the request is limited to 100 entries. - operationId: upsertBusinessPartnersInput - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerInputRequest' - required: true - responses: - '200': - description: Business partner were successfully updated or created - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerInputDto' - '400': - description: On malformed legal entity request - /v6/sharing-state/ready: - post: - tags: - - sharing-state-controller - summary: Sets the given business partners into ready to be shared state - description: The business partners to set the ready state for are identified by their external-id. Only business partners in an initial or error state can be set to ready. If any given business partner could not be set into ready state for any reason (for example, it has not been found or it is in the wrong state) the whole request fails (all or nothing approach). - operationId: postSharingStateReady - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/PostSharingStateReadyRequest' - required: true - responses: - '204': - description: All business partners put in ready to be shared state - '400': - description: Business partners can't be put into ready state (e.g. external-ID not found, wrong sharing state) - /v6/output/changelog/search: - post: - tags: - - changelog-controller - summary: Returns changelog entries for changes to the business partner output stage - description: Returns changelog entries as of a specified timestamp from the output stage, optionally filtered by timestamp, an array of external IDs and a business partner type. - operationId: getOutputChangelog - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ChangelogSearchRequest' - required: true - responses: - '200': - description: The changelog entries for the specified parameters - content: - application/json: - schema: - $ref: '#/components/schemas/PageChangeLogDtoChangelogGateDto' - '400': - description: On malformed pagination request - /v6/output/business-partners/search: - post: - tags: - - business-partner-controller - summary: Search business partners by an array of external IDs from the output stage - description: Get page of business partners output data filtered by a collection of external IDs. An empty external ID list will return a paginated list of all business partners. - operationId: getBusinessPartnersOutput - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - type: array - items: - type: string - responses: - '200': - description: The requested page of business partners - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoBusinessPartnerOutputDto' - '400': - description: On malformed pagination request - /v6/input/partner-upload-process: - post: - tags: - - partner-upload-controller - summary: Create or update business partners from uploaded CSV file - description: 'Create or update generic business partners. Updates instead of creating a new business partner if an already existing external ID is used. The same external ID may not occur more than once in a requested file. ' - operationId: uploadPartnerCsvFile - requestBody: - content: - multipart/form-data: - schema: - required: - - file - type: object - properties: - file: - type: string - format: binary - responses: - '200': - description: Business partners were successfully updated or created - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerInputDto' - multipart/form-data: - schema: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerInputDto' - '400': - description: On malformed Business partner upload request - content: - application/json: - schema: - $ref: '#/components/schemas/PartnerUploadErrorResponse' - /v6/input/changelog/search: - post: - tags: - - changelog-controller - summary: Returns changelog entries for changes to the business partner input stage - description: Returns changelog entries as of a specified timestamp from the input stage, optionally filtered by timestamp, an array of external IDs and a business partner type. - operationId: getInputChangelog - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ChangelogSearchRequest' - required: true - responses: - '200': - description: The changelog entries for the specified parameters - content: - application/json: - schema: - $ref: '#/components/schemas/PageChangeLogDtoChangelogGateDto' - '400': - description: On malformed pagination request - /v6/input/business-partners/search: - post: - tags: - - business-partner-controller - summary: Search business partner by external ID. An empty external ID list returns a paginated list of all business partners. - description: Get page of business partners filtered by a collection of external IDs. - operationId: getBusinessPartnersInput - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - type: array - items: - type: string - responses: - '200': - description: The requested page of busines partners - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoBusinessPartnerInputDto' - '400': - description: On malformed pagination request - /v6/stats/{stage}/address-types: - get: - tags: - - stats-controller - operationId: countAddressTypes - parameters: - - name: stage - in: path - required: true - schema: - type: string - enum: - - Input - - Output - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StatsAddressTypesResponse' - /v6/stats/stages: - get: - tags: - - stats-controller - operationId: countPartnersPerStage - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StatsStagesResponse' - /v6/stats/sharing-states: - get: - tags: - - stats-controller - operationId: countPartnersBySharingState - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StatsSharingStatesResponse' - /v6/stats/confidence-criteria: - get: - tags: - - stats-controller - operationId: getConfidenceCriteriaStats - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StatsConfidenceCriteriaResponse' - /v6/sharing-state: - get: - tags: - - sharing-state-controller - summary: Returns sharing states of business partners, optionally filtered by a business partner type and an array of external IDs - operationId: getSharingStates - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - - name: externalIds - in: query - description: External IDs - required: false - schema: - type: array - items: - type: string - responses: - '200': - description: Page of sharing states - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoSharingStateDto' - /v6/input/partner-upload-template: - get: - tags: - - partner-upload-controller - summary: Get CSV template with headers in file - description: Create empty CSV file template including headers.Generated CSV file can later be used for uploading business partner data. - operationId: getPartnerCsvTemplate - responses: - '200': - description: CSV file template generated successfully - content: - application/json: - schema: - type: string - format: binary - multipart/form-data: - schema: - type: string - format: binary -components: - schemas: - AddressComponentOutputDto: - required: - - addressBpn - - bpnA - - confidenceCriteria - - physicalPostalAddress - - states - type: object - properties: - addressBpn: - type: string - description: The BPNA of the address, on which the business partner provides a view. - name: - type: string - description: The name of the address, on which the business partner provides a view. This is not according to official registers but according to the name the sharing members agree on, such as the name of a gate or any other additional names that designate the address in common parlance. - addressType: - type: string - description: 'One of the address types: Legal Address, Site Main Address, Legal and Site Main Address, Additional Address. ' - enum: - - LegalAndSiteMainAddress - - LegalAddress - - SiteMainAddress - - AdditionalAddress - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: Address properties of business partner output data - AddressRepresentationInputDto: - required: - - physicalPostalAddress - - states - type: object - properties: - addressBpn: - type: string - description: The BPNA of the address, on which the business partner provides a view. - name: - type: string - description: The name of the address, on which the business partner provides a view. This is not according to official registers but according to the name the sharing members agree on, such as the name of a gate or any other additional names that designate the address in common parlance. - addressType: - type: string - description: 'One of the address types: Legal Address, Site Main Address, Legal and Site Main Address, Additional Address. ' - enum: - - LegalAndSiteMainAddress - - LegalAddress - - SiteMainAddress - - AdditionalAddress - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressDto' - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: 'The address, on which the business partner provides a view. ' - AlternativePostalAddressDto: - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - type: string - description: The 2-digit country code of the physical postal address according to ISO 3166-1. - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - administrativeAreaLevel1: - type: string - description: The 2-digit country subdivision code according to ISO 3166-2, such as a region within a country. - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - deliveryServiceType: - type: string - description: 'One of the alternative postal address types: P.O. box, private bag, boite postale.' - enum: - - PO_BOX - - PRIVATE_BAG - - BOITE_POSTALE - deliveryServiceQualifier: - type: string - description: The qualifier uniquely identifying the delivery service endpoint of the alternative postal address in conjunction with the delivery service number. In some countries for example, entering a P.O. box number, postal code and city is not sufficient to uniquely identify a P.O. box, because the same P.O. box number is assigned multiple times in some cities. - deliveryServiceNumber: - type: string - description: The number indicating the delivery service endpoint of the alternative postal address to which the delivery is to be delivered, such as a P.O. box number or a private bag number. - description: An alternative postal address describes an alternative way of delivery for example if the goods are to be picked up somewhere else. - BusinessPartnerIdentifierDto: - type: object - properties: - type: - type: string - description: The type of the identifier. - value: - type: string - description: The value of the identifier like “DE123465789. - issuingBody: - type: string - description: The name of the official register, where the identifier is registered. For example, a Handelsregisternummer in Germany is only valid with its corresponding Registergericht and Registerart. - BusinessPartnerInputDto: - required: - - address - - bpnA - - bpnL - - createdAt - - externalId - - identifiers - - isOwnCompanyData - - legalEntity - - nameParts - - postalAddress - - roles - - site - - states - - updatedAt - type: object - properties: - externalId: - type: string - description: The identifier which uniquely identifies (in the internal system landscape of the sharing member) the business partner. - nameParts: - type: array - description: The list of name parts to accommodate the different number of name fields in different systems. - items: - type: string - identifiers: - type: array - description: The list of identifiers of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerIdentifierDto' - states: - type: array - description: The list of (temporary) states of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - roles: - type: array - description: 'One or more of the roles, the business partner assumes with respect to the sharing member: Supplier, Customer. Sorted and duplicates removed by the service.' - items: - type: string - enum: - - SUPPLIER - - CUSTOMER - - ONE_TIME_SUPPLIER - - ONE_TIME_CUSTOMER - isOwnCompanyData: - type: boolean - description: Indicates whether the sharing member claims (in the initial upload) the business partner to belong to the company data of the sharing member. - legalEntity: - $ref: '#/components/schemas/LegalEntityRepresentationInputDto' - site: - $ref: '#/components/schemas/SiteRepresentationInputDto' - address: - $ref: '#/components/schemas/AddressRepresentationInputDto' - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - description: Generic business partner with external id - BusinessPartnerInputRequest: - required: - - address - - externalId - - identifiers - - isOwnCompanyData - - legalEntity - - nameParts - - roles - - site - - states - type: object - properties: - externalId: - type: string - description: The identifier which uniquely identifies (in the internal system landscape of the sharing member) the business partner. - nameParts: - type: array - description: The list of name parts to accommodate the different number of name fields in different systems. - items: - type: string - identifiers: - type: array - description: The list of identifiers of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerIdentifierDto' - states: - type: array - description: The list of (temporary) states of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - roles: - type: array - description: 'One or more of the roles, the business partner assumes with respect to the sharing member: Supplier, Customer. Sorted and duplicates removed by the service.' - items: - type: string - enum: - - SUPPLIER - - CUSTOMER - - ONE_TIME_SUPPLIER - - ONE_TIME_CUSTOMER - isOwnCompanyData: - type: boolean - description: Indicates whether the sharing member claims (in the initial upload) the business partner to belong to the company data of the sharing member. - legalEntity: - $ref: '#/components/schemas/LegalEntityRepresentationInputDto' - site: - $ref: '#/components/schemas/SiteRepresentationInputDto' - address: - $ref: '#/components/schemas/AddressRepresentationInputDto' - description: Generic business partner with external id - BusinessPartnerOutputDto: - required: - - address - - createdAt - - externalId - - identifiers - - isOwnCompanyData - - legalEntity - - nameParts - - roles - - states - - updatedAt - type: object - properties: - externalId: - type: string - description: The identifier which uniquely identifies (in the internal system landscape of the sharing member) the business partner. - nameParts: - type: array - description: The list of name parts to accommodate the different number of name fields in different systems. - items: - type: string - identifiers: - type: array - description: The list of identifiers of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerIdentifierDto' - states: - type: array - description: The list of (temporary) states of the business partner. Sorted and duplicates removed by the service. - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - roles: - type: array - description: 'One or more of the roles, the business partner assumes with respect to the sharing member: Supplier, Customer. Sorted and duplicates removed by the service.' - items: - type: string - enum: - - SUPPLIER - - CUSTOMER - - ONE_TIME_SUPPLIER - - ONE_TIME_CUSTOMER - isOwnCompanyData: - type: boolean - description: Indicates whether the sharing member claims (in the initial upload) the business partner to belong to the company data of the sharing member. - legalEntity: - $ref: '#/components/schemas/LegalEntityRepresentationOutputDto' - site: - $ref: '#/components/schemas/SiteRepresentationOutputDto' - address: - $ref: '#/components/schemas/AddressComponentOutputDto' - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - description: Generic business partner output with external id - BusinessPartnerStateDto: - type: object - properties: - validFrom: - type: string - description: Date since when the status is/was valid. - format: date-time - validTo: - type: string - description: Date until the status was valid, if applicable. - format: date-time - type: - type: string - description: The type of this specified status. - enum: - - ACTIVE - - INACTIVE - ChangelogGateDto: - required: - - changelogType - - externalId - - timestamp - type: object - properties: - externalId: - type: string - description: The external identifier of the business partner for which the changelog entry was created. - timestamp: - type: string - description: The date and time when the changelog entry was created. - format: date-time - changelogType: - type: string - description: 'One of the actions for which the changelog entry was created: create, update.' - enum: - - CREATE - - UPDATE - description: An entry of the changelog, which is created each time a business partner is modified and contains data about the change. The actual new state of the business partner is not included. - ChangelogSearchRequest: - type: object - properties: - timestampAfter: - type: string - description: Only changelog entries created after this time. Ignored if empty. - format: date-time - example: '2023-03-20T10:23:28.194Z' - externalIds: - uniqueItems: true - type: array - description: Only for business partners with the given array of external IDs. Ignored if empty. - items: - type: string - ConfidenceCriteriaDto: - required: - - checkedByExternalDataSource - - confidenceLevel - - lastConfidenceCheckAt - - nextConfidenceCheckAt - - numberOfSharingMembers - - sharedByOwner - type: object - properties: - sharedByOwner: - type: boolean - checkedByExternalDataSource: - type: boolean - numberOfSharingMembers: - type: integer - format: int32 - lastConfidenceCheckAt: - type: string - format: date-time - nextConfidenceCheckAt: - type: string - format: date-time - confidenceLevel: - type: integer - format: int32 - ErrorInfoChangeLogOutputError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: Error code identifying the error - enum: - - ExternalIdNotFound - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: Key (externalId) of the entity that failed - description: Holds information about failures - GeoCoordinateDto: - required: - - latitude - - longitude - type: object - properties: - longitude: - type: number - description: Longitude coordinate - format: float - latitude: - type: number - description: Latitude coordinate - format: float - altitude: - type: number - description: Altitude, if applicable - format: float - description: The exact location of the physical postal address in latitude, longitude, and altitude. - LegalEntityRepresentationInputDto: - required: - - states - type: object - properties: - legalEntityBpn: - type: string - description: The BPNL of the legal entity, on which the business partner provides a view. - legalName: - type: string - description: The name of the legal entity, on which the business partner provides a view, according to official registers. - shortName: - type: string - description: The abbreviated name of the legal entity, on which the business partner provides a view. - legalForm: - type: string - description: The legal form of the legal entity, on which the business partner provides a view. - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: The legal entity, on which the business partner provides a view. - LegalEntityRepresentationOutputDto: - required: - - bpnL - - confidenceCriteria - - legalEntityBpn - - states - type: object - properties: - legalEntityBpn: - type: string - description: The BPNL of the legal entity, on which the business partner provides a view. - legalName: - type: string - description: The name of the legal entity, on which the business partner provides a view, according to official registers. - shortName: - type: string - description: The abbreviated name of the legal entity, on which the business partner provides a view. - legalForm: - type: string - description: The legal form of the legal entity, on which the business partner provides a view. - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: Legal Entity properties of business partner output data - PageChangeLogDtoChangelogGateDto: - required: - - content - - contentSize - - errors - - invalidEntries - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/ChangelogGateDto' - invalidEntries: - type: integer - description: Number of entries in the page that have been omitted due to being invalid (error) - format: int32 - errors: - type: array - description: Infos about the entries with errors - items: - $ref: '#/components/schemas/ErrorInfoChangeLogOutputError' - description: Paginated collection of results - PageDtoBusinessPartnerInputDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/BusinessPartnerInputDto' - description: Paginated collection of results - PageDtoBusinessPartnerOutputDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/BusinessPartnerOutputDto' - description: Paginated collection of results - PageDtoSharingStateDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/SharingStateDto' - description: Paginated collection of results - PartnerUploadErrorResponse: - required: - - error - - path - - status - - timestamp - type: object - properties: - timestamp: - type: string - description: Timestamp of the error occurrence - format: date-time - status: - type: string - description: HTTP status of the error response - enum: - - 100 CONTINUE - - 101 SWITCHING_PROTOCOLS - - 102 PROCESSING - - 103 EARLY_HINTS - - 103 CHECKPOINT - - 200 OK - - 201 CREATED - - 202 ACCEPTED - - 203 NON_AUTHORITATIVE_INFORMATION - - 204 NO_CONTENT - - 205 RESET_CONTENT - - 206 PARTIAL_CONTENT - - 207 MULTI_STATUS - - 208 ALREADY_REPORTED - - 226 IM_USED - - 300 MULTIPLE_CHOICES - - 301 MOVED_PERMANENTLY - - 302 FOUND - - 302 MOVED_TEMPORARILY - - 303 SEE_OTHER - - 304 NOT_MODIFIED - - 305 USE_PROXY - - 307 TEMPORARY_REDIRECT - - 308 PERMANENT_REDIRECT - - 400 BAD_REQUEST - - 401 UNAUTHORIZED - - 402 PAYMENT_REQUIRED - - 403 FORBIDDEN - - 404 NOT_FOUND - - 405 METHOD_NOT_ALLOWED - - 406 NOT_ACCEPTABLE - - 407 PROXY_AUTHENTICATION_REQUIRED - - 408 REQUEST_TIMEOUT - - 409 CONFLICT - - 410 GONE - - 411 LENGTH_REQUIRED - - 412 PRECONDITION_FAILED - - 413 PAYLOAD_TOO_LARGE - - 413 REQUEST_ENTITY_TOO_LARGE - - 414 URI_TOO_LONG - - 414 REQUEST_URI_TOO_LONG - - 415 UNSUPPORTED_MEDIA_TYPE - - 416 REQUESTED_RANGE_NOT_SATISFIABLE - - 417 EXPECTATION_FAILED - - 418 I_AM_A_TEAPOT - - 419 INSUFFICIENT_SPACE_ON_RESOURCE - - 420 METHOD_FAILURE - - 421 DESTINATION_LOCKED - - 422 UNPROCESSABLE_ENTITY - - 423 LOCKED - - 424 FAILED_DEPENDENCY - - 425 TOO_EARLY - - 426 UPGRADE_REQUIRED - - 428 PRECONDITION_REQUIRED - - 429 TOO_MANY_REQUESTS - - 431 REQUEST_HEADER_FIELDS_TOO_LARGE - - 451 UNAVAILABLE_FOR_LEGAL_REASONS - - 500 INTERNAL_SERVER_ERROR - - 501 NOT_IMPLEMENTED - - 502 BAD_GATEWAY - - 503 SERVICE_UNAVAILABLE - - 504 GATEWAY_TIMEOUT - - 505 HTTP_VERSION_NOT_SUPPORTED - - 506 VARIANT_ALSO_NEGOTIATES - - 507 INSUFFICIENT_STORAGE - - 508 LOOP_DETECTED - - 509 BANDWIDTH_LIMIT_EXCEEDED - - 510 NOT_EXTENDED - - 511 NETWORK_AUTHENTICATION_REQUIRED - error: - type: array - description: List of error messages - items: - type: string - description: List of error messages - path: - type: string - description: Request path where the error occurred - description: Error response for invalid partner upload - PhysicalPostalAddressDto: - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - type: string - description: The 2-digit country code of the physical postal address according to ISO 3166-1. - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - administrativeAreaLevel1: - type: string - description: The 2-digit country subdivision code according to ISO 3166-2, such as a region within a country. - administrativeAreaLevel2: - type: string - description: The name of the locally regulated secondary country subdivision of the physical postal address, such as county within a country. - administrativeAreaLevel3: - type: string - description: The name of the locally regulated tertiary country subdivision of the physical address, such as townships within a country. - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - district: - type: string - description: The name of the district of the physical postal address which divides the city in several smaller areas. - street: - $ref: '#/components/schemas/StreetDto' - companyPostalCode: - type: string - description: The company postal code of the physical postal address, which is sometimes required for large companies. - industrialZone: - type: string - description: 'The industrial zone of the physical postal address, designating an area for industrial development, synonym: industrial area.' - building: - type: string - description: The alphanumeric identifier of the building addressed by the physical postal address. - floor: - type: string - description: 'The number of a floor in the building addressed by the physical postal address, synonym: level.' - door: - type: string - description: 'The number of a door in the building on the respective floor addressed by the physical postal address, synonyms: room, suite.' - taxJurisdictionCode: - type: string - description: Tax jurisdiction codes are used to identify the specific jurisdiction(s) that a company belong to, particularly in bureaucratic processes such as tax returns and IRS forms. - description: A physical postal address describes the physical location of an office, warehouse, gate, etc. - PostSharingStateReadyRequest: - required: - - externalIds - type: object - properties: - externalIds: - type: array - items: - type: string - description: Request for setting business partners into ready to be shared to golden record state - SharingStateDto: - required: - - externalId - - sharingStateType - type: object - properties: - externalId: - type: string - description: The external identifier of the business partner for which the sharing state entry was created. - sharingStateType: - type: string - description: One of the sharing state types of the current sharing state. - enum: - - Pending - - Success - - Error - - Initial - - Ready - sharingErrorCode: - type: string - description: One of the sharing error codes in case the current sharing state type is "error". - enum: - - SharingProcessError - - SharingTimeout - - BpnNotInPool - - MissingTaskID - sharingErrorMessage: - type: string - description: The error message in case the current sharing state type is "error". - sharingProcessStarted: - type: string - description: The date and time when the sharing process was started. - format: date-time - taskId: - type: string - description: The orchestrator task identifier that was created - description: A sharing state entry shows the progress in the sharing process and is updated each time the progress for a business partner changes. The business partner is identified by a combination of external ID and business partner type. - SiteRepresentationInputDto: - required: - - states - type: object - properties: - siteBpn: - type: string - description: The BPNS of the site, on which the business partner provides a view. - name: - type: string - description: The name of the site, on which the business partner provides a view. This is not according to official registers but according to the name the owner chooses. - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: The site, on which the business partner provides a view. - SiteRepresentationOutputDto: - required: - - confidenceCriteria - - siteBpn - - states - type: object - properties: - siteBpn: - type: string - description: The BPNS of the site, on which the business partner provides a view. - name: - type: string - description: The name of the site, on which the business partner provides a view. This is not according to official registers but according to the name the owner chooses. - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - states: - type: array - items: - $ref: '#/components/schemas/BusinessPartnerStateDto' - description: Site properties of business partner output data - StatsAddressTypesResponse: - required: - - additionalTotal - - legalAndSiteTotal - - legalTotal - - siteTotal - type: object - properties: - legalAndSiteTotal: - type: integer - format: int32 - legalTotal: - type: integer - format: int32 - siteTotal: - type: integer - format: int32 - additionalTotal: - type: integer - format: int32 - StatsConfidenceCriteriaResponse: - required: - - checkedByExternalDataSourceTotal - - confidenceLevelAverage - - numberOfBusinessPartnersAverage - - sharedByOwnerTotal - - uniqueTotal - type: object - properties: - numberOfBusinessPartnersAverage: - type: number - format: float - uniqueTotal: - type: integer - format: int64 - sharedByOwnerTotal: - type: integer - format: int64 - checkedByExternalDataSourceTotal: - type: integer - format: int64 - confidenceLevelAverage: - type: number - format: float - StatsSharingStatesResponse: - required: - - errorTotal - - initialTotal - - pendingTotal - - readyTotal - - successTotal - type: object - properties: - initialTotal: - type: integer - format: int32 - readyTotal: - type: integer - format: int32 - pendingTotal: - type: integer - format: int32 - successTotal: - type: integer - format: int32 - errorTotal: - type: integer - format: int32 - StatsStagesResponse: - required: - - inputTotal - - outputTotal - type: object - properties: - inputTotal: - type: integer - format: int32 - outputTotal: - type: integer - format: int32 - StreetDto: - type: object - properties: - namePrefix: - type: string - description: The street related information, which is usually printed before the official street name on an address label. - additionalNamePrefix: - type: string - description: The additional street related information, which is usually printed before the official street name on an address label. - name: - type: string - description: The name of the street. - nameSuffix: - type: string - description: The street related information, which is usually printed after the official street name on an address label. - additionalNameSuffix: - type: string - description: The additional street related information, which is usually printed after the official street name on an address label. - houseNumber: - type: string - description: The number representing the exact location of a building within the street. - houseNumberSupplement: - type: string - milestone: - type: string - description: The number representing the exact location of an addressed object within a street without house numbers, such as within long roads. - direction: - type: string - description: The cardinal direction describing where the exit to the location of the addressed object on large highways / motorways is located, such as Highway 101 South. - description: 'The street of the physical postal address, synonyms: road, avenue, lane, boulevard, highway' diff --git a/openApi/bpdm/kit_business-partner-kit-orchestrator_openAPI.yaml b/openApi/bpdm/kit_business-partner-kit-orchestrator_openAPI.yaml deleted file mode 100644 index 2625a4ba988..00000000000 --- a/openApi/bpdm/kit_business-partner-kit-orchestrator_openAPI.yaml +++ /dev/null @@ -1,628 +0,0 @@ -openapi: 3.0.1 -info: - title: Business Partner Data Management Orchestrator - description: Orchestrator component acts as a passive component and offers for each processing steps individual endpoints - version: 6.1.0 -servers: - - url: http://localhost:8085 - description: Generated server url -paths: - /v6/golden-record-tasks: - post: - tags: - - Task Client - summary: Create new golden record tasks for given business partner data - description: Create golden record tasks for given business partner data in given mode. The mode decides through which processing steps the given business partner data will go through. The response contains the states of the created tasks in the order of given business partner data.If there is an error in the request no tasks are created (all or nothing). For a single request, the maximum number of business partners in the request is limited to 100 entries. - operationId: createTasks - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TaskCreateRequest' - required: true - responses: - '200': - description: The states of successfully created tasks including the task identifier for tracking purposes. - content: - application/json: - schema: - $ref: '#/components/schemas/TaskCreateResponse' - '400': - description: On malformed task create requests or reaching upsert limit - /v6/golden-record-tasks/step-results: - post: - tags: - - Task Worker - summary: Post step results for reserved golden record tasks in the given step queue - description: Post business partner step results for the given tasks in the given step queue. In order to post a result for a task it needs to be reserved first, has to currently be in the given step queue and the time limit is not exceeded. The number of results you can post at a time does not need to match the original number of reserved tasks. Results are accepted via strategy 'all or nothing'. For a single request, the maximum number of postable results is limited to 100. - operationId: resolveStepResults - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TaskStepResultRequest' - required: true - responses: - '204': - description: If the results could be processed - '400': - description: On malformed requests, reaching upsert limit or posting results for tasks which are missing or in the wrong step queue - /v6/golden-record-tasks/step-reservations: - post: - tags: - - Task Worker - summary: Reserve the next golden record tasks waiting in the given step queue - description: Reserve up to a given number of golden record tasks in the given step queue. The response entries contain the business partner data to process which consists of the generic and L/S/A data. The reservation has a time limit which is returned. For a single request, the maximum number of reservable tasks is limited to 100. - operationId: reserveTasksForStep - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TaskStepReservationRequest' - required: true - responses: - '200': - description: The reserved tasks with their business partner data to process. - content: - application/json: - schema: - $ref: '#/components/schemas/TaskStepReservationResponse' - '400': - description: On malformed task create requests or reaching upsert limit - /v6/golden-record-tasks/state/search: - post: - tags: - - Task Client - summary: Search for the state of golden record tasks by task identifiers - description: Returns the state of golden record tasks based on the provided task identifiers. Unknown task identifiers are ignored. - operationId: searchTaskStates - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TaskStateRequest' - required: true - responses: - '200': - description: The state of the tasks for the provided task identifiers. - content: - application/json: - schema: - $ref: '#/components/schemas/TaskStateResponse' - '400': - description: On malformed task search requests -components: - schemas: - AlternativeAddress: - required: - - geographicCoordinates - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinate' - country: - type: string - administrativeAreaLevel1: - type: string - postalCode: - type: string - city: - type: string - deliveryServiceType: - type: string - enum: - - PO_BOX - - PRIVATE_BAG - - BOITE_POSTALE - deliveryServiceQualifier: - type: string - deliveryServiceNumber: - type: string - BpnReference: - type: object - properties: - referenceValue: - type: string - desiredBpn: - type: string - referenceType: - type: string - enum: - - Bpn - - BpnRequestIdentifier - BusinessPartner: - required: - - legalEntity - - nameParts - - uncategorized - type: object - properties: - nameParts: - type: array - items: - $ref: '#/components/schemas/NamePart' - owningCompany: - type: string - uncategorized: - $ref: '#/components/schemas/UncategorizedProperties' - legalEntity: - $ref: '#/components/schemas/LegalEntity' - site: - $ref: '#/components/schemas/Site' - additionalAddress: - $ref: '#/components/schemas/PostalAddress' - type: - type: string - enum: - - LegalEntity - - Site - - Address - description: The business partner data to be processed - BusinessState: - type: object - properties: - validFrom: - type: string - format: date-time - validTo: - type: string - format: date-time - type: - type: string - enum: - - ACTIVE - - INACTIVE - ConfidenceCriteria: - type: object - properties: - sharedByOwner: - type: boolean - checkedByExternalDataSource: - type: boolean - numberOfSharingMembers: - type: integer - format: int32 - lastConfidenceCheckAt: - type: string - format: date-time - nextConfidenceCheckAt: - type: string - format: date-time - confidenceLevel: - type: integer - format: int32 - GeoCoordinate: - type: object - properties: - longitude: - type: number - format: float - latitude: - type: number - format: float - altitude: - type: number - format: float - Identifier: - type: object - properties: - value: - type: string - type: - type: string - issuingBody: - type: string - LegalEntity: - required: - - bpnReference - - confidenceCriteria - - identifiers - - legalAddress - - states - type: object - properties: - bpnReference: - $ref: '#/components/schemas/BpnReference' - legalName: - type: string - legalShortName: - type: string - legalForm: - type: string - identifiers: - type: array - items: - $ref: '#/components/schemas/Identifier' - states: - type: array - items: - $ref: '#/components/schemas/BusinessState' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteria' - isCatenaXMemberData: - type: boolean - hasChanged: - type: boolean - legalAddress: - $ref: '#/components/schemas/PostalAddress' - NamePart: - required: - - name - - type - type: object - properties: - name: - type: string - type: - type: string - enum: - - LegalName - - ShortName - - LegalForm - - SiteName - - AddressName - PhysicalAddress: - required: - - geographicCoordinates - - street - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinate' - country: - type: string - administrativeAreaLevel1: - type: string - administrativeAreaLevel2: - type: string - administrativeAreaLevel3: - type: string - postalCode: - type: string - city: - type: string - district: - type: string - street: - $ref: '#/components/schemas/Street' - companyPostalCode: - type: string - industrialZone: - type: string - building: - type: string - floor: - type: string - door: - type: string - taxJurisdictionCode: - type: string - PostalAddress: - required: - - bpnReference - - confidenceCriteria - - identifiers - - physicalAddress - - states - type: object - properties: - bpnReference: - $ref: '#/components/schemas/BpnReference' - addressName: - type: string - identifiers: - type: array - items: - $ref: '#/components/schemas/Identifier' - states: - type: array - items: - $ref: '#/components/schemas/BusinessState' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteria' - physicalAddress: - $ref: '#/components/schemas/PhysicalAddress' - alternativeAddress: - $ref: '#/components/schemas/AlternativeAddress' - hasChanged: - type: boolean - Site: - required: - - bpnReference - - confidenceCriteria - - siteMainIsLegalAddress - - states - type: object - properties: - bpnReference: - $ref: '#/components/schemas/BpnReference' - siteName: - type: string - states: - type: array - items: - $ref: '#/components/schemas/BusinessState' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteria' - hasChanged: - type: boolean - siteMainAddress: - $ref: '#/components/schemas/PostalAddress' - siteMainIsLegalAddress: - type: boolean - Street: - type: object - properties: - name: - type: string - houseNumber: - type: string - houseNumberSupplement: - type: string - milestone: - type: string - direction: - type: string - namePrefix: - type: string - additionalNamePrefix: - type: string - nameSuffix: - type: string - additionalNameSuffix: - type: string - TaskClientStateDto: - required: - - businessPartnerResult - - processingState - - recordId - - taskId - type: object - properties: - taskId: - type: string - recordId: - type: string - description: The identifier of the gate record for which this task has been created - businessPartnerResult: - $ref: '#/components/schemas/BusinessPartner' - processingState: - $ref: '#/components/schemas/TaskProcessingStateDto' - description: The golden record task's processing state together with optional business partner data in case processing is done - TaskCreateRequest: - required: - - mode - - requests - type: object - properties: - mode: - type: string - description: The mode affecting which processing steps the business partner goes through - enum: - - UpdateFromSharingMember - - UpdateFromPool - requests: - type: array - description: The list of tasks to create - items: - $ref: '#/components/schemas/TaskCreateRequestEntry' - description: Request object to specify for which business partner data tasks should be created and in which mode - TaskCreateRequestEntry: - required: - - businessPartner - type: object - properties: - recordId: - type: string - description: The unique identifier for this record which was previously issued by the Orchestrator - businessPartner: - $ref: '#/components/schemas/BusinessPartner' - TaskCreateResponse: - required: - - createdTasks - type: object - properties: - createdTasks: - type: array - items: - $ref: '#/components/schemas/TaskClientStateDto' - description: Response object for giving a list of created tasks - TaskErrorDto: - required: - - description - - type - type: object - properties: - type: - type: string - description: The type of error that occurred - enum: - - Timeout - - Unspecified - description: - type: string - description: The free text, detailed description of the error - description: Describes an error that happened during processing of a task - TaskProcessingStateDto: - required: - - createdAt - - errors - - modifiedAt - - resultState - - step - - stepState - - timeout - type: object - properties: - resultState: - type: string - description: The processing result of the task, can also still be pending - enum: - - Pending - - Success - - Error - step: - type: string - description: The last step this task has entered - enum: - - CleanAndSync - - PoolSync - - Clean - stepState: - type: string - description: Whether the task is queued or already reserved for the latest step - enum: - - Queued - - Reserved - - Success - - Error - errors: - type: array - description: The actual errors that happened during processing if the task has an error result state. The errors refer to the latest step. - items: - $ref: '#/components/schemas/TaskErrorDto' - createdAt: - type: string - description: When the task has been created - format: date-time - modifiedAt: - type: string - description: When the task has last been modified - format: date-time - timeout: - type: string - description: The timestamp until the task is removed from the Orchestrator - format: date-time - deprecated: true - description: Contains detailed information about the current processing state of a golden record task - TaskStateRequest: - required: - - taskIds - type: object - properties: - taskIds: - type: array - items: - type: string - description: Request object for giving a list of task identifiers to search for the state of tasks - TaskStateResponse: - required: - - tasks - type: object - properties: - tasks: - type: array - items: - $ref: '#/components/schemas/TaskClientStateDto' - description: Response object for giving a list of task states - TaskStepReservationEntryDto: - required: - - businessPartner - - recordId - - requestKey - - taskId - type: object - properties: - taskId: - type: string - description: The identifier of the reserved task - recordId: - type: string - description: The identifier of the gate record for which this task has been created - businessPartner: - $ref: '#/components/schemas/BusinessPartner' - requestKey: - type: string - description: Task reservation entry - TaskStepReservationRequest: - required: - - amount - - step - type: object - properties: - amount: - type: integer - description: The maximum number of tasks to reserve. Can be fewer if queue is not full enough. - format: int32 - step: - type: string - description: The step queue to reserve from - enum: - - CleanAndSync - - PoolSync - - Clean - description: Request object for reserving a number of tasks waiting in a step queue. - TaskStepReservationResponse: - required: - - reservedTasks - - timeout - type: object - properties: - reservedTasks: - type: array - description: The reserved tasks with their business partner data to process - items: - $ref: '#/components/schemas/TaskStepReservationEntryDto' - timeout: - type: string - description: The timestamp until the reservation is valid and results are accepted - format: date-time - deprecated: true - description: Response object for giving a list of reserved tasks - TaskStepResultEntryDto: - required: - - businessPartner - - errors - - taskId - type: object - properties: - taskId: - type: string - description: The identifier of the task for which this is a result - businessPartner: - $ref: '#/components/schemas/BusinessPartner' - errors: - type: array - description: Errors that occurred during processing of this task - items: - $ref: '#/components/schemas/TaskErrorDto' - description: A step result for a golden record task - TaskStepResultRequest: - required: - - results - - step - type: object - properties: - step: - type: string - description: The step queue containing the tasks for which results are posted - enum: - - CleanAndSync - - PoolSync - - Clean - results: - type: array - items: - $ref: '#/components/schemas/TaskStepResultEntryDto' - description: Request object for posting step results of previously reserved tasks - UncategorizedProperties: - required: - - identifiers - - nameParts - - states - type: object - properties: - nameParts: - type: array - items: - type: string - identifiers: - type: array - items: - $ref: '#/components/schemas/Identifier' - states: - type: array - items: - $ref: '#/components/schemas/BusinessState' - address: - $ref: '#/components/schemas/PostalAddress' diff --git a/openApi/bpdm/kit_business-partner-kit-pool_openAPI.yaml b/openApi/bpdm/kit_business-partner-kit-pool_openAPI.yaml deleted file mode 100644 index 9207ec2d463..00000000000 --- a/openApi/bpdm/kit_business-partner-kit-pool_openAPI.yaml +++ /dev/null @@ -1,5368 +0,0 @@ -openapi: 3.0.1 -info: - title: Business Partner Data Management Pool - description: Service that manages and shares business partner data with other CatenaX services - version: 6.1.0 -servers: - - url: http://localhost:8080 - description: Generated server url -tags: - - name: Changelog Controller - description: Read change events of business partner data - - name: Legal Entity Controller - description: Read, create and update business partner of type legal entity - - name: Metadata Controller - description: Read and create supporting data that is referencable in business partner data - - name: Site Controller - description: Read, create and update business partner of type site - - name: Bpn Controller - description: Support functionality for BPN operations - - name: Address Controller - description: Read, create and update business partner of type address -paths: - /v6/sites: - get: - tags: - - Site Controller - summary: Get page of sites matching the pagination search criteria - description: This endpoint retrieves all existing business partners of type sites. - operationId: getSites - parameters: - - name: siteBpns - in: query - required: false - schema: - type: array - items: - type: string - - name: legalEntityBpns - in: query - required: false - schema: - type: array - items: - type: string - - name: name - in: query - required: false - schema: - type: string - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: Page of business partners matching the search criteria, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoSiteWithMainAddressVerboseDto' - '400': - description: On malformed pagination request - put: - tags: - - Site Controller - summary: Updates an existing site - description: Update existing business partner records of type site referenced via BPNS. The endpoint expects to receive the full updated record, including values that didn't change. - operationId: updateSite - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/SitePartnerUpdateRequest' - required: true - responses: - '200': - description: Update sites request was processed successfully, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/SitePartnerUpdateResponseWrapper' - '400': - description: On malformed requests - post: - tags: - - Site Controller - summary: Creates a new site - description: Create new business partners of type site by specifying the BPNL of the legal entity each site belongs to. If the legal entitiy cannot be found, the record is ignored.For matching purposes, on each record you can specify your own index value which will reappear in the corresponding record of the response. - operationId: createSite - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/SitePartnerCreateRequest' - required: true - responses: - '200': - description: New sites request was processed successfully, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/SitePartnerCreateResponseWrapper' - '400': - description: On malformed requests - /v6/legal-entities: - get: - tags: - - Legal Entity Controller - summary: Returns legal entities by different search parameters - description: 'This endpoint tries to find matches among all existing business partners of type legal entity, filtering out partners which entirely do not match and ranking the remaining partners according to the accuracy of the match. ' - operationId: getLegalEntities - parameters: - - name: bpnLs - in: query - required: false - schema: - type: array - items: - type: string - - name: legalName - in: query - required: false - schema: - type: string - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: Page of business partners matching the search criteria, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLegalEntityWithLegalAddressVerboseDto' - '400': - description: On malformed search or pagination request - put: - tags: - - Legal Entity Controller - summary: Updates an existing legal entity - description: Update existing business partner records of type legal entity referenced via BPNL. The endpoint expects to receive the full updated record, including values that didn't change. - operationId: updateBusinessPartners - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/LegalEntityPartnerUpdateRequest' - required: true - responses: - '200': - description: Update legal entities request was processed successfully, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/LegalEntityPartnerUpdateResponseWrapper' - '400': - description: On malformed requests - post: - tags: - - Legal Entity Controller - summary: Creates a new legal entity - description: Create new business partners of type legal entity. The given additional identifiers of a record need to be unique, otherwise they are ignored. For matching purposes, on each record you can specify your own index value which will reappear in the corresponding record of the response. - operationId: createBusinessPartners - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/LegalEntityPartnerCreateRequest' - required: true - responses: - '200': - description: New legal entities request was processed successfully, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/LegalEntityPartnerCreateResponseWrapper' - '400': - description: On malformed requests - /v6/addresses: - get: - tags: - - Address Controller - summary: Returns addresses by different search parameters - description: 'This endpoint tries to find matches among all existing business partners of type address, filtering out partners which entirely do not match and ranking the remaining partners according to the accuracy of the match. The match of a partner is better the higher its relevancy score. ' - operationId: getAddresses_1 - parameters: - - name: addressBpns - in: query - required: false - schema: - type: array - items: - type: string - - name: legalEntityBpns - in: query - required: false - schema: - type: array - items: - type: string - - name: siteBpns - in: query - required: false - schema: - type: array - items: - type: string - - name: name - in: query - required: false - schema: - type: string - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: Page of addresses matching the search criteria, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLogisticAddressVerboseDto' - '400': - description: On malformed search or pagination request - put: - tags: - - Address Controller - summary: Updates an existing address - description: Update existing business partner records of type address referenced via BPNA. The endpoint expects to receive the full updated record, including values that didn't change. - operationId: updateAddresses - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/AddressPartnerUpdateRequest' - required: true - responses: - '200': - description: The successfully updated records, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/AddressPartnerUpdateResponseWrapper' - '400': - description: On malformed requests - post: - tags: - - Address Controller - summary: Creates a new address - description: Create new business partners of type address by specifying the BPN of the parent each address belongs to. A parent can be either a site or legal entity business partner. If the parent cannot be found, the record is ignored.For matching purposes, on each record you can specify your own index value which will reappear in the corresponding record of the response. - operationId: createAddresses - requestBody: - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/AddressPartnerCreateRequest' - required: true - responses: - '200': - description: New business partner record successfully created, possible errors are returned - content: - application/json: - schema: - $ref: '#/components/schemas/AddressPartnerCreateResponseWrapper' - '400': - description: On malformed requests - /v6/sites/search: - post: - tags: - - Site Controller - summary: Returns sites by an array of BPNS and/or an array of corresponding BPNL - description: Search business partners of type site by their BPNSs or by the BPNLs of their parent legal entities - operationId: postSiteSearch - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SiteSearchRequest' - required: true - responses: - '200': - description: Found sites that belong to specified legal entites - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoSiteWithMainAddressVerboseDto' - '400': - description: On malformed request parameters - /v6/members/sites/search: - post: - tags: - - Site Controller - operationId: postSiteSearch_1 - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SiteSearchRequest' - required: true - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoSiteWithMainAddressVerboseDto' - /v6/members/legal-entities/search: - post: - tags: - - Legal Entity Controller - operationId: searchLegalEntities - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LegalEntitySearchRequest' - required: true - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLegalEntityWithLegalAddressVerboseDto' - /v6/members/changelog/search: - post: - tags: - - Changelog Controller - operationId: searchChangelogEntries - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ChangelogSearchRequest' - required: true - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoChangelogEntryVerboseDto' - /v6/members/addresses/search: - post: - tags: - - Address Controller - operationId: searchAddresses - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/AddressSearchRequest' - required: true - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLogisticAddressVerboseDto' - /v6/legal-forms: - get: - tags: - - Metadata Controller - summary: Returns all legal forms - description: Lists all currently known legal forms in a paginated result - operationId: getLegalForms - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: Page of existing legal forms, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLegalFormDto' - '400': - description: On malformed request parameters - post: - tags: - - Metadata Controller - summary: Creates a new legal form - description: 'Create a new legal form which can be referenced by business partner records. The actual name of the legal form is free to choose and doesn''t need to be unique. The technical key can be freely chosen but needs to be unique for the businessPartnerType as it is used as reference by the business partner records. A recommendation for technical keys: They should be short, descriptive and use a restricted common character set in order to ensure compatibility with older systems.' - operationId: createLegalForm - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LegalFormRequest' - required: true - responses: - '200': - description: New legal form successfully created - content: - application/json: - schema: - $ref: '#/components/schemas/LegalFormDto' - '400': - description: On malformed request parameters - '409': - description: Legal form with specified technical key already exists - /v6/legal-entities/search: - post: - tags: - - Legal Entity Controller - summary: Returns legal entities by different search parameters - description: Search legal entity partners by their BPNLs. The response can contain less results than the number of BPNLs that were requested, if some of the BPNLs did not exist. For a single request, the maximum number of BPNLs to search for is limited to ${bpdm.bpn.search-request-limit} entries. - operationId: postLegalEntitySearch - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LegalEntitySearchRequest' - required: true - responses: - '200': - description: Found legal entites - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLegalEntityWithLegalAddressVerboseDto' - '400': - description: On malformed request parameters or if number of requested bpns exceeds limit - /v6/identifier-types: - get: - tags: - - Metadata Controller - summary: Returns all identifier types filtered by business partner type and country. - description: Lists all matching identifier types including validity details in a paginated result - operationId: getIdentifierTypes - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - - name: businessPartnerType - in: query - required: true - schema: - type: string - description: Specifies if an identifier type is valid for legal entities (L) or addresses (A). Sites (S) are not supported. - enum: - - LEGAL_ENTITY - - ADDRESS - - name: country - in: query - required: false - schema: - type: string - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - responses: - '200': - description: Page of existing identifier types, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoIdentifierTypeDto' - '400': - description: On malformed request parameters - post: - tags: - - Metadata Controller - summary: Creates a new identifier type - description: 'Create a new identifier type (including validity details) which can be referenced by business partner records. Identifier types such as BPN or VAT determine with which kind of values a business partner can be identified with. The actual name of the identifier type is free to choose and doesn''t need to be unique. The technical key can be freely chosen but needs to be unique for the businessPartnerType as it is used as reference by the business partner records. A recommendation for technical keys: They should be short, descriptive and use a restricted common character set in order to ensure compatibility with older systems.' - operationId: createIdentifierType - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IdentifierTypeDto' - required: true - responses: - '200': - description: New identifier type successfully created - content: - application/json: - schema: - $ref: '#/components/schemas/IdentifierTypeDto' - '400': - description: On malformed request parameters - '409': - description: Identifier type with specified technical key already exists - /v6/business-partners/changelog/search: - post: - tags: - - Changelog Controller - summary: Returns changelog entries as of a specified timestamp, optionally filtered by a list of BPNL/S/A, or business partner types - operationId: getChangelogEntries - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ChangelogSearchRequest' - required: true - responses: - '200': - description: The specified changelog entries - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoChangelogEntryVerboseDto' - '400': - description: On malformed pagination request - '404': - description: No business partner found for specified bpn - /v6/bpn/search: - post: - tags: - - Bpn Controller - summary: Returns a list of identifier mappings of an identifier to a BPNL/A/S, specified by a business partner type, identifier type and identifier values - description: Find business partner numbers by identifiers. The response can contain less results than the number of identifier values that were requested, if some of the identifiers did not exist. For a single request, the maximum number of identifier values to search for is limited to ${bpdm.bpn.search-request-limit} entries. - operationId: findBpnsByIdentifiers - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IdentifiersSearchRequest' - required: true - responses: - '200': - description: Found bpn to identifier value mappings - content: - application/json: - schema: - uniqueItems: true - type: array - items: - $ref: '#/components/schemas/BpnIdentifierMappingDto' - '400': - description: On malformed request parameters or if number of requested bpns exceeds limit - '404': - description: Specified identifier type not found - /v6/addresses/search: - post: - tags: - - Address Controller - summary: Returns addresses by an array of BPNA and/or an array of corresponding BPNS and/or an array of corresponding BPNL. - description: Search business partners of type address by their BPNA or their parents' BPNL or BPNS. - operationId: searchAddresses_1 - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/AddressSearchRequest' - required: true - responses: - '200': - description: Found sites for the specified sites and legal entities - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLogisticAddressVerboseDto' - '400': - description: On malformed pagination request - /v6/sites/{bpns}: - get: - tags: - - Site Controller - summary: Returns a site by its BPNS - description: Get business partners of type site by BPNS ignoring case. - operationId: getSite - parameters: - - name: bpns - in: path - description: BPNS value - required: true - schema: - type: string - responses: - '200': - description: Found site with specified BPNS - content: - application/json: - schema: - $ref: '#/components/schemas/SiteWithMainAddressVerboseDto' - '400': - description: On malformed request parameters - '404': - description: No site found under specified BPNS - /v6/legal-entities/{idValue}: - get: - tags: - - Legal Entity Controller - summary: Returns a legal entity by identifier, like BPN, DUNS or EU VAT ID, specified by the identifier type - description: This endpoint tries to find a business partner by the specified identifier. The identifier value is case insensitively compared but needs to be given exactly. By default the value given is interpreted as a BPN. By specifying the technical key of another identifier typethe value is matched against the identifiers of that given type. - operationId: getLegalEntity - parameters: - - name: idValue - in: path - description: Identifier value - required: true - schema: - type: string - - name: idType - in: query - description: Type of identifier to use, defaults to BPN when omitted - required: false - schema: - type: string - default: BPN - responses: - '200': - description: Found business partner with specified identifier - content: - application/json: - schema: - $ref: '#/components/schemas/LegalEntityWithLegalAddressVerboseDto' - '400': - description: On malformed request parameters - '404': - description: No business partner found under specified identifier or specified identifier type not found - /v6/legal-entities/{bpnl}/sites: - get: - tags: - - Legal Entity Controller - summary: Returns all sites of a legal entity with a specific BPNL - description: Get business partners of type site belonging to a business partner of type legal entity, identified by the business partner's bpnl ignoring case. - operationId: getSites_1 - parameters: - - name: bpnl - in: path - description: BPNL value - required: true - schema: - type: string - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: The sites for the specified bpnl - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoSiteVerboseDto' - '400': - description: On malformed pagination request - '404': - description: No business partner found for specified bpnl - /v6/legal-entities/{bpnl}/addresses: - get: - tags: - - Legal Entity Controller - summary: Returns all addresses of a legal entity with a specific BPNL - description: Get business partners of type address belonging to a business partner of type legal entity, identified by the business partner's BPNL ignoring case. - operationId: getAddresses - parameters: - - name: bpnl - in: path - description: BPNL value - required: true - schema: - type: string - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: The addresses for the specified BPNL - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoLogisticAddressVerboseDto' - '400': - description: On malformed pagination request - '404': - description: No business partner found for specified BPNL - /v6/field-quality-rules/: - get: - tags: - - Metadata Controller - summary: Get all field quality rules filtered by country (specified by its ISO 3166-1 alpha-2 country code) - description: List the country specific data rules for entity fields.All fields that are not in this list are considered to be forbidden. - operationId: getFieldQualityRules - parameters: - - name: country - in: query - description: ISO 3166-1 alpha-2 country code - required: true - schema: - type: string - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - responses: - '200': - description: List of the existing rules for the given country - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/FieldQualityRuleDto' - '400': - description: On malformed request parameters - /v6/administrative-areas-level1: - get: - tags: - - Metadata Controller - summary: Get page of country subdivisions suitable for the administrativeAreaLevel1 address property - description: Lists all currently known country subdivisions according to ISO 3166-2 in a paginated result - operationId: getAdminAreasLevel1 - parameters: - - name: page - in: query - description: Number of page to get results from - required: false - schema: - minimum: 0 - type: string - default: '0' - - name: size - in: query - description: Size of each page - required: false - schema: - maximum: 100 - minimum: 0 - type: string - default: '10' - responses: - '200': - description: Page of existing country subdivisions, may be empty - content: - application/json: - schema: - $ref: '#/components/schemas/PageDtoCountrySubdivisionDto' - '400': - description: On malformed request parameters - /v6/addresses/{bpna}: - get: - tags: - - Address Controller - summary: Returns an address by its BPNA - description: Get business partners of type address by BPNA ignoring case. - operationId: getAddress - parameters: - - name: bpna - in: path - description: BPNA value - required: true - schema: - type: string - responses: - '200': - description: Found address with specified BPNA - content: - application/json: - schema: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - '400': - description: On malformed request parameters - '404': - description: No address found under specified BPNA -components: - schemas: - AddressIdentifierDto: - required: - - type - - value - type: object - properties: - value: - type: string - description: The value of the identifier like "0847976000005". - type: - type: string - description: The type of the identifier. - description: An address identifier (uniquely) identifies the address, such as the Global Location Number (GLN). - AddressIdentifierVerboseDto: - required: - - type - - value - type: object - properties: - value: - type: string - description: The value of the identifier like "0847976000005". - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoString' - description: An address identifier (uniquely) identifies the address, such as the Global Location Number (GLN). - AddressPartnerCreateRequest: - required: - - bpnParent - - confidenceCriteria - - identifiers - - physicalPostalAddress - - states - type: object - properties: - name: - type: string - description: The name of the address. This is not according to official registers but according to the name the sharing member chooses. - states: - type: array - description: The list of (temporary) states of the address. - items: - $ref: '#/components/schemas/AddressStateDto' - identifiers: - type: array - description: The list of identifiers of the address. - items: - $ref: '#/components/schemas/AddressIdentifierDto' - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - bpnParent: - type: string - description: BPNL of the legal entity or BPNS of the site this address belongs to. - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - requestKey: - type: string - description: Request for creating new business partner record of type address. In general, an address is a collection of information to describe a physical location, using a street name with a house number and/or a post office box as reference. In addition, an address consists of several postal attributes, such as country, region (state), county, township, city, district, or postal code, which help deliver mail.In Catena-X, an address is a type of business partner representing the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates).An address is owned by a legal entity. Thus, exactly one legal entity is assigned to an address. An address can belong to a site. Thus, one or no site is assigned to an address. An address is uniquely identified by the BPNA. - AddressPartnerCreateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/AddressPartnerCreateVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoAddressCreateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - AddressPartnerCreateVerboseDto: - required: - - bpna - - confidenceCriteria - - createdAt - - identifiers - - isCatenaXMemberData - - physicalPostalAddress - - states - - updatedAt - type: object - properties: - bpna: - type: string - description: A BPNA represents and uniquely identifies an address, which can be the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates). It is important to note that only the BPNL must be used to uniquely identify a legal entity. Even in the case that the BPNA represents the legal address of the legal entity, it shall not be used to uniquely identify the legal entity. - name: - type: string - description: The name of the address. This is not according to official registers but according to the name the sharing member chooses. - states: - type: array - description: The list of (temporary) states of the address. - items: - $ref: '#/components/schemas/AddressStateVerboseDto' - identifiers: - type: array - description: The list of identifiers of the address. - items: - $ref: '#/components/schemas/AddressIdentifierVerboseDto' - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressVerboseDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressVerboseDto' - bpnLegalEntity: - type: string - description: The BPNL of the legal entity owning the address. - bpnSite: - type: string - description: The BPNS of the site the address belongs to. - isCatenaXMemberData: - type: boolean - description: Indicates whether the address is owned and thus provided by a Catena-X Member. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - addressType: - type: string - description: Indicates the address type, the legal address to a legal entity or the main address to a site, an additional address, or both legal and site address.The site main address is where typically the main entrance or the reception is located, or where the mail is delivered to. - enum: - - LegalAndSiteMainAddress - - LegalAddress - - SiteMainAddress - - AdditionalAddress - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - description: Created business partner of type address. In general, an address is a collection of information to describe a physical location, using a street name with a house number and/or a post office box as reference. In addition, an address consists of several postal attributes, such as country, region (state), county, township, city, district, or postal code, which help deliver mail.In Catena-X, an address is a type of business partner representing the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates).An address is owned by a legal entity. Thus, exactly one legal entity is assigned to an address. An address can belong to a site. Thus, one or no site is assigned to an address. An address is uniquely identified by the BPNA. - AddressPartnerUpdateRequest: - required: - - bpna - - confidenceCriteria - - identifiers - - physicalPostalAddress - - requestKey - - states - type: object - properties: - bpna: - type: string - description: A BPNA represents and uniquely identifies an address, which can be the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates). It is important to note that only the BPNL must be used to uniquely identify a legal entity. Even in the case that the BPNA represents the legal address of the legal entity, it shall not be used to uniquely identify the legal entity. - name: - type: string - description: The name of the address. This is not according to official registers but according to the name the sharing member chooses. - states: - type: array - description: The list of (temporary) states of the address. - items: - $ref: '#/components/schemas/AddressStateDto' - identifiers: - type: array - description: The list of identifiers of the address. - items: - $ref: '#/components/schemas/AddressIdentifierDto' - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - requestKey: - type: string - description: Request for updating a business partner record of type address. In general, an address is a collection of information to describe a physical location, using a street name with a house number and/or a post office box as reference. In addition, an address consists of several postal attributes, such as country, region (state), county, township, city, district, or postal code, which help deliver mail.In Catena-X, an address is a type of business partner representing the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates).An address is owned by a legal entity. Thus, exactly one legal entity is assigned to an address. An address can belong to a site. Thus, one or no site is assigned to an address. An address is uniquely identified by the BPNA. - AddressPartnerUpdateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoAddressUpdateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - AddressSearchRequest: - required: - - addressBpns - - legalEntityBpns - - siteBpns - type: object - properties: - addressBpns: - type: array - items: - type: string - legalEntityBpns: - type: array - items: - type: string - siteBpns: - type: array - items: - type: string - name: - type: string - AddressStateDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - type: string - description: 'One of the state types: active, inactive.' - enum: - - ACTIVE - - INACTIVE - description: An address state indicates if the address is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the business partner is still operating at that address. - AddressStateVerboseDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoBusinessStateType' - description: An address state indicates if the address is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the business partner is still operating at that address. - AlternativePostalAddressDto: - required: - - city - - country - - deliveryServiceNumber - - deliveryServiceType - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - type: string - description: The 2-digit country code of the physical postal address according to ISO 3166-1. - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - administrativeAreaLevel1: - type: string - description: The 2-digit country subdivision code according to ISO 3166-2, such as a region within a country. - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - deliveryServiceType: - type: string - description: 'One of the alternative postal address types: P.O. box, private bag, boite postale.' - enum: - - PO_BOX - - PRIVATE_BAG - - BOITE_POSTALE - deliveryServiceQualifier: - type: string - description: The qualifier uniquely identifying the delivery service endpoint of the alternative postal address in conjunction with the delivery service number. In some countries for example, entering a P.O. box number, postal code and city is not sufficient to uniquely identify a P.O. box, because the same P.O. box number is assigned multiple times in some cities. - deliveryServiceNumber: - type: string - description: The number indicating the delivery service endpoint of the alternative postal address to which the delivery is to be delivered, such as a P.O. box number or a private bag number. - description: An alternative postal address describes an alternative way of delivery for example if the goods are to be picked up somewhere else. - AlternativePostalAddressVerboseDto: - required: - - city - - country - - deliveryServiceNumber - - deliveryServiceType - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoCountryCode' - administrativeAreaLevel1: - $ref: '#/components/schemas/RegionDto' - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - deliveryServiceType: - type: string - description: 'One of the alternative postal address types: P.O. box, private bag, boite postale.' - enum: - - PO_BOX - - PRIVATE_BAG - - BOITE_POSTALE - deliveryServiceQualifier: - type: string - description: The qualifier uniquely identifying the delivery service endpoint of the alternative postal address in conjunction with the delivery service number. In some countries for example, entering a P.O. box number, postal code and city is not sufficient to uniquely identify a P.O. box, because the same P.O. box number is assigned multiple times in some cities. - deliveryServiceNumber: - type: string - description: The number indicating the delivery service endpoint of the alternative postal address to which the delivery is to be delivered, such as a P.O. box number or a private bag number. - description: An alternative postal address describes an alternative way of delivery for example if the goods are to be picked up somewhere else. - BpnIdentifierMappingDto: - required: - - bpn - - idValue - type: object - properties: - idValue: - type: string - description: Value of the identifier - bpn: - type: string - description: Business Partner Number - description: Mapping of Business Partner Number to identifier value - ChangelogEntryVerboseDto: - required: - - bpn - - businessPartnerType - - changelogType - - timestamp - type: object - properties: - bpn: - type: string - description: The business partner number for which the changelog entry was created. Can be either a BPNL, BPNS or BPNA. - businessPartnerType: - type: string - description: 'One of the types of business partners for which the changelog entry was created: legal entity, site, address.' - enum: - - LEGAL_ENTITY - - SITE - - ADDRESS - - GENERIC - timestamp: - type: string - description: The date and time when the changelog entry was created. - format: date-time - changelogType: - type: string - description: 'One of the actions for which the changelog entry was created: create, update.' - enum: - - CREATE - - UPDATE - description: An entry of the changelog, which is created each time a business partner is modified and contains data about the change. The actual new state of the business partner is not included. - ChangelogSearchRequest: - type: object - properties: - timestampAfter: - type: string - description: Only changelog entries created after this time. Ignored if empty. - format: date-time - example: '2023-03-20T10:23:28.194Z' - bpns: - uniqueItems: true - type: array - description: Only for business partners with the given array of BPNL/S/A. Ignored if empty. - items: - type: string - businessPartnerTypes: - uniqueItems: true - type: array - description: Only for business partners with the given array of business partner types. Ignored if empty. - items: - type: string - enum: - - LEGAL_ENTITY - - SITE - - ADDRESS - - GENERIC - description: Request for searching and filtering the business partner changelog - ConfidenceCriteriaDto: - required: - - checkedByExternalDataSource - - confidenceLevel - - lastConfidenceCheckAt - - nextConfidenceCheckAt - - numberOfSharingMembers - - sharedByOwner - type: object - properties: - sharedByOwner: - type: boolean - checkedByExternalDataSource: - type: boolean - numberOfSharingMembers: - type: integer - format: int32 - lastConfidenceCheckAt: - type: string - format: date-time - nextConfidenceCheckAt: - type: string - format: date-time - confidenceLevel: - type: integer - format: int32 - CountrySubdivisionDto: - required: - - code - - countryCode - - name - type: object - properties: - countryCode: - type: string - description: Country code - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - code: - type: string - description: The country subdivision code according to ISO 3166-2 - name: - type: string - description: The name of the country subdivision according to ISO 3166-2 - description: Country subdivision - ErrorInfoAddressCreateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: AddressCreateError - enum: - - BpnNotValid - - SiteNotFound - - LegalEntityNotFound - - RegionNotFound - - IdentifierNotFound - - AddressDuplicateIdentifier - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - ErrorInfoAddressUpdateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: AddressUpdateError - enum: - - AddressNotFound - - RegionNotFound - - IdentifierNotFound - - AddressDuplicateIdentifier - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - ErrorInfoLegalEntityCreateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: LegalEntityCreateError - enum: - - LegalEntityDuplicateIdentifier - - LegalFormNotFound - - LegalEntityIdentifierNotFound - - LegalAddressRegionNotFound - - LegalAddressIdentifierNotFound - - LegalAddressDuplicateIdentifier - - LegalEntityErrorMapping - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - ErrorInfoLegalEntityUpdateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: LegalEntityUpdateError - enum: - - LegalEntityNotFound - - LegalEntityDuplicateIdentifier - - LegalFormNotFound - - LegalEntityIdentifierNotFound - - LegalAddressRegionNotFound - - LegalAddressIdentifierNotFound - - LegalAddressDuplicateIdentifier - - LegalEntityErrorMapping - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - ErrorInfoSiteCreateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: SiteCreateError - enum: - - LegalEntityNotFound - - MainAddressIdentifierNotFound - - MainAddressRegionNotFound - - MainAddressDuplicateIdentifier - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - ErrorInfoSiteUpdateError: - title: ErrorInfo - required: - - errorCode - - message - type: object - properties: - errorCode: - type: string - description: SiteUpdateError - enum: - - SiteNotFound - - MainAddressIdentifierNotFound - - MainAddressRegionNotFound - - MainAddressDuplicateIdentifier - message: - type: string - description: Error message that explains the error - entityKey: - type: string - description: 'Key of the entity that failed from the request object: index or BPN' - description: Holds information about failures when creating or updating an entity - FieldQualityRuleDto: - required: - - country - - fieldPath - - qualityLevel - type: object - properties: - fieldPath: - type: string - description: Path to the field - schemaName: - type: string - description: Schema name of the entity the field belongs to - country: - type: string - description: Country for wich the rule is valid - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - qualityLevel: - type: string - description: Defines the quality of an entity field. - enum: - - MANDATORY - - OPTIONAL - - FORBIDDEN - description: 'Rule for the quality level of an entity field ' - GeoCoordinateDto: - required: - - latitude - - longitude - type: object - properties: - longitude: - type: number - description: Longitude coordinate - format: float - latitude: - type: number - description: Latitude coordinate - format: float - altitude: - type: number - description: Altitude, if applicable - format: float - description: The exact location of the physical postal address in latitude, longitude, and altitude. - IdentifierTypeDetailDto: - required: - - mandatory - type: object - properties: - country: - type: string - description: 2-digit country code for which this identifier is valid; null for universal identifiers. - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - mandatory: - type: boolean - description: True if identifier is mandatory in this country. - description: Information for which countries an identifier type is valid and mandatory. - IdentifierTypeDto: - required: - - businessPartnerType - - details - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: The technical identifier (unique in combination with businessPartnerType). - businessPartnerType: - type: string - description: Specifies if an identifier type is valid for legal entities (L) or addresses (A). Sites (S) are not supported. - enum: - - LEGAL_ENTITY - - ADDRESS - name: - type: string - description: The name of the identifier type. - details: - type: array - description: Validity details. - items: - $ref: '#/components/schemas/IdentifierTypeDetailDto' - description: An identifier type defines the name or category of an identifier, such as the German Handelsregisternummer, VAT number, Global Location Number (GLN), etc. The identifier type is valid for a business partner type. - IdentifiersSearchRequest: - required: - - businessPartnerType - - idType - - idValues - type: object - properties: - businessPartnerType: - type: string - description: Specifies if an identifier type is valid for legal entities (L) or addresses (A). Sites (S) are not supported. - enum: - - LEGAL_ENTITY - - ADDRESS - idType: - type: string - description: Technical key of the type to which the identifiers belongs to - idValues: - type: array - description: Values of the identifiers - items: - type: string - description: Values of the identifiers - description: Contains identifiers to search legal entities by - LegalEntityIdentifierDto: - required: - - type - - value - type: object - properties: - value: - type: string - description: The value of the identifier like "DE123465789". - type: - type: string - description: The type of the identifier. - issuingBody: - type: string - description: The name of the official register, where the identifier is registered. For example, a Handelsregisternummer in Germany is only valid with its corresponding Handelsregister. - description: A legal entity identifier (uniquely) identifies the legal entity, such as the German Handelsregisternummer, a VAT number, etc. - LegalEntityIdentifierVerboseDto: - required: - - type - - value - type: object - properties: - value: - type: string - description: The value of the identifier like "DE123465789". - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoString' - issuingBody: - type: string - description: The name of the official register, where the identifier is registered. For example, a Handelsregisternummer in Germany is only valid with its corresponding Handelsregister. - description: A legal entity identifier (uniquely) identifies the legal entity, such as the German Handelsregisternummer, a VAT number, etc. - LegalEntityPartnerCreateRequest: - required: - - confidenceCriteria - - identifiers - - isCatenaXMemberData - - legalAddress - - legalName - - states - type: object - properties: - legalName: - type: string - description: The name of the legal entity according to official registers. - legalShortName: - type: string - description: The abbreviated name of the legal entity. - legalForm: - type: string - description: The legal form of the legal entity. - identifiers: - type: array - description: The list of identifiers of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityIdentifierDto' - states: - type: array - description: The list of (temporary) states of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityStateDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the legal entity is owned and thus provided by a Catena-X Member. - legalAddress: - $ref: '#/components/schemas/LogisticAddressDto' - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - requestKey: - type: string - description: Request for creating new business partner record of type legal entity. In general, a legal entity is a juridical person that has legal rights and duties related to contracts, agreements, and obligations. The term especially applies to any kind of organization (such as an enterprise or company, university, association, etc.) established under the law applicable to a country.In Catena-X, a legal entity is a type of business partner representing a legally registered organization with its official registration information, such as legal name (including legal form, if registered), legal address and tax number.A legal entity has exactly one legal address, but it is possible to specify additional addresses that a legal entity owns. Thus, at least one address is assigned to a legal entity. A legal entity can own sites. Thus, many or no sites are assigned to a legal entity. A legal entity is uniquely identified by the BPNL. - LegalEntityPartnerCreateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/LegalEntityPartnerCreateVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoLegalEntityCreateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - LegalEntityPartnerCreateVerboseDto: - required: - - bpnl - - confidenceCriteria - - createdAt - - currentness - - identifiers - - isCatenaXMemberData - - legalAddress - - legalName - - relations - - states - - updatedAt - type: object - properties: - bpnl: - type: string - description: A BPNL represents and uniquely identifies a legal entity, which is defined by its legal name (including legal form, if registered), legal address and tax number. - legalName: - type: string - description: The name of the legal entity according to official registers. - legalShortName: - type: string - description: The abbreviated name of the legal entity. - legalForm: - $ref: '#/components/schemas/LegalFormDto' - identifiers: - type: array - description: The list of identifiers of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityIdentifierVerboseDto' - states: - type: array - description: The list of (temporary) states of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityStateVerboseDto' - relations: - type: array - description: Relations to other business partners. - items: - $ref: '#/components/schemas/RelationVerboseDto' - currentness: - type: string - description: The date the business partner data was last indicated to be still current. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the legal entity is owned and thus provided by a Catena-X Member. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - legalAddress: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - description: Created/updated business partner of type legal entity. In general, a legal entity is a juridical person that has legal rights and duties related to contracts, agreements, and obligations. The term especially applies to any kind of organization (such as an enterprise or company, university, association, etc.) established under the law applicable to a country.In Catena-X, a legal entity is a type of business partner representing a legally registered organization with its official registration information, such as legal name (including legal form, if registered), legal address and tax number.A legal entity has exactly one legal address, but it is possible to specify additional addresses that a legal entity owns. Thus, at least one address is assigned to a legal entity. A legal entity can own sites. Thus, many or no sites are assigned to a legal entity. A legal entity is uniquely identified by the BPNL. - LegalEntityPartnerUpdateRequest: - required: - - bpnl - - confidenceCriteria - - identifiers - - isCatenaXMemberData - - legalAddress - - legalName - - requestKey - - states - type: object - properties: - bpnl: - type: string - description: A BPNL represents and uniquely identifies a legal entity, which is defined by its legal name (including legal form, if registered), legal address and tax number. - legalName: - type: string - description: The name of the legal entity according to official registers. - legalShortName: - type: string - description: The abbreviated name of the legal entity. - legalForm: - type: string - description: The legal form of the legal entity. - identifiers: - type: array - description: The list of identifiers of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityIdentifierDto' - states: - type: array - description: The list of (temporary) states of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityStateDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the legal entity is owned and thus provided by a Catena-X Member. - legalAddress: - $ref: '#/components/schemas/LogisticAddressDto' - requestKey: - type: string - description: Request for updating a business partner record of type legal entity. In general, a legal entity is a juridical person that has legal rights and duties related to contracts, agreements, and obligations. The term especially applies to any kind of organization (such as an enterprise or company, university, association, etc.) established under the law applicable to a country.In Catena-X, a legal entity is a type of business partner representing a legally registered organization with its official registration information, such as legal name (including legal form, if registered), legal address and tax number.A legal entity has exactly one legal address, but it is possible to specify additional addresses that a legal entity owns. Thus, at least one address is assigned to a legal entity. A legal entity can own sites. Thus, many or no sites are assigned to a legal entity. A legal entity is uniquely identified by the BPNL. - LegalEntityPartnerUpdateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/LegalEntityPartnerCreateVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoLegalEntityUpdateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - LegalEntitySearchRequest: - required: - - bpnLs - type: object - properties: - bpnLs: - type: array - items: - type: string - legalName: - type: string - LegalEntityStateDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - type: string - description: 'One of the state types: active, inactive.' - enum: - - ACTIVE - - INACTIVE - description: A legal entity state indicates if the legal entity is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the legal entity is still operating. - LegalEntityStateVerboseDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoBusinessStateType' - description: A legal entity state indicates if the legal entity is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the legal entity is still operating. - LegalEntityWithLegalAddressVerboseDto: - required: - - bpnl - - confidenceCriteria - - createdAt - - currentness - - identifiers - - isCatenaXMemberData - - legalAddress - - legalName - - relations - - states - - updatedAt - type: object - properties: - bpnl: - type: string - description: A BPNL represents and uniquely identifies a legal entity, which is defined by its legal name (including legal form, if registered), legal address and tax number. - legalName: - type: string - description: The name of the legal entity according to official registers. - legalShortName: - type: string - description: The abbreviated name of the legal entity. - legalForm: - $ref: '#/components/schemas/LegalFormDto' - identifiers: - type: array - description: The list of identifiers of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityIdentifierVerboseDto' - states: - type: array - description: The list of (temporary) states of the legal entity. - items: - $ref: '#/components/schemas/LegalEntityStateVerboseDto' - relations: - type: array - description: Relations to other business partners. - items: - $ref: '#/components/schemas/RelationVerboseDto' - currentness: - type: string - description: The date the business partner data was last indicated to be still current. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the legal entity is owned and thus provided by a Catena-X Member. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - legalAddress: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - description: In general, a legal entity is a juridical person that has legal rights and duties related to contracts, agreements, and obligations. The term especially applies to any kind of organization (such as an enterprise or company, university, association, etc.) established under the law applicable to a country.In Catena-X, a legal entity is a type of business partner representing a legally registered organization with its official registration information, such as legal name (including legal form, if registered), legal address and tax number.A legal entity has exactly one legal address, but it is possible to specify additional addresses that a legal entity owns. Thus, at least one address is assigned to a legal entity. A legal entity can own sites. Thus, many or no sites are assigned to a legal entity. A legal entity is uniquely identified by the BPNL. - LegalFormDto: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: The technical identifier of the legal form according to ISO 20275. - name: - type: string - description: The name of legal form according to ISO 20275. - abbreviation: - type: string - description: The abbreviated name of the legal form, such as AG for German Aktiengesellschaft. - description: A legal form is a mandatory corporate legal framework by which companies can conduct business, charitable or other permissible activities. - LegalFormRequest: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: Unique key to be used for reference - name: - type: string - description: Full name of the legal form - abbreviation: - type: string - description: Abbreviation of the legal form name - description: New legal form record to be referenced by business partners - LogisticAddressDto: - required: - - confidenceCriteria - - identifiers - - physicalPostalAddress - - states - type: object - properties: - name: - type: string - description: The name of the address. This is not according to official registers but according to the name the sharing member chooses. - states: - type: array - description: The list of (temporary) states of the address. - items: - $ref: '#/components/schemas/AddressStateDto' - identifiers: - type: array - description: The list of identifiers of the address. - items: - $ref: '#/components/schemas/AddressIdentifierDto' - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - description: In general, an address is a collection of information to describe a physical location, using a street name with a house number and/or a post office box as reference. In addition, an address consists of several postal attributes, such as country, region (state), county, township, city, district, or postal code, which help deliver mail.In Catena-X, an address is a type of business partner representing the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates).An address is owned by a legal entity. Thus, exactly one legal entity is assigned to an address. An address can belong to a site. Thus, one or no site is assigned to an address. An address is uniquely identified by the BPNA. - LogisticAddressVerboseDto: - required: - - bpna - - confidenceCriteria - - createdAt - - identifiers - - isCatenaXMemberData - - physicalPostalAddress - - states - - updatedAt - type: object - properties: - bpna: - type: string - description: A BPNA represents and uniquely identifies an address, which can be the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates). It is important to note that only the BPNL must be used to uniquely identify a legal entity. Even in the case that the BPNA represents the legal address of the legal entity, it shall not be used to uniquely identify the legal entity. - name: - type: string - description: The name of the address. This is not according to official registers but according to the name the sharing member chooses. - states: - type: array - description: The list of (temporary) states of the address. - items: - $ref: '#/components/schemas/AddressStateVerboseDto' - identifiers: - type: array - description: The list of identifiers of the address. - items: - $ref: '#/components/schemas/AddressIdentifierVerboseDto' - physicalPostalAddress: - $ref: '#/components/schemas/PhysicalPostalAddressVerboseDto' - alternativePostalAddress: - $ref: '#/components/schemas/AlternativePostalAddressVerboseDto' - bpnLegalEntity: - type: string - description: The BPNL of the legal entity owning the address. - bpnSite: - type: string - description: The BPNS of the site the address belongs to. - isCatenaXMemberData: - type: boolean - description: Indicates whether the address is owned and thus provided by a Catena-X Member. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - addressType: - type: string - description: Indicates the address type, the legal address to a legal entity or the main address to a site, an additional address, or both legal and site address.The site main address is where typically the main entrance or the reception is located, or where the mail is delivered to. - enum: - - LegalAndSiteMainAddress - - LegalAddress - - SiteMainAddress - - AdditionalAddress - description: In general, an address is a collection of information to describe a physical location, using a street name with a house number and/or a post office box as reference. In addition, an address consists of several postal attributes, such as country, region (state), county, township, city, district, or postal code, which help deliver mail.In Catena-X, an address is a type of business partner representing the legal address of a legal entity, and/or the main address of a site, or any additional address of a legal entity or site (such as different gates).An address is owned by a legal entity. Thus, exactly one legal entity is assigned to an address. An address can belong to a site. Thus, one or no site is assigned to an address. An address is uniquely identified by the BPNA. - PageDtoChangelogEntryVerboseDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/ChangelogEntryVerboseDto' - description: Paginated collection of results - PageDtoCountrySubdivisionDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/CountrySubdivisionDto' - description: Paginated collection of results - PageDtoIdentifierTypeDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/IdentifierTypeDto' - description: Paginated collection of results - PageDtoLegalEntityWithLegalAddressVerboseDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/LegalEntityWithLegalAddressVerboseDto' - description: Paginated collection of results - PageDtoLegalFormDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/LegalFormDto' - description: Paginated collection of results - PageDtoLogisticAddressVerboseDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - description: Paginated collection of results - PageDtoSiteVerboseDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/SiteVerboseDto' - description: Paginated collection of results - PageDtoSiteWithMainAddressVerboseDto: - required: - - content - - contentSize - - page - - totalElements - - totalPages - type: object - properties: - totalElements: - type: integer - description: Total number of all results in all pages - format: int64 - totalPages: - type: integer - description: Total number pages - format: int32 - page: - type: integer - description: Current page number - format: int32 - contentSize: - type: integer - description: Number of results in the page - format: int32 - content: - type: array - description: Collection of results in the page - items: - $ref: '#/components/schemas/SiteWithMainAddressVerboseDto' - description: Paginated collection of results - PhysicalPostalAddressDto: - required: - - city - - country - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - type: string - description: The 2-digit country code of the physical postal address according to ISO 3166-1. - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - administrativeAreaLevel1: - type: string - description: The 2-digit country subdivision code according to ISO 3166-2, such as a region within a country. - administrativeAreaLevel2: - type: string - description: The name of the locally regulated secondary country subdivision of the physical postal address, such as county within a country. - administrativeAreaLevel3: - type: string - description: The name of the locally regulated tertiary country subdivision of the physical address, such as townships within a country. - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - district: - type: string - description: The name of the district of the physical postal address which divides the city in several smaller areas. - street: - $ref: '#/components/schemas/StreetDto' - companyPostalCode: - type: string - description: The company postal code of the physical postal address, which is sometimes required for large companies. - industrialZone: - type: string - description: 'The industrial zone of the physical postal address, designating an area for industrial development, synonym: industrial area.' - building: - type: string - description: The alphanumeric identifier of the building addressed by the physical postal address. - floor: - type: string - description: 'The number of a floor in the building addressed by the physical postal address, synonym: level.' - door: - type: string - description: 'The number of a door in the building on the respective floor addressed by the physical postal address, synonyms: room, suite.' - taxJurisdictionCode: - type: string - description: Tax jurisdiction codes are used to identify the specific jurisdiction(s) that a company belong to, particularly in bureaucratic processes such as tax returns and IRS forms. - description: A physical postal address describes the physical location of an office, warehouse, gate, etc. - PhysicalPostalAddressVerboseDto: - required: - - city - - country - type: object - properties: - geographicCoordinates: - $ref: '#/components/schemas/GeoCoordinateDto' - country: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoCountryCode' - administrativeAreaLevel1: - $ref: '#/components/schemas/RegionDto' - administrativeAreaLevel2: - type: string - description: The name of the locally regulated secondary country subdivision of the physical postal address, such as county within a country. - administrativeAreaLevel3: - type: string - description: The name of the locally regulated tertiary country subdivision of the physical address, such as townships within a country. - postalCode: - type: string - description: The alphanumeric identifier (sometimes including spaces or punctuation) of the physical postal address for the purpose of sorting mail, synonyms:postcode, post code, PIN or ZIP code. - city: - type: string - description: 'The name of the city of the physical postal address, synonyms: town, village, municipality.' - district: - type: string - description: The name of the district of the physical postal address which divides the city in several smaller areas. - street: - $ref: '#/components/schemas/StreetDto' - companyPostalCode: - type: string - description: The company postal code of the physical postal address, which is sometimes required for large companies. - industrialZone: - type: string - description: 'The industrial zone of the physical postal address, designating an area for industrial development, synonym: industrial area.' - building: - type: string - description: The alphanumeric identifier of the building addressed by the physical postal address. - floor: - type: string - description: 'The number of a floor in the building addressed by the physical postal address, synonym: level.' - door: - type: string - description: 'The number of a door in the building on the respective floor addressed by the physical postal address, synonyms: room, suite.' - taxJurisdictionCode: - type: string - description: Tax jurisdiction codes are used to identify the specific jurisdiction(s) that a company belong to, particularly in bureaucratic processes such as tax returns and IRS forms. - description: A physical postal address describes the physical location of an office, warehouse, gate, etc. - RegionDto: - required: - - countryCode - - regionCode - - regionName - type: object - properties: - countryCode: - type: string - description: Country code - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - regionCode: - type: string - description: Abbreviation or shorthand of the area - regionName: - type: string - description: Describes the full name of the region within a country according to ISO 3166-214 - description: Region within a country - RelationVerboseDto: - required: - - endBpnl - - startBpnl - - type - type: object - properties: - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoRelationType' - startBpnl: - type: string - description: BPN of partner which is the source of the relation - endBpnl: - type: string - description: BPN of partner which is the target of the relation - validFrom: - type: string - description: Time when the relation started - format: date-time - validTo: - type: string - description: Time when the relation ended - format: date-time - description: Directed relation between two business partners - SitePartnerCreateRequest: - required: - - bpnlParent - - confidenceCriteria - - mainAddress - - name - - states - type: object - properties: - name: - type: string - description: The name of the site. This is not according to official registers but according to the name the owner chooses. - states: - type: array - description: The list of the (temporary) states of the site. - items: - $ref: '#/components/schemas/SiteStateDto' - mainAddress: - $ref: '#/components/schemas/LogisticAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - bpnlParent: - type: string - description: The BPNL of the legal entity owning the site. - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - requestKey: - type: string - description: Request for creating new business partner record of type site. In general, a site is a delimited geographical area in which an organization (such as an enterprise or company, university, association, etc.) conducts business. In Catena-X, a site is a type of business partner representing a physical location or area owned by a legal entity, where a production plant, a warehouse, or an office building is located. A site is owned by a legal entity. Thus, exactly one legal entity is assigned to a site. A site has exactly one main address, but it is possible to specify additional addresses (such as different gates), that belong to a site. Thus, at least one address is assigned to a site. A site can only be uploaded and modified by the owner (the legal entity), because only the owner knows which addresses belong to which site. A site is uniquely identified by the BPNS. - SitePartnerCreateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/SitePartnerCreateVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoSiteCreateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - SitePartnerCreateVerboseDto: - required: - - bpnLegalEntity - - bpns - - confidenceCriteria - - createdAt - - isCatenaXMemberData - - mainAddress - - name - - states - - updatedAt - type: object - properties: - bpns: - type: string - description: A BPNS represents and uniquely identifies a site, which is where for example a production plant, a warehouse, or an office building is located. - name: - type: string - description: The name of the site. This is not according to official registers but according to the name the owner chooses. - states: - type: array - description: The list of the (temporary) states of the site. - items: - $ref: '#/components/schemas/SiteStateVerboseDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the site is owned and thus provided by a Catena-X Member. - bpnLegalEntity: - type: string - description: The BPNL of the legal entity owning the site. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - mainAddress: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - index: - type: string - description: User defined index to conveniently match this entry to the corresponding entry in the response. - description: Created/updated business partner of type site. In general, a site is a delimited geographical area in which an organization (such as an enterprise or company, university, association, etc.) conducts business. In Catena-X, a site is a type of business partner representing a physical location or area owned by a legal entity, where a production plant, a warehouse, or an office building is located. A site is owned by a legal entity. Thus, exactly one legal entity is assigned to a site. A site has exactly one main address, but it is possible to specify additional addresses (such as different gates), that belong to a site. Thus, at least one address is assigned to a site. A site can only be uploaded and modified by the owner (the legal entity), because only the owner knows which addresses belong to which site. A site is uniquely identified by the BPNS. - SitePartnerUpdateRequest: - required: - - bpns - - confidenceCriteria - - mainAddress - - name - - requestKey - - states - type: object - properties: - bpns: - type: string - description: A BPNS represents and uniquely identifies a site, which is where for example a production plant, a warehouse, or an office building is located. - name: - type: string - description: The name of the site. This is not according to official registers but according to the name the owner chooses. - states: - type: array - description: The list of the (temporary) states of the site. - items: - $ref: '#/components/schemas/SiteStateDto' - mainAddress: - $ref: '#/components/schemas/LogisticAddressDto' - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - requestKey: - type: string - description: Request for updating a business partner record of type site. In general, a site is a delimited geographical area in which an organization (such as an enterprise or company, university, association, etc.) conducts business. In Catena-X, a site is a type of business partner representing a physical location or area owned by a legal entity, where a production plant, a warehouse, or an office building is located. A site is owned by a legal entity. Thus, exactly one legal entity is assigned to a site. A site has exactly one main address, but it is possible to specify additional addresses (such as different gates), that belong to a site. Thus, at least one address is assigned to a site. A site can only be uploaded and modified by the owner (the legal entity), because only the owner knows which addresses belong to which site. A site is uniquely identified by the BPNS. - SitePartnerUpdateResponseWrapper: - required: - - entities - - entityCount - - errorCount - - errors - type: object - properties: - entities: - type: array - items: - $ref: '#/components/schemas/SitePartnerCreateVerboseDto' - errors: - type: array - items: - $ref: '#/components/schemas/ErrorInfoSiteUpdateError' - errorCount: - type: integer - format: int32 - entityCount: - type: integer - format: int32 - description: Holds information about successfully and failed entities after the creating/updating of several objects - SiteSearchRequest: - required: - - legalEntityBpns - - siteBpns - type: object - properties: - siteBpns: - type: array - items: - type: string - legalEntityBpns: - type: array - items: - type: string - name: - type: string - SiteStateDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - type: string - description: 'One of the state types: active, inactive.' - enum: - - ACTIVE - - INACTIVE - description: A site state indicates if the site is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the site is still operating. - SiteStateVerboseDto: - required: - - type - type: object - properties: - validFrom: - type: string - description: The date from which the state is valid. - format: date-time - validTo: - type: string - description: The date until the state is valid. - format: date-time - type: - $ref: '#/components/schemas/TypeKeyNameVerboseDtoBusinessStateType' - description: A site state indicates if the site is active or inactive. This does not describe the relation between a sharing member and a business partner and whether they have active business, but it describes whether the site is still operating. - SiteVerboseDto: - required: - - bpnLegalEntity - - bpns - - confidenceCriteria - - createdAt - - isCatenaXMemberData - - name - - states - - updatedAt - type: object - properties: - bpns: - type: string - description: A BPNS represents and uniquely identifies a site, which is where for example a production plant, a warehouse, or an office building is located. - name: - type: string - description: The name of the site. This is not according to official registers but according to the name the owner chooses. - states: - type: array - description: The list of the (temporary) states of the site. - items: - $ref: '#/components/schemas/SiteStateVerboseDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the site is owned and thus provided by a Catena-X Member. - bpnLegalEntity: - type: string - description: The BPNL of the legal entity owning the site. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - description: In general, a site is a delimited geographical area in which an organization (such as an enterprise or company, university, association, etc.) conducts business. In Catena-X, a site is a type of business partner representing a physical location or area owned by a legal entity, where a production plant, a warehouse, or an office building is located. A site is owned by a legal entity. Thus, exactly one legal entity is assigned to a site. A site has exactly one main address, but it is possible to specify additional addresses (such as different gates), that belong to a site. Thus, at least one address is assigned to a site. A site can only be uploaded and modified by the owner (the legal entity), because only the owner knows which addresses belong to which site. A site is uniquely identified by the BPNS. - SiteWithMainAddressVerboseDto: - required: - - bpnLegalEntity - - bpns - - confidenceCriteria - - createdAt - - isCatenaXMemberData - - mainAddress - - name - - states - - updatedAt - type: object - properties: - bpns: - type: string - description: A BPNS represents and uniquely identifies a site, which is where for example a production plant, a warehouse, or an office building is located. - name: - type: string - description: The name of the site. This is not according to official registers but according to the name the owner chooses. - states: - type: array - description: The list of the (temporary) states of the site. - items: - $ref: '#/components/schemas/SiteStateVerboseDto' - isCatenaXMemberData: - type: boolean - description: Indicates whether the site is owned and thus provided by a Catena-X Member. - bpnLegalEntity: - type: string - description: The BPNL of the legal entity owning the site. - createdAt: - type: string - description: The date when the data record has been created. - format: date-time - updatedAt: - type: string - description: The date when the data record has been last updated. - format: date-time - confidenceCriteria: - $ref: '#/components/schemas/ConfidenceCriteriaDto' - mainAddress: - $ref: '#/components/schemas/LogisticAddressVerboseDto' - description: In general, a site is a delimited geographical area in which an organization (such as an enterprise or company, university, association, etc.) conducts business. In Catena-X, a site is a type of business partner representing a physical location or area owned by a legal entity, where a production plant, a warehouse, or an office building is located. A site is owned by a legal entity. Thus, exactly one legal entity is assigned to a site. A site has exactly one main address, but it is possible to specify additional addresses (such as different gates), that belong to a site. Thus, at least one address is assigned to a site. A site can only be uploaded and modified by the owner (the legal entity), because only the owner knows which addresses belong to which site. A site is uniquely identified by the BPNS. - StreetDto: - type: object - properties: - name: - type: string - description: The name of the street. - houseNumber: - type: string - description: The number representing the exact location of a building within the street. - houseNumberSupplement: - type: string - milestone: - type: string - description: The number representing the exact location of an addressed object within a street without house numbers, such as within long roads. - direction: - type: string - description: The cardinal direction describing where the exit to the location of the addressed object on large highways / motorways is located, such as Highway 101 South. - namePrefix: - type: string - description: The street related information, which is usually printed before the official street name on an address label. - additionalNamePrefix: - type: string - description: The additional street related information, which is usually printed before the official street name on an address label. - nameSuffix: - type: string - description: The street related information, which is usually printed after the official street name on an address label. - additionalNameSuffix: - type: string - description: The additional street related information, which is usually printed after the official street name on an address label. - description: 'The street of the physical postal address, synonyms: road, avenue, lane, boulevard, highway' - TypeKeyNameVerboseDtoBusinessStateType: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: Unique key of this type for reference - enum: - - ACTIVE - - INACTIVE - name: - type: string - description: Name or denotation of this type - description: Named type uniquely identified by its technical key - TypeKeyNameVerboseDtoCountryCode: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: Unique key of this type for reference - enum: - - UNDEFINED - - AC - - AD - - AE - - AF - - AG - - AI - - AL - - AM - - AN - - AO - - AQ - - AR - - AS - - AT - - AU - - AW - - AX - - AZ - - BA - - BB - - BD - - BE - - BF - - BG - - BH - - BI - - BJ - - BL - - BM - - BN - - BO - - BQ - - BR - - BS - - BT - - BU - - BV - - BW - - BY - - BZ - - CA - - CC - - CD - - CF - - CG - - CH - - CI - - CK - - CL - - CM - - CN - - CO - - CP - - CR - - CS - - CU - - CV - - CW - - CX - - CY - - CZ - - DE - - DG - - DJ - - DK - - DM - - DO - - DZ - - EA - - EC - - EE - - EG - - EH - - ER - - ES - - ET - - EU - - EZ - - FI - - FJ - - FK - - FM - - FO - - FR - - FX - - GA - - GB - - GD - - GE - - GF - - GG - - GH - - GI - - GL - - GM - - GN - - GP - - GQ - - GR - - GS - - GT - - GU - - GW - - GY - - HK - - HM - - HN - - HR - - HT - - HU - - IC - - ID - - IE - - IL - - IM - - IN - - IO - - IQ - - IR - - IS - - IT - - JE - - JM - - JO - - JP - - KE - - KG - - KH - - KI - - KM - - KN - - KP - - KR - - KW - - KY - - KZ - - LA - - LB - - LC - - LI - - LK - - LR - - LS - - LT - - LU - - LV - - LY - - MA - - MC - - MD - - ME - - MF - - MG - - MH - - MK - - ML - - MM - - MN - - MO - - MP - - MQ - - MR - - MS - - MT - - MU - - MV - - MW - - MX - - MY - - MZ - - NA - - NC - - NE - - NF - - NG - - NI - - NL - - 'NO' - - NP - - NR - - NT - - NU - - NZ - - OM - - PA - - PE - - PF - - PG - - PH - - PK - - PL - - PM - - PN - - PR - - PS - - PT - - PW - - PY - - QA - - RE - - RO - - RS - - RU - - RW - - SA - - SB - - SC - - SD - - SE - - SF - - SG - - SH - - SI - - SJ - - SK - - SL - - SM - - SN - - SO - - SR - - SS - - ST - - SU - - SV - - SX - - SY - - SZ - - TA - - TC - - TD - - TF - - TG - - TH - - TJ - - TK - - TL - - TM - - TN - - TO - - TP - - TR - - TT - - TV - - TW - - TZ - - UA - - UG - - UK - - UM - - US - - UY - - UZ - - VA - - VC - - VE - - VG - - VI - - VN - - VU - - WF - - WS - - XI - - XU - - XK - - YE - - YT - - YU - - ZA - - ZM - - ZR - - ZW - name: - type: string - description: Name or denotation of this type - description: Named type uniquely identified by its technical key - TypeKeyNameVerboseDtoRelationType: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: Unique key of this type for reference - enum: - - CX_LEGAL_SUCCESSOR_OF - - CX_LEGAL_PREDECESSOR_OF - name: - type: string - description: Name or denotation of this type - description: Named type uniquely identified by its technical key - TypeKeyNameVerboseDtoString: - required: - - name - - technicalKey - type: object - properties: - technicalKey: - type: string - description: Unique key of this type for reference - name: - type: string - description: Name or denotation of this type - description: Named type uniquely identified by its technical key diff --git a/sidebarsDocsKits.js b/sidebarsDocsKits.js index 333ce8ee38a..1d476494670 100644 --- a/sidebarsDocsKits.js +++ b/sidebarsDocsKits.js @@ -241,22 +241,17 @@ const sidebars = { { type: "link", label: "Gate API", - href: 'https://eclipse-tractusx.github.io/api-hub/eclipse-tractusx.github.io/kit_business-partner-kit-gate-V6.1.0/swagger-ui/' + href: 'https://eclipse-tractusx.github.io/api-hub/bpdm/6.2.0-rc5/gate/' }, { type: "link", label: "Pool API", - href: 'https://eclipse-tractusx.github.io/api-hub/eclipse-tractusx.github.io/kit_business-partner-kit-pool-V6.1.0/swagger-ui/' - }, - { - type: "link", - label: "Cleaning Dummy API", - href: 'https://eclipse-tractusx.github.io/api-hub/eclipse-tractusx.github.io/kit_business-partner-kit-cleaning-dummy-V6.1.0/swagger-ui/' + href: 'https://eclipse-tractusx.github.io/api-hub/bpdm/6.2.0-rc5/pool/' }, { type: "link", label: "Orchestrator API", - href: 'https://eclipse-tractusx.github.io/api-hub/eclipse-tractusx.github.io/kit_business-partner-kit-orchestrator-V6.1.0/swagger-ui/' + href: 'https://eclipse-tractusx.github.io/api-hub/bpdm/6.2.0-rc5/orchestrator/' }, 'kits/Business Partner Kit/Software Development View/Use Cases' ]