--- title: Sienge slug: sienge docTags: createdAt: 2024-10-21T18:14:32.788Z --- ## 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 :::hint{type="info"} 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. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/Zntjeh2hlSjYeiPKeoaxA_1.png" size="50" width="480" height="270" position="center" darkWidth="480" darkHeight="270" showCaption="false"} **Passo "sienge"** Este primeiro e único passo irá realizar a busca de um produto na Sienge. Assim ficará a Parametrização do passo Sienge: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/KHotkMPkwiALlsPoIHZf9_image-3.png" size="50" width="425" height="484" position="center" showCaption="false"} **Teste do fluxo** Com o passo configurado basta disparar o fluxo: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/v5F7LNMgqEUai9O-Md0R6_image-4.png" size="50" width="802" height="284" position="center" showCaption="false"} Após o disparo, o resultado do fluxo aparecerá em realtime no canvas: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/YnH61tvdve606q1NUcJn9_image-5.png" size="70" width="1857" height="450" position="center" showCaption="false"} Ao clicar em detalhes, temos a requisição e a resposta retornada pela Sienge: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/r4mVsvU75d2ps_orVC_qp_image-6.png) ### Inserir Títulos Contas a Pagar O fluxo terá apenas um passo que será responsável pela busca de um produto no Sienge. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/Zntjeh2hlSjYeiPKeoaxA_1.png" size="50" width="480" height="270" position="center" darkWidth="480" darkHeight="270" showCaption="false"} **Passo "sienge"** Este passo insere um título de contas a pagar no Sienge. Assim ficará a Parametrização do passo sienge: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/TsYNWglmLsnVYxZWQamIS_image-7.png" size="50" width="425" height="721" position="center" showCaption="false"} Para tratar os dados e montar [JSON](docId\:ynSAQG-jS_hch7HPMvXlc) da requisição que a operação espera utilizamos o Template: ```json {{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: ```json { "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: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/VFtBxsHpbN4IzH_mSu2Yq_image-8.png" size="50" width="1857" height="450" position="center" showCaption="false"} Assim será o retorno da integração com o Sienge quando houver sucesso. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/0l8oVScc3nc12yLZysMfl_image-9.png" size="50" width="1414" height="711" position="center" showCaption="false"} ### 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.