Licitar Digital

conector licitar digital visão geral o conector licitar digital permite que fluxos da fluid consumam e disparem operações nos serviços públicos e privados expostos pelas apis do licitar digital recursos disponíveis processos de compra pública gestão completa de processos licitatórios webhooks de chat integração de comunicação em tempo real nfse gerenciamento de notas fiscais de serviço eletrônicas faturas controle de faturamento e pagamentos organização gerenciamento de unidades organizacionais integrações atualizações e sincronização de dados documentação oficial da api https //licitardigital docs apiary io/#reference/0/processos https //licitarpartner docs apiary io/ configuração criando uma conexão para configurar o conector, você precisará fornecer as seguintes credenciais campo tipo obrigatório descrição user string sim usuário de autenticação token string (secreto) sim token de acesso à api ambiente enum sim ambiente de execução ( sandbox ou produção ) ⚠️ segurança o token deve ser protegido e nunca exposto em logs ou repositórios públicos configurando um fluxo ao configurar um passo com o conector licitar digital selecione o resource (recurso da api) escolha a operation (operação desejada) preencha os parâmetros necessários parâmetros comuns offset paginação posição inicial dos resultados limit paginação quantidade máxima de registros headers string json com cabeçalhos http adicionais recursos e operações 1\ webhook chat gerenciamento de webhooks para integração de chat criar webhook registra um novo webhook para receber eventos de chat parâmetros campo tipo obrigatório descrição method string sim método http (get, post, etc ) url string sim url de destino do webhook headers string sim cabeçalhos http em formato json incluir webhook adiciona webhook ao processo sem campos adicionais requeridos listar webhooks lista webhooks associados a um processo parâmetros campo tipo obrigatório descrição processid string sim id do processo offset string não paginação posição inicial limit string não paginação limite de registros excluir webhook remove um webhook existente parâmetros campo tipo obrigatório processid string sim 2\ nfse (notas fiscais de serviço eletrônicas) gerenciamento de notas fiscais eletrônicas listar faturas pendentes retorna faturas que aguardam processamento parâmetros campo tipo obrigatório offset string não limit string não atualizar status da fatura atualiza informações e status de uma fatura nfse campo obrigatório updatestatus opções de updatestatus dinamicfields atualização com campos dinâmicos completos campo tipo obrigatório descrição id string sim id da fatura nfsestatus string sim status da nfse nfseid string não identificador da nfse nfsepdfurl string não url do pdf da nfse nfsexmlurl string não url do xml da nfse nfsenumber string não número da nfse template atualização via template pré configurado (sem campos adicionais) 3\ processos gerenciamento de processos licitatórios obter dados do processo recupera informações detalhadas de um processo parâmetros campo tipo obrigatório descrição headers string sim cabeçalhos http em json ambiente object sim ambiente de execução unitid string sim id da unidade organizacional id string não id interno do processo externalid string não id externo do processo cadastrar processo cria um novo processo no sistema parâmetros campo tipo obrigatório headers string sim ambiente object sim atualizar processo atualiza dados de um processo existente parâmetros mesmos campos da operação "obter dados do processo" 4\ faturas controle de faturamento e pagamentos obter faturas pendentes lista faturas aguardando processamento (sem parâmetros adicionais) atualizar faturas atualiza informações de faturamento campo obrigatório updatestatus opções de updatestatus dinamicfields campo tipo obrigatório descrição id string sim id da fatura price string sim valor da fatura bankslipurl string sim url do boleto bancário invoiceurl string sim url da nota fiscal description string sim descrição da fatura invoicenumber string sim número da nota fiscal trasactionid string sim id da transação template atualização via template (sem campos adicionais) 5\ organização gestão de unidades organizacionais obter organização recupera dados de uma organização parâmetros campo tipo obrigatório descrição organizationunitid string não id da unidade organizacional integration string não tipo de integração 6\ gerenciamento operações de manutenção e atualização de integrações atualizar processo atualiza diferentes aspectos de um processo campo obrigatório update type opções de update type process atualização de dados do processo campo tipo obrigatório id string sim pncplink string sim lotitems atualização de itens de lote (mesmos campos de process ) logs registro de logs de integração campo tipo obrigatório descrição processid string sim id do processo typeintegration string sim tipo de integração status string sim status da operação statustext string sim texto descritivo do status responsemessage string sim mensagem de resposta exemplo prático fluxo atualização de processo via webhook chat este exemplo demonstra como processar webhooks do licitar digital e atualizar dados de processos em tempo real cenário receber o id do processo por evento, verificar se há dados de webhook chat a serem atualizados, e caso haja, processar e retornar ao requisitante o status da operação estrutura do fluxo \[trigger] → \[listar] → \[verifica] → \[loop] → \[inscrição] → \[headers] → \[envia chat] passos do fluxo trigger (evento) recebe o processid via webhook externo listar (webhook chat) lista webhooks associados ao processo verifica valida se existem webhooks pendentes de processamento loop itera sobre cada webhook encontrado (initial → next → exit) inscrição prepara dados de inscrição headers formata cabeçalhos http necessários envia chat dispara o conector para atualizar o webhook configuração do passo "listar" resource webhook chat operation listar parâmetros campo valor descrição id {{ input body processid}} id do processo recebido no evento offset 0 início da paginação limit 100 máximo de 100 registros por consulta payload de entrada (webhook recebido) { "data" \[ { "headers" \[ "authorization basic bgljaxrhwhhjawlkagfxdpdgdfs0jr3vkyqv0bmwqgo1sl9qyuxmwefy" ], "id" "2d371054 e7c3 44b9 bac6 be95c877c43c", "method" "post", "processid" 83393, "url" "https //webhook effecti com br/licitar digital/" }, { "headers" \[ "authorization basic m2myntblmtutnzzhni00ywzmltlmyjitytqzy2uxmjc1mjmxomixmtdginmmtngu1my0 " ], "id" "2fe4145f 70bb 493c bacb ba33210632fa", "method" "post", "processid" 83393, "url" "https //app elicitacao com br/radarapi/webhook/licitar digital" } ] } resposta esperada após o processamento completo do fluxo, o sistema retorna o status da atualização de cada webhook processado, confirmando ✅ webhooks identificados e processados com sucesso ✅ headers de autenticação validados ✅ requisições disparadas para as urls configuradas ✅ status de integração atualizado boas práticas tratamento de erros implemente validação no passo "verifica" para evitar loops infinitos configure timeout adequado para requisições http registre logs de cada iteração do loop para auditoria performance ajuste o limit conforme o volume esperado de webhooks utilize paginação ( offset ) para grandes volumes de dados considere processamento assíncrono para múltiplos webhooks segurança valide o token de autorização antes de processar utilize variáveis de ambiente para armazenar credenciais sensíveis implemente retry logic para falhas temporárias de rede casos de uso comuns 1\ sincronização de processos licitatórios mantenha processos atualizados em tempo real através de webhooks, garantindo que mudanças de status sejam refletidas imediatamente em sistemas integrados 2\ automação de nfse processe automaticamente a emissão e atualização de notas fiscais eletrônicas vinculadas a processos de compra, reduzindo trabalho manual e erros 3\ notificações em tempo real configure webhooks de chat para disparar notificações instantâneas a equipes responsáveis sempre que houver atualizações críticas em processos 4\ integração com erps sincronize dados de faturas e processos entre o licitar digital e sistemas erp corporativos, mantendo consistência de dados financeiros disparando o fluxo o fluxo pode ser acionado através de execução manual disparo direto pela interface da fluid evento trigger baseado em eventos do sistema agendamento execução programada via scheduler webhook externo chamada http externa validação de resposta as respostas da api são validadas através de status http códigos de retorno padrão corpo da resposta estrutura json conforme documentação notas técnicas protocolo api rest formato json autenticação token based estrutura baseada em schemas oneof para operações dinâmicas versionamento seguir documentação oficial para versões específicas suporte para dúvidas ou problemas com o conector consulte a https //licitardigital docs apiary io/ entre em contato com o suporte da fluid verifique os logs de execução no painel de monitoramento