Opencell icon

Opencell

Consume Opencell API

Overview

The Opencell n8n node's "Quote" resource with the "Generate XML" operation allows you to generate an XML representation of a specific quote version in your Opencell CPQ (Configure, Price, Quote) system. This is useful for scenarios where you need to export, archive, or integrate quote data in XML format with other systems, such as document management, ERP, or custom reporting tools.

Practical examples:

  • Automatically generating and storing quote XMLs after approval.
  • Sending quote XMLs to external partners or customers.
  • Integrating with downstream systems that require quote data in XML format.

Properties

Name Type Meaning
Authentication options Selects the authentication method for connecting to Opencell (Basic Authentication or OAuth2).
Quote Code string The unique code identifying the quote whose XML should be generated.
Quote Version number The version number of the quote to generate the XML for.
Body Content Type hidden Internal property; always set to "multipart-form-data". Not user-configurable.

Output

  • The output will be a JSON object containing the response from the Opencell API for the XML generation request.
  • The main field will typically include the generated XML content or a reference to it, depending on the Opencell API's response structure.
  • The output does not contain binary data directly; it is structured as JSON.

Example output structure:

{
  "xml": "<Quote>...</Quote>",
  // ...other possible metadata fields
}

Note: The actual structure may vary based on the Opencell API implementation.

Dependencies

  • External Service: Requires access to an Opencell instance with the CPQ module enabled.
  • Authentication: You must configure either Basic Authentication or OAuth2 credentials in n8n for Opencell.
  • n8n Configuration: Set up the required credentials under the node's credential section.

Troubleshooting

Common issues:

  • Invalid Credentials: If authentication fails, ensure your credentials are correct and have sufficient permissions.
  • Missing or Incorrect Quote Code/Version: Supplying a non-existent or incorrect quote code/version will result in errors or empty responses.
  • API Connectivity Issues: Network problems or incorrect Opencell API URLs can cause connection failures.

Error messages and resolutions:

  • "Username/password error. Error code : <code>"
    → Check your username and password or OAuth2 setup.
  • "Host error. Error code : <code>"
    → Verify the Opencell API endpoint and network connectivity.
  • "Invalid credentials (unknown error)"
    → Double-check all credential settings in n8n.
  • "Unable to get custom fields. Server response: ..."
    → This is unlikely for this operation but indicates a misconfiguration if encountered.

Links and References


Summary:
This node operation is ideal for automating the extraction of quote data in XML format from Opencell, supporting integration and compliance workflows. Ensure you provide valid quote codes and versions, and configure authentication properly for seamless operation.

Discussion