printful-sol-s-03574-comet-organic-sweatshirt-dtg

name: Printful SOL'S 03574 Comet Organic Sweatshirt DTG description: >- Complete pipeline for SOL'S 03574 Comet Organic Sweatshirt (catalog 506) DTG products on Printful. Covers product creation, variant management, branding placement (front, back, sleeve_left, sleeve_right, label_outside), mockup generation, and Supabase integration. Use when creating DTG organic sweatshirt products, generating mockups, updating branding, or managing organic crewneck sweatshirts. 8 colors, XS-XXL (6 sizes), EU Latvia fulfillment.

Printful SOL'S 03574 Comet Organic Sweatshirt — DTG Pipeline

Full production pipeline for SKAPARA organic crewneck sweatshirts using the SOL'S 03574 Comet blank on Printful. Premium organic cotton sweatshirt with 5 DTG placement options including sleeves and neck label.

Product Specifications

When to Use

• Create a new SKAPARA organic sweatshirt product on Printful
• Upload designs and apply full SKAPARA branding (front + back + sleeves + label)
• Generate mockups for 03574 Comet sweatshirt products
• Update Supabase with sweatshirt product data and mockup images
• Manage 03574 variant colors/sizes

Placements & Canvas Sizes

All DTG canvases at 150 DPI:

BRANDING:

• front: Main design (1800x2400 @150dpi)
• back: SKAPARA wordmark white, centered, ~37% of canvas width, y=150px
• sleeve_left: S mark isotipo white, ~32% of canvas width (144px in 450px), centered vertically
• sleeve_right: Unused by default (available for premium products)
• label_outside: SKAPARA micro logo (255x255)

NOTE: sleeve_left and sleeve_right are long sleeve placements (450x1800) — vertical orientation.

Base Costs (Production)

Placement cost stacking (standard 3-placement: front + back + sleeve_left):

• 3 placements: +17.85 EUR (3 x 5.95)
• Total: 40.25 (XS-L), 42.55 (XL), 44.80 (XXL)

With label_outside (+2.50):

• Total: 42.75 (XS-L), 45.05 (XL), 47.30 (XXL)

Printful API Reference

Auth headers (ALL requests):

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

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: import { createPrintfulClient } from './lib/printful-rate-limiter.mjs'

Key endpoints:

Workflow: Create New Organic Sweatshirt Product

Step 1: Design Assets

Prepare PNGs at 150dpi:

