ObterItem

Observação: Este átomo permite consultar ativos no Fracttal via API oficial.

Descrição

Integre a atualização de inventário com a API Fracttal.

Este átomo faz a solicitação técnica ao endpoint oficial e retorna o resultado. Para estrutura de dados, parâmetros e exemplos atualizados, consulte: - https://api.fracttal.com/reference/consultar-un-active

API de endpoint: OBTENHA https://app.fracttal.com/api/items/

Informações Gerais:

Módulo	Categoria
`Item`	`Read`

Detalhes do Átomo

Parâmetros de Entrada:

código: str, opcional Código único do ativo a consultar.
id: int, opcional ID do ativo no Fracttal.
item_type: str, opcional Tipo de ativo (1: Locais, 2: Equipamentos, 3: Ferramentas, 4: Peças sobressalentes e suprimentos, 5: Digital).
ativo: bool, opcional Indica se o ativo está ativo ou não. Valores: Verdadeiro, Falso
código_de_localização: str, opcional Código de localização pai.
disponível: bool, opcional Indica se o ativo está em serviço.
iniciar: int, opcional Número de registro onde será iniciada a consulta (paginação). Padrão 0.
limite: int, opcional Número de registros que a solicitação mostrará. Padrão 100.
campo_1: str, opcional Nome, descrição ou título principal do ativo.
campo_2: str, opcional Campo adicional para informações complementares (exemplo: marca).
campo_3: str, opcional Campo adicional para informações complementares (exemplo: modelo).
campo_4: str, opcional Campo adicional para informações complementares (exemplo: serial).
campo_5: str, opcional Campo adicional para status, condição ou outra classificação.
campo_6: str, opcional Campo adicional para país, origem ou outras informações relevantes.

Esquema de Entrada:

Campo	Tipo	Obrigatório	Descrição	Padrão	Exemplo
`code`	Optional[str]	❌	Código único do ativo a consultar.	`None`	-
`id_type_item`	ItemType	✅	Tipo de ativo.	`PydanticUndefined`	-
`field_1`	Optional[str]	❌	Nome, descrição ou título principal do ativo.	`None`	-
`field_2`	Optional[str]	❌	Campo adicional para informações complementares (exemplo: marca).	`None`	-
`field_3`	Optional[str]	❌	Campo adicional para informações complementares (exemplo: modelo).	`None`	-
`field_4`	Optional[str]	❌	Campo adicional para informações complementares (exemplo: serial).	`None`	-
`field_5`	Optional[str]	❌	Campo adicional para status, condição ou outra classificação.	`None`	-
`field_6`	Optional[str]	❌	Campo adicional para país, origem ou outras informações relevantes.	`None`	-
`active`	Optional[bool]	❌	Indica se o ativo está ativo ou não.	`None`	-
`barcode`	Optional[str]	❌	Código de barras.	`None`	-
`notes`	Optional[str]	❌	Notas de ativos.	`None`	-
`weight`	Optional[str]	❌	Peso do ativo (apenas para peças sobressalentes e ferramentas)	`None`	-
`purchase_date`	Optional[str]	❌	Data de compra. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	`None`	-
`is_serial_control`	Optional[bool]	❌	verdadeiro se o item for controlado por serial; caso contrário, falso. Valores: Verdadeiro, Falso	`None`	-
`group`	Optional[str]	❌	Tipo de ativo.	`None`	-
`group_1`	Optional[str]	❌	Classificação 1.	`None`	-
`group_2`	Optional[str]	❌	Classificação 2.	`None`	-
`priorities`	Optional[str]	❌	Descrição da prioridade.	`None`	-
`id_priority`	Optional[Priority]	❌	ID de prioridade: 1: Muito Alta, 2: Alta, 3: Média, 4: Baixa, 5: Muito Baixa	`None`	-
`code_parent_location`	Optional[str]	❌	Código do ativo onde está localizado ou faz parte (POST/PUT)	`None`	-
`latitude`	Optional[str]	❌	Latitude.	`None`	-
`longitud`	Optional[str]	❌	Comprimento.	`None`	-
`unit_code`	Optional[str]	❌	Código da unidade (obrigatório se for uma ferramenta ou peça sobressalente)	`None`	-
`unit_description`	Optional[str]	❌	Descrição da unidade (obrigatória se for uma ferramenta ou peça sobressalente)	`None`	-
`visible_to_all`	Optional[bool]	❌	Indica se o ativo ficará visível para todos na empresa. Valores: Verdadeiro, Falso	`None`	-
`total_cost`	Optional[str]	❌	Custo total do ativo.	`None`	-
`startup_date`	Optional[str]	❌	Data de início da depreciação. Formato: 'AAAA-MM-DDTHH:MM:SS-UTC'	`None`	-
`costs_center`	Optional[str]	❌	Descrição do centro de custo.	`None`	-
`budgets`	Optional[str]	❌	Custo total da depreciação linear.	`None`	-
`id_custom_field_group`	Optional[int]	❌	ID do grupo de campos personalizados.	`None`	-
`hours_average_daily_use`	Optional[int]	❌	Média diária de horas de uso (segundos, entre 0 e 86.400)	`None`	-
`id`	Optional[int]	❌	ID do ativo no Fracttal.	`None`	-
`item_type`	Optional[str]	❌	Tipo de ativo (1: Locais, 2: Equipamentos, 3: Ferramentas, 4: Peças sobressalentes e suprimentos, 5: Digital).	`None`	-
`location_code`	Optional[str]	❌	Código de localização pai.	`None`	-
`available`	Optional[bool]	❌	Indica se o ativo está em serviço.	`None`	-
`start`	Optional[int]	❌	Número de registro onde será iniciada a consulta (paginação). Padrão 0.	`None`	-
`limit`	Optional[int]	❌	Número de registros que a solicitação mostrará. Padrão 100.	`None`	-

Detalhes Técnicos:

Suporta consultas individuais por código ou pesquisas paginadas com filtros.
Use campos herdados de BaseAssetModel para filtros comuns.
A paginação é controlada com os parâmetros start e limit.