{
  "meta": {
    "name": "The 3PL Grade Standard",
    "version": "1.0.0",
    "status": "draft",
    "effective_date": "[EFFECTIVE DATE]",
    "publisher": "[LEGAL ENTITY NAME]",
    "url": "https://www.3plgrade.org/standard/v1-0",
    "license": "[LICENSE]",
    "independence_statement": "Payment can buy verification speed and profile services. It never buys points, grades, rankings, or a place on a shortlist.",
    "grade_validity_months": 12,
    "expired_display_days": 30,
    "min_operating_months": 6,
    "scope": "US facilities"
  },
  "capabilities": [
    {
      "code": "ECOM",
      "name": "Ecommerce & DTC Fulfillment",
      "regulated": false,
      "c2_requirements": "None (C2 = N/A)",
      "o6_control": "Peak-season performance: on-time ship >=97% during the most recent Nov-Dec peak, documented",
      "f2_infrastructure": "Pack stations; daily pickups by >=2 parcel carriers; same-day ship cutoff at or after 12:00 local; dimensional/weight capture",
      "f4_integrations": "Native or certified connector to >=1 storefront platform (e.g., Shopify, BigCommerce, WooCommerce, Adobe Commerce) and >=1 marketplace"
    },
    {
      "code": "B2B",
      "name": "B2B & Retail Distribution",
      "regulated": false,
      "c2_requirements": "None (C2 = N/A)",
      "o6_control": "Retailer compliance: chargebacks/deductions <=1% of shipped invoice value over trailing 12 months, documented",
      "f2_infrastructure": "Dock doors with scheduled LTL/TL appointments; pallet build/wrap; GS1-128 carton/pallet labeling",
      "f4_integrations": "EDI 940/945/856 (or API equivalent) and experience with >=1 retailer routing guide"
    },
    {
      "code": "FBA",
      "name": "Amazon FBA & Marketplace Prep",
      "regulated": false,
      "c2_requirements": "None (C2 = N/A)",
      "o6_control": "Amazon inbound defects: prep/labeling non-compliance <=1% of units over trailing 6 months, documented",
      "f2_infrastructure": "FNSKU labeling; poly-bag/bubble wrap; case-pack and carton labeling; carton forwarding",
      "f4_integrations": "Documented Amazon Seller Central / SP-API workflow; optional Walmart WFS prep"
    },
    {
      "code": "COLD",
      "name": "Cold Chain & Food-Grade",
      "regulated": true,
      "c2_requirements": "Facility holds a current GFSI-benchmarked certificate in a storage & distribution scope (e.g., SQF, BRCGS Storage & Distribution) AND FDA food facility registration (document accepted; FDA registration is not public)",
      "o6_control": "Continuous temperature monitoring with alarms; excursion log reviewed with corrective actions; no unresolved excursion in 90 days",
      "f2_infrastructure": "Temperature zones as offered (refrigerated 2-8 C and/or frozen <= -18 C); backup power; temperature mapping within 24 months; pest control program",
      "f4_integrations": "Lot and expiry tracking with FEFO allocation in the WMS; temperature data visible to clients"
    },
    {
      "code": "HAZ",
      "name": "Hazmat & Dangerous Goods",
      "regulated": true,
      "c2_requirements": "PHMSA hazmat registration current where the provider's activities require it (grader records the basis) AND documented DOT hazmat training for handling staff (49 CFR 172.704)",
      "o6_control": "DG segregation by hazard class verified; incident log shows no reportable incident in 24 months",
      "f2_infrastructure": "Segregated/compatible storage; fire protection appropriate to stored classes; spill response kits; DG-trained shipping staff",
      "f4_integrations": "WMS records UN number and hazard class; carrier DG accounts; shipping-paper generation"
    },
    {
      "code": "PHARMA",
      "name": "Pharma, Medical & Healthcare",
      "regulated": true,
      "c2_requirements": "For Rx drug 3PL services: facility appears in FDA's Wholesale Distributor & 3PL licensure reporting database AND holds required state license(s). For medical devices: FDA establishment registration where applicable",
      "o6_control": "DSCSA-compliant chain of custody / product tracing; controlled-room-temperature monitoring; deviations and CAPA closed within 30 days",
      "f2_infrastructure": "Temperature-mapped storage (e.g., 20-25 C controlled room temperature); quarantine and returns cage; secure high-value area; restricted access",
      "f4_integrations": "Lot/serial tracking; EDI/ASN with trading partners; recall management workflow"
    },
    {
      "code": "RET",
      "name": "Returns & Reverse Logistics",
      "regulated": false,
      "c2_requirements": "None (C2 = N/A)",
      "o6_control": "Returns processing: median <=3 business days from receipt to disposition, documented",
      "f2_infrastructure": "Dedicated inspection/grading area; refurbishment/repackaging; disposition channels (restock, liquidate, recycle, destroy with certificate)",
      "f4_integrations": "Returns platform or RMA integration; client-visible disposition reporting"
    },
    {
      "code": "KIT",
      "name": "Kitting & Value-Added Services",
      "regulated": false,
      "c2_requirements": "None (C2 = N/A)",
      "o6_control": "Kitting accuracy >=99.5% with documented QC sampling over trailing 6 months",
      "f2_infrastructure": "Dedicated assembly lines; shrink-wrap/bagging; labeling and printing equipment",
      "f4_integrations": "Bill-of-materials / kit management in the WMS; work-order tracking visible to clients"
    }
  ],
  "planned_capabilities": [
    "Freight & Transportation Management",
    "Bonded Warehousing & FTZ",
    "Oversized & White-Glove",
    "Cross-Border Fulfillment"
  ],
  "pillars": [
    {
      "id": "P1",
      "name": "Verified Credentials & Compliance",
      "points": 20
    },
    {
      "id": "P2",
      "name": "Operational Proof",
      "points": 25
    },
    {
      "id": "P3",
      "name": "Capability Fit",
      "points": 20
    },
    {
      "id": "P4",
      "name": "Customer Evidence",
      "points": 15
    },
    {
      "id": "P5",
      "name": "Business Stability",
      "points": 10
    },
    {
      "id": "P6",
      "name": "Transparency & Freshness",
      "points": 10
    }
  ],
  "checks": [
    {
      "id": "C1",
      "pillar": "P1",
      "max_points": 3,
      "name": "Legal entity active and matches trading name",
      "rule": "Full: entity active in state registry, name/DBA matches. Partial: active but name mismatch unexplained.",
      "iv_sources": "State Secretary of State business search",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "C2",
      "pillar": "P1",
      "max_points": 6,
      "name": "Capability-required licenses / registrations current",
      "rule": "Full: every required item for the capability is current. Partial: required items current but one is pending renewal (<60 days). N/A for capabilities with none.",
      "iv_sources": "FDA WDD/3PL database, state boards, PHMSA search, SQFI/BRCGS directories",
      "scoring": "full_partial_none",
      "applicable_to": [
        "COLD",
        "HAZ",
        "PHARMA"
      ]
    },
    {
      "id": "C3",
      "pillar": "P1",
      "max_points": 4,
      "name": "Quality / safety management certification",
      "rule": "Full: accredited certificate in scope for the facility (ISO 9001, GFSI scheme, ISO 13485, GDP audit). Partial: documented internal QMS (SOPs, CAPA log) without certification.",
      "iv_sources": "IAF CertSearch, SQFI/BRCGS directories, certification body letter",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "C4",
      "pillar": "P1",
      "max_points": 2,
      "name": "Security / trade compliance program",
      "rule": "Full: C-TPAT certified, TAPA FSR, or CBP-bonded/FTZ status. Partial: written security program (access control, CCTV retention, background checks).",
      "iv_sources": "CBP SVI screenshot shared live, TAPA register, CBP/FTZ records",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "C5",
      "pillar": "P1",
      "max_points": 3,
      "name": "Insurance: warehouse legal liability + general liability",
      "rule": "Full: current COI naming both coverages with stated limits. Partial: one coverage only or limits not stated.",
      "iv_sources": "COI confirmed with broker by email/phone",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "C6",
      "pillar": "P1",
      "max_points": 2,
      "name": "Clean regulatory record",
      "rule": "Full: no OSHA serious/willful citations (36 mo), no FDA warning letters or PHMSA penalties (24 mo) for the facility. Partial: one resolved item with documented corrective action.",
      "iv_sources": "OSHA establishment search, FDA warning letters, PHMSA enforcement data",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O1",
      "pillar": "P2",
      "max_points": 6,
      "name": "Order accuracy",
      "rule": "Full: >=99.5% trailing 6+ months. Partial: >=99.0%.",
      "iv_sources": "Live WMS report observed by grader (timestamped capture)",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O2",
      "pillar": "P2",
      "max_points": 6,
      "name": "On-time ship / SLA adherence",
      "rule": "Full: >=98% shipped within agreed cutoff. Partial: >=95%.",
      "iv_sources": "Live WMS/OMS report observed by grader",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O3",
      "pillar": "P2",
      "max_points": 4,
      "name": "Dock-to-stock time",
      "rule": "Full: median <=24 business hours receipt-to-available. Partial: <=48 hours.",
      "iv_sources": "Live WMS report observed by grader",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O4",
      "pillar": "P2",
      "max_points": 4,
      "name": "Inventory accuracy",
      "rule": "Full: cycle-count accuracy >=99.5%. Partial: >=99.0%.",
      "iv_sources": "Live WMS report or cycle-count log observed by grader",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O5",
      "pillar": "P2",
      "max_points": 3,
      "name": "Measurement maturity",
      "rule": "Full: monthly KPI reports from the WMS for >=12 months with written metric definitions. Partial: >=6 months, or no written definitions.",
      "iv_sources": "KPI pack observed live",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "O6",
      "pillar": "P2",
      "max_points": 2,
      "name": "Capability-specific operational control",
      "rule": "See capability table (e.g., temperature alarm logs, DG segregation, chargeback rate).",
      "iv_sources": "Capability-specific record observed live",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "F1",
      "pillar": "P3",
      "max_points": 4,
      "name": "Facility verified",
      "rule": "Full: address, square footage, dock doors and operating hours confirmed. Partial: address confirmed only.",
      "iv_sources": "Address in 2+ independent sources + imagery + live/virtual walkthrough",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "F2",
      "pillar": "P3",
      "max_points": 5,
      "name": "Capability infrastructure",
      "rule": "Full: all infrastructure items in the capability table present. Partial: at least half present.",
      "iv_sources": "Walkthrough, equipment list with photos dated <12 mo",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "F3",
      "pillar": "P3",
      "max_points": 4,
      "name": "WMS and client visibility",
      "rule": "Full: named WMS with client portal showing real-time inventory and orders. Partial: named WMS, reports by email only.",
      "iv_sources": "Live portal demo",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "F4",
      "pillar": "P3",
      "max_points": 4,
      "name": "Integrations for the capability's channels",
      "rule": "Full: all integration items in the capability table. Partial: at least one.",
      "iv_sources": "Live demo or integration list in vendor marketplace",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "F5",
      "pillar": "P3",
      "max_points": 3,
      "name": "Demonstrated experience in this capability",
      "rule": "Full: >=2 years AND >=10 active clients in the capability at this facility. Partial: >=1 year OR >=3 clients.",
      "iv_sources": "Reference calls, client list under NDA",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "E1",
      "pillar": "P4",
      "max_points": 6,
      "name": "Verified customer references",
      "rule": "Full: 2+ current clients reached by grader with the standard script. Partial: 1 reference.",
      "iv_sources": "Grader call/email with reference (script in Appendix)",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "E2",
      "pillar": "P4",
      "max_points": 3,
      "name": "Case studies with named clients and outcomes",
      "rule": "Full: 1+ case study naming the client with quantified results for this capability. Partial: named client, no numbers (or numbers, no name).",
      "iv_sources": "Client confirms case study",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "E3",
      "pillar": "P4",
      "max_points": 3,
      "name": "Third-party review signal",
      "rule": "Full: >=10 reviews on recognized platforms, average >=4.3, no suspicious spikes. Partial: 5-9 reviews or average 4.0-4.29.",
      "iv_sources": "Grader views platform directly (counts as independently verified)",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "E4",
      "pillar": "P4",
      "max_points": 3,
      "name": "Client retention",
      "rule": "Full: average client tenure >=3 years or annual logo retention >=85%. Partial: tenure 2-3 years or retention 70-84%.",
      "iv_sources": "Anonymized client tenure list confirmed by one reference",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "S1",
      "pillar": "P5",
      "max_points": 3,
      "name": "Years operating",
      "rule": "Tiered: >=10 years 1.0; 5-9 years 0.75; 2-4 years 0.5; <2 years 0.",
      "iv_sources": "State registry formation date / facility opening record",
      "scoring": "tiered",
      "applicable_to": "all"
    },
    {
      "id": "S2",
      "pillar": "P5",
      "max_points": 2,
      "name": "Continuity and redundancy",
      "rule": "Full: written business-continuity plan (backup power, IT recovery) or a second facility able to absorb volume. Partial: one of the elements.",
      "iv_sources": "Plan reviewed live",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "S3",
      "pillar": "P5",
      "max_points": 2,
      "name": "Ownership and leadership transparency",
      "rule": "Full: named leadership and ultimate owner/parent disclosed. Partial: leadership named only.",
      "iv_sources": "Registry, press releases, LinkedIn cross-check",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "S4",
      "pillar": "P5",
      "max_points": 3,
      "name": "Financial and legal flags",
      "rule": "Full: no bankruptcy (5 yr), no material judgments/liens, no pattern of customer suits. Partial: one resolved item, explained.",
      "iv_sources": "Bankruptcy, court and lien searches",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "T1",
      "pillar": "P6",
      "max_points": 3,
      "name": "Pricing model transparency",
      "rule": "Full: published or standard rate card covering receiving, storage, pick/pack, minimums and account fees. Partial: fee categories listed without rates.",
      "iv_sources": "Rate card on website (counts as independently verified when public)",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "T2",
      "pillar": "P6",
      "max_points": 3,
      "name": "Written SLAs with remedies",
      "rule": "Full: standard contract has SLAs with credits or remedies. Partial: SLAs without remedies.",
      "iv_sources": "Contract template reviewed",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "T3",
      "pillar": "P6",
      "max_points": 2,
      "name": "Evidence recency",
      "rule": "Full: >=80% of evidence items dated within 12 months. Partial: 50-79%.",
      "iv_sources": "Computed by grading system",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    },
    {
      "id": "T4",
      "pillar": "P6",
      "max_points": 2,
      "name": "Responsiveness and data upkeep",
      "rule": "Full: questionnaire answered within 15 business days and profile data current. Partial: answered late or partially.",
      "iv_sources": "Computed by grading system",
      "scoring": "full_partial_none",
      "applicable_to": "all"
    }
  ],
  "achievement": {
    "full": 1,
    "partial": 0.5,
    "none": 0,
    "S1_tiers": [
      {
        "min_years": 10,
        "value": 1
      },
      {
        "min_years": 5,
        "value": 0.75
      },
      {
        "min_years": 2,
        "value": 0.5
      },
      {
        "min_years": 0,
        "value": 0
      }
    ]
  },
  "evidence_levels": {
    "IV": {
      "label": "Independently verified",
      "multiplier": 1
    },
    "DP": {
      "label": "Document provided",
      "multiplier": 0.75
    },
    "PC": {
      "label": "Public claim",
      "multiplier": 0.4
    },
    "NONE": {
      "label": "No evidence",
      "multiplier": 0
    }
  },
  "registry_exceptions": [
    {
      "capability": "COLD",
      "item": "FDA food facility registration"
    },
    {
      "capability": "HAZ",
      "item": "DOT hazmat training records (49 CFR 172.704)"
    }
  ],
  "evidence_max_age_months": 24,
  "coverage": {
    "min_iv_dp_share": 0.5,
    "each_pillar_min_evidence": "PC"
  },
  "caps": [
    {
      "id": "CAP-1",
      "max_score": 81,
      "condition": "none of O1,O2,O3,O4 is IV"
    },
    {
      "id": "CAP-2",
      "max_score": 87,
      "condition": "F1 is not IV"
    },
    {
      "id": "CAP-3",
      "max_score": 94,
      "condition": "E1 is not IV with full achievement"
    },
    {
      "id": "CAP-4",
      "max_score": null,
      "result": "not_graded",
      "condition": "regulated capability and C2 not full IV"
    }
  ],
  "red_flags": [
    {
      "id": "RF-1",
      "description": "Required license or registration lapsed, suspended or revoked",
      "action": "Hold"
    },
    {
      "id": "RF-2",
      "description": "Open regulatory enforcement at the facility: FDA warning letter (24 mo, unresolved), OSHA willful or repeat citation (36 mo), PHMSA civil penalty (24 mo, unresolved)",
      "action": "Hold"
    },
    {
      "id": "RF-3",
      "description": "Bankruptcy filing, receivership or assignment for benefit of creditors (active or within 24 mo)",
      "action": "Hold"
    },
    {
      "id": "RF-4",
      "description": "Facility closed, sold, or no longer operated by the provider",
      "action": "Withdrawn"
    },
    {
      "id": "RF-5",
      "description": "Falsified, altered or misattributed evidence",
      "action": "Withdrawn + 24-month ineligibility"
    },
    {
      "id": "RF-6",
      "description": "Two or more active lawsuits by customers alleging loss or non-performance, or one alleging fraud, filed within 24 months",
      "action": "Hold"
    }
  ],
  "bands": [
    {
      "letter": "A+",
      "min": 95,
      "max": 100
    },
    {
      "letter": "A",
      "min": 88,
      "max": 94
    },
    {
      "letter": "B+",
      "min": 82,
      "max": 87
    },
    {
      "letter": "B",
      "min": 75,
      "max": 81
    },
    {
      "letter": "C+",
      "min": 68,
      "max": 74
    },
    {
      "letter": "C",
      "min": 60,
      "max": 67
    }
  ],
  "below_minimum": {
    "max": 59,
    "display": "Not graded - insufficient evidence"
  },
  "rounding": "half_up_to_integer_then_caps",
  "statuses": [
    "graded",
    "not_graded",
    "hold",
    "under_appeal",
    "expired",
    "withdrawn"
  ],
  "disputes": {
    "preview_business_days": 10,
    "dispute_window_days": 30,
    "ack_business_days": 2,
    "decision_business_days": 15,
    "appeal_window_business_days": 15,
    "appeal_decision_days": 30
  },
  "versioning": {
    "scheme": "semver",
    "annual_review": "Q4",
    "public_comment_days": 30
  }
}
