Plutio icon

Plutio

Consume Plutio API

Actions20

Invoice → Get

AI-generated

Overview

The Plutio Invoice Get operation node allows you to retrieve invoices from the Plutio API based on various filter criteria. This is useful for automating invoice management, reporting, or integrating invoice data into other workflows. For example, you might use this node to fetch all paid invoices in EUR currency, or to look up a specific invoice by its ID.

Properties

Name Type Meaning
Invoice ID String The unique identifier of the invoice to retrieve.
Invoice Name String The name/title of the invoice. Allows filtering by invoice name (1-500 characters).
Currency Options The currency of the invoice. Can be "USD" or "EUR".
Status Options The status of the invoice: "Draft", "Pending", "Paid", or "Cancelled".
Discount Number The discount percentage applied to the invoice. Should be a number representing percent.

All these properties are optional filters; you can use any combination to narrow down your search.

Output

The output will be an array of JSON objects, each representing an invoice that matches the specified criteria. Each object contains the fields returned by the Plutio API for invoices, which typically include:

  • _id: Unique identifier of the invoice.
  • name: Name/title of the invoice.
  • currency: Currency code (e.g., "USD", "EUR").
  • status: Current status of the invoice.
  • discount: Discount applied (as a string with a percent sign, e.g., "10%").
  • ...plus additional invoice details as provided by Plutio.

Note: The exact structure depends on the Plutio API response.

Dependencies

  • External Service: Requires access to the Plutio API.
  • API Credentials: You must configure valid Plutio API credentials (plutioApi) in n8n.
  • n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

  • Missing or Invalid Credentials:

    • Error message: "401 Unauthorized" or similar.
    • Resolution: Ensure your Plutio API credentials are correctly set up in n8n.

  • No Results Returned:

    • Possible causes: Filters are too restrictive, or no invoices match the criteria.
    • Resolution: Try broadening your search by removing some filters.

  • Invalid Discount Format:

    • Error message: May receive an error if a non-numeric value is entered for Discount.
    • Resolution: Enter only numbers for the Discount field.

  • API Errors:

    • Error message: Any error from the Plutio API will be passed through.
    • Resolution: Check the error message for details and consult the Plutio API documentation.

Links and References

Discussion