# Contract: SmokeDrop Automated Dropshipping & Fulfillment (v1)

- **Domain**: B2B Hardware Procurement & Automated Blind Dropshipping
- **System**: grindbaby
- **Integration**: SmokeDrop US Supplier Network
- **Status**: ACTIVE SPECIFICATION

---

## 1. Objectives & Scope
The purpose of this contract is to define deterministic lifecycle rules, supplier boundaries, white-label packaging enforcement, and order dispatch mechanics for hardware brands fulfilled via the SmokeDrop partner network (specifically **Santa Cruz Shredder** and **Flower Mill**).

---

## 2. Supplier Catalog & SLA Boundaries

| Field | Specification |
| :--- | :--- |
| **Primary Brands** | Santa Cruz Shredder LLC (California), Flower Mill USA (Arizona) |
| **Wholesale Margin Target** | ≥ 35% net margin after platform fees and ground freight |
| **Packaging Invariant** | 100% Blind Shipping required (no third-party distributor branding; packing slip branded as `grindbaby`) |
| **Fulfillment SLA** | 24–48 hour dispatch; USPS Priority or UPS Ground tracked |

---

## 3. Lifecycle Sequence

1. **Catalog Sync**: Daily ingestion of SKU availability, wholesale cost, and Minimum Advertised Price (MAP).
2. **Order Placement**: Customer places order on `https://grindbaby.com`.
3. **Payload Sanitization**: Address format validated against US Postal Service standards.
4. **Automated Dispatch**: Order sent to SmokeDrop fulfillment endpoint with `brandLabel: 'grindbaby'`.
5. **Tracking Callback**: SmokeDrop webhook pushes carrier tracking number back to grindbaby client portal.

---

## 4. Governance & Honesty Invariant

In adherence to the OS Governance Doctrine, if credentials (`SMOKEDROP_API_KEY`) are not configured in production, the system must report `UNCONFIGURED_CREDENTIALS` in calm business language—never simulating fake external success.