Procurement Negotiation Prep Agent

Visão Geral

O Negotiation Prep Agent prepara dossiês de negociação com fornecedores, incluindo histórico de preços, alternativas (BATNA), argumentos e linha de walk-away.

Endpoint

Base URL: https://csuite-dev.vallery.com.br/proc/negotiate
Porta interna: 8034

Endpoints Disponíveis

Health Check

GET /health

Preparar Dossiê

POST /v1/negotiation/prepare

Gera dossiê de negociação para um fornecedor.

Request Body:

{
  "org_id": 1,
  "supplier_id": 1,
  "sku": "SKU001",
  "target_qty": 500
}

Response:

{
  "outcome": "ALLOW",
  "dossier": {
    "supplier_id": 1,
    "supplier_name": "Fornecedor ABC",
    "sku": "SKU001",
    "current_cost": 68.50,
    "target_cost": 62.00,
    "savings_potential_pct": 9.5,
    "batna": {
      "alternative_supplier": "Fornecedor XYZ",
      "alternative_cost": 65.00,
      "switching_cost": 2.5
    },
    "arguments": [
      "Volume anual de R$ 500k gera poder de barganha",
      "Histórico de pagamentos sempre em dia",
      "Concorrente oferece preço 5% menor"
    ],
    "concessions": [
      "Prazo de pagamento flexível",
      "Contrato de 12 meses",
      "Compromisso de volume mínimo"
    ],
    "walk_away_line": 66.00,
    "urgency": "MEDIUM"
  }
}

Componentes do Dossiê

Componente	Descrição
BATNA	Best Alternative to Negotiated Agreement
Target Cost	Preço alvo da negociação
Walk-away Line	Preço máximo aceitável
Arguments	Pontos de argumentação
Concessions	Concessões possíveis
Urgency	Urgência da compra

Integração

Consumido por compradores humanos
Alimenta decisões de aprovação de planos

Dependências

Tabelas:
procurement_cost_snapshot
procurement_supplier_profile
proc_negotiation_dossier

Configuração

Variável	Descrição	Default
`MYSQL_HOST`	Host do banco	localhost
`MYSQL_DB`	Database	csuite_procurement
`PORT`	Porta do serviço	8034

Arquitetura

┌──────────────────┐     ┌──────────────────┐
│ Histórico Preços │────▶│  Negotiation     │
│ Fornecedores Alt │     │  Agent           │
│ Trust Scores     │     │                  │
│ Cost Snapshots   │     │  - prepare()     │
└──────────────────┘     │  - batna()       │
                         │  - arguments()   │
                         └────────┬─────────┘
                                  │
                                  ▼
                         ┌──────────────────┐
                         │ Comprador Humano │
                         └──────────────────┘

Níveis de Urgência

Urgência	Coverage Days	Impacto na Negociação
CRITICAL	< 7	Aceitar preço maior
HIGH	7-14	Negociar rápido
MEDIUM	14-30	Negociação normal
LOW	> 30	Negociar agressivo

Procurement Negotiation Agent