Imobzi icon

Imobzi

Interagir com a API da Imobzi

Overview

This node integrates with the Imobzi API to manage various resources, including documents. Specifically, for the "Documento" resource with the "Create" operation, it allows users to create new document entries in the Imobzi system by specifying relevant fields such as date, description, email, name, phone, title, and value.

Common scenarios where this node is beneficial include automating document management workflows, such as adding new contracts, invoices, or other document types into Imobzi directly from an automation pipeline. For example, after generating a contract PDF in another system, you could use this node to create a corresponding document record in Imobzi with metadata like title, date, and associated contact information.

Properties

Name Meaning
Date Date of the item
Description Description of the item
Email Email address
Name Name of the item
Phone Phone number
Title Title of the item
Value Numeric value associated with the item

These properties are grouped under "Create Fields" and represent the data that can be sent to create a new document in Imobzi.

Output

The node outputs JSON data representing the response from the Imobzi API after creating the document. The output JSON contains the newly created document's details as returned by the API, typically including identifiers and all submitted fields.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "id": "123",
  "date": "2024-01-01",
  "description": "Contract document",
  "email": "example@email.com",
  "name": "Contract #123",
  "phone": "555-1234",
  "title": "Contract Agreement",
  "value": 1000
}

Dependencies

  • Requires an active connection to the Imobzi API.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests.
  • The node uses HTTP methods (POST for create) to interact with the Imobzi REST endpoints.

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 spelled correctly and supported by the node.
  • Operation Not Supported: Using an unsupported operation will cause an error. Confirm the operation is one of the supported ones (create, get, update, delete, getAll).
  • Authentication Failures: Errors related to authentication usually mean the API credentials are missing, invalid, or expired. Verify the API key or token configuration.
  • Empty Required Fields: If required fields for creating a document are missing or empty, the API may reject the request. Make sure to provide necessary fields according to Imobzi API documentation.
  • API Rate Limits or Network Issues: Temporary failures might occur due to network problems or API rate limits. Implement retry logic or check API usage quotas if applicable.

Links and References

Discussion