Anexos nas telas de movimento

A seção Anexos dos movimentos: onde ela existe, por que o arquivo sobe na hora quando o registro já está salvo e por que documentos de movimentos diferentes não se sobrescrevem mais.

IntegraçõesAtualizado em 20/09/2026

Quando usar

Sempre que o documento precisar ficar preso àquele movimento: XML que chegou por e-mail, autorização de devolução, comprovante do transportador, planilha de conferência do cliente.

Antes de começar

  • Movimento aberto no formulário
  • Arquivo com até 50 MB (o limite é por arquivo)
  • Diretório de arquivos configurado no servidor — sem ele o upload é recusado

A seção Anexos guarda os documentos do registro — XML e DANFE da nota, planilha do cliente, e-mail de autorização. Ela existe nas oito telas de Movimentos e em alguns cadastros, e é diferente da seção Fotos, que é onde ficam as imagens tiradas no coletor. Com o registro já gravado, o arquivo sobe assim que você escolhe, sem precisar salvar de novo.

1. Em quais telas existe

Nas oito telas de Movimentos: Recebimento, Pedido de Expedição, Devolução, Reentrega, Retorno de Entrega, Cross-Docking, Cross-Recebimento e Cross-Expedição. Em todas ela é a seção Anexos, com o ícone de clipe na barra de navegação do formulário.

Fora dos movimentos, a mesma seção aparece na aba Anexos do contrato de faturamento, no cadastro de Produto, no cadastro de Cliente/Fornecedor e nos Arquivos da notificação customizada.

Nos movimentos, logo acima de Anexos existe a seção Fotos. As duas listas são separadas e uma não enxerga a outra: Anexos é documento da tela web, Fotos é imagem da operação.

2. Subir arquivo

  1. 1

    **Escolher arquivo** — Clique em 'Escolher arquivo'. Dá para selecionar vários de uma vez — eles são enviados em sequência.

  2. 2

    **Acompanhar** — Cada arquivo vira um card com o nome. Imagem mostra a própria miniatura; PDF, XML, Excel e Word mostram o ícone do tipo.

  3. 3

    **Conferir a mensagem** — No fim aparece 'Anexo adicionado com sucesso' (ou 'N anexos adicionados com sucesso'). Se algum falhar, aparece também 'Falha ao carregar o anexo' e a lista é recarregada — o que ficar na tela é o que realmente existe.

3. Registro novo x registro já salvo

Com o movimento já gravado, o arquivo sobe na hora: ao escolher, ele já vai para o servidor e a lista recarrega. Não precisa clicar em Salvar para o anexo existir, e ele continua lá se você fechar a tela.

Com o movimento ainda NOVO, sem número, não existe registro em que pendurar o arquivo. Nesse caso ele fica só no navegador e sobe depois que você clicar em Salvar e o movimento ganhar o número.

Remover segue a mesma lógica: no movimento salvo a remoção é imediata; no movimento novo ela só vale quando você salvar.

4. Abrir, baixar e remover

  1. 1

    **Abrir** — Clique no card. Imagem e PDF abrem dentro da própria tela; XML abre como texto.

  2. 2

    **Copiar XML** — Na pré-visualização de XML existe o botão 'Copiar XML', que joga o conteúdo inteiro na área de transferência.

  3. 3

    **Download** — O botão Download baixa o arquivo com o nome original.

  4. 4

    **Remover** — O botão de menos no canto do card pede confirmação ('Deseja remover o anexo?').

5. Por que arquivos de movimentos diferentes não se sobrescrevem mais

As oito telas de movimento gravam o anexo com a mesma origem. Isso jogava todos os arquivos na mesma pasta: um 'danfe.pdf' anexado a uma devolução apagava fisicamente o 'danfe.pdf' de outra, e as duas linhas passavam a apontar para o mesmo arquivo — quem abrisse o movimento antigo via o documento do novo.

Agora cada registro tem a pasta dele, e o nome gravado em disco recebe um sufixo único. Dois arquivos com o mesmo nome no MESMO movimento também convivem.

O nome que aparece na tela continua sendo o original que você enviou. O sufixo é só do arquivo no servidor, e o Download devolve o nome de origem.

6. Anexo não é foto

No mesmo movimento convivem duas listas com finalidades diferentes. Anexos guarda documento enviado pela tela web. Fotos guarda a imagem registrada na operação — divergência de recebimento, lacre, avaria.

Elas são gravadas com identificadores distintos, então uma nunca aparece dentro da outra, mesmo sendo o mesmo movimento.

O coletor também tem anexos próprios, os do checklist, que ficam presos ao checklist e não à seção Anexos do movimento.

7. Quando o anexo não sobe

'Não é possível salvar o anexo. Diretório não configurado!' — o WMS não sabe onde gravar arquivo neste ambiente. É configuração de servidor: abra chamado com o suporte, não adianta tentar de novo.

'Erro ao criar diretório' ou 'Erro ao salvar o arquivo' — o servidor recusou a gravação, normalmente permissão de pasta ou disco cheio. Também é chamado.

'Falha ao carregar o anexo' — o arquivo não chegou ao servidor. A lista recarrega logo em seguida, então confira o que ficou na tela antes de refazer.

'Não foi possível abrir o anexo' na pré-visualização — a linha existe, mas o arquivo não foi encontrado no servidor. Costuma ser anexo antigo cujo arquivo foi movido.

Parâmetros que mudam esta tela

Parâmetros
OndeParâmetroO que muda
GeralDiretório de arquivos do Coletor/Web (Configuração do sistema — ajustada pelo suporte)Onde o anexo é gravado no servidor. Sem ele o upload é recusado com 'Diretório não configurado!'
GeralURL base da API do WMS (Configuração do sistema — ajustada pelo suporte)Monta o endereço público da imagem; errada, a miniatura e a pré-visualização de imagem não abrem
MovimentoIdentificador do anexo (Automático — a seção Anexos usa um identificador, a seção Fotos usa outro)Separa documento (Anexos) de imagem da operação (Fotos) no mesmo movimento; as listas não se misturam

Perguntas frequentes

**Preciso clicar em Salvar depois de anexar?** Depende do estado do registro. Movimento já gravado: não, o arquivo sobe na hora. Movimento novo, ainda sem número: sim, ele só sobe quando você salvar.

**Posso anexar vários arquivos de uma vez?** Pode. A seleção é múltipla e eles sobem em sequência. O limite de 50 MB é por arquivo, não pela seleção inteira.

**O anexo do movimento aparece no coletor?** Não. A lista de Anexos é da tela web. O coletor trabalha com as fotos da operação e com os anexos do checklist, que são listas próprias.

**Anexei o XML no movimento errado.** Remova no movimento errado e anexe no certo. Atenção: em movimento já salvo, remover apaga o arquivo do servidor na hora.

**Dois arquivos com o mesmo nome no mesmo movimento se sobrescrevem?** Não. Os dois ficam, com o mesmo nome na tela e arquivos distintos no servidor.

**Por que um anexo não tem o botão de remover?** Porque foi incluído pelo sistema (integração ou rotina automática). Anexo enviado por usuário sempre tem o botão.

Telas relacionadas

**Recebimento** (/apes-local/wms/receipts/grid) — Formulário com a seção Anexos

**Retorno de Entrega** (/apes-local/wms/returns/grid) — Formulário com a seção Anexos

**Cross-Docking** (/apes-local/wms/cross_docking/grid) — Formulário com a seção Anexos

**Contrato de faturamento** (/apes-local/wms/faturamento/contrato/grid) — Aba Anexos do contrato

Artigos relacionados

Anexos nas telas de movimento · Central de Ajuda Hap