Field Control

Use this when the user asks about a specific employee or technician by ID. Returns complete employee data including name, email, address, contract details, work schedule, groups, skills and device info. Do not use for listing multiple employees — use search_employees instead.

get_employee_details

Use this when the user asks about a specific equipment by ID. Returns complete equipment data including name, serial number, model, manufacturer, customer, location and maintenance history. Do not use for listing multiple equipments — use search_equipments instead.

get_equipment_details

Returns the business rules and constraints enforced by equipment mutations (create_equipment, install_equipment, return_equipment, release_equipment), covering number uniqueness, value/thermal capacity constraints, install location consistency with customer, replacement date rules, lifecycle status transitions and storage restrictions on release.

get_equipment_rules

Use this when the user asks about a specific service location by ID. Returns complete location data including name, address, customer, contacts, attachments, territories and responsible person. Do not use for listing multiple locations — use search_locations instead.

get_location_details

Returns the business rules and constraints enforced by storage movement mutations (create_entry_storage_movements, create_removal_storage_movements, create_transfer_storage_movements), covering identifier rules, storage existence, allowed entityType per movement type, quantity/value constraints, item existence and stock balance.

get_movement_rules

Use this when the user asks about a specific work order by ID or needs detailed information about one order. Returns complete order data including tasks, equipments, customer, employee, services, deadline, address and comments. Pass includeForms: true to also return form answers (formulários) with all questions and technician responses. Do not use for listing multiple orders — use search_orders instead.

get_order_details

Returns the business rules and constraints enforced by order mutations (create_order, update_order, save_order_quotation, save_order_links and related), including required fields, allowed values and locked fields.

get_order_rules

Use this when the user asks about a specific inventory part by ID. Returns complete part data including name, code, description, quantity in stock and unit price. Do not use for listing multiple parts — use search_parts instead.

get_part_details

Use this when the user asks about a specific serialized part unit by ID. Returns complete unit data including serial number, status, location history and associated order. Do not use for listing multiple units — use search_part_units instead.

get_part_unit_details

Returns the business rules and constraints enforced by part unit mutations (install_part_unit, return_part_unit, release_part_unit), covering install requirements (location OR equipment), sector/environment hierarchy, equipment status, replacement date rules, lifecycle status transitions and storage restrictions on release.

get_part_unit_rules

Use this when the user asks about a specific product by ID. Returns complete product data including name, code, description, price and stock info. Do not use for listing multiple products — use search_products instead.

get_product_details

Use this when the user asks about a specific quotation or estimate by ID. Returns complete quotation data including items, prices, customer, discounts and approval status. Do not use for listing multiple quotations — use search_quotations instead.

get_quotation_details

Use this when the user asks about a specific service type by ID. Returns complete service data including name, description, pricing and configuration. Do not use for listing multiple services — use search_services instead.

get_service_details

Use this when the user asks about a specific storage location or warehouse by ID. Returns complete storage data including name, address and inventory summary. Do not use for listing multiple storages — use search_storages instead.

get_storage_details

Use this when the user asks about a specific task by ID. Returns complete task data including description, status, scheduled date, duration, assigned employee, order reference and checklist items. Do not use for listing multiple tasks — use search_tasks instead.

get_task_details

Returns the business rules and constraints enforced by task mutations (create_task, update_task), covering status transitions, startedAt/completedAt requirements and locked fields.

get_task_rules

Use this when the user asks about a specific support ticket by ID. Returns complete ticket data including subject, description, status, priority, requester, assigned employee and conversation history. Do not use for listing multiple tickets — use search_tickets instead.

get_ticket_details

Returns the business rules and constraints enforced by ticket mutations (accept_ticket_and_create_order, cancel_tickets), covering pre-selected customer/location/service constraints, schedule suggestions, expiration, archiving and corporate account alignment.

get_ticket_rules

Use this when the user asks about a specific system user by ID. Returns complete user data including name, email, role, phone and profile settings. Do not use for listing multiple users — use search_users instead.

get_user_details

============================================================================= InstallEquipment - Instala um equipamento em uma location ============================================================================= Muda o status do equipamento para "installed" e vincula-o a uma location (e opcionalmente sector/environment). Use quando o usuário quer registrar que um equipamento foi instalado no campo. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID do equipamento locationId (UUID!) → Location onde será instalado ── PARÂMETROS OPCIONAIS ───────────────────────────────────────────────────── locationSectorId (UUID) → Setor (precisa pertencer à locationId) locationEnvironmentId (UUID) → Ambiente (precisa pertencer ao setor) installedAt (Datetime) → Quando foi instalado (default: agora) replacementDueAt (Datetime) → Data prevista de troca (hoje ou futuro) orderId (UUID) → Vincular a uma OS de instalação ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Equipamento não pode estar descartado. Se já tem customer_id, a location deve ser daquele customer. replacementDueAt não pode ser no passado. Chame get_equipment_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id, name } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_equipment_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

install_equipment

