Procurement Execution Agent
Visão Geral
O Execution Agent gerencia o ciclo de vida dos planos de compra, desde a aprovação até o fechamento. Registra evidências e rastreia outcomes.
Endpoint
- Base URL:
https://csuite-dev.vallery.com.br/proc/execute - Porta interna:
8036
Endpoints Disponíveis
Health Check
GET /health
Aprovar Plano
POST /v1/plan/{plan_id}/approve
Aprova um plano de compra.
Request Body:
{
"approved_by": "user@company.com",
"notes": "Aprovado conforme orçamento"
}
Response:
{
"outcome": "ALLOW",
"plan_id": 123,
"status": "APPROVED",
"approved_at": "2026-01-27T22:00:00Z"
}
Executar Plano
POST /v1/plan/{plan_id}/execute
Marca plano como executado (PO emitida).
Request Body:
{
"po_number": "PO-2026-001234",
"executed_by": "user@company.com"
}
Response:
{
"outcome": "ALLOW",
"plan_id": 123,
"status": "EXECUTED",
"evidence_id": 456
}
Registrar Recebimento
POST /v1/plan/{plan_id}/receive
Registra recebimento de mercadoria.
Request Body:
{
"qty_received": 480,
"arrival_date": "2026-02-20",
"invoice_number": "NF-123456"
}
Response:
{
"outcome": "ALLOW",
"outcome_id": 789,
"outcome_status": "PARTIAL",
"qty_planned": 500,
"qty_received": 480,
"variance_pct": -4.0
}
Máquina de Estados
DRAFT ──▶ APPROVED ──▶ EXECUTED ──▶ CLOSED
│ │ │
└──▶ REJECTED └──▶ CANCELLED
│
└──▶ STALE
Tipos de Evidência
| Tipo | Descrição |
|---|---|
| PO | Ordem de Compra |
| INVOICE | Nota Fiscal |
| CONTRACT | Contrato |
| Confirmação por email | |
| SCREENSHOT | Print de sistema |
| OTHER | Outros |
Integração
┌──────────────────┐ ┌──────────────────┐
│ Planning Agent │────▶│ Execution Agent │
└──────────────────┘ │ │
│ - approve() │
┌──────────────────┐ │ - execute() │
│ Cashflow Agent │────▶│ - receive() │
└──────────────────┘ │ - close() │
└────────┬─────────┘
│
▼
┌──────────────────┐
│ ERP / Sistema │
│ de Compras │
└──────────────────┘
Dependências
- Tabelas:
procurement_planprocurement_execution_evidenceproc_plan_outcomeproc_plan_status_transition
Configuração
| Variável | Descrição | Default |
|---|---|---|
MYSQL_HOST |
Host do banco | localhost |
MYSQL_DB |
Database | csuite_procurement |
CASHFLOW_AGENT_URL |
URL Cashflow Agent | http://proc-cashflow-dev:8038 |
POLICY_ENGINE_URL |
URL Policy Engine | http://csuite-executive-dev:8000 |
PORT |
Porta do serviço | 8036 |
Métricas
procurement_plans_approved_total- Planos aprovadosprocurement_plans_executed_total- Planos executadosprocurement_plans_on_time_pct- % entregas no prazoprocurement_variance_pct- Variação média qty_received vs qty_planned