GuideReference

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.

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:

  1. Validates that the order exists and is accessible

  2. Creates a secure, time-limited token for the order

  3. Generates a URL containing this token

  4. 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]"
}

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

  • 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.