Opencell

Overview

The "Create Commercial Order" operation for the "Order" resource in this custom n8n node interacts with the Opencell API to create a new commercial order based on an existing quote. This is typically used in business workflows where a sales quote has been finalized and needs to be converted into an actual order for fulfillment, billing, or further processing.

Common scenarios:

• Automating the transition from sales quotes to commercial orders in CRM/ERP systems.
• Integrating Opencell with other tools (e.g., e-commerce platforms, sales automation) to streamline order creation.
• Triggering downstream processes (like invoicing or provisioning) upon successful order placement.

Practical example:
A sales team finalizes a quote for a customer. Upon approval, this node is triggered to create a corresponding commercial order in Opencell, ensuring all relevant details (quote code and version) are accurately transferred.

---

Properties

Name	Type	Meaning
Authentication	options	Selects the authentication method for connecting to Opencell (Basic Auth or OAuth2).
Quote Code	string	The unique identifier of the quote to base the commercial order on.
Quote Version	number	The specific version of the quote to use for order creation.
Body Content Type	hidden	Internal property; set to "multipart-form-data" for request formatting (not user-editable).

---

Output

• json: The response from the Opencell API after attempting to create the commercial order.
  • The structure of this output will depend on the Opencell API's response for order placement, but typically includes:
    • Order identifiers (such as order ID)
    • Status information
    • Any error messages or validation results if the operation fails

Example output (structure may vary):

{
  "orderId": "12345",
  "status": "CREATED",
  "message": "Commercial order created successfully"
}

If the API returns an error, the json field will contain error details.

---

Dependencies

• External Service: Requires access to an Opencell instance with the CPQ (Configure Price Quote) and order management APIs 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 endpoint and credentials.

---

Troubleshooting

Common issues:

• Invalid Quote Code or Version: If the provided quote code or version does not exist, the API will return an error.
• Authentication Errors: Incorrect credentials or insufficient permissions will result in authentication failures.
• API Connectivity Issues: Network problems or incorrect API endpoints can cause connection errors.

Typical error messages:

• "Username/password error. Error code : XXX" – Check your credentials.
• "Host error. Error code : XXX" – Verify the Opencell server is reachable.
• "Invalid credentials (unknown error)" – Double-check authentication settings.
• API-specific errors (e.g., "Quote not found", "Order already exists") – Ensure input values are correct and the quote is in a valid state for order creation.

How to resolve:

• Confirm that the quote code and version are correct and exist in Opencell.
• Ensure the selected authentication method matches the credentials provided.
• Check network connectivity and Opencell API availability.

---

Links and References

• Opencell Documentation
• n8n Documentation: Custom Nodes
• Opencell API Reference (if available)

---