ScoroInstall

Overview

This node integrates with the Scoro API to perform various operations on different resources. Specifically, for the Invoice - Create operation, it allows users to create a new invoice in their Scoro account by sending a JSON-formatted request body that represents the invoice details.

Common scenarios where this node is beneficial include automating invoice creation as part of a workflow, such as generating invoices after project completion or time tracking entries, or integrating Scoro invoicing with other business systems.

Practical example:

• Automatically create an invoice in Scoro when a new client project is marked as completed.
• Generate invoices based on time entries logged by employees without manual data entry.

Properties

Output

The node outputs JSON data representing the response from the Scoro API after attempting to create the invoice. This typically includes the newly created invoice's details such as its ID, status, amounts, and any metadata returned by the API.

If the API supports binary data (e.g., PDF invoice files), the node would handle it accordingly, but based on the provided code and properties, the output focuses on JSON responses.

Dependencies

• Requires an active connection to the Scoro API via an API key credential.
• The node expects credentials containing at least:
  • Base URL of the Scoro instance.
  • Company account identifier.
  • API key for authentication.
• No additional external dependencies are indicated beyond the Scoro API access.

Troubleshooting

• Unsupported Operation Error: If you select an operation-resource combination not supported by the node, it will throw an error like Operation 'create' for resource 'invoice' is not supported. Ensure the operation and resource names are correct.
• Invalid JSON in Request Property: Since the "Request" property expects a JSON object, providing invalid JSON will cause parsing errors. Make sure the JSON is well-formed.
• Authentication Failures: Errors related to API key or base URL misconfiguration can prevent successful API calls. Verify credentials are correctly set up.
• API Response Errors: If the Scoro API returns errors (e.g., missing required fields, invalid data), these will be surfaced in the node output. Review the API documentation to ensure the request body meets all requirements.

Links and References

• Scoro API Documentation — Official API reference for constructing requests and understanding responses.
• n8n Documentation on Creating Custom Nodes — For more information on how nodes interact with APIs and handle inputs/outputs.