PDF Printing (Demo202509)

Summary

PDF printing uses Documint to generate high-quality printable layouts for industrial use. The PDF Render API endpoint is documented at https://stage.alpha002.io.arda.cards/v1/pdf-render/docs/openapi/index.html.

Three layout types are supported:

1. Kanban Card — for kanban signalling
2. Label — for location and bin labels
3. Breadcrumb — for smaller spaces (shelf edges, etc.)

QR Lookup URL

The QR code printed on PDF outputs uses the Kanban Card lookup URL format:

https://{app-hostname}/kanban/cards/{eId}?view=card&src=qr

Known App Hostnames

Purpose	Hostname
Production	live.app.arda.cards
Staging	stage.app.arda.cards
Development	dev.app.arda.cards

General Payload Structure

All layouts use a row/column structure:

{
  "row": [
    { "column": [ { /* payload_1_1 */ }, { /* payload_1_2 */ } ] },
    { "column": [ { /* payload_2_1 */ } ] }
  ]
}

Maximum of 2 column elements per row for Letter-format printing.

Common Payload Fields

Field	Source
characters	Computed from item_name.length (1=0–18 chars, 2=19–30, 3=31+)
item_name	item.name
notes	notes
print_sku	item.internalSku
qr_code	https://hostname/card/{lookupUrlId}
thin_line	Static URL (indexed by item.color)
word_minimum	Image URL indexed by item.color
text_size	Computed from max length of order units, min units, location, supplier (1=0–22 chars, 2=23+)
min_qnty	item.minQty
word_location	Image URL indexed by item.color
location	item.locator.location
word_order	Image URL indexed by item.color
order_qnty	item.defaultSupplier.orderQuantity.amount
order_mechanism	item.defaultSupplier.orderMethod
word_supplier	Image URL indexed by item.color
supplier	item.defaultSupply
product_image	Base64-encoded product image from item.imageUrl
color_bar	Static URL indexed by item.color
logo	Tenant logo URL (hardcoded for demo)
thin_light_rectangle	Image URL indexed by item.color
light_rectangle	Image URL indexed by item.color

Layout-Specific Schemas

Kanban Card Layout

Documint Template

Additional fields: today (print date), all common fields listed above.

Label Layout

Documint Template

Fields: item_name, characters, notes, thin_line, print_sku, qr_code, product_image, color_bar, logo

Breadcrumb Layout

Documint Template

Fields: item_name, characters, notes, thin_light_rectangle, print_sku, qr_code, logo, product_image, light_rectangle

Design Proposal

The recommended implementation uses a dedicated PDF-Render module (initially in the operations component) with:

1. Image and media file selection via index lookup tables (colors.json, color-options.json)
2. Template storage and Documint API integration
3. Additional Item attributes (minQuantity, color derivation)
4. Tenant-configurable logo (future)