Conectores
E-commerce
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 criar conexão 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 criar fluxo 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 json 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