LavaTop icon

LavaTop

Sends data to LavaTop
Join our community

Actions8

Overview

The "Get Many" operation for the Invoice resource in this node allows users to retrieve multiple invoices from the LavaTop service. It supports filtering and pagination, enabling users to fetch invoices based on various criteria such as date ranges, buyer email, currency, product name, invoice type, and status.

This operation is beneficial in scenarios where you need to analyze or process batches of invoices, generate reports, or synchronize invoice data with other systems. For example, an e-commerce platform could use this node to pull all completed invoices within a specific month to reconcile payments or generate financial summaries.

Properties

Name Meaning
Return All Whether to return all matching invoices or limit the results to a specified page size.
Limit Maximum number of invoices to return per page (valid when Return All is false). Range: 1 to 100.
Page The page number of results to return (valid when Return All is false).
Filters Collection of filters to narrow down the invoices returned. Includes:
- Begin Date Start date (UTC+0) to filter invoices created on or after this date.
- End Date End date (UTC+0) to filter invoices created on or before this date.
- Buyer Email Filter invoices by buyer's email address; supports pattern matching.
- Currencies Filter by transaction currency. Options: RUB, USD, EUR.
- Last 4 Card Digits Filter invoices by the last 4 digits of the payment card used.
- Product Name Filter invoices by product name; supports pattern matching.
- Invoice Types Filter by invoice type. Options: One Time, Recurring.
- Invoice Statuses Filter by invoice status. Options: New, In Progress, Completed, Failed. Default is Completed.

Output

The output contains a JSON array of invoice objects matching the query parameters. Each invoice object includes details such as invoice ID, buyer information, product details, payment status, currency, and timestamps.

If the node supports binary data output (not indicated here), it would typically represent attachments or invoice documents, but this operation primarily returns structured JSON data representing invoices.

Dependencies

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

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Using invalid filter values (e.g., unsupported currencies or statuses) may result in empty responses or errors.
    • Requesting pages beyond the available range will return empty results.

  • Error Messages:

    • Authentication errors: Verify that the API key credential is correctly configured.
    • Validation errors: Check that filter values conform to allowed options and formats.
    • Rate limiting or network errors: Retry after some time or check network connectivity.

Links and References

Discussion