openapi: 3.0.1 info: title: Punchout cXML description: "The Intershop Punchout cXML REST API contains resources for managing\ \ cXML Punchout configurations and cXML Punchout users.\nThis includes updating\ \ configurations, creating, changing or deleting users or user data.\n\nNote:\ \ This is a separate REST API specification for cXML Punchout only. For this reason,\ \ the media type used contains the phrase `cxml`, see paragraph below. \n\n##\ \ Accept Header\nTo use version 3.x of the Punchout cXML REST API, append the\ \ accept header `application/vnd.intershop.punchout.cxml.v3+json` to the request.\n\ \n## Changelog\n- - -\n### Version 3.0.0\n* Major change to the content structure\ \ of the \"configurations\" endpoint (data and info block introduced, additional\ \ meta information added)\n* Moved the cXML part of Punchout (2.3.0) into this\ \ separate REST API specification" contact: name: Intershop Communications AG url: http://intershop.com version: 3.0.0 servers: - url: "/INTERSHOP/rest/{serverGroup}/{siteName}/{appUrl}" description: Intershop ICM Server variables: serverGroup: description: The server group enum: - BOS - JOB - WFS default: WFS siteName: description: The site name default: inSPIRED-inTRONICS-Site appUrl: description: The application URL identifier enum: - rest - example - "-" default: rest tags: - name: General description: This section covers operations for managing cXML Punchout. This includes retrieving details of the cXML standard and cXML Punchout sessions. x-origin-class: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutSessionItemResource - name: User Management description: "This section covers operations for managing cXML Punchout users. This\ \ includes retrieving information on users, creating new users, updating user\ \ data as well as deleting specific users. Additionally, user-specific configuration\ \ values can be retrieved and (partially) updated." x-origin-class: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource paths: /customers/{CustomerKey}/punchouts/cxml1.2: get: tags: - General summary: Returns details for cXML Punchout description: |- This operation returns details of the cXML Punchout standard. An optional parameter `basketId` can be provided to get a list of cXML Punchout fields for the basket. To use this operation, an authenticated user with the permissions "View punchout" (APP_B2B_VIEW_PUNCHOUT) or "Send cXML Cart" (APP_B2B_SEND_CXML_BASKET) is required. operationId: getCXMLPunchoutItemDetails_V3 parameters: - name: basketId in: query description: The ID of the basket to get a list of cXML Punchout fields for schema: type: string description: The ID of the basket to get a list of cXML Punchout fields for - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource responses: "200": description: Ok - The details for the cXML Punchout were successfully retrieved. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/PunchoutItemRO" "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutItemResource.getPunchoutItemDetails_V3(java.lang.String) x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutItemResource /customers/{CustomerKey}/punchouts/cxml1.2/sessions/{CXMLPunchoutSessionKey}: get: tags: - General summary: Returns information on a specific cXML Punchout session description: |- This operation returns information on the given cXML Punchout session. To use this operation, an authenticated user with the permission "Send cXML Cart" (APP_B2B_SEND_CXML_BASKET) is required. operationId: getCXMLPunchoutSession_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutSessionKey in: path description: The ID of the cXML Punchout session (sid) required: true schema: type: string description: The ID of the cXML Punchout session (sid) example: XYSZ12345 example: XYSZ12345 x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutSessionListResource responses: "200": description: Ok - The details for the cXML Punchout session were successfully retrieved. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/CXMLSessionRO" "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutSessionItemResource.getSession_V3() x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutSessionItemResource /customers/{CustomerKey}/punchouts/cxml1.2/users: get: tags: - User Management summary: Returns cXML Punchout users description: |- This operation returns all users for the cXML Punchout standard. The response is of type ResourceCollectionRO and contains objects of type LinkRO. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: getCXMLPunchoutUsers_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource responses: "200": description: Ok - The cXML Punchout users were successfully retrieved. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/LinkROResourceCollectionRO" "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserListResource.getPunchoutUsers_V3() x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserListResource post: tags: - User Management summary: Creates a cXML Punchout user description: |- This operation creates a new cXML Punchout user and automatically assigns an ID. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: createCXMLPunchoutUser_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource requestBody: content: '*/*': schema: $ref: "#/components/schemas/PunchoutUserRO" responses: "201": description: Created - The cXML Punchout user was successfully created. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/LinkRO" "400": description: Bad request - At least one attribute is missing in the request body or the credentials are not valid with regard to internal policies. "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer could not be found or cXML Punchout is not supported. "409": description: |- Conflict - The cXML Punchout user already exists. Possible values for header 'error-key': - punchout.login_already_exists.error security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserListResource.createPunchoutUser_V3(com.intershop.application.storefront.rest.b2b.capi.punchout.resourceobject.PunchoutUserRO) x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserListResource /customers/{CustomerKey}/punchouts/cxml1.2/users/{CXMLPunchoutUserKey}: get: tags: - User Management summary: Returns information on the given cXML Punchout user description: |- This operation returns information on the given cXML Punchout user. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: getCXMLPunchoutUserDetails_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutUserKey in: path description: The ID of the cXML Punchout user required: true schema: type: string description: The ID of the cXML Punchout user example: cxmluser@test.intershop.de example: cxmluser@test.intershop.de x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserListResource responses: "200": description: Ok - The details for the cXML Punchout user were successfully retrieved. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/PunchoutUserRO" "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public com.intershop.application.storefront.rest.b2b.capi.punchout.resourceobject.PunchoutUserRO com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource.getUserDetails_V3() x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource put: tags: - User Management summary: Updates cXML Punchout user data description: |- This operation updates the information of a cXML Punchout user. The following user attributes can be updated: * `email` - Notifications for the cXML Punchout user will be sent to this email address * `password` - The configured password for the cXML Punchout user * `active` - Flag to enable/disable the cXML Punchout user All attributes are optional, see request code examples below. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: updateCXMLPunchoutUser_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutUserKey in: path description: The ID of the cXML Punchout user required: true schema: type: string description: The ID of the cXML Punchout user example: cxmluser@test.intershop.de example: cxmluser@test.intershop.de x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserListResource requestBody: content: '*/*': schema: $ref: "#/components/schemas/PunchoutUserRO" responses: "200": description: Ok - The cXML Punchout user data were successfully updated. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/PunchoutUserRO" "400": description: Bad request - The credentials to be updated are not valid with regard to internal policies. "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public com.intershop.application.storefront.rest.b2b.capi.punchout.resourceobject.PunchoutUserRO com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource.updatePunchoutUser_V3(com.intershop.application.storefront.rest.b2b.capi.punchout.resourceobject.PunchoutUserRO) x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource delete: tags: - User Management summary: Deletes a cXML Punchout user of a customer description: |- This operation deletes a cXML Punchout user of a customer. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: deleteCXMLPunchoutUser_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutUserKey in: path description: The ID of the cXML Punchout user required: true schema: type: string description: The ID of the cXML Punchout user example: cxmluser@test.intershop.de example: cxmluser@test.intershop.de x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserListResource responses: "204": description: No content - The cXML Punchout user was successfully deleted. "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource.deletePunchoutUser_V3() x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserItemResource /customers/{CustomerKey}/punchouts/cxml1.2/users/{CXMLPunchoutUserKey}/configurations: get: tags: - User Management summary: Returns the full list of configuration fields with user-specific values for a given cXML Punchout user description: "This operation returns the full list of configuration fields with\ \ user-specific values for a given cXML Punchout user. \nIf a value is not\ \ set, it is returned as 'null'. \n\n\nTo use this operation, an authenticated\ \ user with the permission \"Manage Punchout\" (APP_B2B_MANAGE_PUNCHOUT) is\ \ required." operationId: getCXMLPunchoutUserConfiguration_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutUserKey in: path description: The ID of the cXML Punchout user required: true schema: type: string description: The ID of the cXML Punchout user example: cxmluser@test.intershop.de example: cxmluser@test.intershop.de x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserListResource responses: "200": description: Ok - The list of configuration values for the cXML Punchout user was successfully retrieved. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/CXMLPunchoutConfigurationListResponse" "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserConfigurationListResource.getUserConfiguration_V3() x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserConfigurationListResource patch: tags: - User Management summary: (Partially) updates the list of user-specific configuration values for a given cXML Punchout user description: |- This operation (partially) updates user-specific configuration values for the given cXML Punchout user. Only the specified configurations are affected. Configuration values that are sent with value 'null' are removed from user preferences. To use this operation, an authenticated user with the permission "Manage Punchout" (APP_B2B_MANAGE_PUNCHOUT) is required. operationId: updateCXMLPunchoutUserConfiguration_V3 parameters: - name: CustomerKey in: path description: The key or UUID to resolve a single item required: true schema: type: string example: ExampleKey x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource - name: CXMLPunchoutUserKey in: path description: The ID of the cXML Punchout user required: true schema: type: string description: The ID of the cXML Punchout user example: cxmluser@test.intershop.de example: cxmluser@test.intershop.de x-item-key: com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserListResource requestBody: content: application/json: schema: type: array items: $ref: "#/components/schemas/CXMLPunchoutConfigurationItemDataRO" responses: "200": description: Ok - The given configuration values for the cXML Punchout user were successfully updated. content: application/vnd.intershop.punchout.cxml.v3+json: schema: $ref: "#/components/schemas/CXMLPunchoutConfigurationListResponse" "400": description: Bad Request - The provided configuration values to update are not valid. "401": description: Unauthorized - The user could not be authenticated. "403": description: Forbidden - The user does not have the required permissions. "404": description: Not found - The customer/cXML Punchout user could not be found or cXML Punchout is not supported. "500": description: 'Internal Server Error - The provided regular expressions (RegEx) to validate the user preference values are not valid. ' security: - bearerAuth: [] - basicAuth: [] - authToken: [] x-origin-method: public jakarta.ws.rs.core.Response com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserConfigurationListResource.updateUserConfiguration_V3(java.util.List) x-origin-class: com.intershop.sellside.rest.b2b.punchout.cxml.v3.capi.resource.CXMLPunchoutUserConfigurationListResource components: schemas: PunchoutDataItemFieldRO: title: PunchoutDataItemField type: object properties: name: type: string description: The name of an element xml: attribute: true type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' example: PunchoutDataItemField xml: attribute: true value: type: string description: The value of the Data Item Field example: "0.0" xml: name: PunchoutDataItemField PunchoutDataItemRO: title: PunchoutDataItem type: object properties: name: type: string description: The name of an element xml: attribute: true type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' example: PunchoutDataItem xml: attribute: true dataItemFields: type: array description: The data item fields as a collection of PunchoutDataItemFieldROs xml: name: PunchoutDataItemField items: $ref: "#/components/schemas/PunchoutDataItemFieldRO" punchoutDataItemFields: type: array writeOnly: true items: $ref: "#/components/schemas/PunchoutDataItemFieldRO" description: This resource holds the Punchout data as a collection of PunchoutDataItemROs. xml: name: PunchoutDataItem PunchoutDataRO: title: PunchoutData type: object properties: name: type: string description: The name of an element xml: attribute: true type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' example: PunchoutData xml: attribute: true punchoutDataItems: type: array writeOnly: true items: $ref: "#/components/schemas/PunchoutDataItemRO" dataItems: type: array description: The Punchout data as a collection of PunchoutDataItemROs xml: wrapped: true items: $ref: "#/components/schemas/PunchoutDataItemRO" description: This resource holds the Punchout data as PunchoutDataRO. xml: name: PunchoutData PunchoutItemRO: title: PunchoutItem required: - punchoutType - version type: object properties: name: type: string description: The name of an element xml: attribute: true type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' xml: attribute: true punchoutType: type: string description: The Punchout type example: oci version: type: string description: The Punchout version example: ver5 punchoutData: $ref: "#/components/schemas/PunchoutDataRO" xml: name: PunchoutItem CXMLSessionRO: type: object properties: operation: type: string basketId: type: string returnURL: type: string creationDate: type: string format: date-time buyerCookie: type: string credentialFrom: $ref: "#/components/schemas/CredentialRO" credentialTo: $ref: "#/components/schemas/CredentialRO" credentialSender: $ref: "#/components/schemas/CredentialRO" CredentialRO: type: object properties: domain: type: string identity: type: string LinkRO: title: Link type: object properties: name: type: string description: The name of the returned element xml: attribute: true type: type: string description: "This is a constant: **Link**" readOnly: true example: Link xml: attribute: true attributes: type: array description: The list of attributes xml: wrapped: true items: $ref: "#/components/schemas/ResourceAttribute" uri: type: string description: The URI relation: type: string description: The relation of the link externalDocs: description: Link Relations (www.iana.org) url: http://www.iana.org/assignments/link-relations/link-relations.xml enum: - about - alternate - appendix - archives - author - bookmark - canonical - chapter - collection - contents - copyright - create-form - current - describedby - describes - disclosure - duplicate - edit - edit-form - edit-media - enclosure - first - glossary - help - hosts - hub - icon - index - item - last - latest-version - license - lrdd - monitor - monitor-group - next - next-archive - nofollow - noreferrer - payment - predecessor-version - prefetch - prev - preview - previous - prev-archive - privacy-policy - profile - related - replies - search - section - self - service - start - stylesheet - subsection - successor-version - tag - terms-of-service - type - up - version-history - via - working-copy - working-copy-of title: type: string description: The title of the link description: type: string description: The description of the link itemId: type: string description: The ID of the linked item attribute: $ref: "#/components/schemas/ResourceAttribute" description: A Link pointing to a resource xml: name: Link ResourceAttribute: title: Attribute type: object properties: name: type: string description: The attribute's name xml: attribute: true type: type: string description: "This is a constant: **ResourceAttribute**" example: ResourceAttribute xml: attribute: true value: type: object description: The attribute's value. description: An attribute xml: name: ResourceAttribute PunchoutUserRO: title: PunchoutUser type: object properties: name: type: string description: The name of an element xml: attribute: true type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' example: PunchoutUser xml: attribute: true id: type: string description: The ID of the user readOnly: true example: oci1 login: type: string description: The login of the user example: ociuser1 email: type: string description: The e-mail adress of the user example: ocitester@test.intershop.de password: type: string description: The password of the user example: '!InterShop00!' active: type: boolean description: Indicates whether the user is active example: true xml: name: PunchoutUser LinkROResourceCollectionRO: title: Collection type: object properties: pageable: type: string description: The pageable ID total: type: integer description: The pageable amount total format: int32 offset: type: integer description: The pageable offset format: int32 amount: type: integer description: The pageable amount format: int32 elements: type: array description: The list of elements xml: wrapped: true items: $ref: "#/components/schemas/LinkRO" type: type: string description: 'The type of the element. This is normally a **constant** that can be used to differentiate elements by their type. ' example: ResourceCollection xml: attribute: true sortKeys: uniqueItems: true type: array description: The keys to sort for xml: wrapped: true items: type: string description: The keys to sort for xml: name: sortKey name: type: string description: The name of an element xml: attribute: true description: A list of Link-ResourceObjects xml: name: ResourceCollection CXMLPunchoutConfigurationInfoRO: type: object properties: metaData: type: array items: $ref: "#/components/schemas/CXMLPunchoutConfigurationItemInfoRO" readOnly: true CXMLPunchoutConfigurationItemDataRO: type: object properties: name: type: string description: The name of an element value: type: string CXMLPunchoutConfigurationItemInfoRO: type: object properties: defaultValue: type: string readOnly: true description: type: string readOnly: true inputType: type: string readOnly: true name: type: string description: The name of an element CXMLPunchoutConfigurationListResponse: type: object properties: data: type: array description: The core data of the response object items: $ref: "#/components/schemas/CXMLPunchoutConfigurationItemDataRO" info: $ref: "#/components/schemas/CXMLPunchoutConfigurationInfoRO" messages: type: array readOnly: true items: $ref: "#/components/schemas/FeedbackRO_v1" FeedbackCauseRO_v1: title: FeedbackCauseRO_v1 required: - code - message type: object properties: code: type: string description: A unique identifier for this particular occurrence of the problem (may be used for localization on client-side) example: product.name.required.error message: type: string description: A human readable message in the request's locale example: The product name must be specified. parameters: type: array description: A map of several parameters that are used to assemble the message items: type: object additionalProperties: type: object paths: type: array description: "A collection of JSON paths to the associated entities. Unless\ \ otherwise specified, this always refers to the request entity." example: - "\"$.name (position: 1)\"" externalDocs: url: https://github.com/json-path/JsonPath items: type: string description: A representation for the common feedback information FeedbackRO_v1: title: FeedbackRO_v1 required: - code - message type: object properties: causes: type: array description: A collection of errors/warnings/infos that caused the feedback items: $ref: "#/components/schemas/FeedbackCauseRO_v1" code: type: string description: A unique identifier for this particular occurrence of the problem (may be used for localization on client-side) example: product.name.required.error message: type: string description: A human readable message in the request's locale example: The product name must be specified. parameters: type: array description: A map of several parameters that are used to assemble the message items: type: object additionalProperties: type: object paths: type: array description: "A collection of JSON paths to the associated entities. Unless\ \ otherwise specified, this always refers to the request entity." example: - "\"$.name (position: 1)\"" externalDocs: url: https://github.com/json-path/JsonPath items: type: string level: type: string description: The level of the feedback example: ERROR enum: - INFO - WARN - ERROR status: type: string description: The HTTP status code that is applicable to this problem example: "422" description: An error or piece of information related to the current request readOnly: true responses: "200": description: OK "201": description: Created "202": description: Accepted "204": description: No Content "205": description: Reset Content "206": description: Partial Content "300": description: Multiple Choices "301": description: Moved Permanently "302": description: Found "303": description: See Other "304": description: Not Modified "305": description: Use Proxy "307": description: Temporary Redirect "308": description: Permanent Redirect "400": description: Bad Request "401": description: Unauthorized "402": description: Payment Required "403": description: Forbidden "404": description: Not Found "405": description: Method Not Allowed "406": description: Not Acceptable "407": description: Proxy Authentication Required "408": description: Request Timeout "409": description: Conflict "410": description: Gone "411": description: Length Required "412": description: Precondition Failed "413": description: Request Entity Too Large "414": description: Request-URI Too Long "415": description: Unsupported Media Type "416": description: Requested Range Not Satisfiable "417": description: Expectation Failed "428": description: Precondition Required "429": description: Too Many Requests "431": description: Request Header Fields Too Large "451": description: Unavailable For Legal Reasons "500": description: Internal Server Error "501": description: Not Implemented "502": description: Bad Gateway "503": description: Service Unavailable "504": description: Gateway Timeout "505": description: HTTP Version Not Supported "511": description: Network Authentication Required parameters: loc: name: loc in: path description: "The locale ID (submitted as optional matrix parameter ```;loc=```).\ \ If omitted, the priority is as follows (from high to low): Locale ID parameter,\ \ user's default locale, site's default locale. The available locales depend\ \ on your individual Intershop Commerce Management installation. Use IANA\ \ language definitions for languages and regions and combine them using an\ \ underscore, e.g., ```en_US```." required: false style: matrix schema: type: string description: "The locale ID (submitted as optional matrix parameter ```;loc=```).\ \ If omitted, the priority is as follows (from high to low): Locale ID parameter,\ \ user's default locale, site's default locale. The available locales depend\ \ on your individual Intershop Commerce Management installation. Use IANA\ \ language definitions for languages and regions and combine them using\ \ an underscore, e.g., ```en_US```." default: en_US examples: en_US: description: English (United States) value: en_US fr_FR: description: French (France) value: fr_FR de_DE: description: German (Germany) value: de_DE x-matrixParamPath: / cur: name: cur in: path description: "The currency code (submitted as optional matrix parameter ```;cur=```).\ \ If omitted, the site's or user's default currency is used." required: false style: matrix schema: type: string description: "The currency code (submitted as optional matrix parameter ```;cur=```).\ \ If omitted, the site's or user's default currency is used." default: USD examples: FJD: description: Fiji Dollar value: FJD MXN: description: Mexican Peso value: MXN STD: description: São Tomé / Príncipe Dobra value: STD LVL: description: Latvian Lats value: LVL SCR: description: Seychelles Rupee value: SCR CDF: description: Congolese Franc value: CDF BBD: description: Barbados Dollar value: BBD GTQ: description: Guatemalan Quetzal value: GTQ CLP: description: Chilean Peso value: CLP HNL: description: Honduran Lempira value: HNL UGX: description: Ugandan Shilling value: UGX ZAR: description: South African Rand value: ZAR TND: description: Tunisian Dinar value: TND BSD: description: Bahamian Dollar value: BSD SLL: description: Sierra Leonean Leone value: SLL SDG: description: Sudanese Pound value: SDG IQD: description: Iraqi Dinar value: IQD CUP: description: Cuban Peso value: CUP GMD: description: Gambian Dalasi value: GMD TWD: description: New Taiwan Dollar value: TWD RSD: description: Serbian Dinar value: RSD ZRZ: description: Zaire value: ZRZ DOP: description: Dominican Peso value: DOP KMF: description: Comoro Franc value: KMF MYR: description: Malaysian Ringgit value: MYR FKP: description: Falkland Islands Pound value: FKP XOF: description: CFA Franc BCEAO value: XOF GEL: description: Lari value: GEL UYU: description: Uruguayan Peso value: UYU MAD: description: Moroccan Dirham value: MAD CVE: description: Cape Verde Escudo value: CVE TOP: description: Tongan Pa'anga value: TOP AZN: description: Azerbaijanian Manat value: AZN OMR: description: Omani Rial value: OMR PGK: description: Papua New Guinean Kina value: PGK KES: description: Kenyan Shilling value: KES SEK: description: Swedish Krona value: SEK BTN: description: Ngultrum value: BTN UAH: description: Ukrainian Hryvnia value: UAH GNF: description: Guinea Franc value: GNF ERN: description: Nakfa value: ERN MZN: description: Mozambican Metical value: MZN SVC: description: Salvadoran Colón value: SVC ARS: description: Argentine Peso value: ARS QAR: description: Qatari Riyal value: QAR IRR: description: Iranian Rial value: IRR NLG: description: Dutch Guilder value: NLG MRO: description: Mauritanian Ouguiya value: MRO CNY: description: Yuan Renminbi value: CNY THB: description: Thai Baht value: THB UZS: description: Uzbekistani Som value: UZS XPF: description: CFP Franc value: XPF BDT: description: Bangladeshi Taka value: BDT LYD: description: Libyan Dinar value: LYD BMD: description: Bermudian Dollar value: BMD KWD: description: Kuwaiti Dinar value: KWD PHP: description: Philippine Peso value: PHP RUB: description: Russian Ruble value: RUB PYG: description: Paraguayan Guarani value: PYG ISK: description: Iceland Krona value: ISK JMD: description: Jamaican Dollar value: JMD GWP: description: Guinea Peso value: GWP BEF: description: Belgian Franc value: BEF ESP: description: Spanish Peseta value: ESP COP: description: Colombian Peso value: COP MKD: description: Denar value: MKD USD: description: US Dollar value: USD DZD: description: Algerian Dinar value: DZD PAB: description: Panamanian Balboa value: PAB SGD: description: Singapore Dollar value: SGD ETB: description: Ethiopian Birr value: ETB KGS: description: Som value: KGS SOS: description: Somali Shilling value: SOS VEF: description: Venezuelan Bolivar Fuerte value: VEF VUV: description: Vanuatu Vatu value: VUV LAK: description: Lao Kip value: LAK BND: description: Brunei Dollar value: BND ZMK: description: Zambian Kwacha value: ZMK XAF: description: CFA Franc BEAC value: XAF LRD: description: Liberian Dollar value: LRD ATS: description: Austrian Schilling value: ATS CHF: description: Swiss Franc value: CHF HRK: description: Croatian Kuna value: HRK ITL: description: Italian Lira value: ITL ALL: description: Albanian Lek value: ALL DJF: description: Djibouti Franc value: DJF MTL: description: Maltese Lira value: MTL TZS: description: Tanzanian Shilling value: TZS VND: description: Vietnamese Dong value: VND AUD: description: Australian Dollar value: AUD ILS: description: New Israeli Sheqel value: ILS GHS: description: Ghanaian Cedi value: GHS GYD: description: Guyanese Dollar value: GYD KPW: description: North Korean Won value: KPW BOB: description: Boliviano value: BOB KHR: description: Cambodian Riel value: KHR MDL: description: Moldovan Leu value: MDL IDR: description: Indonesian Rupiah value: IDR KYD: description: Cayman Islands Dollar value: KYD AMD: description: Armenian Dram value: AMD BWP: description: Botswana Pula value: BWP SHP: description: Saint Helena Pound value: SHP TRY: description: Turkish Lira value: TRY CYP: description: Cyprus Pound value: CYP LBP: description: Lebanese Pound value: LBP TJS: description: Tajikistani Somoni value: TJS JOD: description: Jordanian Dinar value: JOD AED: description: United Arab Emirates Dirham value: AED HKD: description: Hong Kong Dollar value: HKD RWF: description: Rwanda Franc value: RWF EUR: description: Euro value: EUR LSL: description: Lesotho Loti value: LSL DKK: description: Danish Krone value: DKK CAD: description: Canadian Dollar value: CAD BGN: description: Bulgarian Lev value: BGN EEK: description: Estonian Kroon value: EEK MMK: description: Kyat value: MMK MUR: description: Mauritian Rupee value: MUR NOK: description: Norwegian Krone value: NOK SYP: description: Syrian Pound value: SYP ZWL: description: Zimbabwean Dollar value: ZWL GIP: description: Gibraltar Pound value: GIP RON: description: Romanian New Leu value: RON LKR: description: Sri Lankan Rupee value: LKR NGN: description: Nigerian Naira value: NGN CRC: description: Costa Rican Colon value: CRC CZK: description: Czech Koruna value: CZK IEP: description: Irish Pound value: IEP PKR: description: Pakistani Rupee value: PKR GRD: description: Greek Drachma value: GRD XCD: description: East Carribean Dollar value: XCD ANG: description: Netherlands Antillian Guilder value: ANG HTG: description: Haitian Gourde value: HTG BHD: description: Bahraini Dinar value: BHD SIT: description: Slovenian Tolar value: SIT PTE: description: Portuguese Escudo value: PTE BPP: description: Bonus Point Price value: BPP KZT: description: Kazakhstani Tenge value: KZT SRD: description: Surinam Dollar value: SRD SZL: description: Swazi Lilangeni value: SZL LTL: description: Lithuanian Litas value: LTL SAR: description: Saudi Riyal value: SAR TTD: description: Trinidad and Tobago Dollar value: TTD YER: description: Yemeni Rial value: YER MVR: description: Maldivian Rufiyaa value: MVR AFN: description: Afghani value: AFN BPV: description: Bonus Point Value value: BPV INR: description: Indian Rupee value: INR AWG: description: Aruban Florin value: AWG KRW: description: South Korean Won value: KRW NPR: description: Nepalese Rupee value: NPR JPY: description: Japanese Yen value: JPY MNT: description: Mongolian Tugrik value: MNT AOA: description: Angolan Kwanza value: AOA PLN: description: Polish Złoty value: PLN GBP: description: Pound Sterling value: GBP SBD: description: Solomon Islands Dollar value: SBD HUF: description: Hungarian Forint value: HUF BYR: description: Belarussian Ruble value: BYR LUF: description: Luxembourgian Franc value: LUF BIF: description: Burundi Franc value: BIF MWK: description: Malawian Kwacha value: MWK MGA: description: Malagasy Ariary value: MGA FIM: description: Finnish Mark value: FIM BZD: description: Belize Dollar value: BZD DEM: description: Deutsche Mark value: DEM BAM: description: Convertible Marks value: BAM EGP: description: Egyptian Pound value: EGP MOP: description: Macanese Pataca value: MOP NAD: description: Namibian Dollar value: NAD SKK: description: Slovakian Krona value: SKK NIO: description: Cordoba Oro value: NIO PEN: description: Peruvian Nuevo Sol value: PEN NZD: description: New Zealand Dollar value: NZD WST: description: Samoan Tala value: WST TMT: description: Turkmenistani Manat value: TMT FRF: description: French Franc value: FRF BRL: description: Brazilian Real value: BRL x-matrixParamPath: / regionals: name: regionals in: path required: false style: matrix schema: type: object properties: loc: type: string description: The locale ID example: en_US cur: type: string description: The currency code example: EUR x-matrixParamPath: / pgid: name: pgid in: path description: "The personalization group identifier, submitted as matrix parameter\ \ ```;pgid=```. Required if you want to work with customer-specific\ \ content." required: false style: matrix schema: type: string description: "The personalization group identifier, submitted as matrix parameter\ \ ```;pgid=```. Required if you want to work with customer-specific\ \ content." example: FUOGrzQ_VjORpGaN8DRGmLLE0000 example: FUOGrzQ_VjORpGaN8DRGmLLE0000 spgid: name: spgid in: path description: "The secure personalization group identifier, submitted as matrix\ \ parameter ```;spgid=```. Required if you want to work with customer-specific\ \ content." required: false style: matrix schema: type: string description: "The secure personalization group identifier, submitted as matrix\ \ parameter ```;spgid=```. Required if you want to work with customer-specific\ \ content." example: FUOGrzQ_VjORpGaN8DRGmLLE0000 example: FUOGrzQ_VjORpGaN8DRGmLLE0000 securitySchemes: basicAuth: type: http description: "Basic access authentication. In basic authentication, a request\ \ contains a header field in the form of authorization: ```Basic ```,\ \ where credentials is the Base64 encoding of ID and password joined by a\ \ single colon :." scheme: basic authToken: type: apiKey description: User authentication token to authenticate the request. The token is a string generated by the ICM server in the same header in every response of an REST endpoint. name: authentication-token in: header bearerAuth: type: http description: "Bearer token authentication. A request contains a header field\ \ in the form of authorization: ```Bearer ```, where is a string\ \ generated by an authentication service in response to a login request." scheme: bearer bearerFormat: JWT x-apiID: punchout_cxml_v3 x-origin-class: "com.intershop.component.rest.capi.resource.RootResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource,com.intershop.sellside.rest.b2b.punchout.v2.capi.cxml.resource.CXMLPunchoutUserConfigurationListResource" x-apiMediaType: application/vnd.intershop.punchout.cxml.v3+json x-strict-apiMediaType: "true"