Actions4
- Product Actions
- Invoice Receipt Actions
Overview
This node integrates with the Moloni.pt API to create new product entries in a company's product catalog. It is designed for businesses that manage their inventory and sales through Moloni.pt, allowing them to programmatically add products with detailed attributes such as pricing, stock levels, categories, taxes, suppliers, and warehouse information.
Common scenarios where this node is beneficial include:
- Automating product catalog updates from external systems or databases.
- Bulk importing new products into Moloni.pt.
- Integrating e-commerce platforms or ERP systems with Moloni.pt to keep product data synchronized.
For example, an online retailer can use this node to automatically insert new products into Moloni.pt whenever they are added to their internal inventory system, ensuring consistent product data across platforms.
Properties
| Name | Meaning |
|---|---|
| Company ID | Numeric identifier of the company in Moloni.pt under which the product will be created. |
| Category ID | Numeric identifier specifying the category to which the product belongs. |
| Type | Numeric code representing the product type (e.g., physical, service). |
| Name | The name/title of the product. |
| Summary | A brief description or summary of the product. |
| Reference | Unique reference string/code for the product. |
| EAN | European Article Number barcode string for the product. |
| Price | Numeric value indicating the product's price. |
| Unit ID | Numeric identifier for the unit of measurement used for the product (e.g., pieces, kilograms). |
| Has Stock | Numeric flag indicating if the product has stock tracking enabled (typically 0 or 1). |
| Stock | Numeric value representing the current stock quantity available. |
| Minimum Stock | Numeric value defining the minimum stock threshold for alerts or reordering. |
| POS Favorite | Numeric flag indicating if the product is marked as a favorite in Point of Sale systems. |
| At Product Category | String representing additional categorization or tags related to the product category. |
| Exemption Reason | String describing any tax exemption reason applicable to the product. |
| Taxes | Collection of tax records applied to the product. Each tax includes: Tax ID, Value, Order, Cumulative flag. |
| Suppliers | Collection of supplier records associated with the product. Each supplier includes Supplier ID, Cost Price, and Reference. |
| Properties | Collection of custom properties assigned to the product. Each property includes Property ID and its Value. |
| Warehouses | Collection of warehouse stock entries. Each entry includes Warehouse ID and Stock quantity. |
Output
The node outputs JSON data representing the response from the Moloni.pt API after attempting to create the product. This typically includes details about the newly created product such as its unique identifiers, status, and any messages returned by the API.
If the operation is successful, the output JSON will confirm the creation and provide relevant product metadata. There is no indication that binary data is handled or output by this node.
Dependencies
- Requires an active connection to the Moloni.pt API.
- Needs an API authentication token configured via OAuth2 credentials within n8n.
- Network access to
https://api.moloni.pt/v1/must be available. - Proper permissions on the Moloni.pt account to create products.
Troubleshooting
- Authentication Errors: If the node fails due to authentication issues, verify that the OAuth2 credentials are correctly set up and have not expired.
- Validation Errors: Missing required fields like Company ID, Category ID, Name, Reference, Price, Unit ID, Has Stock, or Stock will cause errors. Ensure all mandatory properties are provided.
- API Limitations: The Moloni.pt API may enforce rate limits or restrictions on product creation; hitting these limits will result in errors.
- Incorrect Data Types: Providing incorrect types (e.g., strings instead of numbers) for numeric fields may cause request failures.
- Network Issues: Connectivity problems to the Moloni.pt API endpoint will prevent the node from functioning.
To resolve errors, check the error message returned by the node, ensure all required inputs are valid, and confirm network and credential configurations.