DPD Portugal para WooCommerce – Emissão Automática – Documentação e FAQ

A documentação e as perguntas frequentes são apresentadas em Português, tendo em conta que a esmagadora maioria dos utilizadores deste plugin é de Portugal.

🇬🇧 The documentation and FAQs are presented in Portuguese, bearing in mind that the overwhelming majority of users of this plugin are from Portugal. If you need English support, click on the technical support link next to your license key and open a ticket.

A extensão Emissão Automática do DPD Portugal para WooCommerce, da Naked Cat Plugins, emite a guia de expedição DPD automaticamente quando a encomenda passa para o estado escolhido, sem ter de abrir o ecrã de cada encomenda. Esta página reúne a documentação, as perguntas frequentes e os developer hooks da extensão. Para preços e instalação, consulte a página do produto.

Suporte

Como solicitar suporte técnico?

Se a razão pela qual necessita de suporte técnico não está mencionada nesta página nem na documentação do DPD Portugal para WooCommerce, clique na ligação “Suporte técnico” junto à chave de licenciamento da extensão, no ecrã de configurações do plugin, e preencha o ticket.

Onde posso submeter vulnerabilidades de segurança encontradas neste plugin?

Pode reportar erros de segurança identificados no código desta extensão pelo Patchstack Vulnerability Disclosure Program do DPD Portugal for WooCommerce, indicando que se trata da extensão Emissão Automática.

A equipa do Patchstack ajuda na verificação e na emissão do CVE, e trata de nos notificar.

Licenciamento

O que é necessário para utilizar a extensão?

O DPD Portugal para WooCommerce instalado e activo, na versão 16.2 ou superior, com a sua própria chave de licenciamento inserida e validada. A Emissão Automática tem uma chave de licenciamento própria, que é inserida no mesmo ecrã de configurações, no campo Chave de licenciamento – Extensão Emissão Automática.

Como transferir a licença de domínio?

Peça a mudança de domínio na sua área de cliente, junto à encomenda original.

Depois de receber a nossa resposta de que a licença está libertada, deve ir à configuração do plugin no website antigo, remover a chave da extensão e gravar. Depois, ir à configuração do plugin no site novo, inserir a mesma chave e gravar. Se o website foi transferido já com a chave na base de dados, deve remover a chave, gravar, inserir de novo e gravar de novo.

Como substituir a chave de licenciamento no mesmo website?

Se precisar de usar uma chave diferente no mesmo website, por exemplo porque deixou a licença expirar e comprou uma nova, vá a WooCommerce > Configurações > Envio > DPD Portugal, remova a chave antiga da extensão e grave. Depois, insira a nova chave e grave de novo.

O que acontece se não renovar a minha licença?

As guias continuam a ser emitidas automaticamente com as configurações guardadas, que ficam em modo de leitura, e a nota que a extensão acrescenta à encomenda indica que a licença expirou. Deixa de receber actualizações, incluindo correcções e actualizações de segurança, e suporte técnico.

Renovar a licença ajuda-nos a continuar a melhorar a extensão, a responder às alterações no WordPress, no WooCommerce e na API da DPD, e a fornecer-lhe suporte fiável.

Funcionamento geral

Guia de configuração inicial

Instalação e activação

Instale e active a extensão como qualquer outro plugin. Depois, vá a WooCommerce > Configurações > Envio > DPD Portugal e insira a chave de licenciamento no campo Chave de licenciamento – Extensão Emissão Automática.

Configuração

As opções da extensão estão em WooCommerce > Configurações > Envio > DPD Portugal, em Opções das guias de expedição, no campo Emissão Automática:

  • Estado da encomenda: o estado para o qual a encomenda tem de passar para a guia ser emitida, normalmente “Em processamento”. Os estados em que a encomenda ainda não está paga, ou foi cancelada ou reembolsada, aparecem assinalados como não recomendados.
  • Apenas emitir guia automaticamente se o método de envio da encomenda tem uma conta definida em “Regras por método de envio”: recomendado, para que não sejam emitidas guias DPD para encomendas enviadas de outra forma, como levantamento na loja ou outra transportadora.
  • Não enviar o email de erro quando a guia não é emitida por estes motivos: veja a pergunta Quando é que recebo um email de erro?, abaixo.
  • Emitir guias para mudanças de estado em massa: se a guia também deve ser emitida quando muda o estado de várias encomendas de uma vez, em WooCommerce > Encomendas.

Se usar a Emissão Automática, não configure Definir estado da encomenda depois da emissão para o mesmo estado que emite a guia, a não ser que saiba o que está a fazer.

Quando é emitida a guia?

A guia é emitida quando a encomenda passa para o estado escolhido no campo Emissão Automática.

A emissão é feita em segundo plano, poucos segundos depois da mudança de estado, e não no próprio pedido que muda o estado. Assim, a finalização de compra, a confirmação de pagamento enviada pelo meio de pagamento e as alterações de estado em massa não ficam à espera da DPD. Uma encomenda só é colocada na fila uma vez, mesmo que mude para o estado escolhido várias vezes antes de a guia ser emitida.

