Introdução

O EDI - Eletronic Data Interchange é um canal de captura e processamento de grandes volumes de transações em lote, por meio de troca de arquivos entre o cliente, o parceiro de transmissão de arquivos (VANs) e a Cielo.

Este canal é indicado para:

Público Alvo

Não há restrição para utilização deste Canal. Porém, as necessidades de negócio do cliente podem ou não viabilizar a utilização deste canal de captura.

Conforme descrito acima, algumas características se fazem necessárias:

EDI em 4 passos

Para utilizar o canal de captura EDI, são necessários quatro passos:

  1. Credenciamento: o cliente precisa ser credenciado a Cielo;
  2. Integração: realizar desenvolvimento de acordo com o manual para se integrar ao EDI. Obs.: o tamanho do desenvolvimento dependerá do grau de integração desejado com seus sistemas de gestão (ERP, Automação Comercial, etc);
  3. Homologação: um arquivo teste pode ser enviado à Ilha de Atendimento EDI para validação da estrutura do arquivo;
  4. Produção: enviar o arquivo para processamento.

Suporte Técnico

A solução de captura EDI conta com uma Ilha de Atendimento para suporte, responsável por:

  1. Suporte à integração e homologação pelo cliente;
  2. Suporte de 1º nível na fase de produção;
  3. Interface com as áreas internas Cielo e com parceiros VAN’s (TIVIT e GXS), para suporte de 2º e 3º nível.

Produtos e Bandeiras habilitados para o CANAL EDI:

Produto/Serviço Autorização em lote Cancelamento em lote IATA Submissão Base 2 IATA Cancelamento
Débito Não Sim Não Sim*
Crédito a Vista Sim Sim Sim Sim
Parcelado Loja Sim Sim Sim Sim

Exceções

Conceitos

O que é?

O EDI - Eletronic Data Interchange, é um canal de captura e processamento de transações em lote, por meio de troca de arquivos entre o cliente o parceiro de transmissão de arquivos (VANs) e a Cielo.

Para que serve?

Como funciona?

Considerações Gerais

Nomes dos retornos dos arquivos:

Dicas para formatação dos arquivos EDI

Resumo de Operação (RO)

Identifica o número do lote, grupo de transações de venda.

Comprovante de Venda (CV)

Cada venda é registrada em um comprovante de venda.

Arquivos

Arquivos para Remessa e/ou Retorno de Vendas

Layout de Arquivos para Remessa e/ou Retorno de Vendas

Registro Header

SEQ DESCRIÇÃO POS TAM FOR COMENTÁRIOS Consistências EDI
001 Tipo de registro 1 2 N Identifica o tipo de registro header Obrigatoriamente igual a “00”
002 Data do depósito 3 8 N Data de geração e transmissão do movimento Campo Obrigatório Formato deve ser DDMMAAAA
003 Número do resumo de operações (RO) 11 7 N Informado pelo estabelecimento, identifica o lote de transações Campo Obrigatório. Não enviar o mesmo lote num período de 30 dias do envio anterior
004 Reservado para o estabelecimento 18 10 X Uso exclusivo do estabelecimento, não é utilizado pela CIELO Nenhuma verificação
005 Não utilizar 28 3 N Constante = Zeros Não lido
006 Número do estabelecimento Cielo 31 10 N N.o da maquineta (contrato CIELO) Campo Obrigatório. Rejeição se N = Numérico / X = Alfanumérico

Registro Detalhe

