Ikoula API Microsoft icon

Ikoula API Microsoft

Interact with Ikoula Microsoft API for Microsoft 365 account management. Developed by Ascenzia - www.ascenzia.fr
Join our community

Actions18

Overview

This node integrates with the Ikoula Microsoft API to manage Microsoft 365 resources, specifically focusing here on retrieving detailed information about a specific invoice within a Microsoft subscription. It is useful for scenarios where users need to programmatically access invoice details such as billing data, amounts, dates, and other metadata related to Microsoft 365 subscriptions managed via Ikoula.

Practical examples include:

  • Automatically fetching invoice details for accounting or auditing purposes.
  • Integrating invoice data into financial dashboards or ERP systems.
  • Triggering workflows based on invoice status or content.

Properties

Name Meaning
Subscription ID The ID of the Microsoft subscription associated with the invoice.
Invoice ID The unique identifier of the invoice for which details are requested.
Response Format The format in which the API response should be returned. Options: JSON, XML.

Output

The node outputs the invoice details in the specified response format (json or xml). When JSON is selected, the output is parsed into a JavaScript object under the json property. This object contains all the invoice information returned by the Ikoula Microsoft API, such as invoice metadata, line items, amounts, dates, and other relevant fields.

If XML format is chosen, the raw XML string is returned inside the json.data field as a string.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for the Ikoula Microsoft API, including email and password credentials that are encrypted before transmission.
  • The node communicates with the Ikoula API endpoint at https://api.ikoula.com (default).
  • Proper configuration of the API credentials in n8n is necessary for authentication.
  • The node uses RSA public key encryption to secure the password before sending it to the API.

Troubleshooting

  • No credentials provided!
    This error occurs if the node is executed without valid API credentials configured. Ensure that the required API key credential is set up correctly in n8n.

  • Invalid Subscription ID or Invoice ID
    If the IDs provided do not correspond to existing resources, the API may return errors or empty results. Verify that the subscription and invoice IDs are correct.

  • API Response Format Issues
    Selecting XML format returns raw XML data as a string. If downstream nodes expect JSON, ensure to select JSON format or parse the XML accordingly.

  • Network or Authentication Errors
    Check network connectivity and validity of the API credentials. Also verify that the API endpoint URL is reachable and correct.

Links and References

Discussion