A fila usa o Action Scheduler do WooCommerce (WooCommerce > Estado > Acções agendadas, grupo woo_dpd_portugal_ai). Em sites onde o WP-Cron raramente corre, a emissão pode demorar mais do que alguns segundos.

O resultado fica sempre nas notas da encomenda: a guia emitida, ou o motivo pelo qual não foi emitida.

Posso emitir guias ao mudar o estado de várias encomendas de uma vez?

Sim, se activar Emitir guias para mudanças de estado em massa. O aviso no topo da lista de encomendas indica quantas guias vão ser emitidas nos segundos seguintes, e o resultado de cada uma fica nas notas da encomenda.

Como as guias são emitidas em segundo plano, uma de cada vez, a alteração em massa termina logo, sem esperar pela DPD. Se o seu site voltar a emitir as guias durante a mudança de estado (veja os developer hooks), uma alteração com muitas encomendas pode ultrapassar o tempo máximo de execução do servidor, porque a API da DPD demora alguns segundos por guia. Nesse caso, aumente aos poucos o número de encomendas de cada vez, em vez de aumentar o tempo máximo de execução.

Quando é que recebo um email de erro?

Quando uma guia não é emitida, a encomenda recebe uma nota e é enviado um email para o endereço de recepção das guias (ou para o email de administração do site, se não houver nenhum). Normalmente é um campo da encomenda que a DPD não aceita, como uma morada com caracteres a mais: corrija-o no ecrã da encomenda e emita a guia manualmente.

Há motivos esperados para a guia não ser emitida, para os quais pode não querer o email. Escolha-os em Não enviar o email de erro quando a guia não é emitida por estes motivos (CMD+clique ou CTRL+clique para seleccionar vários):

  • Envio não necessário para a encomenda: a encomenda só tem produtos virtuais.
  • DPD não disponível para a encomenda: o método de envio da encomenda não tem um serviço DPD definido em Regras por método de envio.
  • Já emitida: a encomenda já tem guia DPD, por exemplo porque voltou ao estado escolhido.
  • Prevenido por um filtro de desenvolvedor: código personalizado impediu a emissão.

Já emitida está seleccionado por omissão: uma encomenda que volta ao estado escolhido e já tem guia não é um erro. Os sites que já guardaram este campo mantêm a escolha que fizeram.

Esta extensão consegue garantir que todas as guias de expedição são emitidas automaticamente?

Não. Haverá sempre encomendas que precisam de ser corrigidas ou completadas no ecrã da encomenda, nomeadamente:

  • Conta de expedição: se o método de envio da encomenda não tiver uma conta definida em Regras por método de envio, a guia não é emitida e tem de a emitir no ecrã da encomenda, escolhendo a conta.
  • Número de volumes: a emissão automática é sempre feita com um volume. Para mais do que um, emita a guia no ecrã da encomenda.
  • Cobrança na entrega: só é preenchida automaticamente se o método de pagamento for o Pagamento na entrega do WooCommerce.
  • Nome, morada e outros campos: quase todos têm um limite de caracteres na DPD. Se a encomenda o ultrapassar, a emissão falha e tem de corrigir o campo e emitir a guia no ecrã da encomenda.

Que dados de utilização envia esta extensão?

A extensão segue a opção de dados de utilização anónimos do DPD Portugal para WooCommerce, no fundo do ecrã de configurações. O que envia está descrito na documentação do DPD Portugal para WooCommerce: as opções da Emissão Automática como sim ou não ou a opção escolhida, e contagens semanais das guias emitidas e não emitidas. Nunca são enviados dados pessoais nem dados de vendas.

Developer hooks disponíveis

Filter: woo_dpd_portugal_ai_issue_in_background

Devolvendo false, a guia volta a ser emitida no próprio pedido que muda o estado da encomenda, como antes da versão 2.8, em vez de em segundo plano. O filtro recebe a encomenda e se a mudança de estado foi feita em massa, por isso pode manter as alterações em massa em segundo plano e emitir as restantes de imediato, ou o contrário.
Parâmetros: bool $background = true, $order, bool $bulk

// Emitir sempre durante a mudança de estado
add_filter( 'woo_dpd_portugal_ai_issue_in_background', '__return_false' );

// Ou só nas alterações de estado em massa ficar em segundo plano
add_filter(
    'woo_dpd_portugal_ai_issue_in_background',
    function ( $background, $order, $bulk ) {
        return $bulk;
    },
    10,
    3
);

A extensão emite as guias através da action woo_dpd_portugal_issue_label do DPD Portugal para WooCommerce, pelo que os filtros desse plugin, como woo_dpd_portugal_prevent_issue_label ou woo_dpd_portugal_shipment_data, também se aplicam às guias emitidas automaticamente. Veja os developer hooks do DPD Portugal para WooCommerce.