Novo módulo - Order Attachments
Patch Notes - Order Attachments
Disponibilizamos o módulo Order Attachments, implementado para permitir o envio e a gestão de anexos vinculados ao pedido no Magento 2. O objetivo é centralizar documentos do pedido (ex.: comprovantes, PDFs, imagens de referência, ordens de compra) diretamente no fluxo do checkout e na tela do pedido no Admin, reduzindo tratativas fora da plataforma. O módulo trabalha com vínculo correto Quote → Order: anexos enviados durante o checkout ficam associados ao carrinho e são transferidos automaticamente para o pedido ao finalizar a compra.
O que o módulo faz
-
Permite upload de anexos no checkout, com possibilidade de habilitar/ocultar para visitantes (guest).
Permite o cliente logado gerenciar anexos em Minha Conta → Meus Pedidos → Ver Pedido → aba “Order Attachments”.
Permite gestão no Admin em Sales → Orders → (pedido) → aba “Order Attachments”, com controle por ACL.
Suporta comentário, edição e remoção de anexos.
Aplica validações de limite, tamanho máximo (KB) e extensões permitidas via configuração.
Possui opção de logs de debug para diagnóstico.
Funcionamento do upload (fluxo técnico)
O módulo opera em dois momentos:
-
No checkout (Quote)
-
O arquivo é enviado e vinculado ao Quote (carrinho).
-
Ao finalizar o pedido (Order)
-
Ao confirmar a compra, os anexos são migrados automaticamente de Quote → Order, ficando definitivamente vinculados ao pedido.
Onde fica
Checkout: exibido conforme a configuração de etapa (“Display Attachment”).
Cliente (Minha Conta):
Minha Conta → Meus Pedidos → Ver Pedido → Order Attachments Admin:
Sales → Orders → (pedido) → Order Attachments
Configurações
Admin → Stores → Configuration → Sales → Order Attachments
Configurações disponíveis:
-
Enabled (habilita/desabilita o módulo)
Allow Guest Attachments (Checkout) (permitir anexos para guest)
Display Attachment (definir em qual etapa do checkout exibir ou não exibir)
Limit (máximo de anexos por pedido)
Size (KB) (tamanho máximo por arquivo)
Allowed extensions (lista de extensões permitidas)
Enable Logs (Debug) (logs de debug para troubleshooting)
Limpeza automática (cron)
Para evitar acúmulo de anexos oriundos de carrinhos abandonados, há um cron diário que remove anexos “órfãos” (quotes que não viraram pedido), com retenção de 30 dias.