Publicado em — Deixe um comentário

🇵🇹 Emita facturas com o seu assistente de IA: guia passo a passo para o InvoiceXpress e o WooCommerce

Issue invoices with AI in InvoiceXpress and WooCommerce

🇵🇹 Ler em português

A partir da versão 10.0 do Facturação com InvoiceXpress para WooCommerce Pro, pode pedir ao seu assistente de IA que emita os seus documentos no InvoiceXpress, em linguagem simples, exactamente como se tivesse usado as acções no ecrã da encomenda. Por exemplo:

  • “Factura a encomenda 1234.”
  • “A encomenda 1250 foi paga por transferência, emite o recibo.”
  • “Emite a guia de transporte da encomenda 1260, carregada amanhã às 9:30.”

Este guia mostra o que o assistente consegue fazer, como trata as decisões que são suas, e como o ligar à sua loja em poucos minutos.

O que pode pedir

  • Emitir uma Factura, Factura simplificada ou Factura-recibo para uma encomenda, e também o Recibo automático, se o plugin estiver configurado para o emitir logo a seguir à Factura.
  • Emitir o Recibo de uma Factura já emitida, quando o pagamento chegar.
  • Emitir um Orçamento ou uma Proforma.
  • Emitir uma Guia de transporte, com o Código AT quando o plugin está configurado para o obter de imediato.
  • Consultar uma encomenda: que documentos tem, os números e ligações, e o que falta decidir antes de emitir.
  • Preparar uma encomenda antes de emitir: o motivo de isenção de imposto, a série de documentos, a data de carga e a matrícula da guia, as observações e a referência da nota de encomenda.

Só podem ser emitidos os tipos de documento activos nas configurações do plugin, e as configurações são lidas de novo em cada pedido.

Pergunta-lhe antes de decidir

As facturas são documentos legais e não podem ser apagadas depois de emitidas. Por isso, o plugin indica ao assistente que lhe pergunte, em vez de decidir, sempre que há uma escolha a fazer:

  • Que tipo de documento, quando há mais do que um activo e não disse qual.
  • Que motivo de isenção de imposto, quando a encomenda tem linhas sem IVA. O assistente mostra sugestões e de onde vem cada uma: as configurações do plugin, e o motivo habitual para o caso (M05 para bens enviados para fora da União Europeia, ou M16 para bens vendidos a uma empresa noutro país da UE com o número de contribuinte confirmado no VIES). Nunca escolhe por si.
  • Se deve emitir mesmo assim, quando a encomenda está cancelada, falhada ou reembolsada, ou ainda não foi paga e o documento diria que foi.

Eis como fica, para uma encomenda enviada para uma empresa em Espanha:

Você: Factura a encomenda 1234.

Assistente: A encomenda 1234 não tem IVA, por isso precisa de um motivo de isenção antes de ser facturada. O motivo habitual para bens vendidos a uma empresa noutro país da UE, com o número de contribuinte confirmado no VIES, é o M16 (Artigo 14.º do RITI). A configuração da sua loja para empresas da UE também é M16. Uso este?

Você: Sim.

Assistente: Feito. Foi emitida a Factura FT 2026/123 e enviada por email ao cliente. Aqui está a ligação no InvoiceXpress.

Se estiver tudo definido, por exemplo uma encomenda paga numa loja que só emite Facturas-recibo, o documento é emitido sem qualquer pergunta.

Como ligar o seu assistente de IA, passo a passo

Precisa do Facturação com InvoiceXpress para WooCommerce Pro 10.0 ou superior com a licença activa, do WordPress 6.9 ou superior, e de um assistente de IA compatível com MCP (Model Context Protocol), o padrão aberto que permite a assistentes como o Claude e o Cursor usar ferramentas noutros sistemas.

  1. Instale o plugin MCP Adapter. Em Plugins > Adicionar plugin, procure MCP Adapter, instale-o e active-o. É o plugin oficial do WordPress que torna a sua loja acessível por MCP.
  2. Crie uma senha de aplicação. Em Utilizadores > Perfil, para um utilizador que possa gerir o WooCommerce (Administrador ou Gestor de loja), adicione uma senha de aplicação (por exemplo, “Assistente de IA”) e copie-a. O assistente actua como esse utilizador.
  3. Ligue o seu assistente de IA à sua loja. O MCP Adapter cria um servidor MCP em https://a-sua-loja.pt/wp-json/mcp/mcp-adapter-default-server, e o assistente liga-se directamente a ele por HTTP, autenticando-se com o utilizador e a senha de aplicação. No Claude Code, execute isto num terminal, com o seu endereço, utilizador e senha de aplicação:
claude mcp add --transport http a-minha-loja https://a-sua-loja.pt/wp-json/mcp/mcp-adapter-default-server --header "Authorization: Basic $(printf 'o-seu-utilizador:xxxx xxxx xxxx xxxx xxxx xxxx' | base64 | tr -d '\n')"Linguagem do código: JavaScript (javascript)

Outros assistentes que permitem adicionar um servidor MCP remoto com um cabeçalho personalizado, como o Cursor, usam o mesmo endereço e o mesmo cabeçalho Authorization. As respostas do WordPress podem ser extensas, pelo que as aplicações de conversação para computador, com limites de resposta mais baixos, podem não as conseguir processar.

  1. Comece com uma pergunta que não altera nada. Pergunte “Que documentos InvoiceXpress tem a encomenda 1234?”. O assistente lê a encomenda e responde sem emitir nada, o que confirma que a ligação funciona.
  2. Emita o primeiro documento. Peça “Factura a encomenda 1234” e responda às perguntas, se houver.

Mantenha a senha de aplicação privada e revogue-a em Utilizadores > Perfil se deixar de a usar. A configuração de cada assistente de IA está fora do âmbito do nosso suporte técnico, mas a documentação tem os detalhes do lado do plugin.

Da factura à etiqueta DPD numa só conversa

Se também usa o DPD Portugal para WooCommerce, o mesmo assistente termina o trabalho: “Factura a encomenda 1234, emite a guia de transporte e cria a etiqueta DPD.” A etiqueta leva o Código AT da Guia de transporte, lido directamente do InvoiceXpress.

O que não faz

  • Anular documentos ou emitir Guias de devolução: previsto para uma próxima versão.
  • Emitir Notas de crédito avulsas: o plugin emite-as quando reembolsa a encomenda no WooCommerce, para que coincidam sempre com o reembolso.
  • Alterar o número de contribuinte do cliente: vem do cliente na finalização de compra.

Disponível hoje

A versão 10.0 já está disponível como actualização automática, sem custo adicional para todos os clientes com licença activa. Se ainda não tem o plugin, pode adquiri-lo em nakedcatplugins.com e ver todas as funcionalidades em invoicewoo.com.

Dúvidas ou ideias para o que o assistente deve fazer a seguir? Deixe um comentário ou contacte-nos.

Deixe um comentário