Skip to content

Fracttal ETL Hub Documentation

Post Item

Post Item

This atom allows you to create new assets on the Fracttal platform.

Description

Allows you to create a new asset in Fracttal using the POST /api/items operation.

General Information:

Module	Category
`Item`	`Create`

Atom Details

Input Parameters:

All required and optional fields aligned with the Fracttal API.

Input Schema:

Field	Type	Required	Description	Default	Example
`code`	str	✅	Unique asset code.	`PydanticUndefined`	-
`id_type_item`	ItemType	✅	Asset type.	`PydanticUndefined`	-
`field_1`	str	✅	Asset name.	`PydanticUndefined`	-
`field_2`	Optional[str]	❌	Address / Manufacturer / Part Number / Part Number / Manufacturer (depending on asset type)	`None`	-
`field_3`	Optional[str]	❌	City / Model / Manufacturer / Manufacturer / Serial number (depending on asset type)	`None`	-
`field_4`	Optional[str]	❌	Area code / Serial number / Model / Model / Version (depending on asset type)	`None`	-
`field_5`	Optional[str]	❌	Department / State / Region / Other 1 / Other 1 / Other 1	`None`	-
`field_6`	Optional[str]	❌	Country / Other 2 / Other 2 / Other 2	`None`	-
`active`	Optional[bool]	❌	Indicates whether the asset is active or not.	`None`	-
`barcode`	Optional[str]	❌	Bar-code.	`None`	-
`notes`	Optional[str]	❌	Asset notes.	`None`	-
`weight`	Optional[str]	❌	Asset weight (for spare parts and tools only)	`None`	-
`purchase_date`	Optional[str]	❌	Purchase date.	`None`	-
`is_serial_control`	Optional[bool]	❌	true if the item is controlled by serial, false otherwise.	`None`	-
`group`	Optional[str]	❌	Asset type.	`None`	-
`group_1`	Optional[str]	❌	Classification 1.	`None`	-
`group_2`	Optional[str]	❌	Classification 2.	`None`	-
`priorities`	Optional[str]	❌	Description of priority.	`None`	-
`id_priority`	Optional[Priority]	❌	Priority ID: 1: Very High, 2: High, 3: Medium, 4: Low, 5: Very Low	`None`	-
`code_parent_location`	Optional[str]	❌	Code of the asset where it is located or is part of (POST/PUT)	`None`	-
`latitude`	Optional[str]	❌	Latitude.	`None`	-
`longitud`	Optional[str]	❌	Length.	`None`	-
`unit_code`	Optional[str]	❌	Unit code (mandatory if it is a Tool or Spare Part)	`None`	-
`unit_description`	Optional[str]	❌	Description of the unit (required if it is a Tool or Spare Part)	`None`	-
`visible_to_all`	Optional[bool]	❌	Indicates whether the asset will be visible to everyone in the company.	`None`	-
`total_cost`	Optional[str]	❌	Total cost of the asset.	`None`	-
`startup_date`	Optional[str]	❌	Start date for depreciation.	`None`	-
`costs_center`	Optional[str]	❌	Description of the cost center.	`None`	-
`budgets`	Optional[str]	❌	Total cost of straight-line depreciation.	`None`	-
`id_custom_field_group`	Optional[int]	❌	Custom field group id.	`None`	-
`hours_average_daily_use`	Optional[int]	❌	Average daily usage hours (seconds, between 0 and 86400)	`None`	-

Technical Details:

The official endpoint is POST https://app.fracttal.com/api/items/