Vous êtes sur la page 1sur 24

Cielo EDI

Manual de Integrao Verso 10 - 27-08-2014

EDI System

Manual de Integrao Autorizao e Cancelamento de Transaes

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

Introduo ............................................................................................................................. 3
1.1

Pblico Alvo ................................................................................................................... 3

1.2

EDI em 4 passos............................................................................................................. 4

1.3

Suporte Tcnico............................................................................................................. 4

1.4

Produtos e Bandeiras habilitados para este canal ........................................................ 4

Conceitos ............................................................................................................................... 5
2.1

O que ? ........................................................................................................................ 5

2.2

Para que serve? ............................................................................................................. 5

2.3

Como funciona? ............................................................................................................ 5

Consideraes Gerais ............................................................................................................ 6


Nomes dos retornos dos arquivos: .................................................................................. 6

Dicas para formatao dos arquivos EDI ............................................................................... 7

Layout de Arquivos para Remessa e/ou Retorno de Vendas ............................................... 8


5.1

Registro Header............................................................................................................. 8

5.2

Registro Detalhe ............................................................................................................ 9

5.3

Registro Trailler ........................................................................................................... 11

Dicas sobre cancelamento de vendas ................................................................................ 12

Layout de Arquivos de Remessa e Retorno de Cancelamentos ( No PCI ) ....................... 13

7.1

Registro Header........................................................................................................... 13

7.2

Registro Detalhe .......................................................................................................... 14

7.3

Registro Trailler ........................................................................................................... 16

Layout de Arquivos de Remessa e Retorno de Cancelamentos (PCI) ................................. 17


8.1

Registro Header........................................................................................................... 17

8.2

Registro Detalhe (PCI) ................................................................................................. 18

8.3

Registro Trailler ........................................................................................................... 20

ANEXO I - Tabela de Cdigos de Retorno ........................................................................... 21

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

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:

Autorizar transaes de carto no presente, principalmente transaes


recorrentes, ex.: Editoras, Seguradoras, Academias, etc.
Cancelar transaes de carto presente ou no presente independe do canal
de autorizao: Mquina / TEF / E-commerce ou EDI.
Captura para o processamento, em Base II, das transaes de Cias Areas,
enviadas pela IATA (International Air Transport Association).
Transmisso do extrato eletrnico

1.1 Pblico Alvo


No h restrio para utilizao do EDI. Porm, as necessidades de negcio do
cliente podem ou no viabilizar a utilizao deste canal de captura. Conforme
descrito na introduo, algumas caractersticas se fazem necessrias:

Autorizao de transaes: indicado para clientes com necessidade de


autorizar grandes volumes de transaes, principalmente transaes
recorrentes (academias, seguros, assinaturas, etc).
Cancelamento de transaes: indicado para clientes com necessidade
de cancelar grandes volumes de transaes, de forma automatizada.
Extrato eletrnico: indicado para clientes com grande volume de
transaes, com objetivo de facilitar a conciliao financeira.
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

1.2 EDI em 4 passos


Para utilizar o canal de captura EDI, so necessrios 4 passos:
1. Credenciamento: o cliente precisa ser credenciado a Cielo
2. Integrao: realizar desenvolvimento de acordo com o manual para se
integrar ao EDI. Obs.: o tamanho do desenvolvimento no cliente
depender do grau de integrao desejado com seus sistemas de gesto
(ERP, Automao Comercial, etc).
3. Homologao: um arquivo teste pode ser enviado Ilha de Atendimento
EDI para validao da estrutura do arquivo.
4. Produo: enviar o arquivo para processamento.

1.3 Suporte Tcnico


A soluo de captura EDI conta com uma Ilha de Atendimento para suporte,
responsvel por:
1. Suporte a integrao e homologao do cliente
2. Suporte de 1 nvel na fase de produo
3. Interface com as reas internas Cielo e com parceiros VANs (TIVIT e
GXS), para suporte de 2 e 3 nvel.

