Draft Order PDF
The Nue Self-Service API provides a convenient way to generate shareable PDF documents of draft orders through "magic links." These links allow customers to view, share, and download formatted order quotes without requiring authentication.
How to Generate Order PDF LinksCopied!
Required Information
To generate an order PDF magic link, you need:
-
Order ID: The unique identifier of the draft order for which you want to create a PDF
Generation Process
When you request a magic link using the /orders/magiclink/order/{orderId} endpoint, the system:
-
Validates that the order exists and is accessible
-
Creates a secure, time-limited token for the order
-
Generates a URL containing this token
-
Returns the complete magic link URL in the response
Magic Link Response
The response is straightforward, containing a single magicLink field with the complete URL:
{
"magicLink": "https://app.nue.io/view-order/[secure-token]"
}
Use Cases for Order PDF Magic LinksCopied!
Magic links are particularly valuable in several scenarios:
-
Sharing with Stakeholders: Send quotes to procurement teams or other decision-makers
-
Approval Workflows: Include links in approval request emails
-
Record Keeping: Provide customers with easily accessible documentation
-
Printing and Archiving: Allow easy download for offline record-keeping
Best Practices for Using Order PDF Magic LinksCopied!
-
Generate links only when needed to maintain security
-
Consider including expiration information when sharing links
-
Use descriptive email subjects when sharing links
-
Track which links have been accessed in your application logic
-
Regenerate links if order details change significantly
By leveraging order PDF magic links, you can enhance your self-service experience with professional documentation capabilities while simplifying the sharing and approval process for customers and their stakeholders.