Procurement True Cost Agent

Visão Geral

O True Cost Agent calcula o custo real (total landed cost) de cada SKU, incluindo FOB, frete, impostos, custo de capital e prêmio de risco.

Endpoint

Base URL: https://csuite-dev.vallery.com.br/proc/cost
Porta interna: 8033

Endpoints Disponíveis

Health Check

GET /health

Calcular Custo Real

POST /v1/cost/snapshot/compute

Calcula snapshot de custo para um SKU.

Request Body:

{
  "org_id": 1,
  "sku": "SKU001",
  "supplier_id": 1,
  "fob_price": "10.00",
  "currency": "USD",
  "incoterm": "FOB"
}

Response:

{
  "outcome": "ALLOW",
  "snapshot_id": 1,
  "snapshot": {
    "sku": "SKU001",
    "supplier_id": 1,
    "landed_cost": "68.12",
    "risk_adjusted_cost": "69.48",
    "currency": "BRL",
    "fx_rate": "5.5",
    "cost_breakdown": {
      "fob": 55.0,
      "freight": 5.5,
      "tax": 6.6,
      "capital": 1.02,
      "risk_premium": 1.36,
      "currency": "BRL",
      "fx_rate": 5.5,
      "incoterm": "FOB",
      "lead_days_p50": 30,
      "lead_days_p90": 45
    }
  }
}

Componentes do Custo

Componente	Fórmula	Descrição
FOB	`fob_price * fx_rate`	Preço FOB em BRL
Freight	`FOB * 10%`	Estimativa de frete
Tax	`(FOB + Freight) * 12%`	Impostos
Capital	`subtotal * WACC * (lead_days/365)`	Custo de capital
Risk Premium	`subtotal * risk_factor`	Prêmio de risco do fornecedor

Integração

Consumido pelo Planning Agent para custo de planos
Alimenta comparações de fornecedores

Dependências

Tabela: csuite_procurement.procurement_cost_snapshot
Supplier Profiles: Para lead times e risco

Configuração

Variável	Descrição	Default
`MYSQL_HOST`	Host do banco	localhost
`MYSQL_DB`	Database	csuite_procurement
`WACC_RATE`	Taxa WACC anual	0.12
`DEFAULT_FX_RATE`	Taxa de câmbio default	5.5
`PORT`	Porta do serviço	8033

Arquitetura

┌─────────────────┐     ┌──────────────────┐
│ FOB Price       │────▶│  Cost Agent      │
│ FX Rate         │     │                  │
│ Supplier Profile│     │  - compute()     │
│ Tax Rules       │     │  - breakdown()   │
└─────────────────┘     └────────┬─────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │ cost_snapshot    │
                        └──────────────────┘

Procurement Cost Agent