How to download the label in Magalu's panel
The label only appears once the order is invoiced: with no authorised NF-e there is no button. The order has to be invoiced and ready to ship.
- 1In the partner panel, open order management and filter for orders ready to ship.
- 2Select the orders going out in the same batch.
- 3Ask for the label (the button reads as downloading or printing labels) and choose the format: 4x6 or A4, as PDF or as ZPL.
- 4Pick ZPL if your printer is thermal and speaks the language; pick PDF in every other case — including if you plan to convert it later.
What lands in your Downloads folder
Whichever you asked for: a PDF ready to print, or a text file holding the ZPL for the selected labels. Generated labels expire — usually after 7 days — so downloading far in advance doesn't pay off.
PDF or ZPL: which to pick
ZPL is code the thermal printer executes: it draws the label at native resolution, with no driver in between and nothing rescaled. It's the sharper option — when the printer understands the language.
PDF is an image ready for paper. It prints anywhere, but it goes through the driver, and that's where the classic problems show up: a label shrunk because the print dialog was on “fit to page”, or paper set to A4.
If you're not sure what your printer speaks, start with the 4x6 PDF and print at 100% scale.
I took the ZPL and my printer isn't a Zebra
That happens with Argox (PPLA out of the box) and with any regular inkjet or laser. You don't have to go back to the panel and regenerate: drop the ZPL file onto the converter below and download the PDF at the label's true physical size.
It works the other way too: if you downloaded the PDF but own a thermal printer that speaks ZPL, convert the PDF to ZPL here and send the code straight to the printer.
Settings that keep labels from being rejected
Print at 100% scale, with no margins, and check the driver's paper size is 4x6 — not A4. E-commerce thermal printers are typically 203 dpi (8 dpmm).
Before spending label stock, check the barcode in the preview: blurred or merged bars are usually a symptom of rescaling, not of the label itself.
For developers: labels via the API
Magalu's API generates labels for Magalu Entregas orders with the format chosen between PDF and ZPL, and accepts up to 20 orders per request. There's also an option to download the invoice along with the label.
The ZPL it returns is the same one the panel hands you: drop it onto the converter here to check the layout without wasting label stock.