Editar uma encomenda PrestaShop com o DataFirefly Order Editor

Apresentação

O DataFirefly Order Editor adiciona um editor à página de cada encomenda do back-office, logo por baixo do bloco Produtos. Permite editar uma encomenda validada como um carrinho: adicionar ou retirar produtos, mudar uma combinação, corrigir uma quantidade ou um preço, mudar a morada ou a transportadora, retirar ou adicionar um desconto. Cada alteração é recalculada pelo motor do carrinho do PrestaShop, e a fatura é anulada por uma nota de crédito e emitida de novo, ou atualizada, conforme a sua escolha.

O módulo funciona no PrestaShop 8.0 a 9.x. Está traduzido em português, inglês, francês, espanhol, alemão, italiano, neerlandês e polaco.

Instalação

1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e largue o ficheiro dforderedit-1.0.0.zip.
2. Na instalação, o módulo atribui as suas permissões aos perfis que já podem editar encomendas (por exemplo SuperAdmin, Vendedor, Logística).
3. Abra uma encomenda: o bloco Editor de encomendas aparece por baixo do bloco Produtos.

Configuração

A página de configuração do módulo tem cinco definições:

• Estados da encomenda em que a edição é permitida: o editor só é proposto para encomendas nesses estados. Cancelada, Reembolsada e Erro de pagamento estão excluídos por predefinição.
• Tratamento da fatura por predefinição: nota de crédito e nova fatura (recomendado), ou atualização da fatura existente com o mesmo número. A escolha pode mudar em cada alteração.
• Repor em stock as quantidades retiradas por predefinição.
• Avisar o cliente por e-mail por predefinição.
• Adicionar uma nota privada à encomenda após cada alteração.

Editar uma encomenda

Abrir o editor

Na página da encomenda, clique em Editar esta encomenda. Enquanto não confirmar nada, a encomenda não é tocada: o botão Repor anula todas as alterações em curso e o navegador avisa-o se sair da página com alterações por aplicar.

Produtos

• Adicionar um produto: escreva um nome, referência, EAN ou ID na pesquisa (várias palavras, em qualquer ordem). As setas e a tecla Enter permitem escolher com o teclado. Para um produto com combinações, escolha a combinação na lista que aparece.
• Mudar a combinação: a lista indica o stock de cada combinação. O preço da nova combinação é retomado automaticamente e continua editável.
• Corrigir a quantidade ou o preço: o preço pago pelo cliente é mantido por predefinição. A ligação Aplicar o preço de catálogo retoma o preço atual para esse cliente (grupo, preços específicos, descontos de quantidade).
• Introdução s/ IVA ou c/ IVA: o botão acima da tabela escolhe o modo. Por predefinição segue a apresentação de preços do grupo do cliente. Um preço introduzido c/ IVA é convertido para s/ IVA, que continua a ser a referência da encomenda.
• Retirar uma linha: o ícone do caixote risca a linha, o ícone da seta repõe-na.

Moradas

Escolha outra morada do cliente na lista ou clique em Editar os campos desta morada para corrigir uma rua ou um código postal. Uma morada editada é guardada como nova morada associada apenas a esta encomenda: as encomendas anteriores e o livro de moradas do cliente não mudam. Se o país mudar, o IVA dos produtos e dos portes é recalculado.

Descontos

Desmarque um desconto para o retirar da encomenda. A pesquisa adiciona uma regra de carrinho existente por nome ou código. A ligação Adicionar um desconto livre cria um desconto em valor c/ IVA ou em percentagem com a designação que escolher, sem passar pelo catálogo de regras de carrinho. Este desconto é guardado como uma regra de carrinho desativada, reservada ao cliente e já consumida: não pode ser reutilizada no carrinho.

Envio

A lista de transportadoras só propõe as que podem entregar o carrinho editado na morada escolhida, com preço e prazo. Há três modos para os portes:

• Manter os portes da encomenda: o valor s/ IVA mantém-se, o imposto acompanha a morada se mudar de país.
• Recalcular com a transportadora escolhida: obrigatório quando muda de transportadora.
• Definir os portes (c/ IVA).

Opções

• Estado da encomenda após a alteração: o estado muda através do histórico nativo do PrestaShop, com os e-mails habituais.
• Repor em stock as quantidades retiradas.
• Enviar ao cliente o resumo da encomenda alterada, no seu idioma.
• Fatura: nota de crédito e nova fatura, ou atualização da fatura existente.
• Nota interna, guardada no histórico de alterações.

