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.
O DPD Portugal para WooCommerce, da Naked Cat Plugins, permite a criação de guias de expedição e de devolução através da API da DPD Portugal (antiga Chronopost e SEUR, grupo Geopost) directamente no WooCommerce, além de solicitar recolhas, emitir o relatório de fim de dia e acompanhar o estado dos envios. Esta página reúne a documentação, as perguntas frequentes e os developer hooks disponíveis. Para preços e instalação, consulte a página do produto.
Table of Contents
Suporte
Como solicitar suporte técnico?
Se a razão pela qual necessita de suporte técnico não está mencionada nesta página, clique na ligação “Suporte técnico” junto à chave de licenciamento, no ecrã de configurações do plugin, e preencha o ticket.
Desde a introdução da nova API REST, o suporte técnico deixou de abranger a antiga API SOAP, pelo que, se ainda a está a utilizar, deve solicitar as novas credenciais à DPD e reconfigurar o plugin.
Onde posso submeter vulnerabilidades de segurança encontradas neste plugin?
Pode reportar erros de segurança identificados no código deste plugin pelo Patchstack Vulnerability Disclosure Program.
A equipa do Patchstack ajuda na verificação e na emissão do CVE, e trata de nos notificar.
Licenciamento
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 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, ou porque estava a usar uma chave temporária, vá a WooCommerce > Configurações > Envio > DPD Portugal, remova a chave antiga e grave. Depois, insira a nova chave e grave de novo.
O que acontece se não renovar a minha licença?
Se a sua licença expirar, o plugin continuará a funcionar e a maioria das funcionalidades permanecerá activa, nomeadamente a emissão de guias de expedição. No entanto, perderá acesso a:
- Actualizações de funcionalidades, incluindo correcções e novas funcionalidades
- Actualizações de segurança, que são essenciais para manter a sua loja e os dados dos seus clientes seguros
- Suporte técnico, caso precise de ajuda ou tenha algum problema
- Extensões internas, como guias de devolução, pedido de recolha, relatório de fim de dia, integração PrintNode, entre outras
- Integração com clientes de IA, uma vez que as funcionalidades expostas pela Abilities API deixam de ser registadas e desaparecem do servidor MCP
- Automatizações através de developer hooks, nomeadamente a emissão programática de guias de expedição e de devolução, os pedidos de recolha e a actualização automática do estado dos envios
- Alteração das configurações: as configurações do plugin e das extensões continuam visíveis e a funcionar como estão, mas ficam em modo de leitura. A chave de licença, o debug e os dados de utilização podem ser sempre alterados.
Se expirar a licença de uma extensão (Emissão Automática, Múltiplas Origens ou Fresh), a extensão continua a funcionar com as configurações guardadas, que ficam em modo de leitura, e deixa de receber actualizações e suporte. As guias emitidas pela Emissão Automática e as guias Fresh acrescentam uma nota à encomenda a indicar que a licença expirou.
Renovar a sua licença ajuda-nos a continuar a melhorar o plugin, a responder às alterações no WordPress, no WooCommerce e na API da DPD, e a fornecer-lhe suporte fiável. Recomendamos vivamente que a mantenha activa.
Funcionamento geral
Guia de configuração inicial
Instalação, activação e ligação à API
Instale o plugin e vá a WooCommerce > Configurações > Envio > DPD Portugal. Insira a chave de licenciamento fornecida para o activar.
Nota: Se o seu website está em Português e este ecrã de configurações ainda aparece em Inglês, deve ir a Painel > Actualizações e, no fundo da página, junto a Traduções deverá aparecer um botão para actualizar as mesmas.
Modo de teste: Caso ainda não tenha credenciais nem contas de expedição, e esteja ainda em fase de desenvolvimento, pode usar o modo de teste. Para isso terá de passar o WP_DEBUG a true no wp-config.php e no ecrã de configurações do plugin terá uma opção para activar este modo de teste.
Insira as credenciais da API REST fornecidas pela DPD (Nome de utilizador e Senha). Se ainda não as tem, solicite-as à DPD.
Extensões internas
Aqui poderá activar várias funcionalidades opcionais, como:
- Guias de devolução: caso necessite de emitir documentos para devolução de encomendas;
- Integração na lista de encomendas: para mostrar o estado de emissão da guia de expedição na lista de encomendas em backoffice;
- Solicitar recolha: permitir solicitar recolhas DPD, caso não tenha contratado a recolha diária ou regular;
- Relatório de fim de dia: permitir a emissão de relatório com todos os envios DPD do dia, caso o estafeta que faz a recolha o solicite;
- Regiões não continentais de Espanha: mostrar campos de contas de expedição, e aplicar as suas regras, para as Baleares, Canárias, e Ceuta / Melilla (se a DPD atribui contas de expedição específicas para estes territórios);
- Integração com o PrintNode: Permite a impressão automática de guias no PrintNode imediatamente após a emissão;
- Advanced Shipment Tracking for WooCommerce: adiciona a informação de seguimento DPD ao plugin Advanced Shipment Tracking for WooCommerce quando a guia é emitida. Só aparece com esse plugin activo, e está activa por omissão. Se a usar, recomendamos inactivar a opção “Número(s) de seguimento nos emails” das opções das guias de expedição;
Contas de expedição
Em “Contas de expedição” deve agora configurar os números de conta dos vários serviços que tem com a DPD. São os mesmos números de conta que usa no site ou na aplicação da DPD.
Há duas formas de definir que contas, configuradas no passo anterior, são seleccionadas por omissão ao emitir uma guia. Pode usar ambas ou apenas uma. Normalmente, as regras por método de envio são as que fazem mais sentido:
- Contas por omissão por destino: As contas por omissão são definidas de acordo com o destino geográfico da encomenda;
- Regras por método de envio: As contas por omissão são definidas conforme o método de envio escolhido no momento da finalização da encomenda;
Se utilizar ambas as opções, são aplicadas primeiro as contas por omissão e depois as regras por método de envio. Se um método de envio não tiver regra configurada, é usada a conta por omissão do destino.
Detalhes do expedidor e do contacto no expedidor
Deve, depois, preencher os dados do expedidor (a sua empresa) e da pessoa de contacto no expedidor. Podem repetir dados (por exemplo, telefone fixo igual ao móvel e não existirem ambos) e aconselhamos que todos os dados estejam preenchidos (excepto o fax, que não tem qualquer utilidade). Os detalhes do expedidor incluem a morada de origem da mercadoria, que é transmitida à guia.
Opções das guias de expedição e de devolução
Nas opções das guias de expedição pode definir o tipo de guia de expedição (“Papel normal: A5 (impressa em A4)” ou “Papel normal: A5 (impressa em A4, duas por página)” para impressoras normais, ou “Etiqueta térmica: 10x15cm” se tem a impressora para etiquetas 10×15 fornecida pela DPD), o email para onde as guias devem ser enviadas em PDF (normalmente o email da área de logística que faz o embalamento), se o número de seguimento deve ser adicionado aos emails seguintes enviados pelo WooCommerce ao cliente, e se o serviço Predict deve ser activado por omissão em todas as expedições.
Em “Definir estado da encomenda depois da emissão” pode escolher o estado para o qual a encomenda passa quando a guia de expedição é emitida, no ecrã da encomenda ou automaticamente. Os estados que não fazem sentido para uma encomenda já expedida aparecem como “Não recomendado”. Com a opção “Inactivo”, que é a opção por omissão, o estado da encomenda não é alterado.
Caso tenha activada a integração com o PrintNode, para impressão imediata de guias de expedição aquando da sua emissão, deve também inserir a Chave de API do PrintNode, gravar, e depois escolher para que impressora enviar a impressão. A configuração da impressora no PrintNode está fora do âmbito deste documento e do nosso suporte técnico, mas a Chave de API pode ser adquirida em https://api.printnode.com/app/apikeys
Se aceita devoluções dos clientes via DPD, configure também as opções das guias de devolução:
- Mesmo sem expedição: permite emitir uma guia de devolução para uma encomenda sem guia de expedição emitida;
- Tipo de guia de expedição: define o formato da guia de devolução, com as mesmas opções das guias de expedição. Se a guia for enviada para o email do cliente, para ele a imprimir, escolha papel normal;
- Enviar guia para: define para que email a DPD envia a guia de devolução em PDF: o do cliente, ou o da loja definido nas opções das guias de expedição;
- Solicitar recolha: define se o pedido de recolha na morada do cliente está seleccionado por omissão em cada guia de devolução. A escolha pode ser alterada em cada devolução, no ecrã da encomenda. Só aparece com a extensão interna “Solicitar recolha” activa e configurada.
Integração com a Rede DPD Pickup e Lockers em Portugal para WooCommerce
Se usa o plugin gratuito Rede DPD Pickup e Lockers em Portugal para WooCommerce, aparece também esta secção. Os Lockers DPD não aceitam objectos maiores do que 50x40x20cm nem pagamento na entrega, e estas opções permitem evitar esses envios:
- Esconder Lockers: remove os Lockers DPD dos pontos que o cliente pode escolher na finalização de compra;
- Não aceitar Lockers para Pagamento na entrega (experimental): avisa o cliente e impede a finalização da encomenda quando escolhe um Locker DPD e o método de pagamento “Pagamento na entrega” nativo do WooCommerce. Não tem efeito com “Esconder Lockers” activo, porque nesse caso não há Lockers para escolher.
Guia de operação diária
Emissão de guias de cada encomenda
Para emitir a guia de cada encomenda, deve aceder à edição da encomenda em WooCommerce > Encomendas e emitir a guia na caixa “Guias de expedição e devolução”.
O primeiro passo é escolher a conta de expedição, conforme o destino da encomenda. Numa situação ideal, o plugin já escolheu automaticamente esta conta com base nas configurações que fez inicialmente.
Caso tenha sido escolhido um Ponto Pickup na finalização da encomenda, com um dos plugins compatíveis, o mesmo estará pré-seleccionado, assim como a conta de serviço de pickup correspondente.
É possível adicionar um Código AT (não confundir com o código ACTUD) no caso de já terem o mesmo emitido em documento legal de transporte, deixando de ser necessário acompanhar a mercadoria desse mesmo documento.
O peso é automaticamente obtido dos produtos da encomenda e deve ter em atenção o número de volumes de cada expedição, sendo o valor 1 por omissão.
Caso seja necessário que a DPD faça uma cobrança na entrega, pode ser indicado esse valor, podendo também ser activado ou inactivado o serviço Predict, bem como inseridas observações/instruções adicionais de entrega.
Os dados de morada do cliente são obtidos da morada de envio e, se houver campos que ultrapassem o limite de caracteres autorizado pela API da DPD, ficarão marcados em vermelho para correcção manual antes da emissão da guia.
Solicitação de recolha DPD
Nos casos em que não esteja contratada a recolha diária no armazém da loja online, é possível solicitar a recolha no WooCommerce > Solicitar recolha DPD.
O plugin vai mostrar a hora limite até à qual é possível solicitar uma recolha para o mesmo dia na morada configurada como a da origem da mercadoria.
A indicação do número de volumes não tem de ser exactamente correcta, mas é importante quando existem muitos volumes a recolher, para que a DPD possa deslocar a viatura em conformidade.
Emissão de relatório de fim de dia
Nos casos em que o estafeta que faz a recolha da mercadoria solicita um relatório com todas as encomendas que vão ser transportadas, é possível emitir o mesmo em WooCommerce > Relatório de fim de dia DPD.
Basta seleccionar a data em que as guias foram emitidas, pesquisar, confirmar se todas as encomendas vão sair e, depois de estarem seleccionadas as encomendas, criar o relatório que fica disponível para descarregar em PDF.
Por que é que não posso emitir guias de várias encomendas de uma única vez (em bulk)?
Existem várias razões para isso não ser possível no plugin principal, mas as duas principais são:
- Performance: Não temos como garantir que o seu servidor aguenta fazer tantas chamadas HTTP ao webservice da DPD de uma só vez sem dar timeout.
- Confirmação de dados: muitas vezes o cliente da sua loja insere mais caracteres do que aqueles que são possíveis de colocar numa guia, ou coloca dados incorrectos, pelo que é importante uma confirmação visual dos dados antes da emissão da mesma.
Assim, não é possível termos no plugin principal esta funcionalidade, já que o potencial de falha é considerável.
Lançámos no entanto uma extensão de emissão automática (com algumas limitações) que nos permite dar suporte específico aos clientes que, de forma consciente, queiram implementar essa solução.
Estou a ter problemas de conexão e não consigo emitir a guia ou marcar recolhas. O que fazer?
O plugin liga-se à DPD por HTTPS (porto 443) nos endereços business.dpd.pt (guias, recolhas e relatórios de fim de dia), qabusiness.dpd.pt (o mesmo, no modo de teste) e wservices.dpd.pt (seguimento). Se o servidor do seu website bloqueia ligações de saída, peça ao seu fornecedor de alojamento web para permitir estes endereços.
O link de download do PDF não funciona, seja no ecrã de gestão da encomenda ou na impressão automatizada via PrintNode.
Provavelmente não tem os permalinks do seu website devidamente configurados, nomeadamente a começar com “index.php”. Aconselhamos que os reconfigure com a opção “Nome do artigo”.
Utilização avançada
É possível emitir a guia de expedição automaticamente, em vez de utilizar o formulário no ecrã da encomenda?
Sim, mas apenas com developer hooks, nomeadamente o woo_dpd_portugal_issue_label mencionado abaixo.
Como é que posso obter automaticamente o Código AT para emissão da guia?
Este plugin integra automaticamente com o nosso plugin de facturação WooCommerce para InvoiceXpress bem como o plugin do Moloni.
Em qualquer dos casos, a guia de transporte tem de ser emitida antes da guia DPD. No caso do Moloni, se está a emitir Facturas ou Facturas-recibo, aconselhamos a activação da opção de criar Documento de transporte.
É possível obter automaticamente o estado de cada objecto na DPD, em vez de ter de o fazer manualmente no ecrã da encomenda?
O plugin por si só não faz actualizações automáticas do estado dos objectos na DPD. Optámos por não implementar este mecanismo porque cada site é um site, tem estados de encomendas e comportamentos diferentes e não quisemos correr o risco de agendar tarefas de actualização de estado que pudessem eventualmente ficar a correr para sempre, para cada encomenda.
No entanto, criámos mecanismos que permitem a programadores implementar este tipo de funcionalidade, à sua responsabilidade. Os hooks são disponibilizados de acordo com a nossa política de criar plugins o mais developer friendly possível, mas recordamos que a sua utilização está fora do âmbito do suporte técnico.
Para implementar um mecanismo de consulta automática e regular do estado/seguimento dos objectos na DPD, pode ser usada, por exemplo, esta estratégia:
- Escutar o hook de emissão de guia
woo_dpd_portugal_label_issued- Agendar com o
wp_schedule_eventa consulta de estado na DPD comdo_action( 'woo_dpd_portugal_update_order_tracking_information', $order_id );tendo em atenção o intervalo que não aconselhamos ser menor que 4 horas - Escutar o hook de actualização de estado de seguimento de objectos
woo_dpd_portugal_updated_order_tracking_information- Se
$any_updated == truequer dizer que houve actualizações desde a última consulta e então podemos fazer os testes seguintes, em caso contrário não vale a pena fazer nada ou então pode-se verificar há quanto tempo se está a correr a tarefa agendada, sem obter novas actualizações, e parar o agendamento depois de alguns dias para não continuar, para sempre, a fazer consultas à DPD e talvez notificar o dono de loja que deve verificar o que se passa com estes objectos - Se
$all_final == truesignifica que todos os objectos desta encomenda estão num estado considerado final e devemos parar o agendamento de consulta de estado para não continuar, para sempre, a fazer consultas à API da DPD - Se
$all_delivered == truesignifica que todos os objectos estão entregues e podemos, por exemplo, notificar o cliente e o dono de loja, mudar o estado da encomenda, ou qualquer outra acção que faça sentido no site em causa
- Se
- Agendar com o
O mais importante é garantir, sem falhas, que todas as tarefas agendadas para cada encomenda são canceladas após algum tempo, seja porque já todos os objectos estão em estado final ou porque passou tempo demais sem obter novas actualizações.
Integração com o WordPress MCP Adapter / Clientes de IA
Como utilizar a integração deste plugin com Clientes de Inteligência Artificial?
A partir da versão 15, este plugin expõe três funcionalidades através da Abilities API do WordPress:
- Emissão de guias de expedição (incluindo definição de nº de encomenda, nº de volumes e data de envio);
- Criação do relatório de fim de dia (incluindo definição da data de envio);
- Pedido de recolha DPD (incluindo definição da data de recolha, observações e nº de volumes);
Estas funcionalidades são disponibilizadas aos clientes de IA através do WordPress MCP Adapter, o ponto de ligação normalizado do WordPress para o Model Context Protocol (MCP). O MCP próprio do WooCommerce, que era a forma anterior de lhes aceder, foi descontinuado na versão 10.9 do WooCommerce. O plugin continua a disponibilizá-las também por essa via, para quem ainda utilize versões mais antigas do WooCommerce, mas deixou de ser a forma recomendada. O acesso através do WordPress MCP Adapter requer a versão 15.8 ou superior deste plugin: em versões anteriores, as funcionalidades continuam disponíveis, mas apenas através do MCP do WooCommerce.
O WordPress MCP Adapter está disponível no repositório do WordPress.org: em Plugins > Adicionar plugin, procure “MCP Adapter”, instale-o e active-o. Não tem ecrã de definições nem necessita de qualquer configuração: ao ser activado, cria automaticamente um servidor MCP em /wp-json/mcp/mcp-adapter-default-server, onde as três funcionalidades acima ficam imediatamente disponíveis.
Falta apenas ligar o seu cliente de IA a esse servidor. Essa ligação está fora do âmbito do nosso suporte técnico, mas o processo é o mesmo de qualquer outro servidor MCP remoto e está documentado por cada fabricante. Nos nossos testes utilizamos o Claude Code, cujo procedimento está descrito em Connect Claude Code to tools via MCP, e que comunica directamente por HTTP com o endereço acima, sem qualquer intermediário. Tenha em conta que as respostas do WordPress podem ser extensas, pelo que clientes de IA com limites de resposta mais baixos, como as aplicações de conversação para computador, poderão não conseguir processá-las.
A autenticação é feita com uma Palavra-passe de Aplicação, criada em Utilizadores > Perfil, de uma conta de utilizador com permissões de gestão da loja (manage_woocommerce). Note que o WordPress só mostra essa palavra-passe uma vez, no momento em que a cria.
No Claude Code, a ligação faz-se com um único comando, com o endereço da sua loja, o seu utilizador e a Palavra-passe de Aplicação:
claude mcp add --transport http a-minha-loja https://a-sua-loja.pt/wp-json/mcp/mcp-adapter-default-server --header "Authorization: Basic $(printf 'o-seu-utilizador:xxxx xxxx xxxx xxxx xxxx xxxx' | base64 | tr -d '\n')"
A partir daí, basta usar linguagem natural para solicitar qualquer uma das três funcionalidades descritas acima, incluindo a definição dos parâmetros de cada uma delas.
Dados de utilização
Excepto se for desactivado no fundo do ecrã de configuração, este website envia à Naked Cat Plugins, uma vez por semana, dados de utilização anónimos. Os dados partilhados por todos os nossos plugins estão descritos em https://nakedcatplugins.com/terms-condition-privacy-policy/#usage-data. O DPD Portugal para WooCommerce acrescenta:
- Ligação: credenciais da API REST preenchidas, modo de teste, debug
- Funcionalidades: guias de devolução, coluna na lista de encomendas, pedidos de recolha DPD, relatório de fim de dia, regiões espanholas não continentais, impressão via PrintNode (e se há impressora escolhida), integração com o Advanced Shipment Tracking
- Contas DPD: se está definida a conta de cada serviço, o serviço por omissão para Portugal continental, ilhas, entregas em Pickup e Europa, número de métodos de envio com uma regra de serviço DPD (intervalo), número de métodos de envio com a DPD desactivada (intervalo)
- Guias: formato da guia, envio das guias por email, informação de seguimento nos emails ao cliente, pedido de notificação Predict, estado da encomenda depois de emitida a guia
- Devoluções: guias de devolução sem guia de expedição, formato da guia de devolução, destinatário da guia de devolução, pedido de recolha com as guias de devolução
- Cacifos Pickup: cacifos escondidos, cacifos escondidos para pagamento na entrega
- Integrações: Portugal DPD Pickup and Lockers network for WooCommerce, DPD / Geopost Pickup and Lockers network for WooCommerce, Invoicing with InvoiceXpress for WooCommerce, Moloni, WPML e WooCommerce Multilingual, Advanced Shipment Tracking for WooCommerce
- Personalizações por programadores: se há código que bloqueia guias, que determina que encomendas podem ter guias, ou que altera os dados da guia enviados à DPD
- Quantas vezes por semana (apenas números): número de guias de expedição emitidas (manualmente ou automaticamente), por serviço; número de guias de devolução emitidas, nacionais ou internacionais; número de pedidos de recolha (conta normal ou Fresh); número de relatórios de fim de dia; número de actualizações de seguimento; número de guias enviadas para o PrintNode; número de pedidos de assistentes de IA, por funcionalidade
- Quantas vezes cada erro aconteceu por semana (apenas códigos de erro e números, nunca mensagens): falhas na emissão de guias de expedição e de devolução, nos pedidos de recolha, nos relatórios de fim de dia, na autenticação na DPD, nas actualizações de seguimento e no PrintNode
As extensões seguem esta mesma opção e, quando instaladas, acrescentam:
- Emissão Automática: estado da encomenda que emite a guia, se só emite com um serviço DPD definido para o método de envio, se emite nas alterações de estado em massa, os motivos para os quais não é enviado email de erro; número de guias emitidas automaticamente numa alteração de estado, número de guias automáticas não emitidas, por motivo, e número de alterações de estado em massa que emitiram guias
- Múltiplas Origens: número de origens adicionais (intervalo) e se há origens fora de Portugal; número de guias de expedição a partir de uma origem adicional, de guias de devolução para uma origem adicional e de pedidos de recolha a partir de uma origem adicional. Nunca o nome, a morada ou os contactos de uma origem
- Fresh: se os dias mínimos até à data de validade foram alterados e se os pedidos de recolha estão configurados; número de recolhas Fresh pedidas automaticamente (novas ou reaproveitadas no mesmo dia), número de guias Fresh com a data de validade escolhida manualmente ou a sugerida, e falhas nas recolhas Fresh automáticas (apenas códigos de erro)
- De cada extensão: a versão e o estado da licença
As configurações são enviadas como sim ou não, a opção escolhida, ou se um valor foi alterado em relação ao valor por omissão, nunca o que foi escrito. A utilização e os erros são enviados apenas como números. Nunca são enviados dados pessoais de visitantes, clientes, donos da loja ou funcionários, nem dados de vendas ou outros dados financeiros da loja. Credenciais, chave de licença, moradas, telefones, emails, números de seguimento e observações das guias nunca são enviados.
Perguntas frequentes
Este plugin é um método de envio ou calcula os custos de portes?
Não. Este plugin emite as guias de expedição e devolução directamente nos sistemas da DPD, mas não é um método de envio e não interfere no valor dos portes.
Os portes cobrados aos clientes são configurados em WooCommerce > Configurações > Envio > Zonas de envio, com os métodos nativos do WooCommerce (Envio grátis e Taxa fixa) ou com plugins para regras mais avançadas, por exemplo por peso: Table Rate Shipping for WooCommerce (plugin oficial Woo), Weight Based Shipping for WooCommerce, Flexible Shipping e Table Rate Shipping for WooCommerce (by WebFactory), entre outros.
Tudo o que diz respeito ao valor dos portes é definido nesse método de envio, incluindo os portes grátis a partir de um valor mínimo e a forma como os cupões de desconto contam para esse mínimo. Se o valor não for o esperado, quem pode ajudar é o suporte do plugin que calcula os portes.
Os portes cobrados ao cliente não têm de ser iguais ao que a DPD cobra à loja. Aconselhamos uma estrutura de custos simples.
Esta configuração não é abrangida pelo nosso suporte técnico, mas se nos enviar uma lista completa das regras a aplicar, podemos orçamentar a implementação das mesmas.
Developer hooks disponíveis
O suporte técnico incluído não abrange a utilização destes hooks.
Emissão de guias de expedição
Action: woo_dpd_portugal_issue_label
Esta acção pode ser corrida por developers para emitir guias de expedição programaticamente, em vez de utilizarem a metabox no ecrã de encomenda. É aconselhável a utilização do filtro woo_dpd_portugal_shipment_data para definição, por exemplo, do serviço / conta de expedição a utilizar. Esta acção não verifica se a guia já foi emitida anteriormente, pelo que é prudente verificar antes de correr a mesma, por exemplo consultando o order meta woo_dpd_portugal_tracking_number.
Parâmetros: $order_id
Exemplo de utilização:
Action: woo_dpd_portugal_label_issued
Corre quando uma guia de expedição é emitida com sucesso.
Parâmetros: $order_id
Exemplo de utilização:
Action: woo_dpd_portugal_label_issued_error
Corre quando falha a emissão de uma guia de expedição.
Parâmetros: $order_id, $error_message
Filter: woo_dpd_portugal_shipment_data
Permite manipular os dados da guia de expedição antes de serem apresentados na metabox no ecrã de encomenda, ou passados para a função de emissão quando é feito de forma programática com a action woo_dpd_portugal_issue_label.
Parâmetros: $shipment_data, $order_id
Filter: woo_dpd_portugal_label_shipment_data
Permite corrigir os dados da guia de expedição imediatamente antes de ser pedida à DPD, seja qual for a forma como foi preparada (ecrã da encomenda, API REST, clientes de IA, action woo_dpd_portugal_issue_label ou extensões). É a última oportunidade para alterar os dados, por exemplo uma data que o serviço não permite. A extensão Fresh usa-o para corrigir a data de expedição.
Parâmetros: $shipment_data, $order, $programmatically
Filter: woo_dpd_portugal_label_format
Permite alterar, guia a guia, o formato da guia de expedição configurado nas definições do plugin. A extensão Múltiplas Origens usa-o para aplicar o formato de cada origem.
Parâmetros: $labels_type, $shipment_data, $order
Filter: woo_dpd_portugal_labels_email
Permite alterar, guia a guia, o endereço de email para onde a DPD envia a guia de expedição. Devolvendo um valor vazio, a guia não é enviada por email. A extensão Múltiplas Origens usa-o para aplicar o email de cada origem.
Parâmetros: $labels_email, $shipment_data, $order
Filter: woo_dpd_portugal_default_shipment_service_for_order
Permite alterar o serviço por omissão para uma determinada encomenda.
Parâmetros: $default_service, $order
Exemplo de utilização: (exemplo de criação de novo serviço com o filtro anterior e escolha por omissão com este filtro)
Filter: woo_dpd_portugal_default_shipment_service_for_order_before_shipping_rules
Idêntico ao filtro anterior, mas aplicado mais cedo: depois das regras por país ou região e antes das regras por método de envio configuradas nas definições do plugin, que ainda podem alterar o serviço. Utilize este se pretende definir o ponto de partida sobre o qual essas regras actuam, e o anterior se pretende ter a última palavra.
Parâmetros: $default_service, $order, $services
Filter: woo_dpd_portugal_rest_shipping_params
Permite manipular os dados da guia de expedição antes de serem enviados para a API REST. É preferível usar o filtro woo_dpd_portugal_shipment_data em vez deste.
Parâmetros: $params, $shipment_data, $programmatically
Filter: woo_dpd_portugal_prevent_issue_label
Devolvendo true permite evitar a emissão da guia de expedição, com base em regras definidas pelo dono da loja e com o facto do pedido de emissão ter sido feito programaticamente (com a action woo_dpd_portugal_issue_label) ou não.
Parâmetros: bool = false, $order_id, $programmatically
Filter: woo_dpd_portugal_order_status_after_label_issued
Permite alterar, encomenda a encomenda, o estado a atribuir depois de emitida a guia de expedição, sobrepondo-se ao estado configurado nas definições do plugin. O último parâmetro indica se a guia foi emitida programaticamente ou a partir do ecrã da encomenda.
Parâmetros: $order_status, $order_id, $shipment_data, $programmatically
Filter: woo_dpd_portugal_alert_shipping_label_issued
Devolvendo false permite omitir o alerta de guia emitida (válido para expedição e recolha) no ecrã da encomenda, fazendo imediatamente o reload da página.
Parâmetros: bool = true
Emissão de guias de devolução
Action: woo_dpd_portugal_issue_return
Esta acção pode ser corrida por developers para emitir guias de devolução programaticamente, em vez de utilizarem a metabox no ecrã de encomenda. É aconselhável a utilização do filtro woo_dpd_portugal_return_data para definição, por exemplo, do serviço / conta de devolução a utilizar. Esta acção não verifica se a guia já foi emitida anteriormente, pelo que é prudente verificar antes de correr a mesma, por exemplo consultando o order meta woo_dpd_portugal_return_tracking_number.
Parâmetros: $order_id
Exemplo de utilização:
Action: woo_dpd_portugal_return_issued
Corre quando é emitida uma guia de devolução, com sucesso.
Parâmetros: $order_id
Action: woo_dpd_portugal_return_issued_error
Corre quando falha a emissão de uma guia de devolução.
Parâmetros: $order_id, $error_message
Filter: woo_dpd_portugal_available_pickup_for_return
Devolvendo true mantém disponíveis, na emissão de guias de devolução, os serviços de entrega em Pickup e Loja (dpdshop, dpdhomeshop e dpdhomeshopnew), que por omissão são retirados da lista de serviços.
Parâmetros: bool = false
Filter: woo_dpd_portugal_return_data
Permite manipular os dados da guia de devolução antes de serem apresentados na metabox no ecrã de encomenda, ou passados para a função de emissão quando é feito de forma programática com a action woo_dpd_portugal_issue_return.
Parâmetros: $return_data, $order_id
Filter: woo_dpd_portugal_default_return_service_for_order
Permite alterar o serviço por omissão, de uma guia de devolução, para uma determinada encomenda.
Parâmetros: $default_service, $order, $country
Filter: woo_dpd_portugal_rest_return_params
Permite manipular os dados da guia de devolução antes de serem enviados para a API REST. É preferível usar o filtro woo_dpd_portugal_return_data em vez deste.
Parâmetros: $params, $return_data, $programmatically
Filter: woo_dpd_portugal_prevent_issue_return
Devolvendo true permite evitar a emissão da guia de devolução, com base em regras definidas pelo dono da loja e com o facto do pedido de emissão ter sido feito programaticamente (com a action woo_dpd_portugal_issue_return) ou não.
Parâmetros: bool = false, $order_id, $programmatically
Pedidos de recolhas
Action: woo_dpd_portugal_request_pickup
Esta acção pode ser corrida por developers para fazer pedidos de recolha nas instalações da loja programaticamente, em vez de usarem o ecrã de recolhas. É aconselhável a utilização do filtro woo_dpd_portugal_request_pickup_data para controlar os dados do pedido.
Parâmetros: nenhum
Action: woo_dpd_portugal_requested_pickup
Corre quando é efectuado um pedido de recolha, com sucesso.
Parâmetros: $pickup_request
Action: woo_dpd_portugal_request_pickup_error
Corre quando falha o pedido de recolha.
Parâmetros: $error
Pedidos de recolhas de devoluções
Action: woo_dpd_portugal_request_return_pickup
Esta acção pode ser corrida por developers para fazer pedidos de recolha na morada do cliente programaticamente, em vez de fazerem o pedido juntamente com a emissão da guia de devolução. É aconselhável a utilização do filtro woo_dpd_portugal_request_return_pickup_data para controlar os dados do pedido.
Parâmetros: $order_id
Hooks genéricos de guias
Filter: woo_dpd_portugal_available_services
Permite manipular a lista de serviços DPD disponíveis para configuração das contas de expedição e para escolha no momento da emissão das guias de expedição.
Parâmetros: $services
Exemplo de utilização:
Filter: woo_dpd_portugal_allow_weekend_labels
Devolvendo true permite emitir guias com data de envio ao sábado ou domingo. Por omissão, uma data de fim-de-semana é automaticamente adiada para a segunda-feira seguinte.
Parâmetros: bool = false
Filter: woo_dpd_portugal_available_for_order
Devolvendo false permite não mostrar a metabox para emissão de guias de expedição no ecrã de encomendas e prevenir a emissão das mesmas (também programaticamente). Pode ser útil para evitar que sejam emitidas guias, por exemplo, para encomendas cujo método de entrega não é via DPD Portugal.
Parâmetros: bool = true, $order_id
Informação de seguimento
Action: woo_dpd_portugal_update_order_tracking_information
Esta acção pode ser corrida por developers para fazer pedidos de informação de seguimento à DPD programaticamente.
Parâmetros: $order_id
Exemplo de utilização: ver abaixo, na action woo_dpd_portugal_updated_order_tracking_information
Action: woo_dpd_portugal_updated_order_tracking_information
Corre depois de ser obtida informação actualizada de seguimento de todos os objectos de uma encomenda na DPD
Parâmetros: $order_id, $tracking_information, $all_final, $all_delivered, $any_updated, $programmatically
Exemplo de utilização:
Action: woo_dpd_portugal_updated_object_tracking_information
Corre depois de ser obtida informação actualizada de seguimento de um objecto na DPD
Parâmetros: $order_id, $tracking_number, $tracking_information, $programmatically
Filter: woo_dpd_portugal_tracking_on_emails_html
Permite manipular o HTML (ou plain text) da informação de seguimento que é adicionado aos emails enviados após a emissão da guia de expedição.
Parâmetros: $html, $tracking_numbers, $order, $sent_to_admin, $plain_text
Filter: woo_dpd_portugal_email_tracking_hook_action e woo_dpd_portugal_email_tracking_hook_priority
Permitem alterar a posição do link com informação de seguimento que é adicionado aos emails enviados após a emissão da guia de expedição. Por omissão a action é woocommerce_email_before_order_table e a priority é 10.
Hooks técnicos
Filter: woo_dpd_portugal_webservice_timeout
Permite manipular o tempo disponível para cada chamada API à DPD. Por omissão é metade do valor default_socket_timeout definido no PHP. Se necessitar de aumentar este valor porque as chamadas dão frequentemente timeout, tem outros problemas para resolver para os quais deve contactar o seu serviço de alojamento.
Parâmetros: $seconds
Filter: woo_dpd_portugal_end_of_day_days_before
Permite alterar o número de dias anteriores considerados no ecrã do relatório de fim de dia, na procura de encomendas com guias por fechar. Por omissão são 3.
Parâmetros: $days = 3
Filter: woo_dpd_portugal_show_delete_meta
Devolvendo true mostra, no ecrã da encomenda, o botão “Remover todos os metadados DPD” dessa encomenda, que por omissão só está disponível com o WP_DEBUG activo.
Parâmetros: bool = false, $order
Existem outros hooks para uso interno que não estão documentados.
