The vendor may wish to display a list of music which is ready to be printed by an end-user. Using the getPrintReadyList method, a vendor can request an array of order item objects with prints remaining. These objects contain the attributes order ID, music ID, and number of prints remaining. Though provided, the number of prints remaining is not necessarily needed by vendors; the viewer will display how many prints remaining exist for each music piece and will handle decrementing prints remaining for a user as music is printed. Vendors, however, may choose to use this data to record prints in their own systems. Vendors can determine the number of copies a user printed by comparing the number of prints remaining before and after the viewer was launched.



getPrintReadyList
DescriptionReturns a list of music a user can print
Examplehttps://app.legatomedia.com/vend/getPrintReadyList/<user_id>/<include_printed_orders>/?username=<vendor_username>&api_key=<api_key>
or
https://app.legatomedia.com/vend/getPrintReadyList/<user_id>/<include_printed_orders>/?username=<vendor_username>&api_key=<api_key>&full_details<1 or 0>
e.g.: https://app.legatomedia.com/vend/getPrintReadyList/10000/1/?username=vmusic&api_key=4f0400000000000000
Parameters<user_id>The Legato user ID of the user to get a print-ready list for
<include_printed_orders>(Optional) Return orders already printed, 1 include or 0 to not include
<full_details>(Optional) paramater at end, choose to display the name of the Artist and the Arrangement Type with a 1 or 0
<vendor_username>Your Legato vendor username
<api_key>Your Legato vendor API key
Returns
{     "printouts": [{         "sku": "00-PIP-000623",         "prints_purchased": 1,         "title": "Music Publication Title",         "order_id": 1048214,         "music_id": 13470,         "date": "2012-01-05",         "prints_remaining": 1     }, {         "sku": "00-PIP-000497",         "prints_purchased": 1,         "title": "Another Title",         "order_id": 1048218,         "music_id": 13470,         "date": "2012-01-05",         "prints_remaining": 1     }],     "success": true }
                            
An array of order item objects with prints remaining; order item objects contain the attributes orderID, musicID, and printsRemaining.
Possible Errorsinvalid_user_id