> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumberflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced Workflows

> Master quote validation, counter-offer negotiation, purchase order creation, Team Insights benchmarking, and market-timed procurement decisions

# Advanced Workflows

Once you've mastered the basics, these advanced workflows will transform your procurement operation. Learn to handle complex negotiations, leverage AI market intelligence, benchmark quotes against your team's history, and make data-driven purchase decisions.

## Quote Validation & Review Process

### Human-in-the-Loop (HITL) Workflow

When the AI extracts quote data from supplier emails, you always have control through the validation process:

<Steps>
  <Step title="AI Processing Notification">
    When a new supplier email arrives and is processed, the quote appears in your Kanban board and a validation task is created
  </Step>

  <Step title="Two-Panel Review Interface">
    **Left Panel**: Original supplier document (email body, PDF, or spreadsheet)

    **Right Panel**: AI-extracted structured data — dimensions, species, grade, quantities, unit price in \$/MBF, lead time, payment terms, validity date
  </Step>

  <Step title="Validation Checklist">
    Systematically verify the AI extraction against the original document
  </Step>

  <Step title="Edit & Approve">
    Correct any extraction errors inline and approve for pipeline entry — the card updates automatically
  </Step>
</Steps>

### Critical Validation Points

<AccordionGroup>
  <Accordion title="Product Specifications">
    **Dimension Accuracy**: Verify lumber dimensions (2x4, 2x6, 2x8, 2x10, 2x12)

    **Species Verification**: Confirm wood species — SPF, SYP, Douglas Fir, Hem-Fir — including correct abbreviations

    **Grade Classifications**: Validate grade designations (Construction, Stud, Select Structural, No.1\&Btr, Clear)

    **Length Specifications**: Check length breakdowns (8ft, 10ft, 12ft, 16ft, 20ft) and quantities per length
  </Accordion>

  <Accordion title="Pricing Information">
    **Unit Pricing**: Verify the price is captured in $/MBF — LumberFlow normalizes all prices to $/MBF for consistent comparison

    **Currency**: Confirm USD vs. CAD and note any exchange rate assumptions in the quote

    **Volume Discounts**: Check if the supplier has offered tiered pricing for higher quantities

    **Additional Costs**: Freight charges, handling fees, specialty processing — these affect landed cost
  </Accordion>

  <Accordion title="Terms & Conditions">
    **Payment Terms**: Net 30, Net 15, 2% 10 Net 30, cash terms — capture exactly as quoted

    **Delivery Terms**: FOB mill, FOB destination, freight included/excluded

    **Validity Period**: Quote expiration date — especially important for volatile species pricing

    **Special Conditions**: Minimum order quantities, stocking programs, allocation restrictions
  </Accordion>
</AccordionGroup>

<Warning>
  **Accuracy Critical**: Take time to validate AI extractions carefully. Errors in this stage compound downstream — a misread \$/MBF price flows into counter-offer calculations, purchase orders, and your team benchmarks.
</Warning>

## Using Team Insights During Quote Review

Before deciding whether to accept, counter-offer, or decline a quote, check your **Team Insights** benchmark for that SKU:

<Steps>
  <Step title="Open the Sourcing Card Drawer">
    Click the sourcing request card to open its detail drawer
  </Step>

  <Step title="View Team Insights Panel">
    The Team Insights section shows your team's historical median price for this dimension-species-grade combination (in \$/MBF)
  </Step>

  <Step title="Compare to Quote">
    Is the new quote above, at, or below your team's typical price? Use this to set your counter-offer target.
  </Step>

  <Step title="Check In-Flight Median">
    The in-flight median shows what open (not-yet-fulfilled) quotes for this SKU are currently priced at — useful context for active negotiations
  </Step>
</Steps>

<Tip>
  Team Insights benchmarks update every 30 minutes. For the most recent data, open the full **Team Insights Dashboard** from the sidebar — it shows organization-wide benchmarks across all active SKUs with grade filters and supplier breakdowns.
</Tip>

## Market Timing with Sentiment Intelligence

Before sending an RFQ or accepting a quote, check the **Market Sentiment Badge** on the sourcing card:

<AccordionGroup>
  <Accordion icon="chart-line" title="Using Sentiment to Time Procurement">
    **Bullish sentiment** (market tightening):

    * Prices may rise — consider moving faster on RFQs and accepting competitive quotes sooner
    * Counter-offer aggressively only if you have strong leverage (volume commitment, payment terms)
    * Lock in pricing with longer validity windows if possible

    **Bearish sentiment** (buyer conditions):

    * You may have more negotiating room — test with a counter-offer before accepting
    * Ask suppliers for extended validity periods so you can compare across more responses
    * Consider larger volume commitments if pricing is favorable

    **Neutral sentiment**:

    * Standard procurement timing applies
    * Use Team Insights benchmarks as your primary pricing guide
  </Accordion>

  <Accordion icon="info" title="Sentiment Drilldown">
    Click **See why** on any sentiment badge to read:

    * The news events and signals driving the assessment
    * A daily market summary for the species
    * The confidence level of the assessment

    If you disagree with the AI's read, submit feedback from the drilldown view — this helps calibrate the model over time.
  </Accordion>