SEQ DESCRIÇÃO POS TAM FOR COMENTÁRIOS Consistências EDI
001 Tipo de registro 1 2 N Identifica o tipo de registro detalhe Somente aceito se igual a “01”
002 N. do comprovante de venda (CV) 3 7 N É um número sequencial atribuído pelo estabelecimento, identifica a transação dentro do lote. Campo Obrigatório; Deve ser numérico; Não pode estar duplicado no lote.
003 Número do cartão 10 19 N N. do cartão alinhado à direita, com zeros à esquerda. Campo Obrigatório; Deve ter entre 16 a 19 dígitos.
004 Código de autorização 29 6 X Na remessa, preencher com zeros. No retorno, voltará com o código da autorização. Nenhuma consistência no momento do envio.
005 Data da venda 35 8 N Formato DDMMAAAA Somente aceito o formato especificado
006 Opção da venda 43 1 N ‘0’ – À vista, ‘2’ - Parcelado lojista, ‘4’ – Parcelado lojista – Cia Aerea Campo Obrigatório. Dentro de um mesmo lote todas as transações devem ter a mesma opção de venda.
007 Valor da venda * 44 15 N Venda à vista => valor da venda. Venda parcelada => valor total das parcelas + valor entrada + taxa embarque Campo Obrigatório - Tem que respeitar a “opção de venda” - Não pode ser menor zero/não numérico
008 Quantidade de parcelas 59 3 N Venda à vista => preencher com zeros. Venda parcelada => quantidade de parcelas Campo Obrigatório - Tem que respeitar a “opção de venda” - Não pode ser menor zero\ não numérico.
009 Valor Financiado * 62 15 N Venda à vista => preencher com zeros. Venda parcelada => Valor original financiado Não pode ser menor zero \ não numérico
010 Valor Entrada 77 15 N Venda à vista => preencher com zeros. Venda parcelada => Valor da entrada. Apenas Cias. Aéreas Não pode ser menor zero \ não numérico
011 Taxa Embarque 92 15 N Preencher apenas para Cias. Aéras. Caso contrário preencher com zeros Não pode ser menor zero \ não numérico
012 Valor parcela 107 15 N Venda à vista => preencher com zeros. Venda parcelada => Valor parcela (sem arredondar) Campo Obrigatório. Não pode ser menoo que 0 ou não numérico
013 No do resumo de operações (RO) 122 7 N Igual ao No do RO informado no registro header Obrigatório o uso do mesmo número do header
014 Não utilizar 129 3 N Constante = zeros Não lido
015 Número do estabelecimento 132 10 N N.o da maquineta (contrato CIELO) Deverá ser o mesmo do header
016 Reservado para o estabelecimento 142 30 X Uso exclusivo do estabelecimento, não é utilizado pela CIELO Sem verificações
017 Status da venda (código retorno). Detalhe no campo 023 172 2 N Na remessa preencher com zeros, No retorno, será formatado pela CIELO contendo status conforme tabela ANEXO I Sem verificações
018 Data prevista de liquidação 174 8 N Na remessa preencher com zeros; No retorno, será formatado pela CIELO com a data prevista de liquidação. Não lido
019 Validade do cartão 182 4 X Formato = AAMM Campo obrigatório
020 Não utilizar 186 7 N Constantes = zero Não lido
021 Não utilizar 193 15 N Constantes = zero Não lido
022 Não utilizar 208 03 X Informar brancos Sem verificações
023 Código do Erro 211 04 X Na remessa preencher com brancos. No retorno, caso haja erro será retornado pela Cielo conforme ANEXO II Sem verificações
024 Referência 215 11 X Constante = brancos Deve ser brancos
025 Cartão Novo 226 19 X Na remessa preencher com brancos. No retorno, caso tenha convênio “renova fácil” virá o número cartão alinhado a esquerda com brancos direita. Sem verificações
026 Vencto Novo 245 04 N Na remessa preencher com brancos. No retorno, caso tenha convênio “renova fácil” virá a data do vencto. Cartão novo Sem verificações
027 Não utilizar 249 02 X Constante = brancos Não lido

Registro Trailler

SEQ DESCRIÇÃO POS TAM FOR COMENTÁRIOS Consistências EDI
001 Tipo de registro 1 2 N Identifica o tipo de registro detalhe trailler Obrigatório o uso do código “99”
002 Quantidade de registros 3 7 N Inclusive header e trailler Rejeição se menor que 0 ou não numérico
003 Valor total bruto (*) 10 15 N Informado pelo estabelecimento – Valor total do lote, somatória do campo 007 do registro detalhe. Rejeição se menor que 0 ou não numérico. Rejeita se valor diferente da somatória do campo 07
004 Valor total aceito (*) 25 15 N Na remessa preencher com zeros; No retorno, será formatado pela Cielo com o valor total aceito. Sem verificações
005 Valor totalliquido (*) 40 15 N Na remessa preencher com zeros; No retorno, será formatado pela Cielo com o valor total líquido. Sem verificações
006 Data prevista de crédito 55 8 N Na remessa preencher com zeros; No retorno, será formatado pela Cielo com a data prevista de pagamento. Sem verificações
007 Não utilizar 63 188 X Constante = brancos Não lido

