---
title: Smart Label
---

# Smart Label

## Contexto

A Smart Label centraliza a geração de etiquetas logísticas da Magalog para reduzir inconsistências de layout, falhas de leitura óptica e divergências de roteirização entre embarcadores.  
Ela padroniza a emissão em um único contrato, com retorno pronto para impressão nos formatos **ZPL** ou **PDF**.

## Quando usar

Use a Smart Label quando seu fluxo precisar emitir etiqueta logística de forma síncrona para expedição de pedidos, com dados de embarcador, transporte, pacote, origem, destino e informações fiscais (quando aplicável).

## Pré-requisitos

Antes de integrar:

1. Ter uma aplicação OAuth criada no ecossistema Magalu.
2. Implementar o fluxo de [autenticação e autorização](/docs/first-steps/create-an-application/authentication-authorization).
3. Solicitar os acessos necessários na [criação de aplicação](/docs/first-steps/create-an-application/create-application).
4. Garantir que as **configurações do cliente no Portal Magalog** estejam parametrizadas para o comportamento esperado da etiqueta (layout, formato e regras de impressão).

## Escopos necessários

| Valor | Descrição |
| --- | --- |
| `open:smart-label:write` | Permite gerar etiquetas logísticas. |

## Escopo da API

A API cobre a emissão de **etiquetas de transporte** no padrão Magalog.  
Não contempla etiquetas fora do contexto logístico.

## Ambientes

Ambientes disponíveis: [Ambientes](/docs/first-steps/environment)