printful-beechfield-b682-dtfilm-production

name

Printful Beechfield B682 DTFilm Production

description

Complete pipeline for Beechfield B682 Corduroy Hat (catalog 532) with DTFlex/DTFilm technique on Printful. Covers product creation, variant management, DTFilm design placement, mockup generation, and Supabase integration. Use when creating DTFlex corduroy hat products, DTFilm hats, direct to film hats, full color hats, gradient hats, photo hats, corduroy caps, or managing corduroy hat products with dtf printing.

Printful Beechfield B682 DTFilm Production Pipeline

Full production pipeline for SKAPARA corduroy hats using the Beechfield B682 blank with DTFlex (DTFilm) technique on Printful. The B682 is a soft unstructured cotton corduroy hat with a curved brim and cotton twill sweatband, offering a relaxed premium aesthetic.

For embroidered hats (thread-based designs), see the design-embroidery skill instead. For DTG t-shirts and apparel, see the printful-cc1717 or printful-tshirt skills. For distressed dad hats with DTFilm, see the printful-otto1018-dtfilm skill.

---

Product Specifications

Property	Value
Blank	Beechfield B682
Catalog ID	532
Material	100% cotton corduroy, cotton twill sweatband
Construction	Soft unstructured crown, curved brim
Sizes	One size
Colors	4 (Black, Camel, Dark Olive, Oxford Navy)
Print Method	DTFlex / DTFilm (API key: dtfilm)
Producer	Printful (Latvia)
EU Fulfillment	YES — Latvia/UK

---

When to Use

• Create a new DTFlex/DTFilm corduroy hat product on Printful
• Upload full-color, gradient, or photographic designs to corduroy hats
• Generate mockups for Beechfield B682 DTFilm products
• Update Supabase with corduroy hat product data and mockup images
• Manage B682 variant colors (enable/disable based on design compatibility)

---

DTFlex Technical Process

DTFlex is Printful's premium Direct-to-Film (DTF) technique, perfected over a decade of testing and offered exclusively through Printful.

Process Steps

1. Design printed to PET film — CMYK inks + white underbase layer
2. Adhesive powder applied — thermoplastic powder coating
3. Heat-cured — powder fused to ink layer
4. Heat-pressed onto fabric at 165C — transferred to the hat
5. Cold peel — produces clean edges without glue halo

DTFlex vs Embroidery Comparison

