Pular para o conteúdo principal

DE-PARA Adquirentes

A tela DE-PARA Adquirentes é a tabela de tradução entre as adquirentes (operadoras de cartão) que aparecem nos pedidos vindos dos canais de venda e as adquirentes cadastradas no idworks. Cada linha amarra um par "Integração + identificador da adquirente do canal" a uma "adquirente do ERP". Essa amarração é o que permite o sistema saber qual operadora de cartão registrar nas contas a receber e na conciliação quando um pedido vindo do Mercado Livre / Shopee / VTEX / outros canais cita um identificador interno deles.

Sem essa tradução, pedidos pagos no cartão chegam dos marketplaces com códigos numéricos opacos (ex.: 1234) e o idworks não consegue casar com uma operadora cadastrada — o que impede a conciliação automática do extrato da adquirente.

A tela é simples: lista o DE-PARA atual, com filtros e ações Adicionar, Editar e Remover. Apenas três campos por registro: Integração, Adquirente (integração) e Adquirente (erp).

Índice​

Conceito

Cadastro e edição

Busca e visualização

Regras de negócio

Boas práticas

Referência rápida

O que é a tela DE-PARA Adquirentes?​

É a tela onde você cria a tabela de tradução entre identificadores de adquirentes vindas dos canais de venda (Mercado Livre, Shopee, etc.) e as adquirentes cadastradas como operadoras de cartão no idworks. O propósito é fazer o sistema entender, ao receber um pedido pago no cartão de um canal, qual operadora interna corresponde ao código informado pelo canal — permitindo conciliação correta do extrato da operadora.

📍 Onde: menu lateral → Integrações (HUB) → DE-PARA Adquirentes.

Por que preciso fazer esse DE-PARA?​

Quando um pedido chega de um marketplace pago no cartão, o XML/JSON do canal cita um código interno daquele canal para identificar a operadora de cartão usada — algo como 1234, acquirer_5, card_processor_X. Esses códigos não fazem sentido para o idworks sozinhos: o sistema precisa saber se aquele código corresponde à sua operadora "Cielo", "Stone", "PagSeguro", etc., para:

  • Criar a conta a receber com a operadora correta.
  • Casar o lançamento na conciliação do extrato dessa operadora.
  • Calcular taxas e prazos de recebimento de acordo com o contrato.

Sem o DE-PARA, o pedido chega no idworks com a adquirente em branco ou desconhecida — a conciliação automática não funciona e a operação precisa lançar manualmente cada baixa.

Qual a diferença entre Adquirente (integração) e Adquirente (erp)?​

Adquirente (integração)Adquirente (erp)
O que éO identificador da operadora no canal (Mercado Livre, Shopee, etc.).A operadora de cartão cadastrada no idworks.
Onde fica cadastradoNo próprio canal de venda — você descobre consultando o canal ou o XML/JSON do pedido.No cadastro de Adquirentes do idworks (em Configurações → Adquirentes).
FormatoTexto livre / código numérico (depende do canal).Seletor — escolhe da lista cadastrada.
Quem informaVocê digita manualmente conforme o canal exige.Selecionado da lista.

A função do DE-PARA é amarrar um ao outro: integração + identificador do canal → operadora interna.

Como adicionar um novo DE-PARA?​

Clique em Adicionar no topo da tela. A janela abre com três campos obrigatórios:

  1. Integração — selecione o canal de venda que está enviando o pedido (Mercado Livre, Shopee, VTEX, etc.). A lista mostra apenas integrações já configuradas.
  2. Adquirente (integração) — digite o identificador exato da operadora como vem do canal. Sensível a maiúsculas/minúsculas. Confira no XML/JSON do pedido ou na documentação do canal.
  3. Adquirente (erp) — selecione a operadora de cartão correspondente no cadastro interno (lista de adquirentes cadastradas em Configurações → Adquirentes).

Clique em Salvar. O DE-PARA passa a ser aplicado a partir do próximo pedido que chegar do canal com aquele identificador — pedidos antigos não são re-processados.

Pré-requisito: privilégio Criar hub adquirente.

Como editar um DE-PARA existente?​

Clique no ícone Editar (lápis) na linha do DE-PARA. A janela abre com os três campos preenchidos — altere o que precisar e clique em Salvar.

Geralmente o uso típico é trocar a Adquirente (erp) quando uma operadora foi trocada por outra (mudança de contrato com a operadora) — o lado da integração raramente muda.

Pré-requisito: privilégio Editar hub adquirente.

