Quotes
  • 22 Oct 2024
  • 7 Minutes to read
  • Dark
    Light

Quotes

  • Dark
    Light

Article summary

Import quotes from C4C

Zilliant CPQ enables the import of internal and external quotes. These include sales quotes created in CPQ from an account or opportunity that has been imported from C4C.

Note

CPQ must have a company assigned when creating or synchronizing a quote. The company is assigned to the employee automatically when creating a quote from C4C.

Manage internal quotes

An internal quote is created in C4C and then imported to CPQ. You can edit the quote data in C4C and CPQ. However, you must add or delete line items in the quote in CPQ to prevent inconsistencies in the line-item table between CPQ and C4C. This is required because CPQ is used primarily for the configuration and pricing modules.

You can update line-item data, such as quantity and list price, in C4C. CPQ updates line-item data on subsequent imports when it finds changes or inconsistent last change state IDs.

C4C Internal Quote

Manage external quotes

External quotes are created outside C4C. Create an external quote the following two ways:

  • Create an account from C4C, create a quote from that account, then export the quote to C4C.
  • Import an opportunity from C4C, create a quote from that opportunity, then export the quote to C4C.

The following image refers to exporting a quote to C4C as an external quote (account to quote integration).

External Quote Import Export.png

Use the product object external ID to search for a product

For every quote import, you must have a product with the correct objectERPId assigned. Only those products with an assigned objectERPId can be searched using the internal ID of a product in C4C. Products assigned invalid objectERPId values will fail to import.

Manage sales document status mapping

You can manage the lifecycle of the quote in C4C or CPQ. However, there are limitations to each due to differences in the technical architectures between the two systems.

While importing an account from C4C, CPQ also synchronizes the account if the account from C4C already exists in CPQ. The following processes are performed during synchronization.

Approval process in C4C

For details about CPQ's approval engine and workflow, read Approval process.

In the scenario discussed in this section, a quote has been submitted in C4C, and CPQ's approval engine has been configured as disabled. In this situation, the sales document status of the quote in CPQ is mapped to one of three status values for a quote in C4C. Therefore, if the quote has been submitted in C4C, the quote must be set to PENDING to allow the quote to be editable in CPQ.

Following are the three C4C codes:

  • Status Code
  • Progress Code
  • Approval Code

The following table shows how CPQ changes the sales document status depending on the three C4C codes.

CPQ SALES DOCUMENT STATUSStatus CodeProgress CodeApproval Code
OpenOpenNot relevantNot started
OpenOpenNot relevantIn revision
CompletedOpenNot relevantIn revision
CompletedOpenNot relevantIn approval
CompletedOpenPendingNot Started
Completed
ApprovedOpenNot RelevantApproved
ApprovedOpenPendingApproved
ApprovedCompletedPendingApproved
PENDINGcellPendingcell
ACCEPTEDCompletedWonApproved
ACCEPTEDCompletedWonNot Started
ACCEPTEDCompletedWonApproval Not Necessary
ACCEPTEDCompletedWonNot Found
ACCEPTEDCompletedWonIn Approval
ACCEPTEDCompletedWonIn Revision
ACCEPTEDCompletedWonWithdrawn
REJECTEDCompletedLostNot Started
REJECTEDCompletedLostNot Started

When a quote is in Pending status in C4C, when that quote is imported into CPQ the sales item status changes to Pending status as well.

There is limited functionality in Pending status. When a quote in CPQ is in Pending status, you cannot:

  • Delete or add sub items under a sales item.
  • Make changes to a configurable product.
  • Change the quantity of a sales item to get a new price.

When a quote in CPQ is in Pending status, you can:

  • Add a configurable, classified, or raw product.
  • Configure a newly added product.
  • Remove a product added in Pending status if the sales item status is not in Pending status.
  • Reprice by adding a product, changing the quote header information (such as currency or pricing date), and changing the quantity of the sales item.

The following diagram shows the recommended process that has to be done if the quote lifecycle is controlled in C4C.

Important

You must select the CPQ tab especially if the following relevant pricing changes were made before submitting the quote in C4C. This is necessary in order to synchronize the pricing related changes to do reconfiguration or pricing when the Quote in DSP is still in Open status.

quote_lifecycle_diagram.png

Approval process in CPQ

For details on CPQ's approval engine and workflow, read Approval process.

This section discusses the case in which the approval engine is configured in CPQ. In this scenario, the complete lifecycle of the quote is submitted and managed by CPQ. In this case, the submission trigger in C4C must be disabled.

However, CPQQuoteStatus must be configured in C4C to show the latest status of the quote in CPQ. Zilliant recommends that you enable or disable the line item table based on the value of CPQQuoteStatus.

For example, if CPQQuoteStatus is not in an OPEN state, the line item table should be disabled to align with the behavior that is allowed in CPQ.

If you make changes while** CPQQuoteStatus** is not OPEN, it could trigger the pricing in CPQ on import of those changes. CPQ will ignore the changes as the quote in CPQ is not OPEN.

cpqquotestatusdiagram.png

