EDI System
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
Introduo ............................................................................................................................. 3
1.1
1.2
EDI em 4 passos............................................................................................................. 4
1.3
Suporte Tcnico............................................................................................................. 4
1.4
Conceitos ............................................................................................................................... 5
2.1
O que ? ........................................................................................................................ 5
2.2
2.3
Registro Header............................................................................................................. 8
5.2
5.3
7.1
Registro Header........................................................................................................... 13
7.2
7.3
Registro Header........................................................................................................... 17
8.2
8.3
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
1 Introduo
O EDI - Eletronic Data Interchange um canal de captura e processamento de
grandes volumes de transaes em lote, por meio de troca de arquivos entre o
cliente, o parceiro de transmisso de arquivos (VANs) e a Cielo.
Este canal indicado para:
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
Autorizao
Cancelamento
IATA
Demais
bandeiras
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
2 Conceitos
2.1 O que ?
Transaes IATA: utilizado por Cias Areas internacionais que fazem parte do
sistema IATA e GDS.
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
3 Consideraes Gerais
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
Identifica o tipo de
registro header
Data de gerao e
transmisso do
movimento
Obrigatoriamente igual
a 00
Campo Obrigatrio
Formato deve ser
DDMMAAAA
Campo ObrigatrioNo enviar o mesmo
lote num perodo de
30 dias do envio
anterior
001
Tipo de registro
002
Data do depsito
003
Nmero do
resumo de
operaes (RO)
11
Informado pelo
estabelecimento,
identifica o lote de
transaes
004
Reservado para o
estabelecimento
18
10
Uso exclusivo do
estabelecimento, no
utilizado pela CIELO
Nenhuma verificao
005
No utilizar
28
Constante = Zeros
No lido
006
Nmero do
estabelecimento
Cielo
31
10
N. da maquineta
(contrato CIELO)
007
Cdigo da moeda
41
986 - R$
840 - US$
44
P Produo
45
V venda
008
009
Indicador do
processo
Indicador de
venda
010
Indicao de
estabelecimento
especial
46
01
Constante = brancos
011
No utilizar
47
204
Constante = brancos
Campo Obrigatrio
Rejeio se < 0 ou
no numrico
Rejeitado se diferente
de 986 ou 840
Rejeita se diferente de
P
Campo Obrigatrio
- Somente dever ser
diferente de branco
caso a equipe de
sistemas assim
determinar.
- no lido
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
001
Tipo de registro
Somente aceito se
igual a 01
002
N do
comprovante de
venda (CV)
um nmero sequencial
atribudo pelo
estabelecimento, identifica
a transao dentro do lote.
Campo Obrigatrio;
Deve ser numrico;
No pode estar
duplicado no lote.
003
Nmero do carto
10
19
N do carto alinhado
direita, com zeros
esquerda
Campo Obrigatrio;
Deve ter entre 16 a
19 dgitos.
004
Cdigo de
autorizao
Na remessa, preencher
com zeros.
No retorno, voltar com o
cdigo da autorizao.
29
Nenhuma
consistncia no
momento do envio
005
Data da venda
35
Formato DDMMAAAA
006
Opo da venda
43
0 vista
2 - Parcelado lojista
44
15
Somente aceito o
formato especificado
Campo Obrigatrio
Dentro de um
mesmo lote todas as
transaes devem
ter a mesma opo
de venda
Campo Obrigatrio Tem que respeitar a
opo de venda No pode ser <0 ou
no numrico
Campo Obrigatrio Tem que respeitar a
opo de venda No pode ser <0 ou
no numrico
007
008
Quantidade de
parcelas
59
009
No utilizar
62
15
Constantes = zero
Preencher zeros
010
No utilizar
77
15
Constantes = zero
Preencher zeros
011
No utilizar
92
15
Constante = zeros
Rejeitado diferente
0 ou no numrico
Campo Obrigatrio
No pode ser <0 ou
no numrico
012
107
15
013
N do resumo de
operaes (RO)
122
Igual ao N do RO
informado no registro
header
Obrigatrio o uso
do mesmo nmero
do header
014
No utilizar
129
Constante = zeros
No lido
015
Nmero do
estabelecimento
132
10
N. da maquineta (contrato
CIELO)
Dever ser o
mesmo do header
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
016
Reservado para o
estabelecimento
Status da venda
(cdigo retorno)
017
Detalhe no campo
023
142
172
30
Uso exclusivo do
estabelecimento, no
utilizado pela CIELO
Sem verificaes
Sem verificaes
No lido
018
Data prevista de
liquidao
174
019
Validade do
carto
182
Formato = AAMM
Campo obrigatrio
020
No utilizar
186
Constantes = zero
No lido
021
No utilizar
193
15
Constantes = zero
No lido
022
No utilizar
208
03
Informar brancos
Sem verificaes
Sem verificaes
023
Cdigo do Erro
211
04
024
Referncia
215
11
Constante = brancos
025
Carto Novo
226
19
026
Vencto Novo
245
04
027
No utilizar
249
02
Sem verificaes
Sem verificaes
No lido
10
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
001
Tipo de
registro
Identifica o tipo de
registro detalhe trailler
Obrigatrio o uso do
cdigo 99
002
Quantidade
de registros
Inclusive header e
trailler
Rejeio se <0 ou no
numrico
Informado pelo
estabelecimento
Valor total do lote,
somatria do campo
007 do registro
detalhe
Rejeio se <0 ou no
numrico
Rejeita se valor diferente
da somatria do campo
07
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com o valor total
aceito.
Sem verificaes
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com o valor total
lquido.
Sem verificaes
Sem verificaes
No lido
003
004
005
Valor total
bruto (*)
Valor total
aceito (*)
Valor total
liquido (*)
10
25
40
15
15
15
006
Data prevista
de crdito
55
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com a data prevista
de pagamento.
007
No utilizar
63
188
Constante = brancos
11
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
Por regra, um cancelamento pode ser aceito at 365 dias aps o vencimento
total do mesmo.
Para cancelamentos de vendas, os campos 004, 005, 006, 007 e 008 da linha
de Detalhe devem ser preenchidos com as mesmas informaes da venda,
respeitando o horrio e data de Autorizao e Captura do Brasil.
S sero aceitos cancelamentos das bandeias: VISA, MASTER, ELO e
DINERS.
permitido o cancelamento Total ou Parcial da venda.
Os cancelamentos parciais podem ser enviados at o valor total da
transao, obedecendo as seguintes condies:
Transaes a Vista: mais de 1 cancelamento parcial da mesma transao no
mesmo dia, desde que sejam enviadas em Lotes diferentes.
Transaes Parcelado Loja: no permite cancelamento parcial da mesma
transao no mesmo dia.
Cancelamentos de transaes autorizadas por meio do canal EDI, s podem
ser solicitados aps o recebimento do arquivo retorno da transao de
autorizao (at 48 horas aps o envio do arquivo).
12
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
001
Tipo de registro
002
Data do depsito
003
Nmero do
resumo de
operaes (RO)
11
Informado pelo
estabelecimento,
identifica o lote de
transaes
004
Reservado para o
estabelecimento
18
10
Uso exclusivo do
estabelecimento, no
utilizado pela CIELO
Nenhuma verificao
005
No utilizar
28
Constante = Zeros
No lido
006
Nmero do
estabelecimento
Cielo
31
10
N. da maquineta
(contrato CIELO)
007
Cdigo da moeda
41
008
Indicador do
processo
986 - R$
840 - US$
44
P Produo
009
Indicador de
cancelamento de
vendas
C cancelamento de
venda vista
P cancelamento de
venda parcelado loja
010
Indicao de
estabelecimento
especial
46
01
Constante = brancos
011
No utilizar
47
204
Constante = brancos
45
COMENTRIOS
Consistncias EDI
Identifica o tipo de
registro header
Data de gerao e
transmisso do
movimento
Obrigatoriamente deve
ser 00
Campo Obrigatrio
Formato deve ser
DDMMAAAA
Campo ObrigatrioNo enviar o mesmo
lote num perodo de
30 dias do envio
anterior
Campo Obrigatrio
Rejeitado se < ou = 0
ou no numrico
Rejeitado se diferente
de 986 ou 840
Rejeita se diferente de
P
Se campo diferente de
C ou P o lote ser
recusado.
Somente dever ser
diferente de branco
caso a equipe de
sistemas assim
determinar.
No lido
13
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
001
Tipo de registro
002
N do
comprovante de
venda (CV)
003
Nmero do carto
10
19
004
Cdigo de
autorizao
29
005
Data da venda
006
Opo da venda
007
Valor da venda *
008
Quantidade de
parcelas
009
Valor financiado *
COMENTRIOS
Consistncias EDI
Somente aceito se
igual a 01
Campo Obrigatrio;
Deve ser numrico;
No pode estar
duplicado no lote.
N do carto alinhado
direita, com zeros
esquerda
Campo Obrigatrio;
deve ter entre 16 a
19 dgitos.
Campo Obrigatrio
35
DDMMAAAA
43
0 vista
2 - Parcelado lojista
Campo Obrigatrio
Tem que respeitar a
opo de venda
Campo Obrigatrio
Tem que respeitar a
opo de venda
Campo Obrigatorio
Tem que respeitar a
opo de venda
Campo Obrigatorio
Tem que respeitar a
opo de venda
44
59
62
15
15
Campo Obrigatrio
somente aceito o
formato especificado
Campo Obrigatrio
Dentro de um
mesmo lote todas as
transaes devem
ter a mesma opo
de venda
010
Valor entrada *
77
15
011
No utilizar
92
15
Constante = zeros
Rejeitado diferente 0
ou no numrico
Campo Obrigatorio
Tem que respeitar a
opo de venda
012
107
15
013
N do resumo de
operaes (RO)
122
Igual ao N do RO
informado no registro
header
Obrigatrio o uso do
mesmo nmero do
header
014
No utilizar
129
Constante = zeros
- No lido
14
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
015
Nmero do
estabelecimento
132
10
016
Reservado para o
estabelecimento
142
30
172
Status da venda
(cdigo retorno)
017
Detalhe no campo
023
N. da maquineta (contrato
CIELO)
Uso exclusivo do
estabelecimento, no
utilizado pela CIELO
Na remessa preencher com
zeros. No retorno, ser
formatado pela CIELO
contendo status conforme
tabela ANEXO I
Na remessa preencher com
zeros; No retorno, ser
formatado pela CIELO com
a data prevista de
liquidao.
Dever ser o
mesmo do header
Sem verificaes
Sem verificaes
018
Data prevista de
liquidao
019
Validade do
carto
182
020
Nmero do
resumo de
operaes (RO)
original
186
Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico
021
Valor do
reembolso /
cancelamento
193
15
Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico
022
No utilizar
208
03
Constante = brancos
Sem verificaes
Sem verificaes
174
No lido
Formato = AAMM
Pode ser preenchido com
zeros
023
Cdigo do Erro
211
04
024
Nmero
referncia
215
11
Constante = brancos
025
Carto Novo
226
19
026
Vencto Novo
245
04
027
No utilizar
249
02
Sem verificaes
Sem verificaes
Sem verificaes
No lido
15
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
001
Tipo de
registro
Identifica o tipo de
registro detalhe trailler
Obrigatrio o uso do
cdigo 99
002
Quantidade
de registros
Inclusive header e
trailler
Rejeio se <0 ou no
numrico
Informado pelo
estabelecimento
valor total do lote,
somatria do campo
007 do registro
detalhe
Rejeio se <0 ou no
numrico
Rejeita se valor diferente
da somatria do campo
07
003
Valor total
bruto (*)
10
15
004
Valor total
aceito (*)
25
15
005
Valor total
liquido (*)
40
15
006
Data prevista
de crdito
55
007
No utilizar
63
188
Na remessa
preencher com zeros;
No retorno, ser
formatado na Cielo
com valor total
aceito.
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com o valor total
lquido.
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com a data prevista
de pagamento.
Constante = brancos
Sem verificaes
Sem verificaes
Sem verificaes
- No lido
(*) - Estes campos devem ser considerados com 2 (duas) casas decimais,
sem vrgulas, pontos ou qualquer outro caractere para separar nmeros.
16
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
001
Tipo de registro
Identifica o tipo de
registro header
Tipo de registro
obrigatoriamente igual
a 00
002
Data do depsito
Data de gerao e
transmisso do
movimento
Campo Obrigatrio
Formato deve ser
DDMMAAAA
Informado pelo
estabelecimento,
identifica o lote de
transaes
003
Nmero do resumo
de operaes (RO)
11
004
Reservado para
estabelecimento
18
10
005
No utilizar
28
006
Nmero do
estabelecimento
31
10
N. da maquineta
(contrato CIELO)
007
Cdigo da moeda
41
986 - R$
840 - US$
008
Indicador do
processo
44
P Produo
Rejeita se diferente
P
Constante C
cancelamento de venda
vista
Constante P
cancelamento de venda
parcelado loja
Se campo diferente de
C ou P o lote ser
recusado.
009
Indicador de
cancelamento de
vendas
45
Uso exclusivo do
estabelecimento, no
utilizado pela CIELO
Constante = Zeros
Nenhuma verificao
No lido
Campo Obrigatrio
Rejeio se nmero <
0 ou no numrico
Rejeitado se diferente
de 986 ou 840
010
Indicao de
estabelecimento
46
01
Constante = brancos
011
Verso do Layout
do Arquivo
47
03
Nenhuma verificao
012
No utilizar
50
201
Constante = brancos
No lido
17
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
001
Tipo de registro
002
N do
comprovante de
venda (CV)
003
Filler
10
Constante Brancos
004
Cdigo da
Bandeira
12
Cdigo da bandeira no
Adquirente
Campo Obrigatorio
15
N do terminal.
23
29
005
006
007
Nmero do
terminal
NSU da
transao original
Cdigo de
autorizao
POS
TAM
FOR
COMENTRIOS
Consistncias EDI
Identifica o tipo de
registro detalhe
um nmero sequencial
atribudo pelo
estabelecimento,
identifica a transao
dentro do lote.
Somente aceito se
igual a 01
008
Data da venda
35
DDMMAAAA
009
Opo da venda
43
0 vista
2 - Parcelado lojista
010
011
Quantidade de
parcelas
012
44
59
15
Valor financiado *
62
15
Valor da entrada *
77
15
013
014
No utilizar
92
15
Campo Obrigatrio;
Deve ser numrico;
No pode estar
duplicado no lote.
Nenhuma
consistncia
Rejeio para
campos alfabticos.
Valores aceitos:
001 - VISA
002 - MASTER
007 - ELO
009 - DINERS
Campo Obrigatrio
Campo Obrigatrio
Campo Obrigatrio
Campo Obrigatrio
Somente aceito o
formato especificado
Campo Obrigatrio
Dentro de um
mesmo lote todas as
transaes devem
ter a mesma opo
de venda
Campo Obrigatorio
Tem que respeitar a
opo de venda
Campo Obrigatrio
Tem que respeitar a
opo de venda
Campo Obrigatorio
Tem que respeitar a
opo de venda
Campo Obrigatorio
Tem que respeitar a
opo de venda
Rejeio para
nmeros maiores do
que 8 dgitos
- Rejeitado diferente
0 ou no numrico
18
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
015
107
15
016
N do resumo de
operaes (RO)
122
129
132
10
017
018
No utilizar
Nmero do
estabelecimento
Campo Obrigatorio
Tem que respeitar a
opo de venda
Obrigatrio o uso do
mesmo nmero do
header
No lido
Dever ser o mesmo
do header
019
Reservado para o
estabelecimento
142
30
020
Status da venda
(cdigo de
retorno)
172
021
Data prevista de
liquidao
174
182
Sem verificaes
186
Informar o nmero
original do RO da venda
Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico
193
15
208
03
211
04
Constante = brancos
No remessa preencher
com brancos.
No retorno, haja erro ser
retornado pela Cielo
conforme ANEXO II
025
Validade do
carto
Nmero do
resumo de
operaes (RO)
original
Valor do
reembolso/
cancelamento
No utilizar
026
Cdigo de erro
022
023
024
027
Nmero de
referencia
215
11
Constante = brancos
028
No utilizar
226
25
Constante = brancos
Sem verificaes
Sem verificaes
No lido
Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico
Sem verificaes
Sem verificaes
Testar o contedo
do campo 10 do
header se for:
- igual a G:
. a primeira posio
(215) deste campo
deve ser igual a 3;
. as posies
restantes devem ser
numricas
diferentes de zero;
- diferente de G:
. este campo deve
ser igual a brancos
- No lido
19
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
DESCRIO
POS
TAM
FOR
001
Tipo de
registro
002
Quantidade
de registros
003
Valor total
bruto (*)
10
15
004
Valor total
aceito (*)
25
15
005
Valor total
liquido (*)
40
15
006
Data prevista
de crdito
55
007
No utilizar
63
188
COMENTRIOS
Constante 99
Identifica o tipo de
registro detalhe trailler
Inclusive header e
trailler
Informado pelo
estabelecimento
Valor total do lote,
somatria do campo
007 do registro
detalhe
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com o valor total
aceito.
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com o valor total
lquido.
Na remessa
preencher com zeros;
No retorno, ser
formatado pela Cielo
com a data prevista
de pagamento.
Constante = brancos
Consistncias EDI
Obrigatrio o uso do
cdigo 99
Rejeio se <0 ou no
numrico
Rejeio se <0 ou no
numrico
- Rejeita se valor
diferente da somatria do
campo 07
Sem verificaes
Sem verificaes
Sem verificaes
- No lido
(*) - Estes campos devem ser considerados com 2 (duas) casas decimais,
sem vrgulas, pontos ou qualquer outro caractere para separar nmeros.
20
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
Cdigo
de
Rejeio
Descritivo da Ocorrncia
Cdigo
de
Rejeio
00
02
04
01
03
05
06
Diferena de valor no RO
07
08
10
12
14
09
11
13
15
54
16
18
20
22
42
59
71
73
17
21
23
56
60
72
74
75
Erro
76
77
78
79
Carto cancelado
80
81
Fundos insuficientes
82
87
Carto no permitido
88
89
93
95
Descritivo da Ocorrncia
Erro no arquivo
Estabelecimento invlido
Nmero de parcelas invlido
Nmero do RO invlido (registro
BH)
Valor da taxa de embarque invlido
Cdigo de transao invlido
Valor invlido
Valor do cancelamento invlido
N de itens informados no RO no
compatvel com os CVs
No permitido cancelamento
parcial de um plano parcelado que
est sendo contestado pelo
portador.
Valor do cancelamento maior que
o valor da venda
Nmero do RO original invlido
(registro I2)
Tipo de plano de carto invlido
Data invlida
Transao rejeitada pelo banco
emissor
Autorizao negada
Transao rejeitada pelo banco
emissor
No foi encontrada autorizao no
emissor
Carto cancelado
Carto vencido ou data do
vencimento errada
Excedeu o nmero de transaes
no perodo
92
94
99
Outros motivos
21
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
CDIGO
E001
Complemento Erro
Lote excedeu nmero de registros
Ao EC
Rever estrutura do arquivo
E001
E001
Contatar Cielo
E002
E005
E005
E010
Contatar Cielo
E023
Contatar Cielo
E024
E044
E045
E048
E054
E055
E056
No reenviar a transao
E057
Carto cancelado
E061
E095
E097
E101
No reenviar a transao
Refaa ajustando a quantidade de
parcelas
Contate seu cliente
E102
E103
Contatar Cielo
E104
Carto cancelado
E105
E107
E112
Contatar Cielo
E112
No reenviar a transao
E112
E112
E112
No reenviar a transao
E112
No reenviar a transao
E112
Contatar Cielo
E112
Transao no permitida
No reenviar a transao
E094
E112
No reenviar a transao
Contatar Cielo
No reenviar a transao
22
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
No reenviar a transao
E112
E114
E141
Carto cancelado
E143
E154
Carto cancelado
Transao no autorizada pelo banco
Emissor
Data de vencimento carto incorreta
E157
Carto cancelado
E158
Contatar Cielo
E162
E180
E182
E191
E192
E205
E207
E207
E207
E209
Rever o valor
E210
E210
E112
E112
E151
E210
No reenviar a transao
Reveja dados da transao
Contatar Cielo
E210
E211
E212
Rever o valor
E213
E214
Transao no localizada
E215
Transao j cancelada
Contatar Cielo
E216
No reenviar a transao
E217
E218
Contatar Cielo
E219
E220
Nmero do RO no localizado
Prazo excedido para cancelar transao
E900
E901
E902
E903
23
Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
E904
E905
E906
E912
E913
E911
E915
E916
E917
E918
E919
E920
E925
E926
E914
E921
E922
E923
E924
E930
E931
24