Plugin WCFM: Impressão das encomendas na impressora de cada vendedor

WCFM — Multi-Vendor Marketplace Plugin

Encaminhe automaticamente as encomendas de cada vendedor para a sua própria impressora — sem PC, sem tablet, sem qualquer ação manual. Assim que uma encomenda é efetuada, o talão é impresso diretamente no vendedor com toda a informação necessária para a preparar: nome do cliente, referência, número de telefone, morada de entrega, tipo de encomenda e muito mais. O plugin liga o seu marketplace WCFM às suas impressoras através da API Expedy v2.


Experimente primeiro (sandbox online)

Quer ver o plugin em ação antes de o instalar no seu marketplace? Uma sandbox pronta a usar executa um ambiente completo de WordPress + WooCommerce + Expedy diretamente no seu navegador:

👉 woo.expedy.io

Vem pré-carregada com uma encomenda de demonstração, para que possa explorar o painel de definições e pré-visualizar um talão impresso de imediato — sem conta e sem instalação. A sandbox é temporária e isolada, por isso não são enviadas impressões reais; use-a para testar a interface e a pré-visualização dos talões.


Transferência

Transfira a versão mais recente a partir da página oficial de Releases. Cada versão inclui o ficheiro expedyprint.zip pronto a instalar e o respetivo registo de alterações — esse único ficheiro é tudo o que precisa.


Instalação

  1. Transfira o plugin (expedyprint.zip).
  2. Na administração do WordPress, vá a Plugins → Adicionar novo → Enviar plugin.
  3. Clique em Escolher ficheiro e selecione o ficheiro .zip transferido no passo 1.
  4. Clique em Instalar agora.
  5. Clique em Ativar quando a instalação estiver concluída.
  6. Certifique-se de que o WooCommerce e o WCFM estão instalados e ativos.
  7. Surge uma nova entrada ExpedyPRINT no menu do seu wp-admin — abra-a para configurar o plugin.

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


Obtenha as suas credenciais de API

O plugin liga-se à sua conta através de duas credenciais: um SID da API (o identificador da sua conta) e um token da API (a sua chave secreta).

  1. Ainda não tem conta? Crie a sua conta gratuita em expedy.io/signup.
  2. Inicie sessão na sua conta Expedy e abra a secção API. Contacte o suporte se não tiver acesso.
  3. Copie o seu SID da API e o seu token da API.
  4. Certifique-se de que as impressoras dos seus vendedores estão registadas na sua conta.

Mantenha o seu token da API privado — trate-o como uma palavra-passe.


Configuração

Na administração do WordPress, abra o menu ExpedyPRINT e preencha cada secção.

1. Ligação API

Definição Descrição
SID da API O identificador da sua conta, na secção API da sua conta Expedy.
Token da API A sua chave secreta, na secção API da sua conta Expedy. Deixe em branco para manter o valor já guardado.

Clique em Testar ligação. Em caso de sucesso, a lista de impressoras da sua conta é carregada automaticamente.

2. Impressora

Definição Descrição
Impressora A impressora predefinida, usada para qualquer encomenda não encaminhada para um vendedor específico. Selecione-a na lista pendente — mostra o nome, a largura do papel e o UID. Use Enviar impressão de teste para imprimir um talão de exemplo.
ID da impressora de reserva (opcional) UID de uma segunda impressora que recebe uma cópia de cada talão.
Largura do papel Tamanho do rolo: 58 mm ou 80 mm.

3. Acionamento da impressão

Definição Descrição
Imprimir o talão Estado da encomenda que aciona a impressão automática: Quando a encomenda está paga · Quando a encomenda está em processamento · Quando a encomenda está concluída.
Cópias Número de cópias a imprimir automaticamente por cada encomenda (de 1 a 3).
Fuso horário Ajusta as horas de entrega/levantamento impressas se o seu servidor estiver noutro fuso horário.

4. Cabeçalho e rodapé do talão

Definição Descrição
URL do logótipo URL HTTPS do seu logótipo. Largura máx. recomendada ~570px. Mantenha o ficheiro leve para reduzir o consumo de dados e acelerar a impressão — se a impressão for bloqueada, teste primeiro sem o logótipo.
Título Título mostrado no topo do talão.
Nome da empresa / Identificação da empresa / Morada / Código postal / Cidade / Telefone / E-mail Dados da loja impressos no rodapé do talão.
Detalhe das opções de produto Escolha Detalhes completos ou Detalhes mínimos para as opções de produto impressas em cada linha.

5. Texto do talão

Personalize cada etiqueta impressa no talão (Encomenda, Produto, Preço, Subtotal, Imposto, Total, Envio, Total a pagar, Nota do cliente…). Os valores predefinidos estão em inglês; escreva o seu próprio texto em qualquer idioma.

6. Avançado — Mapeamento multifornecedor

É aqui que se configura o encaminhamento WCFM. Consulte a secção seguinte para o procedimento completo.


Encaminhamento multifornecedor (WCFM)

É para isto que o plugin foi feito: enviar as encomendas de cada vendedor para a sua própria impressora Expedy.

  1. No WCFM, encontre o ID de cada vendedor (lista de vendedores ou loja/perfil do vendedor).
  2. Para cada vendedor, anote o UID da impressora na qual as suas encomendas devem ser impressas (visível na lista pendente Impressora ou na sua conta Expedy).
  3. Vá a ExpedyPRINT → Avançado → Mapeamento multifornecedor e introduza os pares vendor_id:printer_uid, separados por \|\|.

Exemplo: 4:DESNBXP887K\|\|7:DESHKTI4EOW

Quando uma encomenda contém os produtos de um vendedor, o seu talão é enviado automaticamente para a impressora desse vendedor. Qualquer encomenda sem vendedor associado usa a impressora predefinida definida na secção 2.


Tutorial em vídeo

Veja a configuração passo a passo: https://www.youtube.com/watch?v=IYipTBSybsw


Onde encontrar os registos de impressão

Cada tentativa de impressão (com sucesso ou falhada) é registada como nota da encomenda e em WooCommerce → Estado → Registos (origem expedyprint), para que saiba sempre o que aconteceu.


Plugins compatíveis

O plugin Expedy é compatível com as seguintes extensões WooCommerce:

  • YITH (subitens / atributos de produto)
  • WooCommerce TM Extra Product Options
  • ODT Extended / WooODT Lite (Byconsole)
  • Advanced Product Fields Pro (StudioWombat)
  • WooCommerce Local Pickup Time Select
  • WCFM — Multi Vendor Marketplace Plugin

Adicionamos regularmente novos plugins compatíveis. Se o seu não estiver listado, contacte o nosso suporte.


Crie a sua própria integração

Prefere imprimir a partir da sua própria aplicação ou ligar outra plataforma em vez de usar este plugin WooCommerce? 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 Expedy v2.