Saltar para o conteúdo
Tejobit
Logótipo KeyInvoice

Faturação

Integração KeyInvoice

Encomendas e clientes de outros sistemas passam para a KeyInvoice, que emite os documentos, com artigos e stock coerentes.

Pedir esta integração Ver todas as integrações

Visão geral

KeyInvoice

A KeyInvoice é um programa de faturação online certificado, usado por pequenas e médias empresas, distribuidores e lojas com venda online. Para além de faturas, gere encomendas de clientes, artigos com stock e condições de pagamento por cliente.

A KeyInvoice tem uma API própria, ativada por uma chave gerada nas configurações da licença, no separador API KEYINVOICE. A documentação técnica fica disponível dentro da conta, por isso a Tejobit começa sempre por validar a ligação numa conta de demonstração ou na própria licença do cliente.

A ligação trata do trabalho repetitivo entre sistemas: cria o cliente com as condições certas, garante que o artigo existe com a mesma referência e regista a encomenda ou o documento de venda. A KeyInvoice emite, numera e comunica os documentos à AT; a integração apenas a alimenta.

Casos de uso

Para que serve

  • Distribuidor que recebe encomendas de revendedores num portal B2B e quer as encomendas de cliente criadas na KeyInvoice.
  • Loja online com artigos em várias cores e tamanhos que precisa do stock da KeyInvoice refletido no site.
  • Empresa que vende packs de produtos e quer cada componente descontado do stock.
  • Equipa comercial que fecha vendas no CRM e quer a fatura emitida sem passar pelo escritório.
IN

O que a ligação escuta

  • Nova encomenda na loja online ou no portal B2B.
  • Encomenda paga ou aprovada pelo responsável comercial.
  • Consulta agendada aos artigos e ao stock da KeyInvoice.
  • Novo cliente registado na loja ou no CRM.
OUT

O que a ligação faz

  • Cria ou atualiza o cliente, com NIF, morada e condições de pagamento.
  • Cria artigos em falta usando a referência da loja como chave.
  • Regista a encomenda de cliente ou emite o documento de venda acordado.
  • Atualiza o stock da loja online a partir das quantidades da KeyInvoice.
  • Devolve ao sistema de origem o número do documento emitido.

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

  • Licença KeyInvoice com a chave de API gerada nas configurações.
  • Referências de artigo iguais nos dois sistemas, ou uma lista de correspondência.
  • Tipos de documento e séries que a integração deve usar em cada canal.
  • Indicação de qual armazém ou loja corresponde a cada canal de venda.

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 documentação da API só é acessível dentro da conta KeyInvoice; os detalhes técnicos confirmam-se no arranque do projeto.
  • Uma chave de API pertence a uma licença; empresas com várias licenças ou armazéns precisam de configurar cada uma.
  • Sem avisos enviados pela KeyInvoice, o stock e os documentos criados lá são lidos por consultas periódicas, com alguns minutos de atraso.

Perguntas frequentes

Antes de começar

A KeyInvoice já tem plugins para lojas online. Porquê uma integração à medida?

Os plugins resolvem o caso comum. A integração à medida faz sentido com portais B2B, CRM, várias lojas ou regras de documento que os plugins não cobrem.

As faturas são emitidas pela Tejobit?

Não. Os documentos são emitidos pela KeyInvoice, que é o programa certificado. A ligação só lhe envia os dados.

O stock fica sincronizado em tempo real?

Quase. A ligação lê o stock da KeyInvoice a intervalos curtos, ajustados ao volume de vendas, e atualiza a loja a seguir.

Integrações relacionadas

Ver todas as integrações

Ativar a integração KeyInvoice?

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

Fale sobre o projeto geral@tejobit.com