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
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
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
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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.
Integrações relacionadas
Ver todas as integrações- Faturação
Moloni
Cada venda paga noutro sistema passa a fatura no Moloni, na série certa e com o cliente identificado pelo NIF.
Desde 5 € /mês + IVA
Ver integração - Pagamentos
EuPago
Pede pagamentos MB WAY, Multibanco e cartão à API da EuPago e usa o webhook de confirmação para avançar encomendas e faturas.
Desde 5 € /mês + IVA
Ver integração - Logística
CTT Expresso
Cria os envios CTT Expresso a partir das encomendas, imprime a etiqueta e mantém o cliente a par da entrega.
Desde 30 € /mês + IVA
Ver integração
Ativar a integração PrestaShop?
Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.