Sienge
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.
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 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.