Perguntas frequentes sobre o HyperSync

O HyperSync é a camada de integração da HSB Consultoria que transforma o TOTVS Protheus em API REST. A HSB instala no Protheus do cliente e, a partir daí, cada webservice nasce num configurador: o endpoint configurado já é o webservice de produção, sem fonte ADVPL, sem compilar e sem patch no RPO.Ver a demonstração

Não para consultar e gravar. A consulta é um SELECT, e a gravação usa a rotina automática padrão (ExecAuto, como a MATA410) ou grava direto na tabela (RecLock). ADVPL só entra no tipo Customizado, quando o endpoint chama uma função de vocês para uma regra de negócio própria.API REST no Protheus sem ADVPL

Seis. Query SQL devolve o resultado de uma consulta na própria chamada. Banco de Dados grava o resultado de uma consulta em SQL Server, PostgreSQL ou Oracle. Arquivo gera CSV ou TXT e envia para um FTP. ExecAuto grava pela rotina automática padrão, com as validações dela. RecLock grava direto na tabela. Customizado chama uma função ADVPL de vocês.Corpo e resposta de cada tipo

Não. O HyperSync não tem conector por marca. Shopify, VTEX, Mercado Livre ou Salesforce entram como quem chama: a própria plataforma ou um middleware de vocês faz o POST autenticado no endpoint. Também não há de-para de campos: a conversão fica com quem chama, ou numa função Customizada.Protheus com e-commerce e marketplace

Não. Não há gatilho de alteração, e o HyperSync não recebe webhook de outro sistema. Quem inicia é o sistema de fora, chamando o endpoint, ou o Schedule do Protheus, nas saídas agendadas (Banco de Dados e Arquivo). Avisar outro sistema no momento em que um registro muda continua sendo ADVPL, num ponto de entrada.

Não. Ele não gera arquivo no layout bancário CNAB. O tipo Arquivo gera CSV ou TXT com separador a partir de uma consulta, e esse arquivo pode alimentar o gerador de remessa que vocês já usam.

Todos os endpoints usam a mesma rota: POST /api/v1/hypersync/execute, com o código do endpoint no campo id do corpo. A autenticação é o token Bearer do REST do próprio Protheus, e a empresa e a filial vão no header tenantId (ex.: 99,01). Na consulta, o corpo diz quais campos devolver, como no GraphQL. O sandbox gera o cURL e a collection do Postman.Documentação da chamada

A síncrona responde na mesma chamada, com o resultado. A assíncrona entra na fila e responde na hora com um ticket; o resultado sai depois em GET v1/hypersync/getresponse?ticket=<ticket> e fica na Auditoria. A escolha é feita por endpoint, no configurador. Banco de Dados e Arquivo são sempre assíncronos.Execução assíncrona

Por um webhook opcional. Quando a execução termina, o Protheus chama um conector de webhook de vocês (POST, PUT ou PATCH), sempre, só no sucesso ou só no erro, com um corpo montado com as variáveis da execução: ticket, status, endpoint, empresa e filial, quem chamou, duração e retorno. Sem webhook, o resultado sai pelo ticket.Webhook ao concluir

Dois: Pendente e Concluído. Se a rotina recusou a gravação, a mensagem de erro está no retorno. Cada execução fica na Auditoria, com quem chamou, empresa e filial, entrada, retorno e tempo.

Roda no Protheus do cliente, e a execução acontece lá. Os dados do Protheus não passam por servidores da HSB. No assíncrono, o serviço de filas só organiza a ordem de execução, sem dado nenhum, e a validação da licença envia só a chave.Segurança

Pelo modelo AAA, endpoint por endpoint. Autenticação pelo REST do próprio Protheus. Autorização pela lista de usuários do Protheus que podem chamar cada endpoint: quem está fora recebe 400 sem permissão. Auditoria de cada execução: quem chamou, empresa e filial, entrada, retorno e tempo. E a trava de SQL faz os endpoints de consulta só lerem.Segurança

Sim. Uma instalação atende várias empresas e filiais do mesmo Protheus. A empresa e a filial vão no header tenantId de cada chamada, e cada execução registra as duas. O limite do plano conta CNPJs: o Hobby cobre 1, o Pro até 3 e o Enterprise não tem limite.

Sim, pelo MCP, no plano Enterprise. A IA (Claude, ChatGPT ou outra compatível com MCP) consulta só os endpoints publicados no HyperSync, com as mesmas permissões, a mesma trava de SQL e a mesma auditoria. Ela não acessa a base do Protheus direto.MCP para IA

Protheus 12.1.2410 em diante. O REST do Protheus precisa estar no ar, porque a autenticação passa por ele. A HSB confere o ambiente antes de instalar.

A HSB, em qualquer plano, uma vez por ambiente do Protheus. Depois do cadastro ou do pedido de contato, a HSB procura vocês em até 1 dia útil para agendar com o time. Instalado, cada endpoint novo é só configuração.Como é a instalação

O Hobby é grátis: 1.000 requisições por mês, 3 endpoints e 1 CNPJ, com todos os tipos de endpoint. O Pro custa R$ 2.490 por mês no mensal ou R$ 1.990 por mês no anual, com 1 milhão de requisições por mês, endpoints ilimitados e até 3 CNPJs. O Enterprise é sob proposta, com requisições e CNPJs ilimitados, MCP para IA e 40 horas de consultoria HSB por mês.Preços

Não. A requisição não tem custo próprio: cada plano tem um limite de volume por mês. Conta como requisição cada chamada a um endpoint, síncrona ou assíncrona, inclusive as execuções agendadas de Banco de Dados e Arquivo.

Sim. O Pro tem trial de 14 dias, contados a partir do cadastro. E o Hobby é grátis para sempre, sem cartão de crédito, para validar a integração antes de subir de plano.Começar grátis

No Pro mensal: cartão recorrente, boleto ou PIX. No Pro anual: as mesmas opções ou faturamento direto com NF-e e prazo de 30 dias. No Enterprise: contrato anual com fatura em BRL ou USD.