Ir para o conteúdo

Fracttal ETL Hub Documentation

Publicar equivalentes de itens

Publicar equivalentes de itens

Valide se os códigos de equivalência existem antes de enviar o pedido.

O sistema pode rejeitar pares duplicados ou inválidos.

Descrição

Permite associar equivalências entre ativos no Fracttal usando a operação POST /api/items_equivalents. Herda os campos comuns do BaseAssetModel e permite o envio de pares de equivalência de acordo com a API oficial. Documentação oficial: https://api.fracttal.com/reference/asociar-productos-equivalentes#/

Informações Gerais:

Módulo	Categoria
`Item`	`Create`

Detalhes do Átomo

Parâmetros de Entrada:

Campo Equivalentes: lista de pares de equivalências entre ativos.
Cada dict deve ter códigos de item equivalentes.

Esquema de Entrada:

Campo	Tipo	Obrigatório	Descrição	Padrão	Exemplo
`code`	str	✅	Código de ativo exclusivo.	`PydanticUndefined`	-
`id_type_item`	ItemType	✅	Tipo de ativo.	`PydanticUndefined`	-
`field_1`	str	✅	Nome do ativo.	`PydanticUndefined`	-
`field_2`	Optional[str]	❌	Endereço/Fabricante/Número da peça/Número da peça/Fabricante (dependendo do tipo de ativo)	`None`	-
`field_3`	Optional[str]	❌	Cidade/Modelo/Fabricante/Fabricante/Número de série (dependendo do tipo de ativo)	`None`	-
`field_4`	Optional[str]	❌	Código de área/Número de série/Modelo/Modelo/Versão (dependendo do tipo de ativo)	`None`	-
`field_5`	Optional[str]	❌	Departamento / Estado / Região / Outro 1 / Outro 1 / Outro 1	`None`	-
`field_6`	Optional[str]	❌	País / Outro 2 / Outro 2 / Outro 2	`None`	-
`active`	Optional[bool]	❌	Indica se o ativo está ativo ou não. Valores: Verdadeiro, Falso	`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`	-
`equivalents`	list[dict[str, Any]]	✅	Lista de pares de equivalências entre ativos. Cada dict deve ter os códigos de item equivalentes.	`PydanticUndefined`	-

Detalhes Técnicos:

O endpoint oficial é POST https://app.fracttal.com/api/items_equivalents/
Os campos devem estar de acordo com os tipos e restrições da API.

Relacionado: