HFT71 Plugin Documentation

Operational documentation for deploying and maintaining the HFT71 Integration WooCommerce plugin (v1.4.1).

The plugin uses a top-level HFT71 menu in wp-admin (not under WooCommerce):

Submenu	Purpose
Ustawienia	API credentials, sync intervals, status mapping, feature flags
Logi	API request/response log (`hft71_api_log` table)
Modele	Product model configuration (SKUs, sizes, prices)
Kolory	Shared color palette used by models

Documentation

Document	Description
Release checklist	Pre-production deployment checklist
Runbook	Incident handling (API outage, webhooks, stock drift)
Operations checklist	Daily and weekly maintenance tasks
API examples	Request/response examples for integration flows
JSON schemas	Payload and configuration schemas

Centralized model data is stored in custom DB tables (hft71_models, hft71_colors, hft71_model_colors, hft71_model_skus).

Model, color, and SKU data are maintained centrally in plugin tables (admin CRUD).
Admin CRUD via HFT71 > Modele and HFT71 > Kolory.
Public read helpers: hft71_get_models(), hft71_get_model(), hft71_get_model_sku_map(), and related functions (each filterable).
Normalized config shape: schemas/model-config.schema.json.
hft71_model_price_changed action fires when base price or double-sided surcharge changes.

Variant SKUs are computed automatically when saving a model ({model_code}-{color_code}-{size_code}). The model edit screen shows a read-only SKU matrix.
Table hft71_colors stores BYB/HFT code (5 digits, code column), name, and hex (#RRGGBB).
Name ↔ code mapping uses the code column, hft71_model_skus, and hft71_stock_cache.
HFT71 > Kolory: edit name, BYB code, and hex. Duplicate name, hex, or code requires confirmation.

The BYB palette is defined in includes/data/hft71-byb-colors.php (66 colors). Sync to the database via bin/sync-byb-colors.php:

Source	Role
buildyourbrand.de	Five-digit codes in article numbers (`BY011-03467-0042` → `03467`)
BYB Catalog 2025 (PDF)	Color names and hex values (colour charts in the catalog)

Sample entries (code,Name,HEX):

00007,Black,#000000
00220,White,#FFFFFF
00155,Navy,#022447
00431,Heather Grey,#868686
03467,Bark,#9A6055
00606,Burgundy,#3A0201

Full list and PHP/API examples: API examples — BYB section.

Only colors from the buildyourbrand.de catalog for that model are shown (catalog: includes/data/hft71-byb-model-colors.php, table hft71_model_byb_colors).
Selected colors (checkbox) are stored in hft71_model_colors; only colors present in HFT stock (hft71_stock_cache) can be checked.
Rows without stock are grayed out, unchecked, and disabled (read-only).
Grouped header HFT stock over size columns (XS–XXL); cells show stock from hft71_stock_cache or —.
Columns: . (checkbox) → Hex → Color → stock per size.

On HFT71 > Modele > Edit, sizes are chosen via checkboxes (XS–XXL), not a comma-separated text field.
Saved order is persisted in the sizes column (JSON).

hft71_models.care_icons was renamed to care (DB schema version 1.6).
hft71_get_model() / JSON schema field: care (array of care instruction labels).

One-way sync from HFT71 to WooCommerce for shipping.carrier, shipping.tracking, and shipping.trackingRet.
Triggered by cron poll, selected order events, and manual admin action in the order meta box.
Feature-flagged by hft71_shipping_sync_enabled.
Verify via order meta _hft71_shipping_*, log actions sync_shipping / sync_shipping_skipped, and the order meta box section.