LavaTop icon

LavaTop

Sends data to LavaTop
Join our community

Actions8

Overview

This node integrates with the LavaTop platform to retrieve sales data filtered by product. Specifically, the "Get Sales by Product" operation fetches sales records associated with a specified product UUID. It supports filtering by date range, currency, contract status, and search terms within the product sales.

This node is useful for scenarios such as:

  • Generating sales reports for a particular product.
  • Analyzing sales trends over specific periods.
  • Filtering sales data by transaction currency or contract status.
  • Searching sales records with keywords related to the product.

For example, a user might want to get all completed sales in USD for a product during the last quarter or find all sales containing a certain keyword in their description.

Properties

Name Meaning
Return All Whether to return all results or limit the output to a specified number of records.
Limit Maximum number of results to return per page (1 to 100).
Page The page number of results to return when not returning all.
Product ID The UUID of the product to retrieve sales data for.
Filters Collection of optional filters:
  From Date Start date for the sales period filter.
  To Date End date for the sales period filter.
  Currency Filter sales by transaction currency. Options: RUB, USD, EUR.
  Status Filter by contract status. Options include New, In Progress, Completed, Failed, Cancelled, Subscription Active, Subscription Expired, Subscription Cancelled, Subscription Failed. Default is Completed.
  Search Term Search term to filter within product sales records.

Output

The node outputs JSON data representing the sales records matching the query parameters. Each item in the output corresponds to a sale related to the specified product, including details such as sale date, amount, currency, status, and other relevant metadata.

If binary data were involved (e.g., invoices or receipts), it would be summarized accordingly, but this node focuses on JSON sales data.

Dependencies

  • Requires an API key credential for authenticating with the LavaTop service.
  • The node depends on the LavaTop API endpoint that provides sales data.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Common Issues:

    • Invalid or missing Product ID: The node requires a valid UUID for the product; ensure this is correctly provided.
    • API authentication errors: Verify that the API key credential is correctly configured and has necessary permissions.
    • Pagination limits: If Return All is false and the limit/page parameters are misconfigured, you may receive incomplete data.
    • Date filter format: Ensure date filters are in proper ISO 8601 format to avoid API errors.

  • Error Messages:

    • Authentication failures typically indicate invalid credentials; reconfigure the API key.
    • Validation errors on input parameters usually point to missing required fields like Product ID.
    • Rate limiting or server errors from the API should be handled by retrying after some delay.

Links and References

Discussion