• Front design: 1800x2400 (PF#1)
• Back wordmark: 1800x2400 (PF#1) — reuse existing SKAPARA wordmark file
• Sleeve S mark: 450x1800 (PF#147) — reuse existing S mark file
• Label (optional): 255x255 (PF#249)

Step 2: Upload Designs to File Library

# Upload to Supabase Storage first
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}"

# Upload to Printful File Library
curl -X POST "https://api.printful.com/files" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: 17795695" \
  -H "Content-Type: application/json" \
  -H "User-Agent: POD-AI-Store/1.0" \
  -d '{ "url": "'${PUBLIC_URL}'", "filename": "'${FILENAME}'" }'

Step 3: Create Sync Product

curl -X POST "https://api.printful.com/store/products" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: 17795695" \
  -H "Content-Type: application/json" \
  -H "User-Agent: POD-AI-Store/1.0" \
  -d '{
    "sync_product": {
      "name": "Product Name — Organic Sweatshirt",
      "thumbnail": "https://..."
    },
    "sync_variants": [
      {
        "variant_id": CATALOG_VARIANT_ID,
        "retail_price": "54.99",
        "files": [
          { "type": "default", "id": FRONT_FILE_ID },
          { "type": "back", "id": BACK_FILE_ID },
          { "type": "sleeve_left", "id": SLEEVE_FILE_ID }
        ]
      }
    ]
  }'

See VARIANTS.md for all variant IDs.

Step 4: Set Variant Prices

CRITICAL: Set prices in Printful FIRST. Margins are below 35% with 3 placements — the cron sync margin fixer will flag these. Options:

1. Raise retail prices to 59.99/62.99/64.99
2. Use 2 placements only (front + sleeve = 11.90 EUR extra)
3. Adjust margin threshold for sweatshirts

Step 5: Generate Mockups

curl -X POST "https://api.printful.com/mockup-generator/create-task/506" \
  -H "Authorization: Bearer ${PRINTFUL_API_TOKEN}" \
  -H "X-PF-Store-Id: 17795695" \
  -H "Content-Type: application/json" \
  -H "User-Agent: POD-AI-Store/1.0" \
  -d '{
    "variant_ids": [VARIANT_ID],
    "format": "png",
    "width": 1000,
    "option_groups": ["Ghost"],
    "options": ["Front", "Back", "Left"],
    "files": [
      { "placement": "front", "image_url": "FRONT_URL", "position": { "area_width": 1800, "area_height": 2400, "width": 1800, "height": 2400, "top": 0, "left": 0 } },
      { "placement": "back", "image_url": "BACK_URL", "position": { "area_width": 1800, "area_height": 2400, "width": 1800, "height": 2400, "top": 0, "left": 0 } },
      { "placement": "sleeve_left", "image_url": "SLEEVE_URL", "position": { "area_width": 450, "area_height": 1800, "width": 450, "height": 1800, "top": 0, "left": 0 } }
    ]
  }'

Step 6: Download Mockups & Upload to Supabase Storage

Mockup S3 URLs expire in ~24h. Download and re-upload to permanent storage with cache-buster.

Step 7: Update Supabase products Table

await supabase.from('products').upsert({
  id: productId,
  title: 'Product Name',
  description: 'Creative description. Organic cotton, everyday comfort.',
  translations: {
    es: { title: 'Nombre', description: 'Descripcion organica...' },
    de: { title: 'Name', description: 'Bio-Baumwolle Beschreibung...' }
  },
  category_id: 'SWEATSHIRT_CATEGORY_UUID',
  pod_provider: 'printful',
  product_template_id: '506',
  provider_product_id: String(pfProductId),
  base_price_cents: 5499,
  compare_at_price_cents: 6499,
  images: [...],
  product_details: {
    safety_information: GPSR_HTML,
    material: 'Organic cotton',
    care_instructions: 'Machine wash cold, inside out. Tumble dry low. Do not bleach.',
    print_technique: 'DTG (Direct-to-Garment)',
    manufacturing_country: 'Latvia',
    brand: 'SKAPARA',
    blank: "SOL'S 03574 Comet Organic Sweatshirt",
    fit: 'Regular'
  },
  status: 'active'
})

Step 8: GPSR Compliance (MANDATORY for EU)

<p><strong>Manufacturer:</strong> Printful Inc., Latvia</p>
<p><strong>Material:</strong> Organic cotton (SOL'S 03574 Comet)</p>
<p><strong>Print technique:</strong> DTG (Direct-to-Garment) — water-based inks</p>
<p><strong>Care:</strong> Machine wash cold, inside out. Tumble dry low. Do not bleach. Do not iron directly on print.</p>
<p><strong>Compliance:</strong> REACH, OEKO-TEX Standard 100, GOTS organic</p>

Known Issues & Gotchas

Post-Creation Checklist

• Product appears in shop with correct category (sweatshirts)
• All 8 colors show in ProductCard color toggles
• Sizes correctly parsed (XS, S, M, L, XL, XXL)
• Price is correct per size tier
• Mockup images load for all placements (front, back, sleeve)
• GPSR safety information stored in product_details
• Description is clean (no HTML, max 2000 chars)
• Alt text follows pattern: "Title - Color", "Title - Color - Back", "Title - Color - Sleeve"
• Images ordered: all fronts first, then backs, then sleeves
• Cache-buster ?v=timestamp appended to all image URLs