# AYNI · API de encomendas take away para agentes de IA (Madpizza e Stella)

Ativa desde 16/11/2026. Sem chave. Lojas Madpizza: alvalade, amoreiras (Amoreiras Plaza), oeiras (Oeiras Parque), cascais (CascaiShopping). Stella (Saldanha, Rua António Enes 1D, Lisboa): stella.
Base: https://ayni.madpizza.pt/agent_api_v1.php · OpenAPI 3.1: https://madpizza.pt/api/agent/openapi.json

## Regras
- Tudo o que está disponível em take away é 2 por 1: `qty` é a quantidade paga e o cliente leva o dobro. Pagamento na loja, no levantamento.
- O total vem sempre do servidor (POST /quotes). A cotação vale 10 minutos e reserva o bloco de 15 minutos.
- Antes de POST /orders, o agente deve mostrar ao cliente loja, artigos, hora e total e ter o nome, telemóvel e email do cliente. O recibo é enviado por email.
- Limites automáticos: até 30 € pagos, 2 pizzas pagas ou 4 artigos pagos por pedido; 4 pedidos de agentes por loja e bloco; 25 min a 12 h de antecedência; 1 pedido por telemóvel em 4 h. Para pedidos maiores: telefone da loja, https://ayni.madpizza.pt/takeaway_pub.php (Madpizza) ou https://ayni.stellarestaurante.site/takeaway (Stella)
- Erros vêm como `{"ok":false,"error":{"code","message"},"alternatives":[...]}`; em `slot_full`/`slot_invalid` usar uma das `alternatives`.

## Exemplo
GET  https://ayni.madpizza.pt/agent_api_v1.php/stores
GET  https://ayni.madpizza.pt/agent_api_v1.php/stores/alvalade/menu
GET  https://ayni.madpizza.pt/agent_api_v1.php/stores/alvalade/slots
POST https://ayni.madpizza.pt/agent_api_v1.php/quotes
     {"store":"alvalade","lines":[{"code":"10821","qty":1}],"pickup_at":"2026-11-16T19:30:00Z"}
  -> {"quote_id":"q_…","total_cents":1290,"savings_cents":1290,"lines":[{"name":"Basilic","paid_qty":1,"received_qty":2,…}],"expires_at":"…"}
POST https://ayni.madpizza.pt/agent_api_v1.php/orders
     Idempotency-Key: <uuid>
     {"quote_id":"q_…","customer":{"name":"Nome Apelido","phone":"+3519XXXXXXXX","email":"cliente@exemplo.pt"},"terms_accepted":true,"notes":"opcional"}
  -> 201 {"order":{"id":"ag_…","status":"received","pipeline_number":"TA…","pickup_at":…}}
GET  https://ayni.madpizza.pt/agent_api_v1.php/orders/ag_…
