Cielo
A integração com o Cielo conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 13 parâmetros distribuídos em 3 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: Adquirente.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Referência rápida
O que é a integração Cielo?
É a conexão entre o canal Cielo e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Adquirente), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Cielo.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Cielo e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
3 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| ClientID | Texto | ClientID obtido no portal da Cielo |
| ClientSecret | Senha | ClientSecret obtido no portal da Cielo |
| Url notificação e status | Cópia | Url notificação e status para configurar no painel da Cielo |
Conciliação
8 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Número do estabelecimento na Cielo | Texto | Caso tenha mais de uma empresa, coloque separado por vírgula. O código é semelhante a 1103536703 |
| Ativar conciliação | Sim/Não | Ativar a conciliação para importar as transações |
| Plano de contas taxa | Lista | Plano de contas para lançamento da taxa adquirente |
| Tipo documento taxa | Lista | Tipo documento para lançamento da taxa adquirente |
| Centro de custo taxa | Lista | Centro de custo para lançamento da taxa adquirente |
| Diferença dias data venda para conciliação automática | Inteiro | Quantidade de dias a mais e a menos permitido na conciliação automática |
| Diferença valor para conciliação automática | Decimal | Diferença de valor a maior e a menor permitido na conciliação automática |
| Plano de contas antecipação | Lista | Plano de contas para lançamento de antecipação adquirente |
Configurações Gerais
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Mudar pedido para status após pago | Lista | Selecione um status, se desejar, para mudar o pedido após o pagamento ser efetuado |
| Desmembrar pagamento em parcelas | Sim/Não | Ao ativar, o pagamento vai ser desmembrado na quantidade de parcelas ao receber a confirmação da CIELO |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |