Saltar para o conteúdo
Logótipo Vendus

Faturação

Integração Vendus

Pedidos online, takeaway e vendas noutras plataformas passam a documentos na caixa certa do Vendus, com stock acertado.

Visão geral

Vendus

O Cegid Vendus é software de faturação e ponto de venda muito usado em restaurantes, cafés e lojas de rua. Corre no tablet, no computador ou no telemóvel e organiza a operação por lojas e caixas, com mesas, salas e impressoras de cozinha para a restauração.

A API do Vendus funciona com uma chave por utilizador: tudo o que a ligação emite fica atribuído a esse utilizador, como se fosse mais um operador. Cada documento é criado numa caixa concreta, e a API aceita um identificador de transação que impede documentos duplicados quando um pedido é repetido.

A Tejobit usa isto para trazer vendas de fora para dentro do Vendus: encomendas do site, pedidos de takeaway ou vendas num marketplace. O documento pode sair já em formato de impressão térmica (ESC/POS), para o talão ou o pedido aparecer na impressora da loja.

Casos de uso

Para que serve

  • Restaurante que recebe pedidos de takeaway no site e quer o talão a sair na impressora da cozinha.
  • Loja de rua com site, em que a venda online desconta o mesmo stock do balcão.
  • Cadeia com várias lojas que precisa de saber, ao fim do dia, o fecho de cada caixa numa folha partilhada.
  • Quiosque ou evento que recebe pagamentos por MB WAY e emite fatura simplificada automaticamente.
IN

O que a ligação escuta

  • Encomenda paga na loja online ou pedido confirmado na plataforma de takeaway.
  • Pagamento MB WAY ou cartão confirmado pelo gateway.
  • Fecho agendado do dia, para ler movimentos e saldos das caixas.
  • Alteração de produto ou preço no sistema que mantém o catálogo.
OUT

O que a ligação faz

  • Emite fatura simplificada, fatura-recibo ou fatura na caixa e loja definidas.
  • Devolve o documento em PDF ou em ESC/POS para impressão térmica.
  • Cria ou atualiza clientes e produtos, com referência externa para ligar os dois sistemas.
  • Emite nota de crédito associada ao documento original quando há devolução.
  • Lê saldos e movimentos de caixa para relatórios fora do Vendus.

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

  • Conta Vendus com pelo menos um utilizador ativo e a chave de API gerada em APPS, API.
  • Um utilizador dedicado à integração, para os documentos ficarem identificados.
  • Caixas e lojas configuradas, e a indicação de qual recebe as vendas de cada canal.
  • Produtos com referência igual à usada na loja online ou na plataforma de pedidos.

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

  • A data de um documento não pode ser anterior à do último documento emitido nem posterior ao dia atual, por isso vendas atrasadas não se faturam com a data antiga.
  • Depois de emitido, um documento só aceita alterações de estado, de stock ou de modo; tudo o resto exige nota de crédito.
  • Clientes com o NIF genérico 999999990 não devem ser enviados; vendas sem NIF seguem como consumidor final.
  • A API não envia avisos de vendas feitas ao balcão; para as ler noutro sistema, a ligação consulta o Vendus periodicamente.

Perguntas frequentes

Antes de começar

Dá para testar sem emitir documentos reais?

Sim. O Vendus tem um modo de testes, e a ligação é validada nesse modo antes de passar para o modo normal.

Se o site repetir o mesmo pedido, sai fatura duplicada?

Não. Cada venda leva um identificador de transação, e o Vendus recusa criar um segundo documento com o mesmo identificador.

Quem comunica as faturas à AT?

O Vendus, como programa certificado. A ligação apenas entrega a venda; o documento é emitido e assinado pelo Vendus.

Ativar a integração Vendus?

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