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.
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
**Escolher arquivo** — Clique em 'Escolher arquivo'. Dá para selecionar vários de uma vez — eles são enviados em sequência.
- 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
**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
**Abrir** — Clique no card. Imagem e PDF abrem dentro da própria tela; XML abre como texto.
- 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
**Download** — O botão Download baixa o arquivo com o nome original.
- 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
| Onde | Parâmetro | O que muda |
|---|---|---|
| Geral | Diretó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!' |
| Geral | URL 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 |
| Movimento | Identificador 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