Arquivos de Remessa e Retorno de Cancelamentos

Layout de Arquivos de Remessa e Retorno de Cancelamentos ( Não PCI ) utilizado para cancelamentos de transações por meio do canal EDI, por exemplo: transações recorrentes.

Chave sem certificação PCI:

Registro Header

SEQ DESCRIÇÃO POS TAM FOR COMENTÁRIOS Consistências EDI  
001 Tipo de registro 1 2 N Identifica o tipo de registro header Obrigatoriamente deve ser “00”  
002 Data do depósito 3 8 N Data de geração e transmissão do movimento Campo Obrigatório. Formato deve ser DDMMAAAA  
003 Número do resumo de operações (RO) 11 7 N Informado pelo estabelecimento, identifica o lote de transações. Campo Obrigatório. Não enviar o mesmo lote num período de 30 dias do envio anterior  
004 Reservado para o estabelecimento 18 10 X Uso exclusivo do estabelecimento, não é utilizado pela CIELO Nenhuma verificação  
005 Não utilizar 28 3 N Constante = Zeros Não lido  
006 Número do estabelecimento Cielo 31 10 N N.º da maquineta (contrato CIELO) Campo Obrigatório. Rejeitado se valor venda, Venda parcelada => somatória das parcelas e valor de entrada. Campo Obrigatório. Tem que respeitar a “opção de venda”
008 Quantidade de parcelas 59 3 N Venda à vista => preencher com zeros, Venda parcelada => quantidade de parcelas Campo Obrigatório. Tem que respeitar a “opção de venda”  
009 Valor financiado * 62 15 N Venda à vista => preencher com zeros, Venda parcelada => Valor original financiado Campo Obrigatório. Tem que respeitar a “opção de venda”  
010 Valor entrada 77 15 N Venda à vista => preencher com zeros, Venda parcelada => Valor da entrada. Apenas Cias. Aéreas Campo Obrigatório. Tem que respeitar a “opção de venda”  
011 Valor Taxa de Embarque 92 15 N Preencher apenas para Cias. Aéras. Caso contrário preencher com zeros Rejeitado se diferente de zero ou não numérico  
012 Valor parcela * 107 15 N Venda à vista => preencher com zeros, Venda parcelada => Valor da parcela (não fazer arredondamento) Campo Obrigatório. Tem que respeitar a “opção de venda“  
013 Nº do resumo de operações (RO) 122 7 N Igual ao Nº do RO informado no registro header Obrigatório o uso do mesmo número do header  
014 Não utilizar 129 3 N Constante = zeros Não lido  
015 Número do estabelecimento 132 10 N N.º da maquineta (contrato CIELO) Deverá ser o mesmo do header  
016 Reservado para o estabelecimento 142 30 X Uso exclusivo do estabelecimento, não é utilizado pela CIELO Sem verificações  
017 Status da venda (código retorno). Detalhe no campo 023 172 2 N Na remessa preencher com zeros. No retorno, será formatado pela CIELO contendo status conforme tabela ANEXO I Sem verificações  
018 Data prevista de liquidação 174 8 N Na remessa preencher com zeros; No retorno, será formatado pela CIELO com a data prevista de liquidação. Não lido  
019 Validade do cartão 182 4 X Formato = AAMM. Pode ser preenchido com zeros Sem verificações  
020 Número do resumo de operações (RO) original 186 7 N Informar o número original do RO da venda Campo Obrigatório. Rejeitado se ( * ) - Estes campos devem ser considerados com 2 (duas) casas decimais, sem vírgulas, pontos ou qualquer outro caractere para separar números.</aside>  

Regras - cancelamento de vendas

O cancelamento de qualquer transação só será aceito se houver saldo disponível na Agenda Financeira do Estabelecimento Comercial para cobrir o valor do cancelamento solicitado.

Transações a Vista: podem ser enviados mais de um cancelamento parcial da mesma transação no mesmo dia, desde que sejam enviadas em Lotes diferentes / Transações Parcelado Loja: não permite cancelamento parcial da mesma transação no mesmo dia.

Anexos

ANEXO I - Tabela de Códigos de Retorno