============================================================================= InstallPartUnit - Instala uma unidade serializada de peça ============================================================================= Marca uma part_unit como instalada — vinculando-a a uma location e/ou a um equipamento. Use quando o usuário instalou uma peça em campo. O front tem 2 fluxos: instalar em location (com sector/environment opcionais) ou instalar dentro de um equipamento em estoque. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID da part_unit + pelo menos UM de: locationId OU equipmentId ── PARÂMETROS OPCIONAIS ───────────────────────────────────────────────────── locationId (UUID) → Instalar em location locationSectorId (UUID) → Setor (precisa pertencer à locationId) locationEnvironmentId (UUID) → Ambiente (precisa pertencer ao sector) equipmentId (UUID) → Instalar dentro de um equipamento (equipamento NÃO pode estar descartado) installedAt (Datetime) → Quando foi instalado (default: agora) replacementDueAt (Datetime) → Próxima troca (hoje ou futuro) orderId (UUID) → Vincular a uma OS ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Part unit não pode estar descartada. Pelo menos uma de location ou equipment é obrigatória. Sector/environment devem respeitar a hierarquia. Equipment alvo não pode estar descartado. replacementDueAt não pode ser no passado. Chame get_part_unit_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_part_unit_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

install_part_unit

Introspects the Field Control GraphQL API schema (https://eyeofsauron-2.fieldcontrol.com.br) to discover available types, fields and operations in the data model.

introspect_schema

============================================================================= ReleaseEquipment - Libera um equipamento da triagem para um storage de uso ============================================================================= Move um equipamento que está em revisão/triagem ("under_review") para um storage operacional. Após release, o equipamento fica disponível pra ser instalado novamente. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID do equipamento storageId (UUID!) → Storage destino (não pode ser triagem nem de employee) ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Equipamento DEVE estar com status "under_review". Storage destino NÃO pode ter is_triage=true e NÃO pode estar vinculado a um employee. Chame get_equipment_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id, name } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_equipment_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

release_equipment

============================================================================= ReleasePartUnit - Libera uma part_unit da triagem para um storage de uso ============================================================================= Move uma part_unit que está em revisão ("under_review") para um storage operacional, ficando disponível pra reuso/instalação. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID da part_unit storageId (UUID!) → Storage destino (não triagem, não de employee) ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Part unit DEVE estar com status "under_review". Storage destino NÃO pode ser de triagem (is_triage=true) nem estar vinculado a um employee. Chame get_part_unit_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_part_unit_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

release_part_unit

============================================================================= ReturnEquipment - Devolve um equipamento para um storage (almoxarifado) ============================================================================= Marca um equipamento entregue (status "delivered") como devolvido — vai para o storage informado (geralmente triagem). Use quando o usuário quer registrar a devolução pós-uso. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID do equipamento storageId (UUID!) → Storage que recebe a devolução ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Equipamento DEVE estar com status "delivered" para ser devolvido. Storage deve existir na conta. Chame get_equipment_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id, name } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_equipment_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

return_equipment

============================================================================= ReturnPartUnit - Devolve uma part_unit para storage ============================================================================= Marca uma part_unit entregue (status "delivered") como devolvida, indo para o storage informado. Use para registrar devolução pós-uso. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── id (UUID!) → ID da part_unit storageId (UUID!) → Storage que recebe a devolução ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Part unit DEVE estar com status "delivered". Storage deve existir. Chame get_part_unit_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id } ============================================================================= The business rules and constraints enforced by this mutation are documented in get_part_unit_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

return_part_unit

============================================================================= SaveOrderLabels - Define as etiquetas (tags) de uma OS ============================================================================= Substitui o conjunto de etiquetas associadas a uma ordem de serviço. Use quando o usuário quer adicionar, trocar ou setar tags (ex.: "urgente", "garantia", "retrabalho"). Passe lista vazia para limpar todas. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── orderId (UUID!) → ID da OS alvo labelIds ([UUID!]!) → Lista COMPLETA de etiquetas a associar (substitui as existentes) ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Chame get_order_rules para a lista completa de constraints. ── RETORNO ────────────────────────────────────────────────────────────────── [{ id, label { id, name, color } }] (lista resultante) ============================================================================= The business rules and constraints enforced by this mutation are documented in get_order_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

save_order_labels

============================================================================= SaveOrderLinks - Vincula entidades físicas/lógicas a uma OS ============================================================================= Anexa setores, ambientes, equipamentos e/ou unidades de peças a uma ordem de serviço. Cada lista REPLACES a lista existente daquele tipo (não é incremental). Listas omitidas ficam intactas. Para orçamentos use save_order_quotation. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── orderId (UUID!) → ID da OS alvo + pelo menos UMA das listas abaixo ── LISTAS DE VÍNCULOS (pelo menos uma é obrigatória) ─────────────────────── locationSectorIds ([UUID!]) → Setores do local de atendimento locationEnvironmentIds ([UUID!]) → Ambientes do local equipmentIds ([UUID!]) → Equipamentos sendo atendidos partUnitIds ([UUID!]) → Unidades serializadas de peças ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Equipments devem pertencer ao customer OU à location da OS. Chame get_order_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── { id, identifier } (a OS atualizada) ============================================================================= The business rules and constraints enforced by this mutation are documented in get_order_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

