diff --git a/docs/assets/commerce/fullbleed-commerce-walkthrough.mp4 b/docs/assets/commerce/fullbleed-commerce-walkthrough.mp4 new file mode 100644 index 0000000..eee7dfa Binary files /dev/null and b/docs/assets/commerce/fullbleed-commerce-walkthrough.mp4 differ diff --git a/docs/assets/commerce/shopify-automations.png b/docs/assets/commerce/shopify-automations.png new file mode 100644 index 0000000..c59cfe1 Binary files /dev/null and b/docs/assets/commerce/shopify-automations.png differ diff --git a/docs/assets/commerce/shopify-contrast-packing-slip.pdf b/docs/assets/commerce/shopify-contrast-packing-slip.pdf new file mode 100644 index 0000000..4b0e33a Binary files /dev/null and b/docs/assets/commerce/shopify-contrast-packing-slip.pdf differ diff --git a/docs/assets/commerce/shopify-custom-order-summary.pdf b/docs/assets/commerce/shopify-custom-order-summary.pdf new file mode 100644 index 0000000..9695404 Binary files /dev/null and b/docs/assets/commerce/shopify-custom-order-summary.pdf differ diff --git a/docs/commerce/shopify.md b/docs/commerce/shopify.md new file mode 100644 index 0000000..cec2ee5 --- /dev/null +++ b/docs/commerce/shopify.md @@ -0,0 +1,85 @@ +--- +title: Shopify PDF automation preview +description: See Fullbleed Commerce turn saved visual or HTML/CSS templates into order documents through Shopify Flow, with a recorded synthetic-store walkthrough. +--- + +# Shopify PDF automation preview + +Design an order document once, then prepare it from your order workflow. +Fullbleed Commerce combines a visual and HTML/CSS template editor with native +Shopify Flow actions for order summaries and packing slips. + +!!! note "Development preview" + This app is being tested on synthetic orders. It is not available for + production stores or approved for the Shopify App Store. Hosting stops + between attended tests. The walkthrough demonstrates the working preview; + it does not demonstrate a paid merchant purchase. + +## Watch the workflow + +The four-minute recording shows installation, a saved custom template, brand +settings, a manual test of an existing Flow workflow, document activity, and +pausing automation. It uses an existing development-store test plan. English +instructions are included in the video; idle intervals are removed and playback +is 1.3 times the recorded speed. + + + +[Download the MP4](../assets/commerce/fullbleed-commerce-walkthrough.mp4). + +## Customize the document + +In **Template studio**, choose an order summary or packing slip. Drag blocks, +edit text, insert order fields, and style the layout. Switch to **HTML / CSS** +to paste or adjust a template. Preview it with a recent order before saving. +Each document type has its own saved template. + +**Brand settings** supplies the seller name and contact lines, Studio, Contrast +or Quiet design, A4 or Letter paper, accent color, and closing note. Saved custom +templates keep their own CSS. + +The verified workflow produced these synthetic documents: + +- [Custom order summary PDF](../assets/commerce/shopify-custom-order-summary.pdf) + — a visual text edit and CSS accent change applied to the saved template. +- [Contrast packing slip PDF](../assets/commerce/shopify-contrast-packing-slip.pdf) + — recipient details, item quantities and packing checkboxes, without prices. + +## Connect Shopify Flow + +1. Preview and save your templates, then enable **Flow automation** in Fullbleed. +2. Create an **Order created** workflow in Shopify Flow. +3. Add **Create order summary link** and **Create packing slip link**, each + using the triggering order. +4. Pass each action's `downloadUrl` and `expiresAt` to your chosen following + steps. The demonstrated recipe saves four private order metafields for staff. +5. Test with a synthetic order and confirm the complete Flow run, both expiry + times, and both downloads before using a delivery destination. + +The [complete recipe](https://github.com/fullbleed-engine/fullbleed-commerce/blob/main/shopify/recipes/order-documents.md) +includes the field definitions, access settings, and variable mapping. The +recorded workflow was already configured and was manually retried to verify the +new saved template. It completed seven actions: two document preparations, four +field updates, and one diagnostic log. + +## Know what a ready link means + +Fullbleed renders and verifies the document before returning its private link. +The browser downloads in this check matched the preparation hashes. A manual +reprint using the same saved template produced the same PDF. The order counted +once in its billing period. + +Links expire after 24 hours by default. Changing the order or template invalidates +them; pausing automation revokes active links. Anyone with a complete link can +download while it is valid, so share it only with the intended recipient. Fullbleed +does not send customer emails, collect order payments, or mark orders fulfilled. + +Order summaries are not fiscal invoices. The preview rejects edited, cancelled +or refunded orders, more than 250 items, and unsupported characters. + +See the [privacy notice](privacy.md), +[Commerce source and verification](https://github.com/fullbleed-engine/fullbleed-commerce), +or [generate a PDF directly with Node.js](../getting-started/node.md). diff --git a/mkdocs.yml b/mkdocs.yml index a9451d4..d1392b1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -100,4 +100,6 @@ nav: - Performance evidence: guides/performance.md - FAQ: faq.md - Contribute and support: support.md - - Commerce privacy: commerce/privacy.md + - Commerce: + - Shopify preview: commerce/shopify.md + - Privacy: commerce/privacy.md