Código de Rejeição Descritivo da Ocorrência
00 Transação OK (Transação Aceita)
01 Erro no arquivo
02 Código de autorização inválido
03 Estabelecimento inválido
04 Lote misturado
05 Número de parcelas inválido
06 Diferença de valor no RO
07 Número do RO inválido (registro BH)
08 Valor de entrada inválido
09 Valor da taxa de embarque inválido
10 Valor da parcela inválido
11 Código de transação inválido
12 Transação inválida
13 Valor inválido
14 Não aplicável
15 Valor do cancelamento inválido
16 Transação original não localizada (para cancelamento)
17 Nº de itens informados no RO não compatível com os CV’s
18 Número de referência inválido
20 Cancelamento para parcelado de transação já cancelada
21 Valor do cancelamento maior que o valor da venda
22 Valor do cancelamento maior que o permitido (alçada)
23 Número do RO original inválido (registro I2)
42 Cartão cancelado
54 Não é permitido cancelamento parcial de um plano parcelado que está sendo contestado pelo portador.
56 Tipo de plano de cartão inválido
59 Tipo cartão inválido 60 Data inválida
71 Transação rejeitada pelo banco emissor
72 Transação rejeitada pelo banco emissor
73 Cartão com problema - reter o cartão
74 Autorização negada
75 Erro
76 Transação rejeitada pelo banco emissor
77 Erro de sintaxe - refaça a transação
78 Não foi encontrada autorização no emissor
79 Cartão cancelado
80 Cartão cancelado
81 Fundos insuficientes
82 Cartão vencido ou data do vencimento errada
87 Cartão não permitido
88 Excedeu o número de transações no período
89 Mensagem difere da mensagem original
92 Banco emissor sem comunicação
93 Cancelamento com mais de 365 dias
94 Duplicidade de linhas aéreas
95 Sem saldo em aberto
99 Outros motivos

ANEXO II – Detalhamento do erro para Status Venda informado no campo 23

