GreenInvoice icon

GreenInvoice

Interact with GreenInvoice API for Israeli invoicing and accounting

Actions3

Overview

This node integrates with the GreenInvoice API, a service for Israeli invoicing and accounting. Specifically, the "Create Item" operation under the "Item" resource allows users to create new items in their GreenInvoice account. This is useful for businesses that want to programmatically manage their product or service catalog within their invoicing system.

Typical use cases include:

  • Automatically adding new products or services to your invoicing system when they are created in an external database or e-commerce platform.
  • Synchronizing item data between different business systems.
  • Preparing item data before generating invoices or other financial documents.

For example, you could use this node to add a new consulting service with its description, price, and currency, so it can be later included in invoices.

Properties

Name Meaning
Item Name The name of the item to create.
Item Description A detailed description of the item.
Item Price The price of the item as a number.
Currency The currency of the item price. Options: Israeli Shekel (ILS), US Dollar (USD), Euro (EUR).

Output

The node outputs JSON data representing the newly created item as returned by the GreenInvoice API. This typically includes the item's unique identifier, name, description, price, currency, and any other metadata provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the GreenInvoice API.
  • The node makes HTTP requests to https://api.greeninvoice.co.il/api/v1/items.
  • The API key must have permissions to create items in the GreenInvoice account.
  • The node internally obtains a JWT token by sending the API key ID and secret to the GreenInvoice authentication endpoint before making the item creation request.

Troubleshooting

  • Authentication errors: If the API key or secret is incorrect or missing, the node will fail to obtain a valid token, resulting in authentication errors. Verify that the API credentials are correct and have sufficient permissions.
  • Validation errors: Missing required fields such as "Item Name", "Item Description", or "Item Price" will cause the API to reject the request. Ensure all required properties are provided.
  • Unsupported currency: Only the currencies ILS, USD, and EUR are supported. Using other values may cause errors.
  • API connectivity issues: Network problems or incorrect base URL configuration can prevent successful API calls. Confirm network access and endpoint correctness.

Links and References

Discussion