garment-bundle-id 1.0.0

Standard bundle ID generator and parser for QR-based garment factory production tracking. Format: STYLE-LOT-COLOR-SIZE-BUNDLE#-COMPONENT. Built and used in production by Scan ERP.

garment-bundle-id

Standard bundle ID generator and parser for QR-based garment factory production tracking. Built and used in production by Scan ERP.

Install

pip install garment-bundle-id

Usage

from garment_bundle_id import generate_bundle_id, parse_bundle_id, generate_qr_payload

# Generate a bundle ID
bid = generate_bundle_id(
    style="S27", lot="8082", color="BLUE",
    size="M", bundle_number=1, component="FRT"
)
print(bid)  # → 'S27-8082-BLUE-M-001-FRT'

# Parse an existing bundle ID
parsed = parse_bundle_id("S27-8082-BLUE-M-001-FRT")
print(parsed)
# {
#   'style': 'S27', 'lot': '8082', 'color': 'BLUE',
#   'size': 'M', 'bundle_number': 1, 'component': 'FRT'
# }

# Generate compact QR payload for printing
qr = generate_qr_payload(
    article="S27", lot="8082", color="BLUE",
    size="M", bundle_number=1, component="FRT",
    total_pieces=50, quantity=1
)
# → '{"a":"S27","l":"8082","b":"S27-8082-BLUE-M-001-FRT",...}'

Bundle ID Format

STYLE-LOT-COLOR-SIZE-BUNDLE#-COMPONENT
S27 - 8082 - BLUE - M - 001 - FRT

Segment	Description	Example
STYLE	Style number	S27, S31
LOT	Lot/order number	8082, 9001
COLOR	Color name (max 8 chars)	BLUE, NAVY, RED
SIZE	Size code	S, M, L, XL, 32
BUNDLE#	Bundle sequence (zero-padded to 3 digits)	001, 023, 100
COMPONENT	Component code	FRT, BK, SLV, CLR

Used By

• Scan ERP — QR-based ERP for CMT garment factories (115,370+ pieces tracked)

Related Reading

• QR Code Production Tracking in Garment Factories
• Bundle Tracking System for Garment Factory
• RFID vs QR Code for Garment Tracking

License

MIT — Built by Santosh Rijal of Scan ERP