# API preparada para IA

Esta fase disponibiliza uma entrada estruturada para clientes de IA. Ela não interpreta linguagem natural, não chama OpenAI e não cria Ordens de Serviço diretamente no Bling.

## Criar uma solicitação

`POST /api/ai/service-order-requests` recebe `source`, `original_message`, `customer` e `service_order`. `source` aceita somente `chatgpt`, `whatsapp`, `panel` ou `api`; `customer.bling_id` identifica um contato já conhecido no Bling.

O conteúdo de `service_order` é validado e convertido para o payload interno da Fase 5. O retorno inclui somente uma representação segura: identificador, estado, cliente, resumo, `ready_for_confirmation`, `missing_fields`, confirmação e identificador externo quando existir. A mensagem original, o payload interno, logs e credenciais não são retornados.

## Prontidão e confirmação

`ready_for_confirmation` é calculado, não persistido. A solicitação precisa de cliente e descrição do serviço (ou descrição do problema); serviços e peças informados precisam conter seus identificadores e quantidade válida para peças. Enquanto houver pendências, `missing_fields` as descreve e `POST /api/service-order-requests/{id}/confirm` retorna 422 sem chamar o Bling.

Uma solicitação pode ser complementada com `PATCH /api/service-order-requests/{id}` somente em `draft` ou `awaiting_confirmation`. A confirmação continua usando exclusivamente o fluxo idempotente da Fase 5, com lock e confirmação explícita.

## Consulta

`GET /api/ai/service-order-requests/{id}` fornece a mesma representação segura. Clientes de IA nunca recebem tokens, segredos, payload HTTP bruto, logs completos ou acesso direto ao Bling.
