Para aceder às configurações do plugin, siga os seguintes passos:

  1. Entre no painel de administração do WordPress.
  2. Navegue até Settings > TOConline (esta opção será adicionada automaticamente pelo plugin após a sua ativação).

No ecrã de configurações, encontrará diferentes secções que permitem personalizar a integração com o TOConline.


Acesso à API (API Access)

Esta secção é onde se configuram as credenciais que estabelecem a comunicação entre o WooCommerce e o TOConline. Estas credenciais são fornecidas pelo TOConline e são essenciais para autenticar a ligação.

Veja aqui como obter esses dados »


  • Client ID: Insira a chave única fornecida pelo TOConline. Este campo identifica a sua conta no sistema TOConline.
  • Client Secret: Introduza a chave secreta correspondente ao Client ID. Esta informação é confidencial e deve ser manuseada com cuidado.
  • OAuth Authorization URL: O URL de autorização OAuth, fornecido pelo TOConline, necessário para autenticação.
  • API Access URL: O URL base da API fornecido pelo TOConline.
  • OAuth Redirect URL: O URL de redirecionamento para o TOConline após a autenticação.
  • Atualizar Opções: Após preencher todos os campos, clique em Guardar Alterações. Será mostrado o novo botão Test API connection na secção My Company. Clique neste botão para testar a ligação. Se tudo estiver correto, serão disponibilizadas novas opções nesta secção.


Nota: Caso receba uma mensagem de erro ao clicar em Test API connection, verifique se as credenciais foram inseridas corretamente ou contacte o suporte do TOConline.


My Company (Minha Empresa)

A secção My Company permite configurar as séries de documentos fiscais e outros parâmetros relacionados com a faturação. Estas definições são utilizadas para categorizar os documentos gerados pelo TOConline.


  • Tax Exemption Reason:Escolha o motivo de isenção de IVA, se aplicável. Este campo é obrigatório se a loja vender produtos ou serviços isentos de imposto. Exemplos:
    • [M01] Artigo 16.º, n.º 6 do CIVA | Artigo 16.º, n.º 6, alíneas a) a d) do CIVA.
    • Outros motivos podem ser sincronizados automaticamente do TOConline.
  • Invoice Series (Série de Faturas): Selecione a série que será utilizada para a emissão de faturas-recibo. A lista de séries disponíveis será carregada automaticamente ao sincronizar com o TOConline.
  • Credit Note Series (Série de Notas de Crédito): Defina a série que será utilizada para notas de crédito, que são geradas em casos de devoluções ou ajustes financeiros.
  • Notice of Settlement Series (Série de Liquidações): Configure esta série para documentos de liquidação, caso aplicável ao seu negócio.
  • Atualizar Opções: Utilize o botão "Get updated options from TOConline" sempre que for necessário sincronizar alterações feitas diretamente no TOConline. Certifique-se sempre que tem guardadas as suas últimas alterações antes de utilizar este botão, ou as mesmas serão perdidas.


Exemplo Prático: Se a loja utiliza a série “2024” para faturas-recibo, “NC-2024” para notas de crédito e “LIQ-2024” para liquidações, estas séries devem ser selecionadas aqui para garantir que os documentos sejam categorizados corretamente.


Configuração da Integração com o WooCommerce

Nesta secção, pode configurar como o plugin interage com os dados de checkout e produtos do WooCommerce.

  • Tax Registration Number Field: Escolha o campo onde será capturado o número fiscal (NIF ou VAT ID) no checkout. O plugin suporta:
    • WooCommerce Checkout Block (blocos nativos do WooCommerce, introduzidos na versão 9 do mesmo).
    • Shortcode [woocommerce-checkout], caso seja esta a forma de disponibilização do checkout na loja. Antes da versão 9 do WooCommerce, esta era a única opção, e se a sua instalação precede esta versão, confirme se a sua página de checkout ainda utiliza um shortcode. Caso contrário, deverá escolher a opção anterior, WooCommerce Checkout Block.
  • Item Code Prefix: Este campo é usado para definir um prefixo que será automaticamente adicionado a todos os códigos de produtos exportados para o TOConline, de forma a evitar conflitos na exportação de produtos, caso os mesmos já existam com o mesmo código no TOConline. Apenas é necessário inserir o prefixo desejado; em cada documento de venda, o plugin irá adicionar automaticamente este prefixo a cada produto nesse documento. Note que apenas poderá escolher o prefixo antes da primeira fatura-recibo gerada através do plugin, após a qual esta opção ficará permanentemente bloqueada.
    • Exemplo:
      • Prefixo (o seu valor escolhido): TOC
      • ID do produto: 12345
      • Resultado exportado: TOC-12345
  • Guardar Alterações: Após configurar todos os campos, certifique-se que utiliza o botão Guardar Alterações.