Emitir etiquetas pelo MCP
Da pré-postagem à impressão, com recuperação do PDF.
Pré-requisitos
A loja precisa de acesso ativo, contrato próprio dos Correios autenticado e conexão MCP com permissão de lojista. A ferramenta deve aparecer no catálogo retornado pelo servidor.
Prepare os dados
Informe o código do serviço, peso do pacote em gramas, dimensões em centímetros, remetente, destinatário e declaração de conteúdo. Confira nomes, endereços e dados do pedido antes da emissão.
Os códigos contratuais de serviço usados na etiqueta não são os mesmos identificadores de apresentação da cotação. Por exemplo, não envie o texto SEDEX no lugar do código de produto exigido por serviceCode.
Consultar todos os campos de generate_label.
Crie a pré-postagem
O agente chama generate_label. Essa é uma operação real: ela cria uma pré-postagem nos Correios. Ela pode retornar:
prepostagemId, identificador da pré-postagem;trackingCode, código de rastreio;labelPdfBase64, quando o PDF estiver pronto;reason, quando houver falha ou o processamento ainda não estiver concluído.
Se o PDF ainda não estiver pronto
Ao receber label_pdf_timeout com prepostagemId, aguarde e use get_label_pdf com o identificador retornado. Não repita a criação para tentar obter o PDF: isso pode criar outra pré-postagem.
{
"prepostagemId": "ID_RETORNADO_NA_EMISSAO"
}O PDF também pode ser entregue no conteúdo MCP como recurso embutido application/pdf. A forma de exibição depende do cliente.
Trate falhas de negócio
own_contract_required pede configuração do contrato. prepostagem_rejected indica recusa pelos Correios. label_not_printable indica que o rótulo ainda não pode ser impresso. Examine a mensagem e o status antes de uma nova tentativa.
Em caso de timeout de rede com resultado desconhecido, confira o histórico da operação antes de reenviar. Este portal não promete idempotência na criação de etiquetas.