Update one punchout catalog

patch

/fscmRestApi/resources/11.13.18.05/punchoutCatalogs/{CatalogId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Allow price override on purchase order lines
    Maximum Length: 1
    Indicates whether price override is allowed on purchase order lines. Contains one of the following values: true or false. If true, then you can override the price on purchase order lines. If false, then you can't override the price on purchase order lines. This attribute doesn't have a default value.
  • Maximum Length: 1
    Indicates whether mapping is applied. Contains one of the following values: true or false. If true, then mapping is applied. If false, then mapping isn't applied. This attribute doesn't have a default value.
  • Title: Company ID
    Maximum Length: 35
    Unique identifier of the buyer company. This value represents the Domain when the punchout catalog Source is SUPPLIER_VIA_CXML and Company Identification when the Source is SUPPLIER_VIA_XML or EXCHANGE.
  • Title: Company Name
    Maximum Length: 240
    Name of the buyer company. This value represents the Identity when the punchout catalog Source is SUPPLIER_VIA_CXML and Company Name when the Source is SUPPLIER_VIA_XML or EXCHANGE.
  • Title: Description
    Maximum Length: 240
    Description of the punchout catalog.
  • Title: Catalog Name
    Maximum Length: 30
    Name of the punchout catalog.
  • Category Assignments
    Title: Category Assignments
    Details of the categories assigned to the informational catalog for browsing.
  • Unique identifier of the item category that will be used to default on requisition lines created using punchouts when a category can't be determined based on the payload values.
  • Title: Default Category Name
    Maximum Length: 2400
    Name of the item category that will be used to default on requisition lines created using punchouts when a category can't be determined based on the payload values.
  • Title: Derive master items using a supplier item
    Maximum Length: 1
    Indicates whether the application derives the master item using the supplier item when using the punchout. Contains one of the following values: true or false. If true, then the application derives the master item using the supplier item. If false, then the application doesn't derive the master item using the supplier item. This attribute doesn't have a default value.
  • Title: Disable automatic document sourcing
    Maximum Length: 1
    Indicates whether automatic sourcing is disabled. Contains one of the following values: true or false. If true, then automatic sourcing is disabled. If false, then automatic sourcing isn't disabled. This attribute doesn't have a default value.
  • Title: Enable item level punchout
    Maximum Length: 1
    Indicates whether item-level punchout is enabled. Contains one of the following values: true or false. If true, then item-level punchout is enabled. If false, then item-level punchout isn't enabled. This attribute doesn't have a default value.
  • Title: Encoding Method
    Maximum Length: 30
    Encoding method used for the punchout catalog data.
  • Title: Image URL
    Maximum Length: 240
    URL of the catalog image.
  • Title: Keywords
    Maximum Length: 4000
    Keywords that help identify and search for the punchout catalog.
  • Unique identifier of the supplier content map set associated with the punchout catalog.
  • Title: Map Set
    Maximum Length: 30
    Name of the supplier content map set associated with the punchout catalog.
  • Title: Password
    Maximum Length: 100
    Password used to access the punchout catalog.
  • Title: All prices are negotiated
    Maximum Length: 1
    Default Value: true
    Indicates whether prices are negotiated. Contains one of the following values: true or false. If true, then prices are negotiated. If false, then prices aren't negotiated. This attribute doesn't have a default value.
  • Title: Process master items and agreement lines using punchout
    Maximum Length: 1
    Indicates whether the catalog is enabled to shop for master items and agreement lines from the punchout site. Contains one of the following values: true or false. If true, then the catalog is enabled to shop for master items and agreement lines. If false, then the catalog isn't enabled to shop for master items and agreement lines. This attribute doesn't have a default value.
  • Punchout Search Items
    Title: Punchout Search Items
    A collection of items uploaded to the punchout catalog that can be searched during shopping. For example, uploaded search items can represent catalog entries available through punchout.
  • Title: Punchout URL
    Maximum Length: 240
    URL of the punchout catalog.
  • Title: Send deliver-to location to punchout site
    Maximum Length: 1
    Indicates whether the deliver-to location from the requester's preferences will be sent in the punchout setup request document. Contains one of the following values: true or false. If true, then the deliver-to location is sent. If false, then the deliver-to location isn't sent. This attribute doesn't have a default value.
  • Title: Send optional user and company information to punchout site
    Maximum Length: 1
    Indicates whether optional information is sent. Contains one of the following values: true or false. If true, then the application sends optional information. If false, then the application doesn't send optional information. This attribute doesn't have a default value.
  • Title: Source
    Maximum Length: 20
    Type of the source document format.
  • Maximum Length: 360
    Supplier for the punchout catalog.
  • Unique identifier of the supplier.
  • Title: Supplier Name
    Maximum Length: 240
    Name of the supplier company.
  • Title: Supplier ID
    Maximum Length: 256
    Number assigned to the supplier company.
  • Title: Supplier Site
    Maximum Length: 240
    Supplier site of the supplier configured on the punchout catalog.
  • Unique identifier of the supplier site.
  • Title: User Name
    Maximum Length: 100
    User name used to authenticate the connection to the punchout site.
Nested Schema : Category Assignments
Type: array
Title: Category Assignments
Details of the categories assigned to the informational catalog for browsing.
Show Source
Nested Schema : Punchout Search Items
Type: array
Title: Punchout Search Items
A collection of items uploaded to the punchout catalog that can be searched during shopping. For example, uploaded search items can represent catalog entries available through punchout.
Show Source
Nested Schema : punchoutCatalogs-categoryAssignments-item-patch-request
Type: object
Show Source
Nested Schema : punchoutCatalogs-punchoutSearchItems-item-patch-request
Type: object
Show Source
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : punchoutCatalogs-item-response
Type: object
Show Source
  • Title: Allow price override on purchase order lines
    Maximum Length: 1
    Indicates whether price override is allowed on purchase order lines. Contains one of the following values: true or false. If true, then you can override the price on purchase order lines. If false, then you can't override the price on purchase order lines. This attribute doesn't have a default value.
  • Maximum Length: 1
    Indicates whether mapping is applied. Contains one of the following values: true or false. If true, then mapping is applied. If false, then mapping isn't applied. This attribute doesn't have a default value.
  • Title: Company ID
    Maximum Length: 35
    Unique identifier of the buyer company. This value represents the Domain when the punchout catalog Source is SUPPLIER_VIA_CXML and Company Identification when the Source is SUPPLIER_VIA_XML or EXCHANGE.
  • Title: Company Name
    Maximum Length: 240
    Name of the buyer company. This value represents the Identity when the punchout catalog Source is SUPPLIER_VIA_CXML and Company Name when the Source is SUPPLIER_VIA_XML or EXCHANGE.
  • Title: Description
    Maximum Length: 240
    Description of the punchout catalog.
  • Read Only: true
    Unique identifier of the catalog.
  • Title: Catalog Name
    Maximum Length: 30
    Name of the punchout catalog.
  • Title: Catalog Type
    Read Only: true
    Maximum Length: 80
    Type of the catalog. Value for this attribute is always Punchout.
  • Read Only: true
    Maximum Length: 15
    Default Value: PUNCHOUT
    Code that identifies the type of the punchout catalog. The value is always PUNCHOUT.
  • Category Assignments
    Title: Category Assignments
    Details of the categories assigned to the informational catalog for browsing.
  • Read Only: true
    Maximum Length: 64
    User who created the punchout catalog.
  • Read Only: true
    The date when the punchout catalog was created.
  • Unique identifier of the item category that will be used to default on requisition lines created using punchouts when a category can't be determined based on the payload values.
  • Title: Default Category Name
    Maximum Length: 2400
    Name of the item category that will be used to default on requisition lines created using punchouts when a category can't be determined based on the payload values.
  • Title: Derive master items using a supplier item
    Maximum Length: 1
    Indicates whether the application derives the master item using the supplier item when using the punchout. Contains one of the following values: true or false. If true, then the application derives the master item using the supplier item. If false, then the application doesn't derive the master item using the supplier item. This attribute doesn't have a default value.
  • Title: Disable automatic document sourcing
    Maximum Length: 1
    Indicates whether automatic sourcing is disabled. Contains one of the following values: true or false. If true, then automatic sourcing is disabled. If false, then automatic sourcing isn't disabled. This attribute doesn't have a default value.
  • Title: Enable item level punchout
    Maximum Length: 1
    Indicates whether item-level punchout is enabled. Contains one of the following values: true or false. If true, then item-level punchout is enabled. If false, then item-level punchout isn't enabled. This attribute doesn't have a default value.
  • Title: Encoding Method
    Maximum Length: 30
    Encoding method used for the punchout catalog data.
  • Title: Image URL
    Maximum Length: 240
    URL of the catalog image.
  • Title: Keywords
    Maximum Length: 4000
    Keywords that help identify and search for the punchout catalog.
  • Read Only: true
    Maximum Length: 64
    User who last updated the punchout catalog.
  • Read Only: true
    The date when the punchout catalog was last updated.
  • Links
  • Unique identifier of the supplier content map set associated with the punchout catalog.
  • Title: Map Set
    Maximum Length: 30
    Name of the supplier content map set associated with the punchout catalog.
  • Read Only: true
    Unique identifier of the parent catalog.
  • Title: Password
    Maximum Length: 100
    Password used to access the punchout catalog.
  • Title: All prices are negotiated
    Maximum Length: 1
    Default Value: true
    Indicates whether prices are negotiated. Contains one of the following values: true or false. If true, then prices are negotiated. If false, then prices aren't negotiated. This attribute doesn't have a default value.
  • Title: Process master items and agreement lines using punchout
    Maximum Length: 1
    Indicates whether the catalog is enabled to shop for master items and agreement lines from the punchout site. Contains one of the following values: true or false. If true, then the catalog is enabled to shop for master items and agreement lines. If false, then the catalog isn't enabled to shop for master items and agreement lines. This attribute doesn't have a default value.
  • Title: Procurement BU
    Maximum Length: 240
    Procurement business unit in which the punchout catalog is created.
  • Unique identifier of the procurement business unit in which the catalog is created.
  • Punchout Search Items
    Title: Punchout Search Items
    A collection of items uploaded to the punchout catalog that can be searched during shopping. For example, uploaded search items can represent catalog entries available through punchout.
  • Title: Punchout URL
    Maximum Length: 240
    URL of the punchout catalog.
  • Read Only: true
    Key to the URL to the supplier website configured for the punchout catalog.
  • Title: Send deliver-to location to punchout site
    Maximum Length: 1
    Indicates whether the deliver-to location from the requester's preferences will be sent in the punchout setup request document. Contains one of the following values: true or false. If true, then the deliver-to location is sent. If false, then the deliver-to location isn't sent. This attribute doesn't have a default value.
  • Title: Send optional user and company information to punchout site
    Maximum Length: 1
    Indicates whether optional information is sent. Contains one of the following values: true or false. If true, then the application sends optional information. If false, then the application doesn't send optional information. This attribute doesn't have a default value.
  • Title: Source
    Maximum Length: 20
    Type of the source document format.
  • Maximum Length: 360
    Supplier for the punchout catalog.
  • Unique identifier of the supplier.
  • Title: Supplier Name
    Maximum Length: 240
    Name of the supplier company.
  • Title: Supplier ID
    Maximum Length: 256
    Number assigned to the supplier company.
  • Title: Supplier Site
    Maximum Length: 240
    Supplier site of the supplier configured on the punchout catalog.
  • Unique identifier of the supplier site.
  • Read Only: true
    Unique identifier of the trading partner.
  • Title: User Name
    Maximum Length: 100
    User name used to authenticate the connection to the punchout site.
Nested Schema : Category Assignments
Type: array
Title: Category Assignments
Details of the categories assigned to the informational catalog for browsing.
Show Source
Nested Schema : Punchout Search Items
Type: array
Title: Punchout Search Items
A collection of items uploaded to the punchout catalog that can be searched during shopping. For example, uploaded search items can represent catalog entries available through punchout.
Show Source
Nested Schema : punchoutCatalogs-categoryAssignments-item-response
Type: object
Show Source
Nested Schema : punchoutCatalogs-punchoutSearchItems-item-response
Type: object
Show Source
Back to Top