Etiquetas e postagens
Crie pré-postagens e obtenha etiquetas para impressão.
O que você pode construir
Prepare uma postagem a partir dos dados do pedido e obtenha o PDF da etiqueta. Essa capacidade está disponível pelo Meu Ecommerce MCP.
Produto relacionado: Meu Frete.
Como acessar
| Interface | Operação | Uso |
|---|---|---|
| Meu Ecommerce MCP | generate_label | Criar uma pré-postagem e tentar obter o PDF |
| Meu Ecommerce MCP | get_label_pdf | Recuperar o PDF de uma pré-postagem existente |
| Meu Ecommerce MCP | diagnose_label_issue | Consultar tentativas de emissão da loja, sem emitir |
| Meu Ecommerce MCP | recover_label_pdf | Recuperar o PDF de uma tentativa confirmada pelo supportCode |
| Meu Ecommerce MCP | link_label_support_ticket | Vincular a referência de um chamado a uma tentativa |
| Meu Ecommerce MCP | diagnose_contract_issue | Consultar as etapas de configuração do contrato dos Correios |
Não há endpoint REST público de emissão ou download de etiquetas no contrato atual. Use a mesma conexão MCP da plataforma.
Antes de começar
A loja precisa de acesso ativo, contrato próprio dos Correios autenticado e conexão MCP com permissão de lojista. A integração de etiquetas deve estar habilitada, e as ferramentas precisam aparecer no catálogo retornado pelo servidor.
Configure os requisitos da loja pelo dashboard. Uma conexão MCP autorizada, por si só, não habilita a emissão.
Dados e unidades
Informe peso do pacote em gramas, dimensões em centímetros quando necessárias, remetente, destinatário e código contratual do serviço. Para o documento fiscal, envie a chave de 44 dígitos da NF-e em invoiceKey ou os itens da DC-e em declaredItems. O peso da cotação, por outro lado, é informado em quilogramas por unidade. Veja como preparar os dados.
Da criação ao PDF
generate_label cria uma pré-postagem real nos Correios. Se a criação retornar prepostagemId antes de o PDF estar pronto, use get_label_pdf com esse identificador. Repetir a criação pode gerar outra pré-postagem.
Se o resultado de uma emissão não estiver claro, consulte a tentativa com diagnose_label_issue usando o supportCode devolvido por generate_label. Quando houver pré-postagem confirmada, recover_label_pdf obtém o PDF sem nova emissão.
Veja o fluxo completo de emissão e recuperação.
Depois da postagem, use a capacidade de rastreamento para acompanhar a entrega.