Novos totais e confirmação

Pouco depois de cada alteração, a barra fixa no fundo do ecrã mostra o total c/ IVA antes e depois, a diferença e o que o cliente ainda deve ou o valor pago em excesso a reembolsar. A ligação Detalhes abre a comparação linha a linha (quantidades, preços, taxas de imposto), os descontos, as moradas e todos os totais. Os avisos aparecem por cima: stock insuficiente, regra de carrinho cujo mínimo já não é atingido, transportadora que já não entrega.

Clique em Aplicar as alterações: a confirmação lista as linhas afetadas, os descontos, a mudança de transportadora, os documentos que serão criados e o novo estado. Clique em Confirmar e aplicar e a página recarrega com a encomenda atualizada.

Fatura e nota de crédito

Modo nota de crédito e nova fatura (predefinido)

1. O PDF da fatura é arquivado tal como estava, antes de qualquer escrita.
2. Uma nota de crédito anula a fatura pelo valor total. O seu PDF também é arquivado.
3. É emitida uma nova fatura com o número seguinte. As linhas, os descontos, a transportadora e os pagamentos ficam associados a ela.

A ligação de descarga da fatura anulada, no back-office e na conta do cliente, devolve sempre o PDF original. A fatura anulada deixa de ser proposta no formulário de adição de pagamento.

Modo atualização

Os valores da fatura existente são atualizados e ela mantém o número, como o PrestaShop faz de forma nativa. O PDF anterior à alteração é arquivado na mesma. Uma encomenda com várias faturas passa sempre pelo modo nota de crédito e nova fatura.

Pagamentos e reembolsos

O pagamento já recebido fica na encomenda. Quando o novo total é maior, o PrestaShop mostra o valor em falta como em qualquer pagamento parcial. Quando é menor, o valor pago em excesso aparece no editor e o reembolso faz-se através do seu prestador de pagamentos.

Quando uma encomenda passa depois a um estado pago, o PrestaShop adiciona normalmente um pagamento por cada fatura não liquidada. O módulo impede esse pagamento fictício nas faturas anuladas por nota de crédito.

Stock

O stock é ajustado pela diferença. Uma quantidade que passa de 2 para 3 consome uma unidade, uma linha retirada devolve a sua quantidade ao stock se a opção estiver assinalada, e uma combinação trocada devolve a antiga e consome a nova. As quantidades reservadas são recalculadas no fim.

Linhas bloqueadas

• Linha reembolsada ou devolvida: não pode ser alterada nem retirada, para não falsear as notas de crédito existentes. As outras linhas da encomenda continuam editáveis.
• Linha personalizada (texto, ficheiro enviado pelo cliente): pode ser retirada mas não alterada. O texto da personalização aparece por baixo da linha e os ficheiros do cliente nunca são tocados.
• Produto eliminado do catálogo: a linha só pode ser retirada.

Histórico e rastreabilidade

O histórico, por baixo do editor, lista cada alteração: data, funcionário, linhas, descontos, moradas, transportadora e estado alterados, total antes e depois, nota interna e ligações para os PDF arquivados. Uma nota privada resume também a alteração nas mensagens da encomenda.

Na desinstalação, o histórico e os PDF arquivados são mantidos para que as faturas anuladas continuem identificadas se o módulo for reinstalado.

Para programadores

• actionOrderEdited: hook nativo do PrestaShop, chamado com order após cada alteração.
• actionDfOrderEditAfter: chamado com order, id_dforderedit_log, changes (linhas, descontos, moradas, transportadora, totais) e id_order_slips.

O novo cálculo usa um carrinho temporário que nunca é associado a uma encomenda e é eliminado no fim. A pré-visualização é calculada numa transação que é anulada.

Resolução de problemas

O editor não aparece na encomenda

Verifique se o estado da encomenda está entre os estados editáveis da configuração e se o perfil do funcionário pode editar encomendas e ver o módulo.

A transportadora não pode entregar o novo carrinho

O peso, o valor ou a zona estão fora dos escalões da transportadora. Escolha outra transportadora na lista ou defina os portes manualmente.

Não foi possível fixar exatamente o preço de uma linha

Uma regra do catálogo (um desconto de grupo, por exemplo) aplica-se por cima do preço introduzido. Verifique o preço nos detalhes antes de confirmar.

Encomenda proveniente de um carrinho com várias transportadoras

Quando um carrinho foi dividido em várias encomendas, as regras de carrinho são recalculadas apenas na encomenda editada. Um aviso lembra-o na pré-visualização.