Base de conhecimento

1000 perguntas frequentes, 500 tutoriais e vídeos explicativos. Aqui, você encontra apenas soluções!

Como resolver um erro de PDF no PrestaShop 9.x

Atualização 31/08/2026

Este guia tem como objetivo solucionar um problema no CMS Prestashop v9.x relacionado à geração de faturas em PDF a partir do painel de administração (Back Office), especialmente quando o idioma francês é utilizado.

 

O problema

Ao tentar visualizar ou baixar uma fatura em PDF para um pedido em francês, o PrestaShop (na versão 9.x) retorna um Erro 500. Esta falha está relacionada a uma incompatibilidade entre a biblioteca de geração de PDF (TCPDF) que utiliza a fonte padrão (helvetica) e as configurações de hospedagem.

 

Definir uma fonte compatível

A solução consiste em forçar o uso da fonte freesans, que é mais compatível, através de um arquivo de configuração personalizado.

É altamente recomendável criar um arquivo defines_custom.inc.php. Este método é o mais seguro, pois garante que a correção não será perdida durante as atualizações do núcleo do PrestaShop.

Para isso:

  1. Acesse sua instalação do PrestaShop 9.x via FTP ou o Gerenciador de arquivos.
  2. Navegue até o diretório /config/.
  3. Crie um novo arquivo chamado defines_custom.inc.php.
  4. Edite o ficheiro defines_custom.inc.php e adicione o seguinte conteúdo:

    <?php
    /**
     * Avoid error PDF, force font 'freesans'.
     */
    define('PDF_FONT_NAME_MAIN', 'freesans');
  5. Guarde o ficheiro e teste a geração de uma fatura em francês.

Esta seção de perguntas frequentes foi útil?