Módulo PrestaShop: Impressão automática de encomendas (Cloud Print)

Imprima automaticamente as novas encomendas assim que são efetuadas (ou assim que o pagamento é aceite). Sem computador, tablet, smartphone, servidor de impressão local ou controlador para instalar. A sua impressora liga-se diretamente à sua loja PrestaShop através do Servidor Cloud Print da Expedy, por Wi-Fi, Ethernet ou cartão SIM 3G/4G.

Esta documentação abrange o ExpedyPRINT v2, o nosso módulo atual reconstruído sobre a API ExpedyPRINT v2. Não prestamos suporte a versões anteriores à v2.

⚠️ A sua loja PrestaShop deve ter o SSL ativado e não deve estar em modo dev ou debug. Estes modos podem bloquear os pedidos à API e impedir o envio das impressões.

Impressoras compatíveis:

Precisa de verificar a compatibilidade com outra impressora? Crie um ticket de suporte.

Requisitos

Mínimo
PrestaShop 1.6 (testado até 8.x)
PHP 7.2

Precisa também de uma conta Expedy gratuita com um SID de API, um token de API e pelo menos uma impressora cloud registada na conta.

Transferência

Transfira a versão mais recente de expedyprint.zip a partir da página de releases do GitHub:

👉 github.com/ExpedyDev/expedyprint-prestashop-addon/releases

Cada release inclui o zip pronto a instalar e o respetivo changelog. Esse único ficheiro é tudo o que precisa.

O código-fonte completo é aberto e está disponível aqui:

👉 github.com/ExpedyDev/expedyprint-prestashop-addon

Instalação

  1. Transfira expedyprint.zip a partir da última release.
  2. No back office do PrestaShop, abra Módulos → Gestor de módulos.
  3. Clique em Enviar um módulo e selecione o expedyprint.zip transferido. O módulo instala-se automaticamente.
  4. Depois de instalado, clique em Configurar.

Sem controladores, sem linha de comandos, sem software adicional.

Configuração

Abra Módulos → Gestor de módulos → ExpedyPRINT → Configurar. O painel de definições está organizado em secções claramente identificadas, e as ferramentas de ligação, impressora e pré-visualização funcionam todas sem ser preciso guardar o formulário primeiro.

1. Ligação API

Cole o seu SID de API e o seu token de API, depois clique em Testar ligação.

Definição Descrição
SID de API O seu identificador de conta, disponível na consola Expedy em API.
Token de API A sua chave secreta, disponível na mesma secção API. Trate-a como uma palavra-passe. É guardada de forma segura e apenas de escrita, pelo que nunca é apresentada novamente. Deixe o campo em branco ao guardar para manter o token já guardado.

Se o teste for bem-sucedido, a lista de impressoras é obtida da sua conta e o menu pendente de impressoras é preenchido automaticamente.

2. Impressora

Definição Descrição
Impressora Escolha a sua impressora no menu pendente carregado a partir da sua conta (mostra o nome, a largura do papel e o UID).
UID da impressora de reserva Opcional. Uma segunda impressora que recebe o mesmo talão, útil para redundância.
Largura do papel 58 mm ou 80 mm, consoante o rolo da sua impressora.

Use Enviar impressão de teste para imprimir um talão de exemplo na impressora selecionada e confirmar que está tudo configurado.

3. Acionamento da impressão

Definição Descrição
Imprimir o talão Escolha quando ocorre a impressão: assim que uma encomenda é efetuada, ou quando o estado da encomenda passa a "Pagamento aceite".
Número de cópias De 1 a 5 cópias por encomenda.
Cortar o papel após cada talão Corta automaticamente o papel no fim de cada impressão, nas impressoras que o suportam.

4. Conteúdo do talão

Escolha como os produtos e os montantes são apresentados e que blocos são impressos:

  • Apresentação do produto: nome do produto e atributos, referência do produto e atributos, apenas o nome ou apenas a referência.
  • Montantes: montantes de linha com IVA, sem IVA, ou sem montantes por linha. Os montantes são impressos sem símbolo monetário para máxima compatibilidade com impressoras térmicas.
  • Totais: imprima o total com IVA, o total sem IVA e/ou o detalhe de impostos.
  • Códigos de barras EAN-13: imprima o código de barras do produto em cada linha.
  • Número de artigos, método de pagamento, método de entrega/transportadora, nota do cliente: ative ou desative cada bloco.

5. Cabeçalho e rodapé da loja

URL do logótipo opcional (HTTPS, GIF/JPG/PNG, largura máx. 570px), título da loja, nome da empresa, morada, código postal, cidade, telefone e identificação da empresa, tudo impresso no talão.

6. Textos do talão

Cada texto impresso no talão (Encomenda, Produto, Preço, etc.) é totalmente editável, no idioma que preferir.

7. Avançado: mapeamento multiloja

Encaminhe os levantamentos em loja para uma impressora específica com o formato store_id:printer_uid||store_id:printer_uid. Por exemplo, as encomendas da sua loja de Londres podem imprimir-se automaticamente numa impressora enquanto as de Edimburgo vão para outra, totalmente automatizado, sem triagem manual.

Pré-visualização de um talão de encomenda

Na parte inferior da página de definições, a ferramenta Pré-visualizar um talão de encomenda gera o talão exato de qualquer encomenda existente. Basta introduzir o ID da encomenda e clicar em Pré-visualizar. Não é necessária impressora.

Como funciona

O módulo vigia os eventos das suas encomendas e, quando o acionamento configurado é atingido, constrói o talão e envia-o para a sua impressora através da API cloud ExpedyPRINT.

Uma encomenda é impressa uma só vez: um indicador de idempotência impede que a mesma encomenda seja impressa duas vezes. Se uma tentativa de impressão falhar, a encomenda não é marcada, podendo assim repetir na mudança de estado seguinte. Cada tentativa, com ou sem sucesso, é registada em Parâmetros avançados → Registos (Logs) (origem expedyprint).

Módulos compatíveis

O ExpedyPRINT pode ler dados de outros módulos PrestaShop para imprimir informação adicional como o tipo de levantamento ou entrega, a data e a janela horária, além das opções de produto. As integrações suportadas incluem:

  • Janelas de entrega e levantamento: prestatilldrive, prestadrive, prestatillhomedelivery, fspickupatstorecarrier, preferreddeliverytime
  • Opções de produto e campos personalizados: configurator, an_productfields, idxrcustomproduct

Esta lista não é exaustiva. Não podemos garantir uma impressão correta se a sua instalação PrestaShop estiver muito personalizada ou usar módulos que alterem as funções nativas de encomenda.

Crie a sua própria integração

Para imprimir a partir da sua própria aplicação ou de outra plataforma, use o SDK Node.js oficial e os exemplos de API:

👉 github.com/ExpedyDev/expedy-sdk-node

Mostra como autenticar-se, listar as suas impressoras e enviar trabalhos de impressão através da API ExpedyPRINT v2.

Personalização e suporte

O módulo é open source sob a licença Open Software License (OSL 3.0), por isso pode modificar livremente o código para o adaptar às suas necessidades. A Expedy já não oferece desenvolvimento à medida nem serviços de personalização.

O suporte é prestado apenas para o ExpedyPRINT v2. As versões anteriores à v2 já não são suportadas.