Saltar para o conteúdo

Comércio

Integração PrestaShop

Lê encomendas pelo Webservice do PrestaShop e liga-as à faturação, aos pagamentos e ao envio, fora dos módulos da loja.

Visão geral

PrestaShop

O PrestaShop tem muitas lojas antigas em Portugal, algumas com anos de catálogo e clientes. Quem as gere conhece o problema: cada módulo de faturação ou de envio custa dinheiro, é preciso voltar a comprá-lo a cada versão nova e há sempre um que deixa de ser mantido.

A Tejobit liga-se ao Webservice do PrestaShop, a API nativa da loja, com uma chave que só dá acesso aos recursos necessários: encomendas, histórico de estados, clientes, moradas, produtos e stock. A partir daí, a faturação e o envio passam a viver fora da loja.

Como o PrestaShop não envia webhooks de origem, a ligação consulta as encomendas novas e as mudanças de estado em intervalos curtos, ou recebe um aviso de um módulo leve quando faz sentido.

Casos de uso

Para que serve

  • Loja de peças e acessórios com milhares de produtos que quer stock alinhado com o armazém
  • Loja de produtos gourmet que emite a fatura no Moloni quando o pagamento é aceite
  • Negócio que gera referências EuPago para encomendas pagas por Multibanco
  • Loja com expedição CTT que quer o seguimento no histórico da encomenda
IN

O que a ligação escuta

  • Novas encomendas e mudanças em order_histories, consultadas de forma periódica
  • Estados de encomenda específicos, como «Pagamento aceite» ou «Enviado»
  • Aviso de um módulo leve no momento da encomenda, quando instalado
  • Alterações de stock vindas de outro sistema
OUT

O que a ligação faz

  • Emitir a fatura no programa certificado com os dados da morada de faturação
  • Mudar o estado da encomenda e adicionar o número de seguimento
  • Atualizar stock_availables a partir do armazém ou de outro canal
  • Criar referências de pagamento e associá-las à encomenda
  • Guardar uma cópia das encomendas numa base de dados para relatórios

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Webservice ativo no PrestaShop e uma chave com permissões por recurso
  • Versão do PrestaShop e lista de módulos que mexem em encomendas
  • Mapa dos estados de encomenda usados na loja
  • Acesso ao programa de faturação, ao gateway e à transportadora

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • O PrestaShop não tem webhooks nativos, por isso há um pequeno intervalo entre a encomenda e a reação
  • Lojas com URL amigáveis desligadas ou servidores restritivos podem exigir ajustes para o Webservice responder
  • Módulos que guardam dados fora das tabelas padrão podem não estar acessíveis pela API

Perguntas frequentes

Antes de começar

Funciona com PrestaShop 1.7, 8 e 9?

Sim. O Webservice existe nas três versões. Há diferenças pequenas nos recursos, que são tratadas na instalação.

Tenho de instalar algum módulo?

Não é obrigatório. A ligação funciona só com o Webservice. Um módulo leve só se justifica quando é preciso reagir à encomenda no mesmo segundo.

Posso desinstalar o módulo de faturação atual?

Depois de a ligação estar a faturar e validada, sim. A transição é feita com uma data de corte, para não haver faturas em duplicado.

Ativar a integração PrestaShop?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.