Opencell icon

Opencell

Consume Opencell API

Overview

The Opencell Quote - Quote Quotation operation in this n8n node allows you to retrieve a detailed quotation for a specific quote version from the Opencell CPQ (Configure, Price, Quote) system. This is useful for automating business processes that require fetching up-to-date quote details, such as generating customer proposals, integrating with CRM systems, or triggering follow-up actions based on quote status.

Practical examples:

  • Automatically fetch and store the latest quotation details for a given quote and version.
  • Integrate with document generation tools to create customer-facing proposals.
  • Use in approval workflows where the full quote data is needed for decision-making.

Properties

Name Type Meaning
Authentication options Selects the authentication method: Basic Authentication or OAuth2.
Quote Code string The unique code identifying the quote whose quotation is to be retrieved.
Quote Version number The version number of the quote to fetch the quotation for.
Body Content Type hidden Internal property set to "multipart-form-data" (not user-configurable).

Output

  • The output will be a JSON object containing the full quotation details for the specified quote code and version, as returned by the Opencell API endpoint /opencell/api/rest/cpq/quotes/quoteVersions/{quoteCode}/{quoteVersion}/quotation.
  • The structure of the output depends on the Opencell API but typically includes fields such as quote items, pricing, applicant information, status, and other relevant metadata.

Example output structure:

{
  "quote": {
    "code": "Q12345",
    "version": 2,
    "status": "DRAFT",
    "applicantAccountCode": "CUST001",
    "items": [
      {
        "productCode": "PROD1",
        "quantity": 10,
        "price": 100
      }
    ],
    "totalAmount": 1000,
    // ...other fields
  }
}

Note: Actual fields depend on your Opencell configuration.

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 the Opencell API.
  • n8n Configuration: Credentials must be set up under the node's credential options.

Troubleshooting

Common issues:

  • Invalid credentials: If authentication fails, ensure your API credentials are correct and have sufficient permissions.
  • Quote not found: If the provided Quote Code or Quote Version does not exist, the API will return an error. Double-check these values.
  • API connectivity: Network issues or incorrect Opencell API URLs can cause connection errors.

Error messages:

  • "Username/password error. Error code : XXX": Check your Basic Auth credentials.
  • "Host error. Error code : XXX": Verify the Opencell server address and network connectivity.
  • "Invalid credentials (unknown error)": Recheck all authentication settings.
  • "Resource not found" or similar: Ensure the Quote Code and Version are valid and exist in Opencell.

Links and References

Discussion