</AccordionGroup>

## Counter-Offer & Negotiation Management

### Counter-Offer Generation Process

<Steps>
  <Step title="Set Negotiation Parameters">
    Define your target price (in \$/MBF), acceptable range, and any specific requirements (delivery timing, payment terms, volume commitment)
  </Step>

  <Step title="AI Draft Generation">
    The AI:

    * Reads the complete email thread history with this supplier
    * Summarizes prior communications and offers
    * Drafts a professional counter-offer that references the context naturally
    * Sends as a proper email reply (maintaining RFC thread continuity)
  </Step>

  <Step title="Review & Customize">
    Edit the AI-generated draft to match your specific requirements — adjust tone, add specifics, or reframe the ask
  </Step>

  <Step title="Send & Track">
    Send the counter-offer and track supplier response through the board — the card moves to NEGOTIATING automatically
  </Step>
</Steps>

### Advanced Negotiation Strategies

<AccordionGroup>
  <Accordion title="Volume-Based Negotiations">
    **Bundle Opportunities**: If you have multiple SKUs in TO SOURCE, consider grouping them for one supplier to negotiate a combined volume deal

    **Future Volume Commitments**: Offer projected future orders as leverage for better current pricing

    **Seasonal Planning**: Negotiate annual or seasonal pricing agreements when sentiment suggests supply will tighten
  </Accordion>

  <Accordion title="Market-Informed Positioning">
    **Use Team Insights Data**: "Our recent purchases of this grade have averaged \$X/MBF — we're looking for pricing in that range" is a stronger position than a bare counter-offer

    **Sentiment-Backed Timing**: "Given current market conditions for SPF, we'd like to get this deal done quickly — what's your best price?" is more compelling when sentiment backs it up

    **Competitive Context**: Reference market conditions from LumberFlow's daily intelligence without revealing what specific competitors quoted you
  </Accordion>

  <Accordion title="Relationship-Based Strategies">
    **Partnership Value**: Reference your payment history and order consistency — suppliers price better for reliable buyers

    **Exclusive Opportunities**: Offer exclusive sourcing commitment for a period in exchange for better pricing

    **Problem-Solving Collaboration**: For delivery timing issues, offer flexibility on your end in exchange for pricing concessions
  </Accordion>
</AccordionGroup>

## Quote Comparison Workflow

When multiple suppliers have responded to an RFQ, use the **Quote Comparison** interface to evaluate all options:

<Steps>
  <Step title="Open Quote Center">
    Navigate to **Review Quotes** in the sidebar, or click **Review Quotes** on a QUOTING card
  </Step>

  <Step title="Side-by-Side Comparison">
    All quotes for a sourcing request are displayed side-by-side, normalized to \$/MBF for true comparison — even when suppliers quote in different units
  </Step>

  <Step title="Team Benchmark Overlay">
    The comparison view shows your Team Insights benchmark as a reference line — see at a glance which quotes beat your historical median
  </Step>

  <Step title="Supplier Performance Context">
    Performance badges on each quote card show that supplier's response rate, speed, and pricing history — informing your selection beyond just the current price
  </Step>

  <Step title="Select and Act">
    Accept a quote to proceed to PO creation, or send a counter-offer to one or more suppliers to continue negotiating
  </Step>
</Steps>

## Purchase Order Management

### Individual PO Creation Process

LumberFlow uses a precision-first approach to purchase order creation. Each PO requires individual review and validation to ensure accuracy.

<Steps>
  <Step title="Navigate to Quote Review">
    Access individual quotes through the dashboard quote drawer or the **Review Quotes** page
  </Step>

  <Step title="Validate Quote Details">
    Review and confirm all pricing, terms, and specifications one final time before committing
  </Step>

  <Step title="Create Purchase Order">
    Use the dedicated **Create PO** workflow — pricing is calculated in \$/MBF using the `getMBFPerPack()` utility for dimensional lumber conversions
  </Step>

  <Step title="Human Validation Required">
    Review the generated PO for accuracy — dimensions, quantities, unit price (\$/MBF), total price, and terms — before it is finalized
  </Step>
</Steps>

<Warning>
  **No Automated PO Generation**: Purchase orders are never created automatically. Each PO requires explicit human validation to prevent errors in final procurement commitments.
</Warning>

### MBF-Based Pricing Calculations

All purchase orders in LumberFlow use **\$/MBF** (dollars per thousand board feet) as the universal pricing unit:

