Pré-requisitos para utilizar a integração

Para que a integração entre o Construpoint e o Sienge Plataforma seja viável, é necessário que a empresa atenda aos seguintes requisitos:

• Contrato ativo com ambos os sistemas:

  • Sienge Plataforma

    • Módulo Engenharia > Diário de Obras habilitado.

    • Armazenamento de dados no servidor Sienge.

    • Acesso ao plano de APIs, cuja quantidade permitida pode variar conforme a demanda e volume de informações da empresa.

  • Construpoint

    • Contratação do módulo de Engenharia, com pelo menos a ferramenta de Diário de Obra habilitada.

Configuração e parametrização - Parte 1:

Os principais passos para liberação e configuração da integração são Criação e liberação do usuário API no Sienge conexão entre as plataformas e vínculo entre obras no Construpoint. Para realizar essa parametrização, siga os passos:

1 - Acesse o Sienge logado com usuário administrador e, no canto superior esquerdo da tela, seleciona a opção “Integrações”:

2 - No menu vá em “APIs” > “Usuários de APIs” > “Novo usuário de API”:

3 – Inclua uma descrição e um e-mail. O e-mail servirá para possíveis recuperações de acesso ou senha, se necessário:

4 – O nome de acesso já virá com o nome da empresa, inclua um complemento como “Construpoint” ou “Diario” e copie o dado, essa informação será necessária para realizarmos a integração:

5 – Ajuste o prazo para expiração da senha conforme preferência e salve os dados:        

6 – Aparecerá uma senha em tela, guarde essa informação, será necessária para realizarmos a integração:

7 – Seguiremos com a liberação das APIs necessárias. Para localizar os itens basta digitar na caixa de busca o Recurso e, ao encontrá-lo, selecione. Abrirá uma lista com os endpoints, selecione todos os listados a seguir:

APIs necessárias para a integração:

• Empreendimentos (Obras)

Get - /enterprises/{enterpriseId}

Get - /enterprises

• Orçamentos de obra - Transacional

Get - /building-cost-estimations/{buildingId}/sheets

•  Planejamentos de obra

           Get - /building-projects/{buildingId}/sheets/{buildingUnitId}/tasks

• Insumos do orçamento da obra

           Get - /building-cost-estimations/{building-id}/resources

• Diário de obra

Delete – /construction-daily-report/{buildingId}/{constructionDailyId}

Get – /construction-daily-report

Get – /construction-daily-report/event-type

Put - /construction-daily-report/{buildingId}/{constructionDailyId}/tasks

Post - /construction-daily-report/{buildingId}/{constructionDailyId}/tasks

Post - /construction-daily-report/{buildingId}/{constructionDailyId}/crews

Put - /construction-daily-report/{buildingId}/{constructionDailyId}/crews

Post - /construction-daily-report/{buildingId}/{constructionDailyId}/events

Put - /construction-daily-report/{buildingId}/{constructionDailyId}/events

Put - /construction-daily-report/{buildingId}/{constructionDailyId}/equipments

Post - /construction-daily-report/{buildingId}/{constructionDailyId}/equipments

Post - /construction-daily-report

Post - /construction-daily-report/{buildingId}/{constructionDailyId}/attachments

Pronto! Usuário de API criado e permissões liberadas! 

Configuração e parametrização - Parte 2:

Agora vamos seguir com a conexão entre as duas plataformas:

1 – No Construpoint, com um usuário administrador acesse Configurações > Parâmetros e localize a parte de Integrações: 

2 – Na segunda aba de Integração – Diário de obra Sienge preencha os campos de Usuário API e senha gerados nos passos anteriores e o link padrão https://api.sienge.com.br/nome-da-empresa/public/api/v1:

3 – Ative a integração e clique em Atualizar:

Com isso as plataformas já estão conectadas! 

Configuração e parametrização - Parte 3:

Seguiremos com a vinculação das obras e sincronismo de efetivos e campos personalizados/flexíveis. 

1 – Para garantir um de/para correto entre as obras, acesse o ícone em azul “Obra”:

2 – Na coluna da esquerda temos a lista de obras do Sienge, selecione a obra do Construpoint através da lista suspensa e Salve: 

3 – Clique em Sincronizar efetivos e, finalizando o carregamento clique em Sincronizar campos flexíveis:

Com isso os primeiros parâmetros já estão configuradores e as plataformas já estão conectadas, permitindo a importação dos contratos e realização do fluxo de medições.

Saiba mais! Confira neste artigo o vídeo que preparamos para você: Integração Construpoint X Sienge Plataforma: Da Parametrização ao Uso!

Artigos Relacionados: 

[CONSTRUPOINT] Integração com Sienge Plataforma no módulo de Diário de Obra 

FAQ - [CONSTRUPOINT] Diário de Obra integrado ao Sienge  

Esperamos que este artigo tenha ajudado!