{ "info": { "name": "Sienge — mcp.ai", "description": "REST API for the Sienge MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.mcp.ai/api/sienge", "type": "string" }, { "key": "apiKey", "value": "sk_live_...", "type": "string" } ], "item": [ { "name": "sienge_bulk", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bulk", "host": [ "{{baseUrl}}" ], "path": [ "bulk" ] }, "description": "Consulta em MASSA do Sienge (bulk-data): o período inteiro numa chamada, sem paginação. Para sincronizar ou analisar volume grande.", "body": { "mode": "raw", "raw": "{\n \"recurso\": \"\",\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"tipo_data\": \"\",\n \"empresa_id\": 0,\n \"centros_custo_ids\": \"\",\n \"obra_id\": 0,\n \"unidade_construtiva_id\": 0,\n \"cliente_id\": 0,\n \"indexador_correcao_id\": 0,\n \"data_correcao\": \"\",\n \"data_base\": \"\",\n \"max_linhas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_centros_custo", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/centros/custo", "host": [ "{{baseUrl}}" ], "path": [ "centros", "custo" ] }, "description": "Centros de custo (id, nome, empresa, CNPJ). O id é o costCenterId dos filtros financeiros e do custo orçado x realizado.", "body": { "mode": "raw", "raw": "{\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_clientes", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/clientes", "host": [ "{{baseUrl}}" ], "path": [ "clientes" ] }, "description": "Clientes (compradores) cadastrados: id, tipo de pessoa, nome, CPF/CNPJ. O id é o customerId de sienge_contas_receber. Contato (e-mail, telefones, endereços) só com incluir_contato=true.", "body": { "mode": "raw", "raw": "{\n \"cpf\": \"\",\n \"cnpj\": \"\",\n \"obra_id\": 0,\n \"so_ativos\": false,\n \"alterados_desde\": \"\",\n \"incluir_contato\": false,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contas_pagar", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contas/pagar", "host": [ "{{baseUrl}}" ], "path": [ "contas", "pagar" ] }, "description": "Títulos de contas a pagar por período da data de EMISSÃO (ou da data de ALTERAÇÃO com por_alteracao=true, para sincronização incremental): credor, empresa (debtorId), documento, nº de parcelas, valor ", "body": { "mode": "raw", "raw": "{\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"por_alteracao\": false,\n \"empresa_id\": 0,\n \"credor_id\": 0,\n \"centro_custo_id\": 0,\n \"numero_documento\": \"\",\n \"status\": \"\",\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"empresa_ids\": \"\",\n \"credor_ids\": \"\",\n \"centro_custo_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contas_pagar_parcelas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contas/pagar/parcelas", "host": [ "{{baseUrl}}" ], "path": [ "contas", "pagar", "parcelas" ] }, "description": "Parcelas de títulos de contas a pagar: número, vencimento, data-base, valor, forma de pagamento, situação e envio ao banco. Com incluir_apropriacao_obra=true traz também a apropriação do título nas ob", "body": { "mode": "raw", "raw": "{\n \"titulo_ids\": \"\",\n \"incluir_apropriacao_obra\": false,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contas_receber", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contas/receber", "host": [ "{{baseUrl}}" ], "path": [ "contas", "receber" ] }, "description": "Títulos de contas a receber de UM cliente (o Sienge exige o cliente; o id vem de sienge_clientes): documento, emissão, valor, empresa, inadimplente, sub judice, quitação e unidade. Visão do período in", "body": { "mode": "raw", "raw": "{\n \"cliente_id\": 0,\n \"empresa_id\": 0,\n \"centro_custo_id\": 0,\n \"quitados\": false,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"cliente_ids\": \"\",\n \"empresa_ids\": \"\",\n \"centro_custo_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contas_receber_parcelas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contas/receber/parcelas", "host": [ "{{baseUrl}}" ], "path": [ "contas", "receber", "parcelas" ] }, "description": "Parcelas de títulos de contas a receber: vencimento, saldo devedor, tipo de condição, portador e se o boleto foi gerado. 1 requisição por título.", "body": { "mode": "raw", "raw": "{\n \"titulo_ids\": \"\",\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contrato_detalhe", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contrato/detalhe", "host": [ "{{baseUrl}}" ], "path": [ "contrato", "detalhe" ] }, "description": "Detalhe de contratos de suprimento: saldos de mão de obra e material, caução, e as obras com unidades construtivas do contrato. Com obra_id + unidade_construtiva_id no item, traz também os itens do co", "body": { "mode": "raw", "raw": "{\n \"contratos\": \"\",\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_contratos", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/contratos", "host": [ "{{baseUrl}}" ], "path": [ "contratos" ] }, "description": "Contratos de suprimento (empreitadas, fornecedores) por período da data do contrato: documento + número do contrato (a chave), fornecedor, empresa, status, aprovação, autorização, vigência, objeto, va", "body": { "mode": "raw", "raw": "{\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"empresa_id\": 0,\n \"obra_id\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"empresa_ids\": \"\",\n \"obra_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_credores", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/credores", "host": [ "{{baseUrl}}" ], "path": [ "credores" ] }, "description": "Credores (fornecedores, corretores, funcionários) com CPF/CNPJ, situação, endereço, telefones e contatos. Busque por nome (trecho), CPF ou CNPJ.", "body": { "mode": "raw", "raw": "{\n \"nome\": \"\",\n \"cpf\": \"\",\n \"cnpjs\": \"\",\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_custo_orcado_realizado", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/custo/orcado/realizado", "host": [ "{{baseUrl}}" ], "path": [ "custo", "orcado", "realizado" ] }, "description": "Mapa Imobiliário por empreendimento no período: custo orçado x custo incorrido (acumulado, do mês, a incorrer), VGV e POC, receita apropriada, recebimentos, custo apropriado (estoque, garantia, comiss", "body": { "mode": "raw", "raw": "{\n \"centros_custo_ids\": \"\",\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_empresas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/empresas", "host": [ "{{baseUrl}}" ], "path": [ "empresas" ] }, "description": "Empresas cadastradas no Sienge (id, razão social, nome fantasia, CNPJ). O id é o companyId/debtorId usado nos filtros das outras tools.", "body": { "mode": "raw", "raw": "{\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_indexadores", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/indexadores", "host": [ "{{baseUrl}}" ], "path": [ "indexadores" ] }, "description": "Indexadores de correção (INCC, IGP-M, CUB…) com o último valor. O id é o indexador_correcao_id de sienge_bulk (contas a pagar exige um).", "body": { "mode": "raw", "raw": "{\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_list_accounts", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/accounts", "host": [ "{{baseUrl}}" ], "path": [ "list", "accounts" ] }, "description": "Lista as conexões Sienge (id, apelido, subdomínio do cliente, client_ref quando veio de Connect Session). Não chama a API.", "body": { "mode": "raw", "raw": "{\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_medicao_itens", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/medicao/itens", "host": [ "{{baseUrl}}" ], "path": [ "medicao", "itens" ] }, "description": "Uma medição de contrato por inteiro: totais (material, mão de obra, descontos, impostos, caução, líquido), os itens medidos (quantidade, acumulado, %, valores e apropriação na planilha da obra) e, com", "body": { "mode": "raw", "raw": "{\n \"documento_id\": \"\",\n \"numero_contrato\": \"\",\n \"obra_id\": 0,\n \"medicao_numero\": 0,\n \"incluir_titulos\": false,\n \"account\": \"\",\n \"documento_ids\": \"\",\n \"obra_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_medicoes_contratos", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/medicoes/contratos", "host": [ "{{baseUrl}}" ], "path": [ "medicoes", "contratos" ] }, "description": "Medições de contratos de suprimento: contrato, obra, número, data e vencimento, responsável, aprovação, autorização, liberação, valores de mão de obra e material, líquido e a liberar. Filtre por contr", "body": { "mode": "raw", "raw": "{\n \"documento_id\": \"\",\n \"numero_contrato\": \"\",\n \"obra_id\": 0,\n \"fornecedor_id\": 0,\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"documento_ids\": \"\",\n \"obra_ids\": \"\",\n \"fornecedor_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_obra_detalhe", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/obra/detalhe", "host": [ "{{baseUrl}}" ], "path": [ "obra", "detalhe" ] }, "description": "Detalhe de obras/empreendimentos por id: endereço, status do orçamento e da obra, nível de apropriação, dados da construção (responsável técnico, pavimentos, área, início e fim), dados de venda e cent", "body": { "mode": "raw", "raw": "{\n \"obra_ids\": \"\",\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_obras", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/obras", "host": [ "{{baseUrl}}" ], "path": [ "obras" ] }, "description": "Empreendimentos e obras (no Sienge a obra é um \"enterprise\": o id dele é o buildingId de orçamento, planejamento, contratos e medições). Traz id, nome, nome comercial, CNPJ, tipo, empresa, tabela de c", "body": { "mode": "raw", "raw": "{\n \"empresa_id\": 0,\n \"tipo\": 0,\n \"so_habilitadas_integracao\": false,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"empresa_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_orcamento_insumos", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/orcamento/insumos", "host": [ "{{baseUrl}}" ], "path": [ "orcamento", "insumos" ] }, "description": "Insumos orçados da obra: item da planilha (WBS), código do insumo, descrição, unidade, quantidade, preço unitário e total, data do preço, detalhe e marca. Filtre por unidade construtiva.", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"unidade_construtiva_id\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\",\n \"unidade_construtiva_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_orcamento_itens", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/orcamento/itens", "host": [ "{{baseUrl}}" ], "path": [ "orcamento", "itens" ] }, "description": "Itens de uma planilha do orçamento atual (EAP): código WBS, descrição, unidade, quantidade, preço unitário e total, e preço por categoria (material, mão de obra…). Para todas as obras e versões de uma", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"unidade_construtiva_id\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\",\n \"unidade_construtiva_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_orcamento_planilhas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/orcamento/planilhas", "host": [ "{{baseUrl}}" ], "path": [ "orcamento", "planilhas" ] }, "description": "Planilhas da versão atual do orçamento de uma obra: uma por unidade construtiva (building unit). O id da planilha é o unidade_construtiva_id de sienge_orcamento_itens, sienge_orcamento_insumos e sieng", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_planejamento_medicoes", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/planejamento/medicoes", "host": [ "{{baseUrl}}" ], "path": [ "planejamento", "medicoes" ] }, "description": "Medições de avanço físico do planejamento (progress logs): número da medição, data, responsável, consistência e aprovação.", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"unidade_construtiva_id\": 0,\n \"data_inicio\": \"\",\n \"data_fim\": \"\",\n \"medicao_numero\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\",\n \"unidade_construtiva_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_planejamento_tarefas", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/planejamento/tarefas", "host": [ "{{baseUrl}}" ], "path": [ "planejamento", "tarefas" ] }, "description": "Cronograma (versão atual do planejamento) de uma planilha da obra: tarefas com nível, início e fim, duração, quantidade, valor, execução planejada mês a mês (% planejado) e itens de orçamento ligados.", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"unidade_construtiva_id\": 0,\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\",\n \"unidade_construtiva_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "sienge_unidades", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/unidades", "host": [ "{{baseUrl}}" ], "path": [ "unidades" ] }, "description": "Unidades dos empreendimentos (estoque de imóveis): nome, tipo, situação comercial, áreas privativa/comum/terreno, fração ideal, andar, previsão de entrega e avaliação.", "body": { "mode": "raw", "raw": "{\n \"obra_id\": 0,\n \"situacao_comercial\": \"\",\n \"nome\": \"\",\n \"limite\": 0,\n \"offset\": 0,\n \"max_paginas\": 0,\n \"account\": \"\",\n \"obra_ids\": \"\"\n}", "options": { "raw": { "language": "json" } } } } } ] }