<AccordionGroup>
  <Accordion title="Why $/MBF Matters">
    Lumber is sold in packs (bundles), but different dimensions have different board footage per pack. A quote of $700/MBF for 2x4s and $700/MBF for 2x8s represent the same price per board foot, but wildly different prices per pack.

    LumberFlow normalizes everything to \$/MBF so you can compare quotes across dimensions, grades, and species on a true apples-to-apples basis.
  </Accordion>

  <Accordion title="How Calculations Work">
    The system uses the `getMBFPerPack()` utility:

    * Each dimension (2x4, 2x6, 2x8, etc.) and length (8ft, 10ft, 12ft, etc.) has a known MBF-per-pack value
    * Total cost = (unit price in \$/MBF) × (MBF per pack) × (quantity in packs)
    * All calculations are shown in the PO creation flow for human review before finalization
  </Accordion>
</AccordionGroup>

### Why Individual PO Creation?

<AccordionGroup>
  <Accordion title="Accuracy Over Speed">
    Each lumber transaction involves complex volume calculations, grade specifications, and pricing structures. Individual review prevents the costly errors that bulk operations might introduce.
  </Accordion>

  <Accordion title="Supplier-Specific Terms">
    Individual POs allow for supplier-specific payment terms, delivery requirements, and special conditions that bulk operations cannot accommodate accurately.
  </Accordion>

  <Accordion title="Audit Trail">
    Every PO has a full audit trail: who approved it, what quote it was based on, and what validation was performed. This is essential for procurement governance.
  </Accordion>
</AccordionGroup>

## Available Bulk Operations

<Info>
  **Email Thread Intelligence**: All bulk operations maintain individual email thread continuity with each supplier — no cross-contamination between supplier conversations.
</Info>

<AccordionGroup>
  <Accordion title="Bulk RFQ Distribution" icon="paper-plane">
    **TO SOURCE Cards**: Send AI-generated RFQs to multiple suppliers for items ready to source

    * Supplier grouping: one email per supplier covering all their relevant products
    * Template consistency: professional formatting and your company information in every email
    * Review before send: all AI drafts shown for approval before any email is sent
    * Idempotent: duplicate clicks are caught — no double-sends
  </Accordion>

  <Accordion title="Bulk Counter-Offers" icon="message-circle">
    **Quote-Based Actions**: Only available for items that have received actual quotes with pricing

    * Each counter-offer references that supplier's specific email thread and quote
    * Target prices and custom instructions can be set before the AI drafts
    * All drafts reviewed before sending
  </Accordion>

  <Accordion title="Bulk Negotiation Continuation" icon="handshake">
    **NEGOTIATING Cards**: Continue ongoing negotiations with follow-up communications

    * Context preservation: each supplier receives a follow-up that references their specific conversation
    * Relationship management: tone adapts based on negotiation history
    * Final approval: individual review required before accepting final terms and creating POs
  </Accordion>
</AccordionGroup>

<Warning>
  **No Bulk Purchase Orders**: Purchase order creation is intentionally excluded from bulk operations to ensure accuracy, proper validation, and correct MBF-based pricing calculations for every committed order.
</Warning>

## Data-Driven Decision Making

### Key Performance Indicators

<CardGroup cols={2}>
  <Card title="Dashboard KPIs" icon="chart-line">
    **Open Pipeline Value**: Total dollar value of sourcing requests in progress

    **Average Response Time**: Supplier responsiveness benchmark

    **Conversion Rate**: Percentage of RFQs that result in received quotes

    **Deal Velocity**: Average days from first quote to purchase order
  </Card>

  <Card title="Procurement Analytics" icon="users">
    **Cost vs. Benchmark**: How your fulfilled prices compare to your Team Insights median

    **Supplier Competitiveness**: Which suppliers consistently win your business at best pricing

    **Negotiation Success Rate**: Percentage of counter-offers that improve the initial quote

    **Cycle Time**: Average time from plan creation to PO, broken down by stage
  </Card>
</CardGroup>

### Strategic Procurement Planning

<Steps>
  <Step title="Market Intelligence Review">
    Start each procurement cycle by reviewing Market Sentiment for your target species — this informs your RFQ timing and counter-offer aggression level
  </Step>

  <Step title="Team Insights Baseline">
    Pull the Team Insights dashboard to see current internal benchmarks — know what "good" looks like before your first quote arrives
  </Step>

  <Step title="Supplier Strategy">
    Use performance badge data to prioritize which suppliers to engage first for time-sensitive sourcing, and which to use for competitive pressure
  </Step>

  <Step title="Post-Cycle Review">
    After a procurement cycle closes, review fulfilled prices against team benchmarks and market sentiment assessments to calibrate your next round
  </Step>
</Steps>

These advanced workflows position you to maximize the value of every procurement decision — backed by real market intelligence and your own team's pricing history.

<CardGroup cols={2}>
  <Card title="Lumber Price Forecasts" icon="chart-line" href="https://lumberflow.com/forecast">
    Daily AI-powered price forecasts by species — bookmark this to inform your procurement timing
  </Card>

  <Card title="Pricing Intelligence" icon="dollar-sign" href="https://lumberflow.com/solutions/lumber-pricing-intelligence">
    How LumberFlow normalizes quotes to \$/MBF for true apples-to-apples comparison
  </Card>
</CardGroup>