Anexos comerciais

Arquivos e anexos comerciais

checkout.attachmentsEnabled permite mostrar um campo opcional de anexo dentro do formulário [data-checkout-form]. Use um input file com data-order-attachment-input e accept .pdf,.png,.jpg,.jpeg,.webp; o runtime lê até 5 MiB e envia com a mesma tentativa de compra. Um botão type button com data-order-attachment-clear limpa a seleção local. O tema não envia IDs de arquivo, loja ou cliente como autorização e não implementa upload por conta própria.

confirmation.attachment e buyer.order.attachment contêm null ou { id, name, size, url }. A URL já é montada pelo backend; use-a escapada, sem concatenar prefixos de storage. É um link público do contrato de arquivos legado, não um asset do tema e não deve passar por asset_url.

buyer.order.attachmentsEnabled habilita o formulário de alteração. Os hooks obrigatórios do formulário são data-order-attachment-form, data-order-id, data-attachment-id (vazio quando não há anexo) e data-buyer-csrf. Declare POST com destino /api/account/pedidos/{id}/anexo via storefront_url. Um botão submit normal envia a seleção; data-order-attachment-remove desvincula o anexo atual. Use data-order-attachment-message em região role status para retorno acessível. Liquid define estrutura, CSS apresentação e o runtime controla envio e repetição. As prévias usam dados fictícios e não enviam arquivos.