Note

Because the complete quote lifecycle is managed in CPQ, you should perform the CRUD operations on line item data in CPQ to reduce inconsistencies between the two systems.

Import partners of quote from C4C

C4C partnerCPQ equivalentQuote C4C ImportNotes
BILL_TO_PARTYAccountSupported
SHIP_TO_PARTYAccountSupported
BUYER_PARTYAccountSupported
PAYER_PARTYAccountSupported
SELLER_PARTYAccountSupported
SALES_EMPLOYEE_PARTYEmployeeSupportedYou must assign the External ID of the user in CPQ to the Internal ID of the employee in C4C.
EMPLOYEE_RESPONSIBLE_PARTYEmployeeSupportedYou must assign the External ID of user in CPQ to the Internal ID of employee in C4C.
PRODUCT_RECIPIENT_PARTYNot supportedNot supportedNot supported
SALES_PARTNER_PARTYAccountNot supportedCould be a Business Partner in C4C
COMPETITOR_PARTYAccountNot supportedCould be a Business Partner in C4C
OTHER_PARTYAccountNot supportedCould be a Business Partner in C4C
SALES_UNIT_PARTYCompanyNot supported
SALES_TEAM_PARTYNot supportedNot supported

By default, the partners are not synchronized. If you want to synchronize the partners by default, configure the following setting in CPQ:

  1. Go to Administration and select SettingBoolean.
  2. Search for SettingSyncPartnerQuoteEnabled.
  3. Set Setting Value Boolean to YES.

Import a quote with custom field from C4C

CPQ supports the import of custom fields to the following SUBJECT TYPE within the quote dataset.

  • Quote
  • SalesItem
  • PartnerFunctionRecord

Import a quote header custom field from C4C

For quote header custom field mapping, the following properties must be set where MX_GRAPH_TYPE_URI, MX_SUBJECT_TYPE_URI and CFC_XPATH are fixed.

FIELD NAMEFIELD VALUE or EXPLANATIONFIXED
MX_GRAPH_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#QuoteYes
MX_SUBJECT_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#QuoteYes
MX_FIELD_URIThe CPQ field URI was customized inside the application-schema-ext.owl with the domain as Quote. Example: http://www.inmindcloud.com/application/application-schema-ext.owl#zQuoteXxxXxxXxxNo
CFC_FIELD_NAMEThe C4C field name was created in C4C. It must start with the prefix: a00:zQuoteXxxXxxXxxNo
CFC_FIELD_NAME_SPACEName space of the custom field. For example, the namespace used for a custom field: http://sap.com/xi/AP/CustomerExtension/BYD/A0014No
CFC_XPATH//CustomerQuoteYes

Import a Quote Line Item Custom Field from C4C

For Quote Line Item custom field mapping, you must set the following properties where MX_GRAPH_TYPE_URI, MX_SUBJECT_TYPE_URI and CFC_XPATH are fixed.

FIELD NAMEFIELD VALUE or EXPLANATIONFIXED
MX_GRAPH_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#QuoteYes
MX_SUBJECT_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#SalesItemYes
MX_FIELD_URIThe CPQ field URI is the one that was customized inside the application-schema-ext.owl having the domain as SalesItem. For example, http://www.inmindcloud.com/application/application-schema-ext.owl#zQuoteSalesItemXxxXxxXxxNo
CFC_FIELD_NAMEThe C4C field name is the one that was created in C4C. It must start with the prefix: a00:zQuoteSalesItemXxxXxxXxxNo
CFC_FIELD_NAME_SPACEThe name space of the custom field. For example, the namespace used for a custom field: http://sap.com/xi/AP/CustomerExtension/BYD/A0014No
CFC_XPATH//CustomerQuote/Item[ID='SalesItem.objectExternalId']Yes

Import quote partner with a custom field from C4C

For quote partner custom field mapping, you must set the following properties where MX_GRAPH_TYPE_URI, MX_SUBJECT_TYPE_URI and CFC_XPATH are fixed.

FIELD NAMEFIELD VALUE or EXPLANATIONFIXED
MX_GRAPH_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#QuoteYes
MX_SUBJECT_TYPE_URIhttp://www.inmindcloud.com/application/schema.owl#PartnerFunctionRecordYes
MX_FIELD_URIThe CPQ field URI was customized inside the application-schema-ext.owl with the domain as PartnerFunctionRecord. For example: http://www.inmindcloud.com/application/application-schema-ext.owl#zQuotePartnerXxxXxxXxxNo
CFC_FIELD_NAMEThe C4C field name is the one that was created in C4C. It must start the prefix: a00:zQuotePartnerXxxXxxXxxNo
CFC_FIELD_NAME_SPACEName space of the custom field. For example, the namespace used for a custom field: http://sap.com/xi/AP/CustomerExtension/BYD/A0014No
CFC_XPATHThe following are supported XPath for Quote Partners: //CustomerQuote/PayerParty, //CustomerQuote/BillToParty, //CustomerQuote/BuyerParty, //CustomerQuote/ProductRecipientPartyYes

Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.