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 Client operation under the Client resource allows users to create new client records in their GreenInvoice account.

Typical use cases include automating client management workflows such as:

  • Adding new clients automatically when they sign up on a website or CRM.
  • Syncing client data from other systems into GreenInvoice.
  • Streamlining bookkeeping by programmatically maintaining client lists.

For example, a business could use this node to add a new client with their tax ID and contact details directly into GreenInvoice whenever a new customer is registered in their sales system.

Properties

Name Meaning
Client Name The full name of the client to be created.
Tax ID The client's tax identification number (required).
Additional Client Fields Optional additional information about the client:
- Accounting Key A key used for accounting purposes.
- Active Whether the client is currently active (true/false).
- Address The client's street address.
- City The city where the client is located.
- Country The client's country. Options: Israel, United States, United Kingdom.
- Department The department associated with the client.
- Email The client's email address.
- Phone The client's phone number.

Output

The node outputs JSON data representing the newly created client object as returned by the GreenInvoice API. This typically includes all client details stored in GreenInvoice after creation, such as assigned IDs and any default fields set 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 POST requests to https://api.greeninvoice.co.il/api/v1/clients with appropriate authorization headers.
  • The user must configure the API credentials in n8n before using this node.

Troubleshooting

  • Common issues:

    • Missing required fields like Client Name or Tax ID will cause the API request to fail.
    • Invalid or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Operation createClient is not supported for clients resource": Indicates a misconfiguration or unsupported operation; ensure the correct operation is selected.
    • API errors related to invalid input will be returned from the GreenInvoice API and surfaced in the node's output if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify all required fields are provided and correctly formatted.
    • Check that the API key credential is valid and has necessary permissions.
    • Ensure network access to the GreenInvoice API endpoint is available.

Links and References

Discussion