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!