Saltar para o conteúdo
Tejobit
Logótipo TOConline

Faturação

Integração TOConline

Documentos de venda e recibos entram no TOConline assim que a venda é paga, no mesmo sítio onde o contabilista trabalha.

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

Visão geral

TOConline

O TOConline junta faturação e contabilidade online e é muito usado por contabilistas certificados e pelas empresas que acompanham. Quando a faturação está no TOConline, cada documento fica disponível para a contabilidade sem exportações nem importações.

A API do TOConline usa OAuth com código de autorização e expõe clientes, fornecedores, produtos, serviços, documentos de venda e recibos. Um documento de venda (fatura, fatura simplificada, fatura-recibo, nota de crédito ou de débito) fica finalizado ao ser submetido; depois disso só pode ser anulado, com motivo. Os recibos podem liquidar vários documentos de uma vez e aceitam pagamentos parciais.

A Tejobit liga o TOConline às fontes de receita da empresa: loja online, gateway de pagamento ou CRM. A ligação cria o documento na série certa, regista o recibo com o meio de pagamento real (Multibanco, transferência, cartão) e envia o PDF ao cliente, para a conta corrente estar sempre certa.

Casos de uso

Para que serve

  • Empresa cujo contabilista já usa TOConline e quer a faturação da loja online lá dentro.
  • Clínica ou consultório que fatura consultas marcadas e pagas online.
  • Prestador de serviços que emite faturas a 30 dias e regista recibos quando a referência Multibanco é paga.
  • Negócio com guias de transporte que precisam de código de comunicação da AT antes da carga sair.
IN

O que a ligação escuta

  • Encomenda paga na loja online.
  • Callback do gateway a confirmar o pagamento de uma referência Multibanco ou MB WAY.
  • Proposta aceite ou negócio ganho no CRM.
  • Envio preparado no armazém, para emitir a guia de transporte.
OUT

O que a ligação faz

  • Cria ou atualiza o cliente, com morada e contacto de email.
  • Emite o documento de venda na série escolhida para aquele canal.
  • Regista o recibo contra uma ou mais faturas, com o meio de pagamento correto.
  • Envia o documento ou o recibo por email e guarda o link do PDF.
  • Pede a comunicação da guia de transporte à AT e devolve o código ao sistema logístico.

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

  • Empresa no TOConline com licença de faturação (GC) ativa.
  • Um utilizador Empresário para gerar os dados de acesso à API em Empresa, Configurações, Dados API.
  • Séries de documentos definidas para cada tipo de documento e canal de venda.
  • Para guias de transporte, credenciais de utilizador do Portal das Finanças com permissão de comunicação.

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

  • Sem licença de faturação ativa, a API só permite leituras: criar ou alterar documentos fica bloqueado.
  • Documentos submetidos ficam finalizados e não se editam; anular é definitivo e exige motivo.
  • Os tokens de acesso duram poucas horas e têm de ser renovados com frequência; a ligação trata disso, mas uma pausa longa obriga a nova autorização.
  • O link com os dados de acesso enviado ao integrador expira ao fim de 72 horas.

Perguntas frequentes

Antes de começar

O meu contabilista tem de fazer alguma coisa?

Normalmente só confirmar as séries e as taxas de IVA. O acesso à API é gerado por um utilizador Empresário da própria empresa.

Posso juntar vários pagamentos parciais à mesma fatura?

Sim. Os recibos do TOConline aceitam pagamentos parciais, e a ligação regista cada prestação à medida que é confirmada.

Quem comunica as faturas à AT?

O TOConline, como programa certificado. A ligação só cria os documentos; nunca os emite fora do TOConline.

Integrações relacionadas

Ver todas as integrações

Ativar a integração TOConline?

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