save_order_links

============================================================================= SaveOrderProducts - Define os produtos consumidos numa OS ============================================================================= Substitui a lista de produtos consumidos/vendidos na ordem de serviço. Use quando o usuário quer registrar produtos usados na execução. Passe lista vazia para limpar. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── orderId (UUID!) → ID da OS alvo products ([ProductOrServiceInputToSave!]!) → Lista COMPLETA de produtos (substitui a existente) ── ESTRUTURA DE CADA PRODUTO ─────────────────────────────────────────────── id (String!) → ID do produto no catálogo quantity (Float!) → Quantidade consumida value (Float) → Preço unitário (opcional — usa o do catálogo se omitido) ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Chame get_order_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── [{ id, quantity, totalValue }] (lista resultante) ============================================================================= The business rules and constraints enforced by this mutation are documented in get_order_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

save_order_products

============================================================================= SaveOrderQuotation - Vincula um orçamento (quotation) a uma OS ============================================================================= Anexa uma cotação/orçamento a uma ordem de serviço. Tipicamente usado após o cliente aprovar o orçamento. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── orderId (UUID!) → ID da OS alvo quotationId (UUID!) → ID do orçamento a vincular ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── A quotation DEVE pertencer ao mesmo customer da OS. Quotations arquivadas ou com status refused/expired/canceled NÃO podem ser vinculadas — apenas status pending (0) ou approved (1). Chame get_order_rules para mais. ── RETORNO ────────────────────────────────────────────────────────────────── { id, identifier } (a OS atualizada) ============================================================================= The business rules and constraints enforced by this mutation are documented in get_order_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

save_order_quotation

============================================================================= SaveOrderServices - Define os serviços executados numa OS ============================================================================= Substitui a lista de serviços executados na ordem de serviço. Use quando o usuário quer registrar quais serviços foram realizados (e quantidade/preço), tipicamente na conclusão da OS. Passe lista vazia para limpar. ── PARÂMETROS OBRIGATÓRIOS ────────────────────────────────────────────────── orderId (UUID!) → ID da OS alvo services ([ProductOrServiceInputToSave!]!) → Lista COMPLETA de serviços (substitui a existente) ── PARÂMETROS OPCIONAIS ───────────────────────────────────────────────────── taskId (UUID) → Limita os serviços a uma task específica da OS ── ESTRUTURA DE CADA SERVIÇO ─────────────────────────────────────────────── id (String!) → ID do serviço no catálogo quantity (Float!) → Quantidade executada value (Float) → Preço unitário (opcional) ── REGRAS DE NEGÓCIO IMPORTANTES ─────────────────────────────────────────── Chame get_order_rules para a lista completa. ── RETORNO ────────────────────────────────────────────────────────────────── [{ id, quantity, totalValue }] (lista resultante) ============================================================================= The business rules and constraints enforced by this mutation are documented in get_order_rules. Mutations that violate them are rejected. The full structure of the input argument, including nested types, is available from search_schema.

save_order_services

Use this when the user wants to find, list or search customers (clientes). Returns paginated results with customer name, document number, contact info and address. Supports filtering by name, city, state, document number, tags and rating. Do not use for getting details of a single customer — use get_customer_details instead.

search_customers

Use this when the user wants to list, search or filter field technicians/employees (técnicos/funcionários). Returns paginated results with employee name, email, groups and contract status. Supports filtering by name, active status, group and territory. Do not use for getting details of a single employee — use get_employee_details instead.

search_employees

Use this when the user wants to find, list or search equipments (equipamentos). Returns paginated results with equipment name, serial number, model, customer and location. Supports filtering by name, serial number, customer and location. Do not use for getting details of a single equipment — use get_equipment_details instead.

search_equipments

Use this when the user wants to find, list or search service locations (locais de atendimento). Returns paginated results with location name, address, customer and contact info. Supports filtering by name, city, state, customer and territory. Do not use for getting details of a single location — use get_location_details instead.

search_locations

Use this when the user wants to list, search or filter work orders (ordens de serviço). Returns paginated results with order ID, identifier, status, customer name, scheduled date and assigned employee. Supports filtering by date range, status, customer, employee and territory. Do not use for getting details of a single order — use get_order_details instead.

search_orders

Use this when the user wants to list individual serialized part units. Returns paginated results with unit serial number, status and location. Supports filtering by part and status. Do not use for getting details of a single unit — use get_part_unit_details instead.

search_part_units

Use this when the user wants to find or list inventory parts (peças). Returns paginated results with part name, code, quantity and unit price. Supports filtering by name and code. Do not use for getting details of a single part — use get_part_details instead.

search_parts

Use this when the user wants to find or list products (produtos). Returns paginated results with product name, code and price. Supports filtering by name and type. Do not use for getting details of a single product — use get_product_details instead.

search_products

Use this when the user wants to list, search or filter quotations/estimates (orçamentos). Returns paginated results with quotation number, customer, total value, status and date. Supports filtering by status, customer and date range. Do not use for getting details of a single quotation — use get_quotation_details instead.

search_quotations