Imobzi icon

Imobzi

Interagir com a API da Imobzi
Join our community

Actions62

Overview

This node integrates with the Imobzi API to manage financial account records under the "Financeiro" resource. Specifically, the Create operation allows users to add new financial items such as transactions or accounts by specifying relevant details like date, description, value, and contact information.

Typical use cases include automating the creation of financial entries when new invoices are generated, recording payments, or adding financial data from other systems into Imobzi for centralized management.

For example, a user can create a new financial record with a specific date, title, description, monetary value, and associated contact email or phone number, streamlining bookkeeping workflows.

Properties

Name Meaning
Date Date of the financial item (e.g., transaction date).
Description Textual description providing details about the financial item.
Email Email address related to the financial item (e.g., payer or contact email).
Name Name associated with the financial item.
Phone Phone number related to the financial item or contact.
Title Title or short label for the financial item.
Value Numeric value representing the amount of the financial item (e.g., payment amount).

These fields are grouped under the "Create Fields" collection property, which is used to specify the data sent to the Imobzi API when creating a new financial record.

Output

The node outputs JSON data representing the response from the Imobzi API after creating the financial record. The output JSON contains the newly created item's data fields as returned by the API.

Example structure of the output JSON might include:

{
  "id": "12345",
  "date": "2024-06-01",
  "description": "Payment received",
  "email": "client@example.com",
  "name": "Invoice #456",
  "phone": "555-1234",
  "title": "Payment",
  "value": 1500.00,
  // ... other fields returned by the API
}

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Imobzi API.
  • Users must configure an API authentication credential (an API key or token) in n8n to authorize requests.
  • The node uses authenticated HTTP requests to endpoints under /financial/accounts for the Financeiro resource.

Troubleshooting

  • Unsupported Resource Error: If the resource name is incorrect or not supported, the node throws an error indicating the resource is unsupported. Ensure the resource is set exactly to "financeiro" for this operation.
  • Operation Not Supported: Using an unsupported operation will cause an error. Confirm that the operation is set to "create" for creating financial records.
  • API Authentication Failures: Errors related to authentication usually mean the API credentials are missing, invalid, or expired. Verify the API key/token configuration in n8n.
  • Invalid Field Values: Providing empty or incorrectly typed values (e.g., non-numeric for "Value") may cause API errors. Validate input data before execution.
  • Network Issues: Connectivity problems with the Imobzi API endpoint will result in request failures. Check network access and API availability.

Links and References

Discussion