Pular para o conteúdo
Instalação

Instalação do HyperSync no Protheus: requisitos, quem instala e onde ficam os dados

Por Cesar Ramalho (abre em nova aba), HSB Consultoria · Atualizado em

O HyperSync é instalado pela engenharia da HSB no Protheus do cliente, uma vez por ambiente, a partir do release 12.1.2410. Depois do cadastro ou do contato, a HSB fala com o seu time em até 1 dia útil e confere o ambiente antes de instalar. A execução e os dados ficam no seu Protheus, sem passar pelos servidores da HSB.

  • A instalação é feita pela HSB em qualquer plano, inclusive no Hobby.
  • Uma instalação atende várias empresas e filiais do mesmo Protheus.
  • Depois dela, cada webservice novo é só configuração.

Requisitos

Release do Protheus
12.1.2410 ou superior.
REST do Protheus
No ar. As chamadas aos endpoints se autenticam pelo REST do próprio Protheus, com token Bearer.
Licença do HyperSync
A chave da licença. A validação envia só a chave.
O resto do ambiente
Depende de como o Protheus de vocês está montado. A HSB confere antes de instalar.

Se o ambiente tem algo fora do comum, levante na conversa com a HSB antes da instalação.

Do cadastro ao primeiro endpoint

  1. 01

    Cadastro ou contato

    Pelo cadastro no site, em qualquer plano, ou pela página de contato. O cadastro entra na fila de instalação.

  2. 02

    A HSB entra em contato

    Em até 1 dia útil, para agendar a instalação com o seu time.

  3. 03

    A HSB confere o ambiente

    Release, REST do Protheus e o que mais depender da instalação de vocês, antes de instalar.

  4. 04

    A engenharia da HSB instala

    Uma vez por ambiente do Protheus.

  5. 05

    O seu time configura os endpoints

    No configurador, em 6 passos, com o sandbox para testar e gerar o cURL e a collection do Postman.

Onde ficam os dados

Os dados do Protheus não passam por servidores da HSB.

Execução e dados

Ficam no seu Protheus. Os dados do Protheus não passam por servidores da HSB.

Fila do assíncrono

O serviço de filas só organiza a ordem de execução, pelo ticket, sem dado nenhum.

Licença

A validação da licença envia só a chave.

Fora do Protheus, a HSB tem o cadastro que vocês fazem no site, com os dados de cadastro e de cobrança. Detalhes na página de Segurança.

Uma instalação, várias empresas e filiais

Uma instalação atende várias empresas e filiais do mesmo Protheus. Quem chama informa a empresa e a filial no header tenantId, e cada execução registra as duas na Auditoria.

Quantas empresas cada plano cobre:

Hobby
1 CNPJ
Pro
Até 3 CNPJs
Enterprise
Sem limite

A empresa e a filial na chamada

empresa 99, filial 01
POST /api/v1/hypersync/execute
Authorization: Bearer <token do REST do Protheus>
tenantId: 99,01

{
  "id": 41,
  "data": {
    "fields": ["A1_COD", "A1_NOME", "A1_EST"],
    "params": "A1_EST = 'SP'"
  }
}

Depois da instalação

Cada webservice novo é configuração

O endpoint configurado já é o webservice de produção: sem fonte ADVPL, sem compilar e sem patch no RPO.

ADVPL só no Customizado

O tipo Customizado chama uma função ADVPL de vocês, para regra de negócio própria. Os outros tipos são só configuração.

Cada ambiente com os seus endpoints

Homologação e produção têm endpoints próprios. Não há cópia automática de um ambiente para o outro.

Como fica um endpoint na prática: API REST no Protheus sem ADVPL, HyperSync × WSRESTFUL e a documentação.

Perguntas frequentes

Quem instala o HyperSync?+
A engenharia da HSB, no Protheus do cliente, uma vez por ambiente. Vale para qualquer plano, inclusive o Hobby.
Qual a versão mínima do Protheus?+
O release 12.1.2410. O HyperSync roda do 12.1.2410 para cima, e a HSB confere o ambiente antes de instalar.
Em quanto tempo a HSB entra em contato?+
Em até 1 dia útil depois do cadastro no site ou do contato, para agendar a instalação com o seu time.
Os dados do Protheus vão para a HSB?+
Não. A execução e os dados ficam no Protheus do cliente. O serviço de filas do assíncrono só organiza a ordem de execução, sem dado nenhum, e a validação da licença envia só a chave.
Preciso instalar em homologação e em produção?+
Sim, se for usar nos dois. A instalação é feita uma vez por ambiente, e cada ambiente do Protheus tem os seus endpoints, sem cópia automática de um para o outro.
Uma instalação atende várias empresas e filiais?+
Sim. Uma instalação atende várias empresas e filiais do mesmo Protheus. Quem chama informa empresa e filial no header tenantId, 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.

Comece pelo cadastro. A HSB fala com o seu time em até 1 dia útil.

Antes, se quiser, veja na demonstração como fica um endpoint configurado. Nenhum Protheus real é acessado.

Ver a demonstraçãoComeçar grátis