---
updatedAt: 2026-06-18T14:03:31.000Z
agentTools:
  projectIndex: https://docs.melhorenvio.com.br/llms.txt
---

# Pré-visualização de etiquetas

Etiquetas

<div style={{ textAlign: "justify" }}>

O usuário pode verificar as etiquetas antes mesmo de gerá-las.

Para isto, basta requisitar o link de pré-visualização informando o `id` da etiqueta.

No momento da pré-visualização, o rastreio e a autorização de postagem não estarão disponíveis.

> 📘 Nota
>
> É necessário já ter comprado a(s) etiqueta(s) previamente.

</div>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-melhor-envio-sandbox",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sandbox.melhorenvio.com.br/",
      "description": "Ambiente de Sandbox (Testes)"
    },
    {
      "url": "https://melhorenvio.com.br/",
      "description": "Ambiente de Produção (Real)"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/api/v2/me/shipment/preview": {
      "post": {
        "summary": "Pré-visualização de etiquetas",
        "description": "Etiquetas",
        "operationId": "pre-visualizacao-de-etiquetas",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer token"
            }
          },
          {
            "name": "User-Agent",
            "in": "header",
            "description": "É obrigatório que seja adicionado o cabeçalho HTTP User-Agent com o nome da sua aplicação junto a um email de contato/suporte.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Aplicação (email para contato técnico)"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "orders"
                ],
                "properties": {
                  "orders": {
                    "type": "array",
                    "description": "Pedidos",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "examples": {
                "Pré visualização de etiquetas": {
                  "value": {
                    "orders": [
                      "{{id}}"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"url\": \"https://sandbox.melhorenvio.com.br/pre-impressao/Xvi2N2ImijM6\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/pre-impressao/Xvi2N2ImijM6"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"error\": \"Não é possível imprimir etiquetas com o pagamento ainda não processado. Favor aguarde.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Não é possível imprimir etiquetas com o pagamento ainda não processado. Favor aguarde."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```