Como remover um DE-PARA?​

Clique no ícone Remover (lixeira) na linha. O sistema mostra a janela de confirmação com o nome da integração e do identificador da adquirente — confirme.

Use quando o canal mudou o código interno (raro) ou quando a operadora foi descontinuada e não há mais pedidos novos chegando com aquele código.

Pré-requisito: privilégio Deletar hub adquirente.

Como filtrar os DE-PARA cadastrados?​

Clique em Filtros para abrir o painel lateral. Os filtros disponíveis:

  • Conta — separa por conta (subdomínio).
  • Integração — filtra por canal de venda (todos os Mercado Livre, todos os Shopee, etc.).
  • Adquirente (erp) — filtra por operadora interna.

Clique em Aplicar para atualizar.

De onde vem a lista de Integrações?​

A lista mostra apenas integrações ativas e cadastradas para a empresa em Configurações → Integrações. Cada empresa tem o seu conjunto: se você não cadastrou Mercado Livre, ele não aparece aqui.

Para incluir uma integração que está faltando, cadastre primeiro em Configurações → Integrações com as credenciais do canal.

De onde vem a lista de Adquirentes (erp)?​

A lista mostra as operadoras de cartão cadastradas em Configurações → Adquirentes. É um cadastro paralelo ao das integrações — cada operadora (Cielo, Stone, PagSeguro, Mercado Pago, etc.) tem seus dados de contrato (taxas, prazos de recebimento) cadastrados lá.

Para incluir uma operadora, cadastre primeiro em Configurações → Adquirentes com as informações de contrato.

O que descubro no canal para preencher o campo Adquirente (integração)?​

Cada canal usa seu próprio formato — geralmente:

  • Mercado Livre — campo payment_method_id ou nome customizado da operadora no pedido.
  • Shopee — código de processador de pagamento ou nome do gateway.
  • VTEX — nome do sistema de pagamento ou da adquirente, conforme aparece no pedido.
  • Shopify — gateway ou nome do processador.

Para descobrir o valor exato, abra um pedido recente do canal no idworks (em Vendas → Pedidos) e localize o pagamento — o identificador da operadora aparece nos detalhes. Use exatamente esse valor (sensível a maiúsculas/minúsculas) na coluna Adquirente (integração) do DE-PARA.

Quando você ainda não tem nenhum pedido no canal para consultar, peça a documentação técnica para o suporte do canal de venda.

Boas práticas para o DE-PARA de adquirentes​

Um DE-PARA bem feito é o que faz a conciliação do cartão funcionar sozinha, sem baixa manual de cada pedido. Recomendações:

  • Cadastre o DE-PARA antes de começar a vender no cartão pelo canal. O mapeamento só vale para os pedidos que chegam depois dele — pedidos antigos não são reprocessados. Deixar para configurar depois obriga a lançar as baixas na mão.
  • Copie o identificador do canal exatamente como ele aparece. O campo Adquirente (integração) é sensível a maiúsculas/minúsculas — uma letra diferente faz o pedido chegar com a operadora em branco. Confira no próprio pedido em Vendas → Pedidos antes de digitar.
  • Cadastre a operadora em Configurações → Adquirentes antes de criar o DE-PARA. O lado Adquirente (erp) é um seletor — se a operadora não estiver cadastrada lá com taxas e prazos, ela não aparece para escolher e a conciliação não calcula os valores certos.
  • Crie um DE-PARA para cada operadora que aparece nos seus pedidos. Toda operadora citada pelo canal que não tiver tradução chega como adquirente desconhecida e fura a conciliação automática — não deixe nenhuma de fora.
  • Atualize só o lado da operadora quando trocar de contrato. Quando mudar de operadora de cartão, edite o DE-PARA e troque apenas o Adquirente (erp) — o identificador do canal raramente muda, então não precisa recadastrar do zero.

Resumo de parametrizações​

A tela Hub Adquirente não tem parametrizações próprias que mudem o cadastro/uso de cada integração. A configuração específica de cada adquirente (Cielo, Rede, MercadoPago, etc.) — taxas, plano de contas, centro de custo, antecipação — fica em Configurações → Parametrizações → Conciliação e está documentada na FAQ de Conciliação Adquirente.

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égioLibera
Visualizar hub adquirenteAcesso à tela e à lista.
Criar hub adquirenteBotão Adicionar.
Editar hub adquirenteÍcone Editar (lápis) na linha.
Deletar hub adquirenteÍcone Remover (lixeira) na linha.
Última atualização em