---
updatedAt: 2026-04-22T12:42:04.000Z
agentTools:
  projectIndex: https://docs.frenet.com.br/llms.txt
---

# Obter etiqueta do envio pelo Id

Serviço para obter dados da etiqueta do envio

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "Frenet WhiteLabel Shipments (Orders) API",
    "version": "2.1",
    "title": "Frenet WhiteLabel Shipments (Orders) API",
    "contact": {
      "name": "Suporte Técnico",
      "url": "https://ajuda.frenet.com.br/",
      "email": "suporte@frenet.com.br"
    }
  },
  "tags": [
    {
      "name": "Shipments",
      "description": "Serviços para Gerenciar os Envios"
    }
  ],
  "paths": {
    "/shipments/{shipmentId}/label": {
      "get": {
        "tags": [
          "Shipments"
        ],
        "summary": "Obter etiqueta do envio pelo Id",
        "description": "Serviço para obter dados da etiqueta do envio",
        "operationId": "getShipmentLabelAsync",
        "parameters": [
          {
            "in": "header",
            "name": "token",
            "required": true,
            "description": "Token do Cliente",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "x-partner-token",
            "required": true,
            "description": "Token do parceiro",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shipmentId",
            "in": "path",
            "description": "Código interno do envio na Frenet",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "in": "header",
            "name": "x-printing-format",
            "description": "Formato da impressão da etiqueta. Se não for informado, o padrão é A4.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShipmentResult"
                }
              }
            }
          },
          "400": {
            "description": "business error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "internal error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "api_partner_key": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://whitelabel.frenet.com.br/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "token",
        "in": "header"
      },
      "api_partner_key": {
        "description": "API para identificação do partner",
        "type": "apiKey",
        "name": "x-partner-token",
        "in": "header"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "Message": {
            "type": "string",
            "description": "Mensagem de retorno"
          },
          "Details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorDetail"
            },
            "description": "Lista de erros, quando houver"
          }
        },
        "example": {
          "Message": "Mensagem de Erro",
          "Details": [
            {
              "Code": 401,
              "Message": "Não Autorizado"
            },
            {
              "Code": 1000,
              "Message": "Cotação inválida (SessionId)"
            },
            {
              "Code": 2001,
              "Message": "Nome do remetente inválido"
            },
            {
              "Code": 2002,
              "Message": "Email do remetente inválido"
            }
          ]
        }
      },
      "ErrorDetail": {
        "type": "object",
        "description": "## Lista dos possíveis erros retornados pela API\n  | Code | Message |\n  | --- | ------- | \n  | 401 | Não Autorizado - Token Inválido |\n  | 403 | Sem permissão para acessar o recurso |\n  | 500 | Detalhes da exceção |\n  | 1000 | Cotação inválida (SessionId) |\n  | 1001 | Cep de origem inválido |\n  | 1002 | Cep de destino inválido |\n  | 1003 | Peso do pacote inválido |\n  | 1999 | Não foi possível obter cotação. Detalhes {0} |\n  | 2001 | Nome do remetente inválido |\n  | 2002 | Email do remetente inválido |\n  | 2003 | Rua do remetente inválida |\n  | 2004 | Numero do remetente inválido |\n  | 2005 | Bairro do remetente inválido |\n  | 2006 | Cidade do remetente inválida |\n  | 2007 | Estado do remetente inválido |\n  | 2008 | Nome do destinatário inválido |\n  | 2009 | CPF/CNPJ do destinatário inválido |\n  | 2010 | Telefone do destinatário inválido |\n  | 2011 | Rua do destinatário inválida |\n  | 2012 | Numero do destinatário inválido |\n  | 2013 | Bairro do destinatário inválido |\n  | 2014 | Cidade do destinatário inválida |\n  | 2015 | Estado do destinatário inválido |\n  | 2016 | Peso do volume inválido |\n  | 2017 | Valor de frete do volume inválido |\n  | 2018 | Identificação do volume inválida |\n  | 2019 | Agência de postagem inválida |\n  | 2020 | Chave da nota fiscal inválida |\n  | 2021 | O CNPJ emissor da chave de acesso é diferente do CNPJ de cadastro |\n  | 2999 | Não foi possível inserir o envio. Detalhes {0} |\n  | 3000 | Saldo insuficiente. |\n  | 3999 | Não foi possível pagar o envio. Detalhes {0} |\n  | 4000 | Problema de comunicação com a transportadora. Detalhes {0} |\n  | 4999 | Não foi possível gerar a etiqueta do envio. Detalhes {0} |\n  ---\n",
        "properties": {
          "Code": {
            "type": "integer",
            "format": "int32",
            "description": "Código do erro"
          },
          "Message": {
            "type": "string",
            "description": "Mensagem de retorno"
          }
        },
        "example": {
          "Code": 2011,
          "Message": "Rua do destinatário inválida"
        }
      },
      "ShipmentBaseResponse": {
        "allOf": [
          {
            "type": "object",
            "properties": {
              "ShipmentId": {
                "type": "integer",
                "format": "int64",
                "description": "Código interno do envio na Frenet"
              },
              "OrderId": {
                "type": "string",
                "description": "Código do pedido na Plataforma"
              },
              "ShipmentStatus": {
                "type": "integer",
                "description": "enum:\n  * 1 - Criado\n  * 2 - PendentePagamento\n  * 3 - FalhaPagamento\n  * 4 - SucessoPagamento\n  * 5 - Postado\n  * 6 - CancelamentoAgendado\n  * 7 - Cancelado\n  * 9 - Excluído\n  * 18 - Entregue no ponto de postagem"
              }
            }
          }
        ]
      },
      "ShipmentResult": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ShipmentBaseResponse"
          },
          {
            "type": "object",
            "properties": {
              "TrackingUrl": {
                "type": "string",
                "description": "URL para rastreio do envio"
              },
              "LabelUrl": {
                "type": "string",
                "description": "URL para impressão da etiqueta do envio"
              },
              "DeclarationUrl": {
                "type": "string",
                "description": "URL para impressão da declaração de conteúdo do envio"
              },
              "ReceiptNotificationUrl": {
                "type": "string",
                "description": "URL para impressão do Aviso de Recebimento do envio (quando contratado como serviço adicional)"
              },
              "ValidThrough": {
                "type": "string",
                "format": "date-time",
                "description": "Data de validade da Etiqueta."
              },
              "Errors": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ErrorDetail"
                },
                "description": "Lista de erros, quando houver"
              }
            }
          }
        ]
      }
    }
  },
  "x-readme": {}
}
```