Conectores
E-commerce

Sienge

12min

Objetivo/Resumo

O Sienge é o Ecossistema de Tecnologia e Negócios da Indústria da Construção e do Mercado Imobiliário. Integramos a cadeia da construção de ponta a ponta e nosso compromisso é levar o setor a novos patamares de produtividade, previsibilidade e eficiência operacional.

Criando um fluxo utilizando o conector Sienge

Para utilizar o conector do Sienge, é necessário criar uma conexão .

Criando conexão Sienge

Acesse nosso passo a passo para saber como Criar Conexão.

Estes são os seguintes parâmetros de configuração da conexão que serão requisitados na hora da criação:

  • Autenticação HTTP: parâmetro usado para referenciar como será a autenticação ao servidor. Nele temos um tipo:
    • Basic: o cliente envia um cabeçalho de autenticação com seu nome de usuário e senha.

Importante

Para setar os valores de qualquer autenticação temos duas opções:

Recuperar Valor do cache/requisição

  • onde o usuário por exemplo precise fazer uma requisição para obter um Bearer Token, aqui será preciso informar o caminho onde o valor se encontra.

Usar valor fixo/template

  • onde o usuário pode passar um valor fixo.

Configurando fluxo Sienge

Crie um fluxo e arraste o conector Sienge para o canvas. OBS: Acesse nosso passo a passo para saber como Criar Fluxo Selecione o conector e na aba de Parametrização preencha os seguintes parâmetros de configuração:

  • Sub Domínio: Nome do sub domínio da empresa configurado na API.
  • Recurso: Entidade para qual será realizada a ação. No momento o conector dispões um recurso sendo ele, Títulos Contas a Pagar;\
  • Operação: ação que será realizada para o recurso selecionado.
  • Operações disponíveis para recurso Títulos Contas a Pagar:
    • Inserir Título: requer o um body com a json de integração a ser enviado para
    • integração ao Sienge; * Buscar Título: Requer o ID do Título.

Na prática

Neste tópico criaremos dois exemplos de fluxos utilizando o conector do Sienge.

Buscar Títulos Contas a Pagar

O fluxo terá apenas um passo que será responsável pela busca de um produto no Sienge.

Document image


Passo "sienge"

Este primeiro e único passo irá realizar a busca de um produto na Sienge. Assim ficará a Parametrização do passo Sienge:

Document image


Teste do fluxo

Com o passo configurado basta disparar o fluxo:

Document image


Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

Document image


Ao clicar em detalhes, temos a requisição e a resposta retornada pela Sienge:

Document image


Inserir Títulos Contas a Pagar

O fluxo terá apenas um passo que será responsável pela busca de um produto no Sienge.

Document image


Passo "sienge"

Este passo insere um título de contas a pagar no Sienge. Assim ficará a Parametrização do passo sienge:

Document image


Para tratar os dados e montar JSON da requisição que a operação espera utilizamos o Template:

JSON


Teste do fluxo

Com o passo configurado basta disparar o fluxo, é preciso enviar body com os dados que serão tratados par montagem do body a ser enviado na integração.

Segue o payload completo de exemplo utilizado para este teste:

JSON


Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

Document image


Assim será o retorno da integração com o Sienge quando houver sucesso.

Document image


Conclusão

O conector Sienge oferece uma integração eficiente para a gestão de dados no setor de construção civil. Ao longo desta documentação, apresentamos suas principais funcionalidades e configurações, demonstrando como ele pode automatizar processos e reduzir erros. Esperamos que este guia sirva como apoio para otimizar o uso do conector e alcançar maior eficiência operacional.

Updated 22 Oct 2024
Doc contributor
Doc contributor
Did this page help you?