Factor	DTFlex (this skill)	Embroidery
Colors	Unlimited CMYK	15 threads (6 max/design)
Gradients	YES — full gradient support	Only with unlimited_color (+3.25EUR)
Photographic content	YES	NO
Fine detail	Thin lines, small text OK	1.5mm min line, 5mm min text
Texture/feel	Smooth vinyl-like finish	Raised textured 3D feel
Durability	50+ washes	Excellent (best)
Print area	5.00" x 2.00" (PF#816)	4.00" x 1.75" (PF#78 — smaller on B682)
Cost per placement	+2.60 EUR	+2.95 EUR
Placements available	FRONT ONLY	Front + Back + Left + Right
Premium feel	Modern/clean/graphic	Classic/luxury/artisan
Best for	Logos with gradients, photo prints, complex multi-color designs	Simple iconic marks, monochrome text, classic branding

Key Advantage

DTFlex allows unlimited colors, gradients, and photographic content on hats at a lower cost (+2.60 EUR vs +2.95 EUR) and significantly larger print area (5.00"x2.00" vs 4.00"x1.75" — 43% larger for B682 specifically).

Key Limitation

DTFlex on hats supports FRONT PLACEMENT ONLY. No back, left, or right side printing. All branding must be integrated into the front design itself.

---

Placement & Canvas Size

Single placement only — all at 300 DPI:

Placement	API File Type	Printfile	Canvas (px)	Physical	Extra Cost
front_dtf_hat	front_dtf_hat	PF#816	1500 x 600 @300dpi	5.00" x 2.00"	+2.60 EUR

CRITICAL: This is the ONLY available placement for DTFilm hats. No back, left, right, or label placements exist in DTFilm mode.

BRANDING RULE: Since only front placement exists, the SKAPARA brand mark or text MUST be integrated INTO the front design itself. Options:

• Small S mark in corner of design (recommended)
• "SKAPARA" text as part of the design composition
• S mark watermark integrated into the artwork
• Brand signature line at bottom of design area

---

Base Costs (Production)

Color	Base Cost (EUR)	DTFilm Placement	Total Production Cost
Black	13.45	+2.60	16.05
Camel	13.45	+2.60	16.05
Dark Olive	13.45	+2.60	16.05
Oxford Navy	13.45	+2.60	16.05

All colors same base price — flat 13.45 EUR across all variants.

---

Pricing (>=35% Margin Rule)

CRITICAL: The cron sync margin fixer overwrites prices if margin falls below 35%. Set correct prices in Printful FIRST.

Color	Production Cost	Min Retail (35%)	Recommended Retail	Margin
Black	16.05 EUR	24.69 EUR	27.99 EUR	42.7%
Camel	16.05 EUR	24.69 EUR	27.99 EUR	42.7%
Dark Olive	16.05 EUR	24.69 EUR	27.99 EUR	42.7%
Oxford Navy	16.05 EUR	24.69 EUR	27.99 EUR	42.7%

Formula: retail_price >= production_cost / 0.65

Recommended strategy: Set all variants to 27.99 EUR for consistent 42.7% margins. The corduroy material justifies a premium price point above the distressed cotton Otto Cap.

---

8-Step Production Pipeline

Step 1: Design the DTFilm Artwork

Create a 1500x600px @300dpi PNG design for the front placement.

Design capabilities (DTFilm allows ALL of these):

• Full CMYK unlimited colors
• Smooth gradients and color transitions
• Photographic/raster content
• Fine lines and small text
• Transparency (will show hat fabric/corduroy texture through transparent areas)

BRANDING INTEGRATION (MANDATORY): Since DTFilm only supports front placement, integrate SKAPARA branding INTO the front design:

• Option A: Small S mark (isotipo) in bottom-right corner (~100x100px area)
• Option B: "SKAPARA" text as subtle part of design composition
• Option C: S mark watermark blended into artwork

Canvas specs:

Width:  1500px (5.00")
Height:  600px (2.00")
DPI:     300
Format:  PNG (transparent background OK)
Color:   sRGB

Corduroy texture note: The corduroy fabric has a distinctive ribbed texture. DTFlex print sits ON TOP of the corduroy, creating a slightly textured surface under the print. Designs with larger solid areas show this texture more than fine-detail designs.

Step 2: Upload Design to Supabase Storage

# Upload to Supabase Storage (permanent hosting)
curl -X POST "${SUPABASE_URL}/storage/v1/object/designs/uploads/${FILENAME}" \
  -H "Authorization: Bearer ${SUPABASE_SERVICE_KEY}" \
  -H "apikey: ${SUPABASE_SERVICE_KEY}" \
  -H "Content-Type: image/png" \
  -H "x-upsert: true" \
  --data-binary "@${LOCAL_FILE_PATH}"

# Get public URL
PUBLIC_URL="${SUPABASE_URL}/storage/v1/object/public/designs/uploads/${FILENAME}"

Step 3: Upload Design to Printful File Library

curl -X POST "https://api.printful.com/files" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: ${PRINTFUL_STORE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "'${PUBLIC_URL}'",
    "filename": "'${FILENAME}'"
  }'

Response: { "result": { "id": 123456789, "type": "default", "preview_url": "..." } }

Save the id as FRONT_FILE_ID.

Step 4: Create Sync Product on Printful

curl -X POST "https://api.printful.com/store/products" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: ${PRINTFUL_STORE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "sync_product": {
      "name": "Product Name — Beechfield B682 DTFlex",
      "thumbnail": "https://files.cdn.printful.com/files/.../preview.png"
    },
    "sync_variants": [
      {
        "variant_id": VARIANT_ID_BLACK,
        "retail_price": "27.99",
        "files": [
          { "type": "front_dtf_hat", "id": FRONT_FILE_ID }
        ],
        "options": [
          { "id": "technique", "value": "dtfilm" }
        ]
      },
      {
        "variant_id": VARIANT_ID_CAMEL,
        "retail_price": "27.99",
        "files": [
          { "type": "front_dtf_hat", "id": FRONT_FILE_ID }
        ],
        "options": [
          { "id": "technique", "value": "dtfilm" }
        ]
      },
      {
        "variant_id": VARIANT_ID_DARK_OLIVE,
        "retail_price": "27.99",
        "files": [
          { "type": "front_dtf_hat", "id": FRONT_FILE_ID }
        ],
        "options": [
          { "id": "technique", "value": "dtfilm" }
        ]
      },
      {
        "variant_id": VARIANT_ID_OXFORD_NAVY,
        "retail_price": "27.99",
        "files": [
          { "type": "front_dtf_hat", "id": FRONT_FILE_ID }
        ],
        "options": [
          { "id": "technique", "value": "dtfilm" }
        ]
      }
    ]
  }'

Key points:

• variant_id is the catalog variant ID from VARIANTS.md
• retail_price is the customer-facing price as a string
• files[].type MUST be "front_dtf_hat" (NOT "default" or "embroidery_front")
• options MUST include { "id": "technique", "value": "dtfilm" } to select DTFilm technique
• Only ONE file entry per variant (front only — no back/side placements available)

NOTE: Variant IDs for B682 need to be looked up from the Printful catalog API. See VARIANTS.md for the complete mapping.

Step 5: Set Variant Prices

Verify prices are set correctly. Update individual variants if needed:

curl -X PUT "https://api.printful.com/store/variants/${SYNC_VARIANT_ID}" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: ${PRINTFUL_STORE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "retail_price": "27.99"
  }'

CRITICAL: Set prices in Printful FIRST. The cron sync margin fixer overwrites if margin <35%.

Step 6: Generate Mockups

curl -X POST "https://api.printful.com/mockup-generator/create-task/532" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: ${PRINTFUL_STORE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "variant_ids": [VARIANT_ID_BLACK],
    "format": "png",
    "width": 1000,
    "option_groups": ["Front"],
    "files": [
      {
        "placement": "front_dtf_hat",
        "image_url": "DESIGN_PREVIEW_URL",
        "position": {
          "area_width": 1500,
          "area_height": 600,
          "width": 1500,
          "height": 600,
          "top": 0,
          "left": 0
        }
      }
    ]
  }'

Poll task status:

curl -s "https://api.printful.com/mockup-generator/task?task_key=gt-XXXXX" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: ${PRINTFUL_STORE_ID}"

Rate limits for mockups: ~10 req/min. Use delay(10000) between tasks.

Generate mockups for each color variant (Black, Camel, Dark Olive, Oxford Navy).

Download and re-upload: Mockup S3 URLs expire ~24h. Always download and re-upload to Supabase Storage:

const storagePath = `designs/mockups/${productSlug}/${colorSlug}-front.png`
const ts = Math.floor(Date.now() / 1000)
const publicUrl = `${SUPABASE_URL}/storage/v1/object/public/designs/${storagePath}?v=${ts}`

Step 7: Update Supabase — Product + Variants

const ts = Math.floor(Date.now() / 1000)

const images = [
  { src: `https://.../mockups/slug/black-front.png?v=${ts}`, alt: 'Title - Black' },
  { src: `https://.../mockups/slug/camel-front.png?v=${ts}`, alt: 'Title - Camel' },
  { src: `https://.../mockups/slug/dark-olive-front.png?v=${ts}`, alt: 'Title - Dark Olive' },
  { src: `https://.../mockups/slug/oxford-navy-front.png?v=${ts}`, alt: 'Title - Oxford Navy' },
]

// 1. Create or update product in Supabase
await supabase.from('products').upsert({
  id: productId,
  title: 'Product Name',
  description: 'Creative marketing description only. No specs here.',
  translations: {
    es: { title: 'Titulo en espanol', description: 'Descripcion en espanol' },
    de: { title: 'Titel auf Deutsch', description: 'Beschreibung auf Deutsch' }
  },
  category_id: 'CATEGORY_UUID', // FK to categories table — caps or dad-hats
  pod_provider: 'printful',
  product_template_id: '532', // Beechfield B682 catalog ID
  provider_product_id: String(pfProductId), // Printful sync product ID
  base_price_cents: 2799,
  compare_at_price_cents: 4999, // Strikethrough price — must be > base_price_cents
  images,
  product_details: {
    safety_information: GPSR_HTML, // See Step 8
    material: '100% Cotton Corduroy, Cotton Twill Sweatband',
    care_instructions: 'Spot clean recommended. Hand wash cold. Air dry. Do not bleach. Do not iron directly on print.',
    print_technique: 'DTFlex (Direct-to-Film)',
    manufacturing_country: 'Latvia',
    brand: 'SKAPARA',
    blank: 'Beechfield B682',
    construction: 'Soft unstructured crown, curved brim, cotton twill sweatband',
    fit: 'One size adjustable'
  },
  status: 'active'
})

// 2. Create product variants (all 4 colors, one size each)
const colors = [
  { color: 'Black', hex: '#000000', variantId: 'VARIANT_ID_BLACK' },
  { color: 'Camel', hex: '#C19A6B', variantId: 'VARIANT_ID_CAMEL' },
  { color: 'Dark Olive', hex: '#556B2F', variantId: 'VARIANT_ID_DARK_OLIVE' },
  { color: 'Oxford Navy', hex: '#1B2A4A', variantId: 'VARIANT_ID_OXFORD_NAVY' },
]

for (const { color, hex, variantId } of colors) {
  await supabase.from('product_variants').upsert({
    product_id: productId,
    color,
    color_hex: hex,
    size: 'One size',
    is_enabled: true,
    external_variant_id: String(variantId),
    image_url: `https://.../mockups/slug/${colorSlug}-front.png?v=${ts}`
  })
}

Step 8: GPSR Compliance (MANDATORY for EU)

Every product MUST have GPSR data before going live. EU Regulation 2023/988.

<p><strong>Manufacturer:</strong> Printful Inc., Latvia</p>
<p><strong>Material:</strong> 100% Cotton Corduroy, Cotton Twill Sweatband (Beechfield B682)</p>
<p><strong>Construction:</strong> Soft unstructured crown, curved brim</p>
<p><strong>Print technique:</strong> DTFlex (Direct-to-Film) — CMYK + white underbase, heat-pressed at 165C, cold peel</p>
<p><strong>Care:</strong> Spot clean recommended. Hand wash cold. Air dry. Do not bleach. Do not iron directly on print.</p>
<p><strong>Compliance:</strong> REACH, OEKO-TEX Standard 100</p>

Store in products.product_details.safety_information (JSONB).

---

Printful API Reference

Auth headers (ALL requests):

Authorization: Bearer ${PRINTFUL_API_TOKEN}
X-PF-Store-Id: ${PRINTFUL_STORE_ID}
Content-Type: application/json
User-Agent: POD-AI-Store/1.0

Store ID: 17795695 (Skapara)

Rate limits:

• General API: ~120 req/min. Use delay(2000) between calls
• Mockup Generator: ~10 req/min. Use delay(10000) between tasks
• On 429: read x-ratelimit-reset header, wait that many seconds, retry

Shared utility: For scripts, use import { createPrintfulClient } from './lib/printful-rate-limiter.mjs'

Key endpoints:

Endpoint	Method	Use
/files	POST	Upload image to File Library
/store/products	POST	Create new sync product
/store/products/{id}	GET/PUT	Read/update sync product + all variants
/store/variants/{vid}	PUT	Update single variant
/mockup-generator/create-task/532	POST	Create B682 mockup task
/mockup-generator/task?task_key=gt-xxx	GET	Poll mockup task status
/mockup-generator/printfiles/532	GET	List B682 print positions

---

Description Rules

What goes in description (creative text only):

• Product context, design inspiration, target audience
• 2-3 sentences max, casual but smart tone
• Highlight the DTFlex technique: "full-color DTFlex print", "vibrant gradient detail", "photo-quality transfer"
• Mention the corduroy premium aesthetic: "soft cotton corduroy", "unstructured relaxed fit", "premium textured fabric"
• Must be translated to EN, ES, DE

What does NOT go in description:

• Material composition -> product_details.material
• Care instructions -> product_details.care_instructions
• Manufacturing info -> product_details.manufacturing_country
• Safety/compliance -> product_details.safety_information

---

Known Issues & Gotchas

Issue	Detail	Workaround
FRONT ONLY	DTFilm on hats has no back/side placements	Integrate branding into front design
Technique option required	Must pass { "id": "technique", "value": "dtfilm" } in variant options	Always include in create/update calls
File type confusion	API type is front_dtf_hat, NOT default or embroidery_front	Use exact string front_dtf_hat
Variant IDs not in data	B682 variant IDs not listed in original specs	Query /v2/catalog-products/532/catalog-variants to get IDs
Corduroy texture	DTFlex print shows corduroy ribbing through print	Expected behavior — adds tactile interest
Temporary mockup URLs	S3 URLs expire ~24h	Download + re-upload to Supabase Storage
Python urllib blocked	Cloudflare rejects Python urllib	Use curl or Node.js fetch
Margin fixer	Cron sync overwrites prices if margin <35%	Set correct price in Printful FIRST
Cloudflare 403	Missing User-Agent causes blocks	Always include User-Agent: POD-AI-Store/1.0
Cache-busting	Browser/CDN caches images by URL	ALWAYS append ?v=timestamp to image URLs
B682 vs Otto Cap	B682 has higher base (13.45) but flat pricing vs Otto Cap variable (11.95-14.45)	Price B682 at 27.99 EUR uniformly

---

Post-Creation Checklist

After creating a DTFilm corduroy hat product, verify:

• Product appears in shop with correct category (caps or dad-hats)
• All 4 color variants show in ProductCard color toggles
• Size shows as "One size"
• Price is correct (27.99 EUR for all variants)
• Price not overridden by margin fixer (>=35% margin)
• Mockup images load for front view (only placement available)
• GPSR safety information stored in product_details
• Description is clean (no HTML tags, max 2000 chars)
• SKAPARA branding integrated into front design (no separate back/side branding possible)
• Alt text follows pattern: "Title - Color"
• Cache-buster ?v=timestamp appended to all image URLs
• Translations present (EN, ES, DE)