How it works
3D Print Pricing remains the order-tracking system, Home Assistant is the farm-management system. An order has an immutable identifier (id, UUID) from the moment it’s created until it’s deleted — you can safely tie a QR label for the order to it: even if you change the quantity, price, customer, or material, the identifier stays the same.
3D Print Pricing ──REST + webhook──► Home Assistant ──Klipper/Moonraker──► printer
▲ │
└──────────────── PUT /print-jobs/{id} (status) ◄───────────────────────────┘Assigning a specific printer/spool (e.g. via Spoolman) is Home Assistant's logic — 3D Print Pricing isn't involved in that. 3D Print Pricing only hands over the order data and accepts the status back.
Authorization
A personal access token (PAT) is created in Settings → Integrations → Developers → Access tokens. It’s sent with every request as a header:
Authorization: Bearer pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxThe token grants full access to all account data on your behalf, with no scope limited to orders only — the same as what the slicer plugin uses. Create a separate token for Home Assistant (don't reuse your personal one) — that way you can revoke it at any time without touching your other integrations.
Every endpoint page below has a “Run” button — a real request with this token to your account, straight from the browser. The token is never stored on our server — it's kept only in this browser tab's session, and carries over to the other /developers pages until you close the tab.