1.4 Produtos e Bandeiras habilitados para este canal


A verso atual do EDI permite as seguintes Bandeiras:
Bandeira

Autorizao

Cancelamento

IATA

Demais
bandeiras

O Canal de Captura EDI no suporta transaes de Dbito e Bandeiras


VANs (Amex e alguns Vouchers, por exemplo).

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

2 Conceitos
2.1 O que ?

O EDI - Eletronic Data Interchange, um canal de captura e processamento de


transaes em lote, por meio de troca de arquivos entre o cliente o parceiro de
transmisso de arquivos (VANs) e a Cielo.

2.2 Para que serve?

Autorizar transaes de carto no presente, principalmente transaes


recorrentes, ex.: Editoras, Seguradoras, Academias, etc.

Cancelar transaes de carto, presente ou no presente, independe do


canal onde foi realizada a autorizao: Mquina, TEF, E-Commerce ou EDI.

Transaes IATA: utilizado por Cias Areas internacionais que fazem parte do
sistema IATA e GDS.

Extrato eletrnico: indicado para clientes com grande volume de transaes,


com objetivo de facilitar a conciliao financeira.

2.3 Como funciona?

O cliente, aps credenciamento na Cielo, solicita os documentos de integrao


e a criao de uma caixa postal para envio dos arquivos EDI.

Desenvolve a integrao entre seus sistemas de gesto, backoffice ou


automao comercial para formatar as transaes de acordo com o layout EDI
(arquivo de transaes).

A Ilha de Atendimento EDI e o parceiro Cielo (VAN), prestam os suportes


necessrios ao cliente durante a fase de integrao.

O cliente envia os arquivos de transao, no formato (layout) especfico do


EDI, para a caixa postal eletrnica. Exceo: transaes IATA possuem layout
prprio.

Estas transaes so enviadas aos sistemas da Cielo, que realizar o


processamento de segunda-feira a sbado e envio destas transaes s
respectivas bandeiras de carto, para autorizao ou cancelamento das
mesmas.

A Cielo retorna o arquivo ao cliente em at 2 dias, com o resultado do


processamento de todas as transaes (aprovadas ou negadas com seus
motivos).

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

3 Consideraes Gerais

O arquivo de retorno estar disponvel para o Estabelecimento em at 48


horas, utilizando o mesmo layout.
O arquivo de Remessa de Vendas ou Cancelamento submetido at
12:00h ser retornado em D+1. Arquivos submetidos aps 12:00 h, sero
considerados como movimento do dia posterior e seu retorno ser em
D+2.
Os movimentos so processados de segunda a sbado. No h
processamento aos domingos.
Podem ser enviadas transaes de carto de crdito das bandeiras: Visa,
MasterCard, ELO e Diners.
Transaes de arquivos de Cias. Areas via IATA no so contempladas
neste manual. Possuem lay-out especfico..
No possumos ambiente de homologao para este servio.

Nomes dos retornos dos arquivos:

Ao enviar o arquivo de Submisso de Cancelamento, o sistema pode


retornar dois tipos de arquivo: Retmov ou Visa Erro.
Retmov: arquivo de retorno com todas as transaes (aprovadas ou
negadas).
Visa Erro: transaes que no foram efetuadas devido a um problema
de estrutura do arquivo enviado, tendo todas as transaes no
submetidas.
Possveis erros de digitao, bem como na estrutura do arquivo, so de
responsabilidade do cliente.

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

4 Dicas para formatao dos arquivos EDI


Resumo de Operao (RO)
Identifica o nmero do lote, grupo de transaes de venda.
Comprovante de Venda (CV)
Cada venda registrada em um comprovante de venda.

Cada Resumo de Operao (RO) poder conter at 9.999 Comprovantes de


