Conectores
ERP
Sienge
12 min
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 docid 1pcvn0mjbfkujhmhj86k 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 docid\ ocjtbfhi9rerkr2d6owip 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 passo "sienge" este primeiro e único passo irá realizar a busca de um produto na sienge assim ficará a parametrização do passo sienge teste do fluxo com o passo configurado basta disparar o fluxo após o disparo, o resultado do fluxo aparecerá em realtime no canvas ao clicar em detalhes, temos a requisição e a resposta retornada pela sienge inserir títulos contas a pagar o fluxo terá apenas um passo que será responsável pela busca de um produto no sienge passo "sienge" este passo insere um título de contas a pagar no sienge assim ficará a parametrização do passo sienge para tratar os dados e montar docid\ ynsaqg js hch7hpmvxlc da requisição que a operação espera utilizamos o template {{with input body }} {{$codempresa = 0 }} {{if eq empresa `00 000 000/0001 01` }}{{$codempresa = 01 }}{{end }} {{if eq empresa `00 000 000/0001 02` }}{{$codempresa = 02 }}{{end }} {{if eq empresa `00 000 000/0001 03` }}{{$codempresa = 03 }}{{end }} { "debtorid" {{$codempresa}}, "creditorid" 11117, "documentidentificationid" "ffx", "documentnumber" "{{now | tostring | substr 0 19 | replace " " "" | replace " " " " | replace " " "" }}", "issuedate" "{{default "" data | htmldate }}", "installmentsnumber" 1, "indexid" 0, "basedate" "{{default "" data | htmldate }}", "duedate" "{{default "" data | htmldate }}", "billdate" "{{default "" data | htmldate }}", "totalinvoiceamount" {{default "" valor | replace "," " "}}, "notes" "{{default "" observacao}}", "discount" 0, "budgetcategories" \[ { "costcenterid" {{$codempresa}}{{ centro custo}}, "paymentcategoriesid" "{{default "" natureza | replace " " ""}}", "percentage" 100 } ], "departmentscost" \[ { "departmentid" {{ centro custo | int64}}, "percentage" 100 } ] }{{end }} 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 { "cartao" "231024 1174", "categoria" "material de expediente", "centro custo" "04", "chave nfe" null, "cnpj despesa" null, "conta contabil" "hard coded", "data" "2024 10 14t16 19 56z", "empresa" "37 806 875/0001 95", "forma pagamento" "débito", "fornecedor" "kalunga riomar recife", "id despesa" "0866de09 2eca 49ca a01a 81e254e8ded1", "natureza" "2 11 03 12", "observacao" "teste sienge ", "projeto" null, "recibo" \[ "https //api payfyapp com br/api/transactions/receipt/15520487 1a0a 433c 8a8a e27d472aa9d6" ], "status nota" "débito", "taxas" \[], "tipo despesa" "despesa", "tipo movimentacao" "aprovado", "usuario" "074 252 704 20", "valor" "8,40" } após o disparo, o resultado do fluxo aparecerá em realtime no canvas assim será o retorno da integração com o sienge quando houver sucesso 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