CÓDIGO Complemento Erro Ação EC
E001 Lote excedeu número de registros Rever estrutura do arquivo
E001 Estrutura do lote incorreta Rever estrutura do arquivo
E001 Meio de transmissão inválido Contatar Cielo
E002 Reveja os dados do cartão Refaça a transação com dados validos
E005 Número de Estabelecimento não encontrado Confira os dados do Estabelecimento Cielo
E005 Problema no seu cadastro na Cielo Contatar Cielo
E010 Problema no seu cadastro na Cielo Contatar Cielo
E023 Problema no seu cadastro na Cielo Contatar Cielo
E024 Tipo de cartão não permitido neste canal Contate seu cliente
E044 Data da transação não confere Rever dados da transação original
E045 Código de autorização não encontrado Confira os dados da transação
E048 Data de vencimento cartão incorreta Contate seu cliente
E054 Estrutura do lote incorreta Reveja seu arquivo
E055 Quantidade de Parcelas invalida Verificar a quantidade de parcelas
E056 Transação não permitida para seu cadastro Não reenviar a transação
E057 Cartão cancelado Contate seu cliente
E061 Reveja os dados do cartão Refaça a transação com dados validos
E094 Transação não permitida para cartão Internacional Não reenviar a transação
E095 Transação não permitida para cartão Débito Não reenviar a transação
E097 Parcelado com valor inferior a R$ 5,00 Refaça ajustando a quantidade de parcelas
E101 Transação rejeitada pelo banco Emissor Contate seu cliente
E102 Transação rejeitada pelo banco Emissor Contate seu cliente
E103 Problema no seu cadastro na Cielo Contatar Cielo
E104 Cartão cancelado Contate seu cliente
E105 Transação rejeitada pelo banco Emissor Contate seu cliente
E107 Transação rejeitada pelo banco Emissor Contate seu cliente
E112 Transação não permitida neste canal Contatar Cielo
E112 Transação em moeda Dólar, não permitida. Não reenviar a transação
E112 Transação sem código de autorização Refaça incluindo o código de autorização
E112 Transação não permitida para Cadastro Recorrente Contatar Cielo
E112 Transação autorizada anteriormente Não reenviar a transação
E112 Cartão não permitido para Cadastro Dólar Não reenviar a transação
E112 Transação Parcelada Não Permitida Não reenviar a transação
E112 Problema no seu cadastro na Cielo Contatar Cielo
E112 Transação não permitida Não reenviar a transação
E112 Transação não permitida para seu cadastro Não reenviar a transação
E112 Transação cartão Internacional não permitida para seu cadastro Não reenviar a transação
E112 Dados da transação inválidos Reveja dados da transação
E114 Reveja os dados do cartão Refaça a transação com dados validos
E141 Cartão cancelado Contate seu cliente
E143 Cartão cancelado Contate seu cliente
E151 Transação não autorizada pelo banco Emissor Contate seu cliente
E154 Data de vencimento cartão incorreta Contate seu cliente
E157 Cartão cancelado Contate seu cliente
E158 Tipo de cartão não permitido neste canal Contatar Cielo
E162 Cartão não permitido para esta transação Contate seu cliente
E180 Data da transação não confere Rever dados da transação original
E182 Código de segurança do cartão inválido Rever dados da transação / Contate seu cliente
E191 Banco Emissor sem comunicação Contatar Cielo
E192 Aplicável para Cias Aéreas Aplicável para Cias Aéreas
E205 Reveja os dados do cartão Refaça a transação com dados validos
E207 Número do Lote inválido Rever o número do Lote
E207 Campo Lote não é numérico Rever o número do Lote
E207 Número de Lote duplicado Rever o número do Lote
E209 Aplicável para Cias Aéreas Rever o valor
E210 Quantidade de Parcelas invalida Campo zerado quantidade de parcelas
E210 Quantidade de Parcelas invalida Numero de parcelas excedeu limite
E210 Produto não autorizado para seu Estabelecimento Contatar Cielo
E210 Quantidade de parcelas maior que permitido Contatar Cielo para alterar cadastro parcelado
E211 Aplicável para Cias Aéreas Rever o valor
E212 Aplicável para Cias Aéreas Rever o valor
E213 Valor de cancelamento não permitido Reveja os dados da transação
E214 Transação não localizada Reveja os dados da transação
E215 Transação já cancelada Contatar Cielo
E216 Transação cancelada anteriormente Não reenviar a transação
E217 Valor de cancelamento maior venda Reveja dados da transação
E218 Cancelamento não permitido neste canal Contatar Cielo
E219 Número do RO não localizado Reveja os dados da transação
E220 Prazo excedido para cancelar transação Não reenviar a transação
E900 Tipo de Registro Inválido Rever estrutura do arquivo
E901 Data do Depósito do Header Inválida Reveja os dados da transação
E902 Número do Resumo de Operações (RO) do Header Inválido Reveja o Número do Resumo de Operações (RO)
E903 Número do Estabelecimento do Header Inválido Reveja o Número de Estabelecimento / Contate a Cielo
E904 Moeda do Header Inválida Reveja estrutura do Header
E905 Indicador de teste do Header Inválido Reveja estrutura do Header
E906 Indicador de venda do Header Inválido Reveja estrutura do Header
E911 Número do Comprovante de Venda (CV) Inválido Reveja os dados da transação
E912 Data da Venda Inválida Reveja os dados da transação
E913 Opção da Venda Inválida Reveja os dados da transação
E914 Número do Cartão Inválido Reveja os dados da transação / Contate seu Cliente
E915 Valor da Venda Inválido Reveja os dados da transação
E916 Quantidade de Parcelas Inválida Reveja os dados da transação
E917 Valor Financiado Inválido Reveja os dados da transação
E918 Valor da Entrada Inválido Reveja os dados da transação
E919 Valor da Taxa Embarque Inválido Aplicável para Cias Aéreas
E920 Valor da Parcela Inválido Reveja os dados da transação
E921 Número do Resumo de Operações (RO) Inválido Reveja o Número do Resumo de Operações (RO)
E922 Número do Estabelecimento Inválido Reveja o Número de Estabelecimento / Contate a Cielo
E923 Validade do Cartão Inválido Contate seu cliente
E924 Número do Resumo de Operações (RO) Original Inválido Reveja o Número do Resumo de Operações (RO)
E925 Valor do Reembolso Inválido Reveja os dados da transação
E926 Número de Referencia Inválido Reveja os dados da transação
E930 Quantidade de Registros do Trailer não confere Reveja a quantidade de registros
E931 Valor total bruto não confere Reveja os dados da transação