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

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

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:

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)

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.

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:

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

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)