Overview 7 Tempo mínimo de leitura

Integrações no PaperOffice AI: o guia completo

Visão geral: qual conexão é adequada

  • Plataformas de automação como n8n, Make e Zapier: por meio da API REST com uma chave de API e por webhooks. O n8n também pode usar o servidor MCP do PaperOffice.
  • Sistemas ERP e contabilidade: conexões prontas para Holded e JTL-Wawi espelham pedidos, faturas e preços como uma fonte operacional.
  • Transportadoras: conexões prontas para GLS, DB Schenker e DHL buscam o status do envio.
  • Serviços de dados: verificação de ID de IVA, taxas de câmbio, geocodificação e mapas, no aplicativo e por meio da API.

As fontes operacionais fazem parte do Knowledge Base AI, que está disponível a partir do plano Plus. Seu agente de chat ou telefone compartilha dados do cliente, como o status de um pedido, apenas após o cliente ter provado sua identidade.

n8n, Make e Zapier

Você utiliza os blocos de construção padrão dessas ferramentas: solicitações HTTP para a API REST e webhooks.

  1. Crie uma chave na página Chaves API e insira-a no nó HTTP como um token bearer.
  2. Chame a API REST, por exemplo, para carregar ou pesquisar. Os endpoints estão na Documentação da API.
  3. Para receber resultados, abra Workflow AI → Workflow Agents, edite um agente salvo e escolha a guia Webhooks.
  4. Clique em Adicionar destino de webhook e insira o endereço do webhook do n8n, Make ou Zapier como a URL de destino.
  5. Em Send when, escolha Execução concluída com sucesso, Falha na execução ou ambos.
  • Para uma revisão humana, seu fluxo cria uma tarefa de revisão e aguarda um webhook. O evento task.completed relata a decisão.
  • Os webhooks do PaperOffice são assinados no cabeçalho X-PaperOffice-Signature. Verifique a assinatura em seu fluxo.
  • Espaços reservados como {trigger.pofid} são permitidos no caminho, na consulta e nos cabeçalhos, mas não no nome do host.
  • Os destinos de webhook em agentes de fluxo de trabalho estão disponíveis a partir do plano Professional. Cada entrega de webhook bem-sucedida é cobrada, e as chamadas de API são cobradas.

Holded

O PaperOffice lê pedidos de venda com detalhes de contato, faturas, notas creditórias e produtos do Holded e os espelha como uma fonte operacional. O espelhamento é apenas para leitura. Apenas anexos vão para o Holded, com um opt-in separado e uma chave separada com acesso de gravação.

  1. Abra Knowledge Base AI → Fontes operacionais e clique em Adicionar fonte. Escolha Holded como a conexão.
  2. Na guia Conexão, insira sua chave de API do Holded.
  3. Opcional: escolha um espaço de trabalho para os documentos e marque faturas, notas creditórias ou pedidos de venda. O arquivamento em PDF cobre apenas novos documentos após o salvamento.
  4. Opcional: ative o envio de anexos para o Holded (cobrado) e insira a chave de API do Holded com acesso de gravação.
  5. Na guia Comprovante, escolha como os clientes se identificam e salve.

Para anexar um documento, abra-o, clique em Anexar no Holded e confirme o destino. O PaperOffice encontra o destino pelo número do documento; com várias correspondências ou nenhuma, nada é enviado. Os arquivos podem ter até 10 MB, e os documentos anexados não são enviados novamente. As buscas, o arquivamento e os anexos são cobrados.

JTL-Wawi

O PaperOffice lê pedidos, notas de entrega com números de rastreamento e itens com preços do JTL-Wawi por meio da API oficial do JTL. A conexão é apenas para leitura; nada é alterado no JTL-Wawi.

  1. Abra Knowledge Base AI → Fontes operacionais, clique em Adicionar fonte e escolha JTL-Wawi como a conexão.
  2. Na guia Conexão, escolha JTL Cloud ou JTL-Wawi on-premises. Para o JTL Cloud, insira o ID do locatário; para on-premises, insira o endereço HTTPS e a chave de API do registro do aplicativo.
  3. Insira um número de pedido real para a pré-visualização e escolha a prova na guia Comprovante.
  4. Na guia Pré-visualização, clique em Visualizar sem salvar, depois salve e inicie a primeira sincronização com Sincronizar agora.

No modo on-premises, o JTL-Wawi precisa de um endereço HTTPS público na porta padrão 443; endereços internos e HTTP são bloqueados. Por favor, verifique com o suporte se o JTL Cloud já está habilitado para sua conta. Após três tentativas de busca falhas consecutivas, a fonte pausa automaticamente. As buscas são pagas.

Rastreamento de envios com GLS, DB Schenker e DHL

Quando os clientes perguntam "Onde está meu pacote?", PaperOffice busca o status do envio da GLS, DB Schenker ou DHL. É necessário ter suas próprias credenciais com a transportadora.

  1. Abra Knowledge Base AI → Fontes operacionais, clique em Adicionar fonte e escolha o tipo GLS (fase 2), Schenker (fase 2) ou DHL.
  2. Na guia Conexão, insira suas credenciais: para GLS, o endereço ShipIT, nome de usuário e senha; para DB Schenker, a chave de acesso; para DHL, a chave de API.
  3. Insira um número de rastreamento real para a pré-visualização, escolha a prova, verifique a pré-visualização e salve.
  4. Na guia Sincronizar, clique em Sincronizar agora.

As sincronizações posteriores leem os números de rastreamento existentes automaticamente. As mensagens de status para os clientes por SMS ou e-mail são enviadas apenas em uma mudança real de status e somente se você as ativar na guia Mensagens; por padrão, isso está desativado. Os SMS são pagos.

Serviços de dados: ID de IVA, taxas de câmbio, geocodificação e mapas

PaperOffice oferece quatro serviços de dados: verificação de ID de IVA contra o sistema VIES da UE, taxas de câmbio com conversão, geocodificação e mapas. Você pode testá-los no aplicativo em Data AI Playground, que está disponível em todos os planos, e usá-los em seus próprios sistemas através da API REST ou do conector MCP. As requisições de API são pagas.

  • ID de IVA: a verificação é executada contra o VIES e, através da API, também em lotes de até 100 números. As taxas de IVA para os 27 países da UE também estão disponíveis.
  • Com o AI-DMS Ultra, PaperOffice verifica automaticamente o ID de IVA do fornecedor contra o VIES para cada documento. Isso é pago.
  • Geocodificação: endereço para coordenadas, coordenadas para endereço e sugestões de endereço, através da API também em lotes de até 1.000 endereços.
  • Mapas: em Analytics AI → Mapa de Remetentes, você vê os remetentes dos seus documentos em um mapa assim que o AI-DMS os processa. Analytics AI está disponível a partir do plano Corporate.

Perguntas frequentes

  • Existe um nó n8n pronto? Você conecta o n8n através de requisições HTTP, webhooks ou seu cliente MCP.
  • O PaperOffice altera dados no Holded ou JTL-Wawi? O JTL-Wawi é apenas para leitura. No Holded, apenas anexos são enviados, e somente se você ativar isso com uma chave separada.
  • Meus clientes veem o status do pedido sem prova? Não. O agente compartilha dados do cliente apenas após a prova.
  • Quais transportadoras são suportadas? Conexões prontas existem atualmente para GLS, DB Schenker e DHL.
  • Posso verificar muitos IDs de IVA de uma vez? Sim, através da API em lotes de até 100 números.