OpencellInstall

Overview

The "Create or Update Quote Item" operation for the "Quote" resource in this n8n node allows you to add or update items within an existing quote in the Opencell system. This is typically used in CPQ (Configure, Price, Quote) workflows where you need to programmatically manage the products and details associated with a sales quote.

Common scenarios:

• Adding new products to an existing quote.
• Updating product quantities or versions in a quote.
• Associating additional contract or discount information with quote items.

Practical example:
A sales automation workflow where, after a customer selects products on your website, the selected products are automatically added as items to their quote in Opencell, possibly updating existing entries if they already exist.

---

Properties

Name	Type	Meaning
Authentication	options	Selects the authentication method: Basic Authentication or OAuth2.
Offer Code	string	The code identifying the offer being quoted. Required.
Quote Code	string	The unique identifier of the quote to which items are being added or updated. Required.
Quote Version	string	The version of the quote being modified. Required.
Products	collection	List of products to add/update. Each product includes:
		- Product Code (string): Identifier of the product.
		- Product Version (number): Version of the product.
		- Quantity (number): Number of units for this product.
Additional Fields	collection	Optional extra fields:
		- Contract Code (string): Associated contract code.
		- Discount Plan Code (string): Code for any discount plan applied.
		- Offer ID (string): Internal offer identifier.
Body Content Type	hidden	Always set to "multipart-form-data".

---

Output

• The output is a JSON object containing the response from the Opencell API after creating or updating the quote item(s).
• The structure of the output will reflect the Opencell API's response for the /opencell/api/rest/cpq/quotes/quoteItems endpoint, typically including status, identifiers, and possibly the updated quote item details.

Example output:

{
  "status": "SUCCESS",
  "message": "Quote item created/updated successfully",
  "data": {
    // ...details about the quote item(s)
  }
}

• If multiple input items are processed, the output will be an array of such objects, each corresponding to an input item.

---

Dependencies

• External Service: Requires access to an Opencell instance with the CPQ module enabled.
• Authentication: Needs valid credentials for either Basic Authentication or OAuth2, configured in n8n credentials.
• n8n Configuration: The node must be properly configured with the correct Opencell API base URL and credentials.

---

Troubleshooting

Common issues:

• Missing required fields: If Offer Code, Quote Code, Quote Version, or Products are missing, the node will throw an error indicating required parameters are not provided.
• Invalid authentication: Errors like Username/password error or Invalid credentials indicate problems with the supplied credentials.
• API errors: If the Opencell API returns an error (e.g., invalid quote code, non-existent product), the error message from the API will be included in the node's output.

How to resolve:

• Double-check that all required fields are filled in and correctly formatted.
• Ensure your Opencell credentials are valid and have sufficient permissions.
• Verify that the quote and product codes exist in your Opencell instance.

---

Links and References

• Opencell Documentation
• n8n Documentation
• CPQ Concepts

---