Baixar etiqueta (Correios)
get_label_pdfGet a fresh download link for the PDF of an already-created Correios pré-postagem by its id. Use it when generate_label's link reason was label_pdf_timeout and you want a new link to hand the merchant/customer, or to re-check status later. Requires the prepostagemId returned by generate_label; if you only have the supportCode of a label attempt, use recover_label_pdf instead. Never creates a new pré-postagem. Requires the store's own authenticated Correios contract.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prepostagemId": "<prepostagemId>"
},
"name": "get_label_pdf"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| instanceId | No | Merchant/store id. Ignored on authenticated servers (the merchant comes from the API key); used only on local/unauthenticated servers. | |
| prepostagemId | Yes | Correios pré-postagem id, as returned by generate_label in the `prepostagemId` field. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Why the PDF wasn't returned. | |
| status | No | Correios status/business message, when the label isn't printable. | |
| actionUrl | No | When set (e.g. reason=subscription_required), send the merchant here to finish setup. | |
| labelPdfUrl | No | Clickable link to download the label PDF — share this with the merchant/customer in chat. | |
| prepostagemId | No | The pré-postagem id the PDF belongs to. | |
| labelPdfBase64 | No | Base64-encoded label PDF, once ready. |