Venda (CV's).
As transaes devero ser agrupadas por tipo de operao ( vista ou
parcelado loja), devendo-se criar um RO especfico para cada uma delas.
Para cada grupo de transaes (lote/RO) deve ser gerado um movimento
contendo header, detalhe(s) e trailler.
Para cada nmero de maquineta todas as regras acima devem ser aplicadas.
Deve ser submetido header, detalhe e trailler para cada maquineta e para
cada resumo de operao (RO)
O arquivo deve ser formatado com 1 nico lote (RO) de vendas parceladas
por maquineta e 1 lote de venda (RO) vista por maquineta.

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

5 Layout de Arquivos para Remessa e/ou Retorno de


Vendas
5.1 Registro Header
SEQ

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

POS = Posio inicial do Campo no Arquivo;


TAM = Tamanho do Campo
FOR = Formatos vlidos para o contedo do campo, sendo:
N = Numrico X = Alfanumrico

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

5.2 Registro Detalhe


SEQ

DESCRIO

POS

TAM

FOR

COMENTRIOS

Consistncias EDI

001

Tipo de registro

Identifica o tipo de registro


detalhe

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

Venda vista => valor da


venda
Venda parcelada => valor
total da venda

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

Valor da venda (*)

008

Quantidade de
parcelas

59

Venda vista => preencher


com zeros
Venda parcelada =>
quantidade de parcelas

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

Valor parcela (*)

107

15

Venda vista => preencher


com zeros
Venda parcelada => Valor
parcela (sem arredondar)

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

Na remessa preencher com


zeros, No retorno, ser
formatado pela CIELO
contendo status conforme
tabela ANEXO I

Sem verificaes

No lido

018

Data prevista de
liquidao

174

Na remessa preencher com


zeros; No retorno, ser
formatado pela CIELO com
a data prevista de
liquidao.

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

Deve ser brancos

023

Cdigo do Erro

211

04

Na remessa preencher com


brancos.
No retorno, caso haja erro
ser retornado pela Cielo
conforme ANEXO II

024

Referncia

215

11

Constante = brancos

025

Carto Novo

226

19

026

Vencto Novo

245

04

027

No utilizar

249

02

Na remessa preencher com


brancos.
No retorno, caso tenha
convnio renova fcil vir
o nmero carto alinhado a
esquerda com brancos
direita.
Na remessa preencher com
brancos.
No retorno, caso tenha
convnio renova fcil vir
a data do vencto. Carto
novo
Constante = brancos

Sem verificaes

Sem verificaes

No lido

10

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

5.3 Registro Trailler


SEQ

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

( * ) - Estes campos devem ser considerados com 2 (duas) casas decimais,


sem vrgulas, pontos ou qualquer outro caractere para separar nmeros.

11

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

6 Dicas sobre cancelamento de vendas

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

Layout de Arquivos de Remessa e Retorno de


Cancelamentos ( No PCI )
Layout utilizado para cancelamentos de transaes por meio do canal EDI,
por exemplo: transaes recorrentes.
Chave sem certificao PCI:
Nmero da Maquineta;
Nmero do carto;
Data,
Valor
Autorizao da transao original;

7.1 Registro Header


SEQ

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

7.2 Registro Detalhe


SEQ

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

Identifica o tipo de registro


detalhe
um nmero sequencial
atribudo pelo
estabelecimento, identifica
a transao dentro do lote.

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.

Preencher com o cdigo de


autorizao da venda.

Campo Obrigatrio

35

DDMMAAAA

43

0 vista
2 - Parcelado lojista

Venda vista => valor venda


Venda parcelada =>
somatria das parcelas e
valor de entrada.

Campo Obrigatrio
Tem que respeitar a
opo de venda

Venda vista => preencher


com zeros
Venda parcelada =>
quantidade de parcelas

Campo Obrigatrio
Tem que respeitar a
opo de venda

Venda vista => preencher


com zeros
Venda parcelada => Valor
original financiado

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

Venda vista => preencher


com zeros
Venda parcelada => Valor
da entrada

011

No utilizar

92

15

Constante = zeros

Rejeitado diferente 0
ou no numrico
Campo Obrigatorio
Tem que respeitar a
opo de venda

012

Valor parcela (*)

107

15

Venda vista => preencher


com zeros
Venda parcelada => Valor
da parcela (no
fazer arredondamento)

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

Informar o nmero original


do RO da venda

Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico

021

Valor do
reembolso /
cancelamento

193

15

Valor a ser reembolsado

Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico

022

No utilizar

208

03

Constante = brancos

Sem verificaes

Sem verificaes

Deve ser brancos

174

No lido

Formato = AAMM
Pode ser preenchido com
zeros

023

Cdigo do Erro

211

04

No remessa preencher com


brancos.
No retorno, caso haja erro
ser retornado pela Cielo
conforme ANEXO II

024

Nmero
referncia

215

11

Constante = brancos

025

Carto Novo

226

19

026

Vencto Novo

245

04

027

No utilizar

249

02

Na remessa preencher com


brancos. No retorno, caso
tenha convnio renova
fcil vir o nmero carto
alinhado a esquerda com
brancos direita.
Na remessa preencher com
brancos. No retorno, caso
tenha convnio renova
fcil vir a data do vencto.
do carto novo.
Constante = brancos

Sem verificaes

Sem verificaes

Sem verificaes

No lido

15

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

7.3 Registro Trailler


SEQ

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

8 Layout de Arquivos de Remessa e Retorno de


Cancelamentos (PCI)
Chave PCI:
Nmero da Maquineta;
NSU (documento);
Nmero Lgico do Terminal;
Data, valor e autorizao da transao original; e
Cdigo da Bandeira.

8.1 Registro Header


SEQ

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

Campo ObrigatrioNo enviar o mesmo


lote num perodo de
30 dias do envio
anterior

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

Somente dever ser


diferente de branco
caso a equipe de
sistemas assim
determinar.

011

Verso do Layout
do Arquivo

47

03

Preencher com 001

Nenhuma verificao

012

No utilizar

50

201

Constante = brancos

No lido

17

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

8.2 Registro Detalhe (PCI)


SEQ

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

Nmero Sequencial nico


da transao original
Preencher com o cdigo
de autorizao da venda.

008

Data da venda

35

DDMMAAAA

009

Opo da venda

43

0 vista
2 - Parcelado lojista

Venda vista => valor


venda
Venda parcelada =>
somatria das Parcelas e
valor entrada.

Venda vista =>


preencher com zeros
Venda parcelada => qtde
de parcelas

010

Valor da venda (*)

011

Quantidade de
parcelas

012

44

59

15

Valor financiado *

62

15

Valor da entrada *

77

15

013

014

No utilizar

92

15

Venda vista => preencher


com zeros
Venda parcelada => Valor
original financiado
Venda vista =>
preencher com zeros
Venda parcelada => Valor
da entrada
Constante = zeros

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

Valor parcela (*)

107

15

016

N do resumo de
operaes (RO)

122

129

132

10

017
018

No utilizar
Nmero do
estabelecimento

Venda vista =>


preencher com zeros
Venda parcelada => Valor
da parcela (no
fazer arredondamento)
Igual ao N.do RO
informado no registro
header
Constante = zeros
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 anexa
ANEXO I
Na remessa preencher
com zeros. No retorno,
ser formatado pela
CIELO com a data
prevista de liquidao

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

Preencher com 0000

Sem verificaes

186

Informar o nmero
original do RO da venda

Campo Obrigatrio
Rejeitado se < ou =
0 ou no numrico

193

15

Valor a ser reembolsado

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

8.3 Registro Trailler


SEQ

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

ANEXO I - Tabela de Cdigos de Retorno

Cdigo
de
Rejeio

Descritivo da Ocorrncia

Cdigo
de
Rejeio

00
02
04

Transao OK (Transao Aceita)


Cdigo de autorizao invlido
Lote misturado

01
03
05

06

Diferena de valor no RO

07

08
10
12
14

Valor de entrada invlido


Valor da parcela invlido
Transao invlida
No aplicvel
Transao original no localizada
(para cancelamento)

09
11
13
15

Nmero de referncia invlido

54

16
18
20
22
42
59
71
73

Cancelamento para parcelado de


transao j cancelada
Valor do cancelamento maior que o
permitido (alada)
Carto cancelado
Tipo carto invlido
Transao rejeitada pelo banco
emissor
Carto com problema - reter o
carto

17

21
23
56
60
72
74

75

Erro

76

77

Erro de sintaxe - refaa a transao

78

79

Carto cancelado

80

81

Fundos insuficientes

82

87

Carto no permitido

88

89
93
95

Mensagem difere da mensagem


original
Cancelamento com mais de 365
dias
Sem saldo em aberto

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

Banco emissor sem comunicao

94

Duplicidade de linhas areas

99

Outros motivos

21

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014

ANEXO II Detalhamento do erro para Status Venda


informado no campo 23

CDIGO
E001

Complemento Erro
Lote excedeu nmero de registros

Ao EC
Rever estrutura do arquivo

E001

Estrutura do lote incorreta

Rever estrutura do arquivo

E001

Meio de transmisso invlido

Contatar Cielo

E002

Reveja os dados do carto

E005

Nmero de Estabelecimento no encontrado

E005

Problema no seu cadastro na Cielo

Refaa a transao com dados validos


Confira os dados do Estabelecimento
Cielo
Contatar Cielo

E010

Problema no seu cadastro na Cielo

Contatar Cielo

E023

Problema no seu cadastro na Cielo

Contatar Cielo

E024

Tipo de carto no permitido neste canal

Contate seu cliente

E044

Data da transao no confere

Rever dados da transao original

E045

Cdigo de autorizao no encontrado

Confira os dados da transao

E048

Data de vencimento carto incorreta

Contate seu cliente

E054

Estrutura do lote incorreta

Reveja seu arquivo

E055

Quantidade de Parcelas invalida

Verificar a quantidade de parcelas

E056

Transao no permitida para seu cadastro

No reenviar a transao

E057

Carto cancelado

Contate seu cliente

E061

Refaa a transao com dados validos

E095

Reveja os dados do carto


Transao no permitida para carto
Internacional
Transao no permitida para carto Dbito

E097

Parcelado com valor inferior a R$ 5,00

E101

Transao rejeitada pelo banco Emissor

No reenviar a transao
Refaa ajustando a quantidade de
parcelas
Contate seu cliente

E102

Transao rejeitada pelo banco Emissor

Contate seu cliente

E103

Problema no seu cadastro na Cielo

Contatar Cielo

E104

Carto cancelado

Contate seu cliente

E105

Transao rejeitada pelo banco Emissor

Contate seu cliente

E107

Transao rejeitada pelo banco Emissor

Contate seu cliente

E112

Transao no permitida neste canal

Contatar Cielo

E112

Transao em moeda Dlar, no permitida.

No reenviar a transao

E112

Refaa incluindo o cdigo de autorizao

E112

Transao sem cdigo de autorizao


Transao no permitida para Cadastro
Recorrente
Transao autorizada anteriormente

E112

Carto no permitido para Cadastro Dlar

No reenviar a transao

E112

Transao Parcelada No Permitida

No reenviar a transao

E112

Problema no seu cadastro na Cielo

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

Transao no permitida para seu cadastro


Transao carto Internacional no permitida
para seu cadastro
Dados da transao invlidos

E114

Reveja os dados do carto

Refaa a transao com dados validos

E141

Carto cancelado

Contate seu cliente

E143

Contate seu cliente

E154

Carto cancelado
Transao no autorizada pelo banco
Emissor
Data de vencimento carto incorreta

E157

Carto cancelado

Contate seu cliente

E158

Tipo de carto no permitido neste canal

Contatar Cielo

E162

Carto no permitido para esta transao

Contate seu cliente

E180

Data da transao no confere

E182

Cdigo de segurana do carto invlido

E191

Banco Emissor sem comunicao

Rever dados da transao original


Rever dados da transao / Contate seu
cliente
Contatar Cielo

E192

Aplicvel para Cias Areas

Aplicvel para Cias Areas

E205

Reveja os dados do carto

Refaa a transao com dados validos

E207

Nmero do Lote invlido

Rever o nmero do Lote

E207

Campo Lote no numrico

Rever o nmero do Lote

E207

Nmero de Lote duplicado

Rever o nmero do Lote

E209

Aplicvel para Cias Areas

Rever o valor

E210

Quantidade de Parcelas invalida

Campo zerado quantidade de parcelas

E210

Quantidade de Parcelas invalida


Produto no autorizado para seu
Estabelecimento

Numero de parcelas excedeu limite

E112
E112

E151

E210

No reenviar a transao
Reveja dados da transao

Contate seu cliente


Contate seu cliente

Contatar Cielo

E210

Quantidade de parcelas maior que permitido

E211

Aplicvel para Cias Areas

Contatar Cielo para alterar cadastro


parcelado
Rever o valor

E212

Aplicvel para Cias Areas

Rever o valor

E213

Valor de cancelamento no permitido

Reveja os dados da transao

E214

Transao no localizada

Reveja os dados da transao

E215

Transao j cancelada

Contatar Cielo

E216

Transao cancelada anteriormente

No reenviar a transao

E217

Valor de cancelamento maior venda

Reveja dados da transao

E218

Cancelamento no permitido neste canal

Contatar Cielo

E219
E220

Nmero do RO no localizado
Prazo excedido para cancelar transao

Reveja os dados da transao


No reenviar a transao

E900

Tipo de Registro Invlido

Rever estrutura do arquivo

E901

Data do Depsito do Header Invlida

Reveja os dados da transao

Nmero do Resumo de Operaes (RO) do


Header Invlido
Nmero do Estabelecimento do Header
Invlido

Reveja o Nmero do Resumo de


Operaes (RO)
Reveja o Nmero de Estabelecimento /
Contate a Cielo

E902
E903

23

Cielo EDI
Manual de Integrao Verso 10 - 27-08-2014
E904

Moeda do Header Invlida

Reveja estrutura do Header

E905

Indicador de teste do Header Invlido

Reveja estrutura do Header

E906

Indicador de venda do Header Invlido

Reveja estrutura do Header


Reveja os dados da transao

E912

Nmero do Comprovante de Venda (CV)


Invlido
Data da Venda Invlida

E913

Opo da Venda Invlida

Reveja os dados da transao

Nmero do Carto Invlido

E911

Reveja os dados da transao

E915

Valor da Venda Invlido

Reveja os dados da transao / Contate


seu Cliente
Reveja os dados da transao

E916

Quantidade de Parcelas Invlida

Reveja os dados da transao

E917

Valor Financiado Invlido

Reveja os dados da transao

E918

Valor da Entrada Invlido

Reveja os dados da transao

E919

Valor da Taxa Embarque Invlido

Aplicvel para Cias Areas

E920

Valor da Parcela Invlido

Reveja os dados da transao

Nmero do Resumo de Operaes (RO)


Invlido
Nmero do Estabelecimento Invlido
Validade do Carto Invlido

Reveja o Nmero do Resumo de


Operaes (RO)
Reveja o Nmero de Estabelecimento /
Contate a Cielo
Contate seu cliente

E925

Nmero do Resumo de Operaes (RO)


Original Invlido
Valor do Reembolso Invlido

Reveja o Nmero do Resumo de


Operaes (RO)
Reveja os dados da transao

E926

Nmero de Referencia Invlido

Reveja os dados da transao

Quantidade de Registros do Trailer no


confere
Valor total bruto no confere

Reveja a quantidade de registros

E914

E921
E922
E923
E924

E930
E931

Reveja os dados da transao

24

Vous aimerez peut-être aussi