How do I send a label to Peoplevox for printing?

You would return a URL to your PDF file on the response when Peoplevox sends a request to your API.

Do I need to download the labels and host them myself?

Not necessarily, but you must provide Peoplevox with a URL from which the document can be obtained and printed. Some carriers will host the labels themselves and provide a URL, and others with save the label from the carrier to a cloud storage platform, then return the URL to that.

What should I do if my endpoint receives a document request with some bad data from Peoplevox, like an invalid address?

In this case, you should respond to the request with a "fail" status so that Peoplevox can print the failover label. You should also provide the Peoplevox user with an easy process for correcting the shipment data and re-printing the label. Some data can be corrected within Peoplevox and the document request resubmitted, but other data is locked at the point of shipment.

What should I do if I receive multiple requests for the same shipment (i.e. for the same Peoplevox package)?

If the first request for a package succeeded, and the documentation has not been voided in the carrier system, then you should respond with the same documentation and tracking numbers. If the documentation has been voided, or the previous documentation request failed, then you should provide a new set of documentation and tracking numbers.

What should I do if I receive multiple requests for related shipments (i.e. multiple packages for the same order)?

You should try to optimise the shipping with the carrier. Typically, that means collecting both packages into the same consignment.

Is it possible for my carrier system to send the labels directly to the printer?

This is not currently supported, but may be added to the platform at a later date.