Introdução

Essa API possibilita o registro de grupos e mantém seu registro para receber arquivos EDI (Electronic Data Interchange).

Descrição do Produto

O Extrato Eletrônico é um produto disponibilizado pela Cielo aos clientes que necessitam de automatização no processo de conciliação. Nele, as informações são transmitidas de forma padronizada sem intervenção manual por meio do canal SFG (Sterling File Gateway), proporcionando agilidade e segurança no tráfego das informações. Ao lado, macrofluxo do serviço.

Benefícios

Fluxo de Concessão

Passo 1 - Login

1 - O parceiro redireciona o cliente para {cielo-login-url}.
2 - O cliente entra com suas credenciais e clica em Entrar.
3 - A Cielo mostra os termos de autorização e o cliente aprova este acesso clicando em Permitir Acesso.
4 - A Cielo redireciona o cliente para o parceiro novamente em {partner-call-back-url}.

Login e Concessão de Acesso

O que é cielo-login-url?

https://{base-login-url}?response_type=code &client_id={client_id} &redirect_uri={redirect_uri} &scope={scope} &state={state}

O que é partner-callback-url?

https://{partner-callback-url}?code={code}&state={state}

Passo 2 – Requisitando um Access Token

Request

POST {cielo-api-base-url}/consent/v1/oauth/access-token

Key Value
Authorization Basic Base64(client_id e client_secret do parceiro concatenado com “:” e codificado em base64)

curl --location --request POST 'https://{cielo-api-base-url}/consent/v1/oauth/access-token' \
--header 'Basic Basic64'
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type": "authorization_code",
    "code": "{}"
}'

Response


{
"access_token": "{access_token}",
"refresh_token": "{refresh_token}",
"token_type": "access_token",
"expires_in": {expiration_time}
}

Propriedade Descrição
access_token O access_token para chamar as APIs da Cielo.
refresh_token Quando o access_token expirar o parceiro pode solicitar um novo access_token usando este refresh_token.
expiration_time O tempo de expiração do access_token em milisgundos.

Observações

Passo 3 - Chamando as APIs

Neste momento parceiro vai conseguir chamar as APIs da Cielo sem a necessidade da aprovação do cliente, pois esta já foi concedida.

A única exigência para chamar as APIs da Cielo é enviar o seguinte header HTTP: Authorization: Bearer {access_token} Em todas as chamadas para as APIs.

Passo 3.1 - Atualizando um Access Token

  1. O serviço do parceiro chama o serviço de refresh_token.
  2. A Cielo retorna um access_token novo, um refresh_token novo e um novo expiration_time.

O dados de resposta serão os mesmos do passo 2 quando o parceiro solicita um acess_token, porém todos os dados retornados são novos e precisam ser armazenados no lugar dos antigos.

Request


curl --location --request POST 'https://{cielo-api-base-url}/consent/v1/oauth/access-token' \
--header 'Basic Basic64'
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type": "refresh_token",
    "refresh_token": "{}"
}'

Um ponto de atenção na requisição pois agora o parceiro precisa enviar o grant_type como refresh_token e no campo refresh_token deve ser enviado um refresh_token válido (e não mais um access_token).

Response


{
"access_token": "{access_token}",
"refresh_token": "{refresh_token}",
"token_type": "access_token",
"expires_in": {expiration_time}
}

Propriedade Descrição
access_token O access_token para chamar as APIs da Cielo.
refresh_token Quando o access_token expirar o parceiro pode solicitar um novo access_token usando este refresh_token.
expiration_time O tempo de expiração do access_token em milisgundos.

Erros

Caso ocorra algum erro do lado Cielo o cliente será redirecionado para a URL de call-back do parceiro com o parâmetro error na URL, por exemplo https://{partner-callback-url}?error={error}.

Possíveis valores para {error}:

Opcionalmente pode ser retornado um outro parâmetros error_description com um detalhe do erro, apenas um texto simples.

Observação

Ambiente

Ambiente Endereço
Sandbox https://api2.cielo.com.br/sandbox/
Homologação https://apihom-cielo.sensedia.com/
Produção https://api2.cielo.com.br/

Collection

Dispobilizamos as Collections utiizadas para realizar as todas operações da API. Será necessário configurar a URL e as credenciais.

Download das Collections

Operações

GET Consulta a Lista de Filiais

Executa a lista de clientes abaixo do access_token informado. O filtro pode ser usado para listar apenas aqueles disponíveis ou indisponíveis. Indisponível significa que a filial já participa de outro registro. Nos serviços de registro e edição, há validação para permitir que apenas aqueles disponíveis sejam informados.

Response

GET /edi/merchantgroup

Headers

Key Value  
  Authorization Bearer + access_token

{
  "legalEntityNumber": "string",
  "branches": [
    {
      "merchantID": "9999111222",
      "legalEntityNumber": "01234567890",
      "businessName": "V",
      "status": "UNAVAILABLE"
    }
  ]
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
branches Lista de Filiais      
businessName Nome da empresa      
status Filial disponível ou Indisponível      

GET Consultar configurações existentes.

Retorna configurações existentes agrupadas por mainMerchantID.

Response

GET /mainmerchants

Headers

Key Value
Authorization Bearer + access_token

{
   "registerID":"38724",
   "mainMerchantID":"2006907071",
   "merchants":[
      "2006907071"
   ],
   "type":[
      "SELL",
      "PAYMENT",
      "ANTECIPATION_CIELO",
      "ASSIGNMENT",
      "BALANCE",
      "ANTECIPATION_ALELO"
   ],
   "editStatus":"AVAILABLE"
}

POST Registrar merchantID

Registre o ID do lojista(apenas um, uma lista ou todos), com base no número da entidade.

Request

POST /edi/registers

Headers

Key Value
Authorization Bearer + access_token

{
  "mainMerchantId": "9999111222",
  "merchants": [
    "9999111111",
    "9999111333"
  ],
  "merchantEMail": "customer@customer.com",
  "type": [
    "SELL"
  ]
}

Propriedade Descrição Tipo Tamanho Obrigatório
mainMerchantId ID principal do cliente. String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
merchantEMail Endereço de e-mail do cliente      
type Representa o estado dos tipos de arquivo EDI. Pelo menos um desses arquivos é necessário: SELL, PAYMENT, ANTECIPATION_CIELO      

Response


{
  "legalEntityNumber": 1234567890,
  "mainMerchantId": 2008983,
  "registerID": 12345,
  "merchants": [
    823958412384701,
    679809436576210
  ],
  "type": [
    "SELL"
  ],
  "status": "PROCESSING"
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
mainMerchantId ID principal do cliente. String    
registerID ID do registro. O mesmo fornecido por /edi/registers String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
type Representa o estado dos tipos de arquivo EDI. Pelo menos um desses arquivos é necessário: SELL, PAYMENT, ANTECIPATION_CIELO      
status Status de registro. Se concluído, os arquivos serão fornecidos no dia seguinte      

GET Consultar o Status do Registro

Recupere o status de registro do EDI.

Response

GET /edi/registers/{registerID}

Headers

Key Value
Authorization Bearer + access_token
registerID Valor usado para recuperar o status do registro.

{
  "legalEntityNumber": "01234567890",
  "registerID": 12345,
  "merchants": [
    9999222111,
    9999222222
  ],
  "status": "PROCESSING"
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
registerID ID do registro. O mesmo fornecido por /edi/registers String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
status Status de registro. Se concluído, os arquivos serão fornecidos no dia seguinte      

GET Consulta o Registro do merchantID

Consulte o MerchantID com base no registerID ou no mainMerchantID.

Response

GET /edi?registerID=&mainMerchantID=

Headers

Key Value
Authorization Bearer + access_token
registerID O registerID é fornecido pela operação /edi/registers ao se registrar. Pode ser usado no lugar de mainMerchantID, se preferir (apenas um precisa ser informado).
mainMerchantID A maneira mais comum de recuperar um registro EDI na empresa. Pode ser usado em vez de registerID, principalmente em casos de registro não realizados por /edi/registers.

{
  "legalEntityNumer": "12314314",
  "mainMerchantId": 9999111222,
  "registerID": 12345,
  "merchants": [
    9999111111,
    9999111333
  ],
  "type": [
    "SELL"
  ],
  "acknowledge": "COMPLETED"
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
mainMerchantId ID principal do cliente. String    
registerID ID do registro. O mesmo fornecido por /edi/registers String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
type Representa o estado dos tipos de arquivo EDI. Pelo menos um desses arquivos é necessário: SELL, PAYMENT, ANTECIPATION_CIELO      

PUT Atualizar o Registro do merchantID

Atualize o merchantID com base no registerID ou mainMerchantID.

Request

PUT /edi

Headers

Key Value
Authorization Bearer + access_token

{
  "registerID": "string",
  "mainMerchantId": "9999222333",
  "merchants": [
    "9999222111",
    "9999222222"
  ],
  "type": [
    "SELL"
  ]
}

Propriedade Descrição Tipo Tamanho Obrigatório
registerID ID do registro. O mesmo fornecido por /edi/registers String    
mainMerchantId ID principal do cliente. String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
type Representa o estado dos tipos de arquivo EDI. Pelo menos um desses arquivos é necessário: SELL, PAYMENT, ANTECIPATION_CIELO      

Response


{
  "legalEntityNumber": "01234567890",
  "mainMerchantId": 9999111222,
  "registerID": 12345,
  "merchants": [
    9999222333,
    9999111222
  ],
  "type": [
    "SELL"
  ]
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
mainMerchantId ID principal do cliente. String    
registerID ID do registro. O mesmo fornecido por /edi/registers String    
merchants Representa o estado da lista de códigos do comerciante (todos os clientes do grupo serão considerados se omitidos). Exemplo: Lista [“9999111111”, “9999111333”]      
type Representa o estado dos tipos de arquivo EDI. Pelo menos um desses arquivos é necessário: SELL, PAYMENT, ANTECIPATION_CIELO      

DELETE Excluir o Registro do merchantID

Consulte o MerchantID com base no registerID ou no mainMerchantID.

Response

DELETE /edi

Headers

Key Value
Authorization Bearer + access_token
registerID O registerID é fornecido pela operação /edi/registers ao se registrar. Pode ser usado no lugar de mainMerchantID, se preferir (apenas um precisa ser informado).
mainMerchantID A maneira mais comum de recuperar um registro EDI na empresa. Pode ser usado em vez de registerID, principalmente em casos de registro não realizados por /edi/registers.

{
  "legalEntityNumer": "12314314",
  "mainMerchantId": 9999111222,
  "registerID": 12345,
  "acknowledge": "COMPLETED"
}

Propriedade Descrição Tipo Tamanho Obrigatório
legalEntityNumber Número de entidade brasileiro. Para uma pessoa jurídica, a raiz (primeiros 8 dígitos) do documento CNPJ deve ser informada. No caso de uma pessoa, todo o documento CPF deve ser informado (11 dígitos, são necessários zeros à esquerda para completar esse tamanho). String 8  
mainMerchantId ID principal do cliente. String    
registerID ID do registro. O mesmo fornecido por /edi/registers String    
acknowledge        

Tipos de Extrato Eletrônico

Tabela A - Tipos de Arquivo

Tipo de Arquivo Informação Tipo de Registro Objetivo
03 Vendas com Plano Parcelado Vendas concluídas (capturadas) no dia anterior, ajustes e transações rejeitadas, com a previsão de pagamento. Todo o plano parcelado da venda realizada no dia anterior. 0 - Header
1 - Detalhe RO (com a primeira parcela)
2 - Detalhe CV
1 - Detalhe RO (previsão da segunda parcela em diante)
9 - Trailer
Conferir se todas as vendas realizadas foram recebidas pela Cielo e as previsões de pagamento.
04 Pagamentos Valores pagos na conta-corrente no dia do envio do Extrato: detalha os ROs e ajustes compensados no dia.
Transações compensadas, já antecipadas ou cedidas anteriormente e pagamentos de parcelas em aberto.
0 - Header
1 - Detalhe RO
2 - Detalhe CV
9 - Trailer
Conferir origem do pagamento recebido (tipo de venda, bandeira e cliente/estabelecimento que efetuou a venda).
Conciliação com a conta corrente.
06 Antecipação de Recebíveis Cielo Operação de ARV realizada pela Cielo no dia anterior ao envio do arquivo e respectivo detalhe dos ROs e CVs que foram antecipados. 0 - Header
5 - Detalhe de ARV
6 - Detalhe ROs antecipados
2 - Detalhe CV
7 - Detalhe dos débitos de ROs Antecipados
2 - Detalhe CV
9 - Trailer
Obs.: Será demonstrado o registro tipo 5 para cada operação realizada.
Atualizar o fluxo de caixa, considerando os valores já recebidos através da antecipação.
07 Cessão de Recebíveis Operação de cessão realizada no banco Bradesco no dia anterior ao envio do arquivo e respectivo detalhe dos ROs cedidos.
Não é demonstrada a condição comercial negociada ou parcela cedida
0 - Header
5 - Detalhe de ARV
6 - Detalhe ROs antecipados 9 - Trailer
Obs.: Será demonstrado o registro tipo 5 para cada operação realizada.
Atualizar o fluxo de caixa, considerando os valores já recebidos através da operação de cessão.
09 Saldo em Aberto Valores a receber com a Cielo, contemplando as transações realizadas, capturadas e processadas, vendas a débito, crédito e parceladas ainda não liquidadas no movimento fechado no mês anterior. O arquivo é disponibilizado mensalmente. 0 - Header
1 - Detalhe RO
9 - Trailer
Atualizar a previsão futura de recebimentos. Este extrato é o analítico da Carta Saldo (Carta de Circularização) encaminhado para fins de auditoria. Não deve ser utilizado para conciliação.
10 Antecipação de Recebíveis Alelo Operação de ARV realizada pela Alelo no dia anterior ao envio do arquivo e respectivo detalhe dos ROs e CVs que foram antecipados. 0 - Header
5 - Detalhe de ARV
6 - Detalhe ROs antecipados
2 - Detalhe CV
7 - Detalhe dos débitos de ROs Antecipados
2 - Detalhe CV
9 - Trailer
Obs.: Será demonstrado o registro tipo 5 para cada operação realizada.
Atualizar o fluxo de caixa, considerando os valores já recebidos através da antecipação.

Layouts dos Tipos de Registros

Tabela B - Registro 0 - Header

Identifica o cabeçalho de cada arquivo por matriz de extrato eletrônico*

Inicio Fim Tamanho Tipo Descrição Edição dos Dados
001 001 1 Num. Tipo de registro Constante 0 : identifica o tipo de registro header (início do arquivo).
002 011 10 Num. Estabelecimento Matriz Número do estabelecimento matriz de extrato eletrônico.  
012 019 8 Num. Data de processamento AAAAMMDD data em que o arquivo foi gerado.  
020 027 8 Num. Período inicial AAAAMMDD período inicial.  
028 035 8 Num. Período final AAAAMMDD período final.  
036 042 7 Num. Sequência Número sequencial do arquivo. Nos casos de recuperação, este dado será enviado como 9999999.  
043 047 5 Alfa. Empresa adquirente Constante Cielo.  
048 049 2 Num. Opção de extrato Vide Tabela I.  
050 050 1 Alfa. Transmissão Cielo.  
051 070 20 Alfanum. Caixa Postal Caixa postal.  
071 073 3 Num. Versão Layout Constante 013.  
074 250 177 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.  

Registro 1 - Detalhe do Resumo de Operações (RO)

Grupo de vendas, ajustes ou cobrança de serviços. Permite identificar a origem dos lançamentos e as ações de manutenção.

Inicio Fim Tamanho Tipo Descrição Edição dos Dados
001 001 1 Num. Tipo de registro Constante 1 - Identifica o tipo de registro detalhe do RO.
002 011 10 Num. Estabelecimento Submissor Número do estabelecimento e/ou filial onde a venda foi realizada.
012 018 7 Num. Número do RO Número do resumo de operação. Contêm informações referentes a um grupo de vendas realizadas em uma determinada data.
019 020 2 Num. Parcela No caso de venda parcelada, será formatado com o número da parcela que está sendo liberada na data do envio do arquivo. No caso de venda à vista, será formatado com brancos.
021 021 1 Alfa Filler "/" - Para vendas parceladas.
"a" - aceleração das parcelas.
" " - demais situações.
022 023 2 Alfanum. Plano No caso de venda parcelada, será formatado com o maior número de parcelas encontradas naquele grupo de vendas. Se o RO tiver vendas em 03, 04 ou 06 parcelas, será preenchido com 06. Se for uma aceleração de parcelas, será formatado com a maior parcela acelerada.
Exemplo: (posições 019 a 023)
02A02 indica a aceleração da parcela 02 até a 02, ou seja, somente uma parcela.
03A08 indica a aceleração da parcela 03 até a parcela 08 do plano da venda, ou seja, foram aceleradas 06 parcelas.
No caso de venda à vista, será formatado com brancos.
024 025 2 Num. Tipo de Transação Código que identifica a transação vide Tabela II.
026 031 6 Num. Data de apresentação AAMMDD Data em que o RO foi transmitido para a Cielo.
032 037 6 Num. Data prevista de pagamento AAMMDD Data prevista de pagamento. Na recuperação, pode ser atualizada após o processamento da transação ou ajuste.
038 043 6 Num. Data de envio ao banco AAMMDD Data em que o arquivo de pagamento foi enviado ao banco. Na recuperação, pode ser atualizada após o processamento da transação ou ajuste.
044 044 1 Alfa Sinal do valor bruto + - identifica valor a crédito.
- - identifica valor a débito.
045 057 13 Num. Valor bruto (*) Somatória dos valores de venda.
058 058 1 Alfa Sinal da taxa administrativa + - identifica valor a crédito.
- - identifica valor a débito.
059 071 13 Num. Valor da taxa administrativa (*) Valor da taxa administrativa descontada sobre as vendas.
072 072 1 Alfa Sinal do valor rejeitado + identifica valor a crédito.
- - identifica valor a débito.
073 085 13 Num. Valor rejeitado (*) Se houver rejeição, será preenchido com a somatória das transações rejeitadas.
086 086 1 Alfa Sinal do valor líquido + identifica o valor a crédito.
- - identifica o valor a débito.
087 099 13 Num. Valor líquido (*) Valor das vendas descontado o valor da taxa administrativa.
100 103 4 Alfanum. Banco Código do banco no qual os valores foram depositados.
104 108 5 Alfanum. Agência Código da agência na qual os valores foram depositados.
109 122 14 Alfanum. Conta-corrente / poupança Conta-corrente / poupança na qual os valores foram depositados.
123 124 2 Num. Status do pagamento Identifica a situação em que se encontram os créditos enviados ao banco vide Tabela III. Na recuperação, o status é atualizado de acordo com o envio e retorno de confirmação de pagamento por parte do banco.
125 130 6 Num. Quantidade de CVs aceitos Quantidades de vendas aceitas no RO.
131 132 2 Num. Código do Produto (Desconsiderar) A partir de 01/03/2014, o Identificador do produto passou a ser enviado nas posições 233-235 com três caracteres.
133 138 6 Num. Quantidades de CVs rejeitados Quantidade de vendas rejeitadas no RO.
139 139 1 Alfa Identificador de revenda/aceleração Identifica as ocorrências de manutenção em transações parceladas na loja:
R - Revenda
A - Aceleração
"" - Brancos (nenhuma ocorrência).
140 145 6 Num. Data de captura da transação AAMMDD - Data em que a transação foi capturada pela Cielo. Na recuperação, pode ser atualizada após o processamento da transação ou ajuste.
146 147 2 Alfanum. Origem do ajuste Identifica o tipo de ajuste vide Tabela V. Preenchido se o tipo de transação for:
02 Ajuste crédito
03 Ajuste débito
04 Ajuste aluguel
148 160 13 Num. Valor complementar Valor do saque quando o produto for igual a 36 ou valor do Agro Electron para transações dos produtos 22 23 ou 25 apresentados na Tabela IV.
161 161 1 Alfa Identificador de Antecipação Identificador de antecipação do RO:
" " - Não antecipado;
"A" - Antecipado Cielo ou Alelo;
C - Antecipado no banco - Cessão de Recebíveis.
 
162 170 9 Num. Número da operação de Antecipação Identifica o número da operação de Antecipação apresentada no registro tipo 5 campo 12 ao 20, associada ao RO antecipado na Cielo/Alelo ou cedido no banco.
Conterá zeros, caso o RO não tenha sido antecipado.
171 171 1 Alfa Sinal do valor Bruto antecipado + identifica valor a crédito. - - identifica valor a débito.
172 184 13 Num. Valor Bruto Antecipado (*) Valor bruto antecipado, fornecido quando o RO for antecipado/cedido. Será preenchido com zeros quando não houver antecipação.
185 187 3 Num. Bandeira Código da Bandeira vide tabela VI.
188 209 22 Num. Número Único do RO Número Único de identificação do RO formatado da seguinte forma:
Primeira parte (fixa) 15 posições fixas: identifica o resumo mantendo o seu histórico na Cielo;
Segunda parte (variável) 07 posições variáveis: Identifica as alterações realizadas no RO.
210 213 4 Num. Taxa Administrativa (*) Percentual de taxa administrativa aplicado no valor da transação.
214 218 5 Num. Tarifa Administrativa (*) Tarifa cobrada por transação.
219 222 4 Num. Taxa de Garantia (*) Percentual de desconto aplicado sobre transações Electron Pré-Datado.
223 224 2 Num. Meio de Captura Vide tabela VII. Caso a venda tenha sido reprocessada, o sistema enviará o meio de captura 06: Meio de captura manual. Neste caso, desconsiderar o valor informado no número lógico do terminal.
225 232 8 Alfanum. Número lógico do terminal Número lógico do terminal onde foi efetuada a venda. Quando o meio de captura for igual a 06, desconsiderar o número lógico do terminal, pois este será um número interno da Cielo.
233 235 3 Num. Código do Produto Código que identifica o produto vide Tabela IV.
236 245 10 Num. Matriz de Pagamento Estabelecimento matriz de pagamento.
246 246 1 Alfa Reenvio de Pagamento S - identifica que este resumo está sendo reenviado no extrato. Desconsiderar o pagamento enviado anteriormente. N - não refere-se à reenvio de pagamento.
247 247 1 Alfa Conceito aplicado Identifica o conceito aplicado no resumo apresentado:
" " - Antigo
"N" - Novo
248 249 2 Alfanum. Grupo de Cartões Identifica o grupo de cartões conforme abaixo:
- Brancos. Serviço não atribuído
01 - Cartão emitido no Brasil
02 - Cartão emitido no exterior
03 - MDR por Tipo de Cartão - Inicial
04 - MDR por Tipo de Cartão - Intermediário 05 - MDR por Tipo de Cartão - Superior
250 250 1 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.

Registro 2 - Detalhe do Comprovante de Venda (CV)

Detalhe das vendas ou ajustes agrupados em um RO. Conforme regras de segurança, todos os registros que possuírem número de cartão apresentarão o número truncado.

001 001 1 Num. Tipo de registro Constante "2" identifica o tipo de registro de detalhe do Comprovante de Venda (CV).
002 011 10 Num. Estabelecimento Submissor Número do estabelecimento e/ou filial onde a venda foi realizada.
012 018 7 Num. Número do RO Número do resumo de operação. Contêm informações referentes a um grupo de vendas realizadas em uma determinada data.
019 037 19 Alfanum. Número do cartão truncado Número do cartão truncado: número do cartão que efetuou a compra com número truncado. Conterá zeros para compras via mobile payment ou comércio eletrônico, sendo para o último opcional.
038 045 8 Num. Data da venda/ajuste AAAAMMDD Data em que a venda ou o ajuste foi realizado.
046 046 1 Alfa. Sinal do valor da compra ou valor da parcela "+" - identifica valor a crédito. "-" - identifica valor a débito.
047 059 13 Num. Valor da compra ou valor da parcela (*) Valor da compra ou da parcela que foi liberada, no caso de venda parcelada na loja.
060 061 2 Num. Parcela No caso de venda parcelada, será formatado com o número da parcela que está sendo liberada. No caso de venda à vista, será formatado com zeros.
062 063 2 Num. Total de parcelas Número total de parcelas da venda. No caso de venda à vista, será formatado com zeros.
064 066 3 Num. Motivo da rejeição Vide Tabela VIII, caso não possua rejeição o campo é formatado em branco.
067 072 6 Alfanum. Código de autorização Código de autorização da transação. Este número não é único e pode se repetir. Para efeito de conciliação deverá ser combinado com outras chaves.
073 092 20 Alfanum. TID Identificação da transação realizada no comércio eletrônico
093 098 6 Alfanum. NSU/DOC Número sequencial, também conhecido como DOC (número do documento), que identifica a transação no dia em que ela foi realizada. Este número não é único e pode se repetir. Caso a venda tenha sido reprocessada, o NSU pode ser alterado.
099 111 13 Num. Valor Complementar (*) Valor da transação de Saque com cartão de Débito ou Agro Electron de acordo com indicador de produto do RO.
112 113 2 Num. Dig Cartão Número de dígitos do cartão.
114 126 13 Num. Valor total da venda Valor total da venda no caso de Parcelado Loja.
127 139 13 Num. Valor da próxima parcela Valor da próxima parcela no caso de Parcelado Loja.
140 148 9 Alfanum. Número da Nota Fiscal Número da nota fiscal para estabelecimentos que capturam esta informação na máquina. Quando não disponível será formatado com zeros.
149 150 2 Alfanum. Tipo de Cartão Código do tipo de cartão vide tabela XI.
151 152 2 Alfanum. Grupo de Cartões Código do grupo de cartões vide tabela X.
153 160 8 Alfanum. Número lógico do terminal Número lógico do terminal onde foi efetuada a venda. Quando o Meio de Captura for 06, desconsiderar esta informação.
161 162 2 Alfa Identificador de taxa de embarque ou valor de entrada Identificação da transação referente à taxa de embarque ou valor de entrada:
TX - Taxa de embarque;
VE - Valor da entrada;
Brancos - para demais tipos de transação.
163 182 20 Alfanum. Referência/código do pedido Referência ou código do pedido informado em uma transação de comércio eletrônico.
Quando não disponível, será formatado com brancos.
183 188 6 Num. Hora da transação Hora da transação apresentada no formado HHMMSS.
Essa informação será gerada somente nos registros de venda do arquivo de venda com CV original.
Nos demais casos, o campo será formatado com zeros.
189 217 29 Num. Número único da transação Número Único que identifica cada transação.
218 218 1 Alfa Indicador Cielo Promo Identificador do Produto Cielo Promo = “S”.
Identifica que a venda participou de campanha na Plataforma Promocional.
Caso contrário, será formatado com brancos.
219 220 2 Num. Modo de Entrada do Cartão Identifica o modo de entrada do cartão. Vide Tabela IX.
221 235 15 Alfanum. Código da Venda dentifica o código da venda. (somente conceito novo).
236 250 15 Alfanum. Código Interno do Ajuste Identifica o código de agrupamento dos ajustes. (somente conceito novo).

Registro 5 - Detalhe da Operação de Antecipação de Recebíveis

Apresenta a operação de antecipação realizada na Cielo / Alelo ou de cessão de recebíveis (Banco Bradesco) realizada no dia anterior à geração do arquivo.

001 001 1 Num. Tipo de registro Constante "5" identifica o tipo de registro que apresenta as informações de uma operação de antecipação.
002 011 10 Num. Estabelecimento de pagamento ou submissão Número do estabelecimento.
012 020 9 Num. Número da operação de Antecipação Número da operação de Antecipação, também apresentado no registro tipo 1 na data de liquidação do RO.
021 028 8 Num. Data de crédito da operação AAAAMMDD Data de pagamento da operação.
029 029 1 Alfa Sinal do valor bruto da antecipação à vista. "+" - identifica valor positivo.
"-" - identifica valor negativo.
030 042 13 Num. Valor bruto da antecipação à vista Valor bruto da antecipação de agenda à vista.
O valor bruto da antecipação corresponde à soma dos valores lîquidos originais dos ROs antecipados dessa agenda.
043 043 1 Alfa Sinal do valor bruto da antecipação parcelado. "+" - identifica valor positivo.
"-" - identifica valor negativo.
044 056 13 Num. Valor bruto da antecipação parcelado Valor bruto da antecipação da agenda do parcelado.
O valor da antecipação corresponde à soma dos valores líquidos originais dos ROs antecipados dessa agenda.
057 057 1 Alfa Sinal do valor bruto da antecipação Eléctron Pré-Datado "+" - identifica valor positivo.
"-" - identifica valor negativo.
058 070 13 Num. Valor bruto da antecipação Eléctron Pré-Datado. Valor bruto da antecipação da agenda do Electron Pré-Datado.
O valor bruto da antecipação corresponde à soma dos valores líquidos originais dos ROs antecipados dessa agenda.
071 071 1 Alfa Sinal do valor bruto da antecipação "+" - identifica valor positivo.
"-" - identifica valor negativo.
072 084 13 Num. Valor bruto da antecipação O valor bruto da antecipação corresponde à soma dos valores líquidos originais dos ROs antecipados.
085 085 1 Alfa Sinal do valor líquido da antecipação à vista "+" - identifica valor positivo.
"-" - identifica valor negativo.
086 098 13 Num. Valor líquido da antecipação à vista Valor líquido da antecipação da agenda à vista.
099 099 1 Alfa Sinal do valor líquido da antecipação parcelado "+" - identifica valor positivo.
"-" - - identifica valor negativo.
100 112 13 Num. Valor líquido da antecipação parcelado Valor líquido da antecipação da agenda do parcelado.
113 113 1 Alfa Sinal do valor líquido da antecipação PréDatado "+" - identifica valor positivo.
"+" - identifica valor negativo.
114 126 13 Num. Valor líquido da antecipação Pré-Datado Valor líquido da antecipação da agenda do Electron Pré-Datado.
127 127 1 Alfa Sinal do valor líquido da antecipação "+" - identifica valor positivo.
"-" - identifica valor negativo.
128 140 13 Num. Valor líquido da antecipação Valor líquido da antecipação das agendas à vista, parcelado e Electron Pré-Datado.
141 145 5 Num. Taxa de desconto da antecipação (*) Taxa de desconto comercial da antecipação.
146 149 4 Alfanum. Banco Código do banco no qual os valores foram depositados.
150 154 5 Alfanum. Agência Código da agência na qual os valores foram depositados.
155 168 14 Alfanum. Conta-corrente / poupança Conta-corrente / poupança na qual os valores foram depositados.
169 169 1 Alfa Sinal do valor líquido da antecipação total "+" - identifica valor positivo. "-" - identifica valor negativo.
170 182 13 Num. Valor líquido da antecipação total Valor líquido da antecipação total (deduzido a taxa e tarifa).
183 183 1 Alfa Sinal do valor da tarifa "+" - identifica valor positivo. "-" - identifica valor negativo.
184 192 9 Num. Tarifa Valor da tarifa cobrada por operação. Se não houver cobrança de tarifa, o campo será preenchido em branco.
193 250 58 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.

Registro 6 - Detalhe dos ROs Antecipados

Apresenta o detalhamento da operação de Antecipação demonstrando os ROs antecipados/cedidos.

001 001 1 Num. Tipo de registro Constante 6 identifica o tipo de registro que apresenta as informações de um RO que foi antecipado.
002 011 10 Num. Estabelecimento Submissor Número do estabelecimento e/ou filial onde a venda foi realizada.
012 020 9 Num. Número da operação de antecipação Número da operação de antecipação.
021 028 8 Num. Data de vencimento do RO AAAAMMDD Data de vencimento original do RO que foi antecipado.
029 035 7 Num. Número do RO antecipado Número do RO antecipado.
036 037 2 Num. Parcela antecipada Número da parcela antecipada no caso de RO parcelado, se RO de venda à vista, será formatado com zeros.
038 039 2 Num. Total de parcelas Quantidade de parcelas do RO. No caso de RO de venda à vista, será formatado com zeros.
040 040 1 Alfa Sinal do valor bruto original do RO "+" - identifica valor positivo. "-" - identifica valor negativo.
041 053 13 Num. Valor bruto original do RO (*) Valor bruto original do RO.
054 054 1 Alfa Sinal do valor líquido original do RO "+" - identifica valor positivo. "-" - identifica valor negativo.
055 067 13 Num. Valor líquido original do RO (*) Valor líquido Original do RO.
068 068 1 Num. Sinal do valor bruto da antecipação do RO "+" - identifica valor positivo. "-" - identifica valor negativo.
069 081 13 Num. Valor bruto da antecipação do RO (*) Valor líquido original do RO, exceto se houver débitos programados para este RO.
082 082 1 Alfa Sinal do valor líquido da antecipação do RO "+" - identifica valor positivo. "-" - identifica valor negativo.
083 095 13 Num. Valor líquido da antecipação do RO (*) Valor pago ao estabelecimento descontada a taxa de desconto comercial da antecipação.
096 098 3 Num. Bandeira Código da Bandeira vide Tabela VI.
099 120 22 Num. Número Único do RO Número Único de identificação do RO formatado da seguinte forma:
Primeira parte (fixa) - 15 posições fixas: identifica o resumo mantendo o seu histórico na Cielo;
Segunda parte (variável) - 07 posições variáveis: para uso da Cielo. Identifica as alterações realizadas no RO.
121 121 1 Alfanum. Identificador de RO de ajuste antecipado S considerar ajuste antecipado.
Campo preenchido somente quando os ROs de ajustes forem efetivamente antecipados. (somente conceito novo).
122 250 129 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.

Registro 7 - Detalhe dos Débitos de ROs Antecipados

Apresenta os débitos compensados nas datas antecipadas.

001 001 1 Num. Tipo de registro Constante 7 identifica o tipo de registro que apresenta as informações de um RO que foi antecipado.
002 011 10 Num. Estabelecimento Submissor Número do estabelecimento e/ou filial onde a venda foi realizada.
012 033 22 Num. Número Único do RO original da venda Número único do RO original da venda.
034 040 7 Num. Número do RO antecipado Número do RO da venda original.
041 048 8 Num. Data de pagamento do RO antecipado AAAAMMDD Data de Pagamento do RO Antecipado.
049 049 1 Alfa Sinal do valor do RO antecipado "+" - identifica valor positivo."-" - identifica valor negativo.
050 062 13 Num. Valor do RO antecipado Valor do RO antecipado.
063 084 22 Num. Nº Único do RO da venda que originou o ajuste Número único do RO da venda que originou o ajuste.
085 091 7 Num. Nº do RO de ajuste a débito Número do RO que apresenta os valores retidos para a operação de antecipação.
092 099 8 Num. Data de pagamento do ajuste AAAAMMDD.
100 100 1 Alfa Sinal do valor do ajuste a débito "+" - identifica valor positivo. "-" - identifica valor negativo.
101 113 13 Num. Valor do ajuste a débito Valor total do débito.
114 114 1 Alfa Sinal do valor compensado "+" - identifica valor positivo. "-" - identifica valor negativo.
115 127 13 Num. Valor compensado Valor compensado do RO antecipado.
128 128 1 Alfa Sinal do saldo do RO antecipado "+" identifica valor positivo. "-" - identifica valor negativo.
129 141 13 Num. Valor do saldo do RO antecipado Resultado do total de débito valor compensado.
142 250 109 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.

Registro 9 - Trailer

Indica o final do arquivo.

001 001 1 Num. Tipo de registro Constante Identifica o tipo de registro de detalhe trailer (final do arquivo).
002 012 11 Num. Total de registro Número total de registros, os quais não incluem header e trailer.
013 013 1 Alfa Sinal Valor Líquido da soma de todos os CVs "+" - identifica valor positivo. "-" - identifica valor negativo.
014 030 17 Num. Valor Líquido da soma de todos os CVs Valor Líquido da soma de todos os CVs.
031 041 11 Num. Quantidade total de CVs Quantidade total de CVs.
042 250 209 Alfanum. Uso Cielo Em Branco. Reservado para Cielo.

Observação: os campos reservados para a Cielo poderão ser utilizados para a inclusão de novas informações. Também poderá ser necessário incluir novos tipos de registros. Por conta disso, sugerimos que a solução de conciliação despreze os registros não relacionados nesta especificação.

Tabelas

Tabela I - Tipos de Arquivos

Type Codigo Tabela I Descrição
SELL 03 Vendas com Plano Parcelado
PAYMENT 04 Pagamentos
ANTECIPATION_CIELO 06 Antecipação de Recebíveis Cielo
ASSIGNMENT 07 Cessão de Recebíveis
BALANCE 09 Saldo em aberto
ANTECIPATION_ALELO 10 Antecipação de Recebíveis Alelo

Tabela II - Opção de Extrato

Código Descrição
03 Vendas com Plano Parcelado
04 Pagamentos
06 Antecipação de Recebíveis Cielo
07 Cessão de Recebíveis
09 Saldo em Aberto
10 Antecipação de Recebíveis Alelo

Tabela III - Tipo de Transação

Código Descrição
01 Venda
02 Ajuste a Crédito
03 Ajuste a Débito
04 Plano Cielo
05 Reagendamento

Tabela IV - Status do Pagamento

Código Descrição
00 Agendado: identifica a captura de uma transação e informa a previsão de pagamento. A data prevista poderá ser alterada.
01 Pago: identifica que o pagamento foi realizado pelo banco domicílio.
02 Enviado para o Banco: identifica que a Cielo solicitou o pagamento/cobrança para o banco domicílio, porém não houve confirmação.
03 A Confirmar: identifica que a Cielo solicitou o pagamento/cobrança para o banco domicílio, porém ainda não houve confirmação.

Quando um valor a crédito estiver em processo de compensação com um valor a débito, ambos serão enviados no arquivo de pagamento na data da compensação, posterior a data prevista de pagamento. O status enviado para o banco poder ser novamente apresentado no extrato de pagamento, quando o banco domicílio devolver uma ordem de crédito (reenvio de pagamento)

Tabela V - Código do Produto

Código Descrição
001 Agiplan crédito à vista
002 Agiplan parcelado loja
003 Banescard crédito à vista
004 Banescard parcelado loja
005 Esplanada crédito à vista
006 Credz crédito à vista
007 Esplanada parcelado loja
008 Credz parcelado loja
009 Elo Crediário
010 Mastercard crédito à vista
011 Maestro
012 Mastercard parcelado loja
013 Elo Construcard
014 Elo Agro Débito
015 Elo Agro Custeio
016 Elo Agro Investimento
017 Elo Agro Custeio + Débito
018 Elo Agro Investimento + Débito
019 Discover crédito à vista
020 Diners crédito à vista
021 Diners parcelado loja
022 Visa Agro Custeio + Débito
023 Visa Agro Investimento + Débito
024 FCO Investimento
025 Agro Electron
026 Agro Custeio
027 Agro Investimento
028 Visa FCO Giro
029 Visa crediário no crédito
030 Visa parcelado cliente
033 JCB crédito a vista
036 Visa Saque com cartão de Débito
037 Flex Car Visa Vale
038 Credsystem crédito à vista
039 Credsystem parcelado loja
040 Visa crédito à vista
041 Visa Electron Débito à vista
042 Visa Pedágio
043 Visa parcelado loja
044 Visa Electron Pré-Datado
045 Alelo Refeição
046 Alelo Alimentação
058 Alelo Multibenefícios
059 Alelo Auto
060 Sorocred débito à vista
061 Sorocred crédito à vista
062 Sorocred parcelado loja
064 Visa Crediário
065 Alelo Refeição
066 Alelo Alimentação
067 Visa Capital de Giro
068 Visa Crédito Imobiliário
069 Alelo Cultura
070 Elo crédito a vista
071 Elo débito à vista
072 Elo parcelado loja
079 Pagamento Carnê Visa Electron
080 Visa Crédito Conversor de Moeda
081 Mastercard Crédito Especializado (*)
082 Amex crédito à vista
083 Amex parcelado loja
084 Amex parcelado banco
089 Elo Crédito Imobiliário
091 Elo Crédito Especializado (*)
094 Banescard Débito
096 Cabal crédito à vista
097 Cabal débito à vista
098 Cabal parcelado loja
161 Hiper crédito à vista
162 Hiper débito à vista
163 Hiper parcelado loja
164 Hipercard crédito à vista
165 Hipercard parcelado loja
200 Verdecard crédito a vista
201 Verdecard parcelado loja
202 Nutricash Alimentação
203 Nutricash Refeição
204 Nutricash Multibenefícios
205 Nutricash Combustível
206 Ben Alimentação
207 Ben Refeição
314 Ourocard Agro débito
315 Ourocard Agro custeio
316 Ourocard Agro investimento
317 Ourocard Agro custeio + débito
318 Ourocard Agro investimento + débito
321 Mastercard crediário no crédito
322 Mastercard parcelado cliente
324 Elo parcelado cliente
330 Elo crediário no crédito
342 Mastercard Pedágio
377 Elo Carnê
378 Mastercard Carnê
380 Mastercard Crédito Conversor de Moeda
433 JCB parcelado loja

Tabela VI - Origem do Ajuste

Código Descrição Tipo Ajuste  
01 Acerto de correção monetária Acerto  
02 Acerto de data de Pagamento Acerto  
03 Acerto de taxa de comissão Acerto  
04 Acerto de valores não processados Acerto  
05 Acerto de valores não recebidos Acerto  
06 Acerto de valores não reconhecidos Acerto  
07 Acerto de valores negociados Acerto  
08 Acerto de valores processados indevidamente Acerto  
09 Acerto de lançamento não compensado em conta-corrente Acerto  
10 Acerto referente valores contestados Acerto/Chargeback  
12 Acertos diversos Acerto  
13 Acordo de cobrança Acerto  
14 Acordo jurídico Acerto  
15 Multa do Programa de Bandeira Acerto/Chargeback  
16 Bloqueio de valor por ordem judicial Bloqueio  
17 Cancelamento da venda Cancelamento  
18 Cobrança de tarifa Operacional Cobrança  
19 Valor Mensalidade Farol Acerto / Cobrança  
20 Cobrança Plano Cielo Cobrança  
21 Contrato de caução Acerto  
22 Crédito de devolução do cancelamento banco emissor Acerto/Cancelamento  
23 Crédito EC referente contestação portador Acerto/Chargeback  
24 Crédito por cancelamento rejeitado Cielo Acerto/Chargeback  
25 Processamento do débito duplicado Visa Pedágio Acerto  
26 Débito por venda realizada sem a leitura do chip Acerto  
27 Débito por venda rejeitada no sistema Cielo Acerto  
28 Consumidor não reconhece a compra Acerto/Chargeback  
29 Estorno de acordo jurídico Acerto  
30 Estorno de contrato de caução Acerto  
31 Estorno de acordo de cobrança Acerto  
32 Estorno de bloqueio de valor por ordem judicial Acerto  
33 Estorno de cancelamento de venda Acerto  
34 Estorno de cobrança de tarifa operacional Acerto  
35 Estorno de cobrança mensal Lynx Comércio Acerto  
36 Estorno de cobrança Plano Cielo Acerto  
37 Estorno de débito venda sem a leitura do Chip Acerto  
38 Estorno de incentivo comercial Acerto  
39 Estorno de Multa Programa Monitoria Chargeback Acerto/Chargeback  
40 Estorno de rejeição ARV Acerto  
41 Estorno de reversão de duplicidade do pagamento - ARV Acerto  
42 Estorno de tarifa de cadastro Acerto  
43 Estorno de extrato papel Acerto  
44 Estorno de processamento duplicado de débito - Visa Pedágio Acerto  
45 Incentivo comercial Acerto  
46 Incentivo por venda de Recarga Acerto  
47 Regularização de rejeição ARV Acerto  
48 Reversão de duplicidade do pagamento - ARV Acerto  
49 Tarifa de cadastro Cobrança  
50 Tarifa de extrato no papel Cobrança  
51 Aceleração de débito de antecipação Acerto  
52 Descumprimento de contrato Acerto/Chargeback  
53 Venda recorrente cancelada pelo consumidor Acerto/Chargeback  
54 Consumidor não reconhece a compra Acerto/Chargeback  
55 Cartão com validade vencida Acerto/Chargeback  
57 Mercadoria com defeito ou diferente da descrição Acerto/Chargeback  
58 Transação irregular Acerto/Chargeback  
59 Mercadoria não foi entregue Acerto/Chargeback  
60 Serviços não prestados Acerto/Chargeback  
61 Venda sem código de autorização Acerto/Chargeback  
62 Número de cartão inválido Acerto/Chargeback  
63 Cópia do comprovante / documento inválido Acerto/Chargeback  
65 Comprovante / documento ilegível Acerto/Chargeback  
66 Venda sem leitura de chip Acerto/Chargeback  
67 Venda em outra moeda Acerto/Chargeback  
68 Venda processada incorretamente Acerto/Chargeback  
69 Venda cancelada Acerto/Chargeback  
70 Crédito em duplicidade Acerto/Chargeback  
71 Documentos não recebidos Acerto/Chargeback  
72 Pagamento realizado por outros meios Acerto/Chargeback  
73 Equipamento perdido / roubado Acerto/Cobrança  
77 Multa por excesso de chargeback Acerto/Chargeback  
78 Serviços Score Cobrança  
79 Reagendamento do débito de antecipação Acerto  
80 Ajuste do débito de cessão Acerto  
81 Cielo e-Commerce Acerto/Cobrança  
85 Cielo Controle (Excedente) Acerto/Cobrança  
86 Cielo Controle (Franquia) Acerto/Cobrança  
93 Meliuz Acerto/Cobrança  

Tabela VII - Bandeira

Código Descrição  
001 Visa  
002 Mastercard  
003 Amex  
006 Sorocred  
007 Elo  
009 Diners  
011 Agiplan  
015 Banescard  
023 Cabal  
029 Credsystem  
035 Esplanada  
040 Hipercard  
060 Jcb  
064 Credz  
072 Hiper  
075 Ourocard  

Tabela VIII - Meio de Captura

Código Descrição
00 LIO
01 POS (Point of Sale)
02 PDV (Ponto de Venda) ou TEF (Transferência Eletrônica de Fundos)
03 e-Commerce (Comércio Eletrônico)
04 EDI (Troca Eletrônica de Dados)
05 ADP/BSP (Empresa Capturadora) ou Reprocessamento
06 Manual
07 URA/CVA
08 Mobile
09 Moedeiro Eletrônico em Rede
99 Não identificado

Tabela IX - Motivo da Rejeição

Código Descrição
002 Cartão inválido
023 Outros erros
024 Tipo cartão inválido
031 Transação de saque com cartão Electron valor zerado
039 Banco emissor inválido
044 Data da transação inválida
045 Código de autorização inválido
055 Número de parcelas inválido
056 Transação financiada para estabelecimento não autorizado
057 Cartão em boletim protetor
061 Número de cartão inválido
066 Transação não autorizada
067 Transação não autorizada
069 Transação não autorizada
070 Transação não autorizada
071 Transação não autorizada
072 Transação não autorizada
073 Transação inválida
074 Valor de transação inválido
075 Número de cartão inválido
077 Transação não autorizada
078 Transação não autorizada
079 Transação não autorizada
080 Transação não autorizada
081 Cartão vencido
082 Transação não autorizada
083 Transação não autorizada
084 Transação não autorizada
086 Transação não autorizada
091 Transação não autorizada
092 Banco emissor sem comunicação
093 Desbalanceamento no plano parcelado
094 Venda parcelada para cartão emitido no exterior
097 Valor de parcela menor do que o permitido
099 Banco emissor inválido
100 Transação não autorizada
101 Transação duplicada
102 Transação duplicada
124 BIN não cadastrado
126 Transação de saque com cartão Electron inválida
128 Transação de saque com cartão Electron inválida
129 Transação de saque com cartão Electron inválida
130 Transação de saque com cartão Electron inválida
133 Transação de saque com cartão Electron inválida
134 Transação de saque com cartão Electron inválida
140 Estabelecimento não e-commerce
141 Cartão travel transação inválida
143 Venda em dólar inválido
145 Estabelecimento inválido para distribuição
147 Parcelado emissor não habilitado
150 Estabelecimento não financeiro

Tabela X - Modo de Entrada do Cartão

Código Descrição
00 Reentrada manual
01 Digitada
02 Trilha magnética
03 Código de barra
04 OCR (tecnologia que processa uma imagem e extrai os textos escritos)
05 Chip online
06 Trilha
07 Contactless
81 Digitada
90 Trilha
91 Contactless emulando tarja
95 Chip offline

Tabela XI - Grupo de Cartões

Código Descrição
00 Serviço não atribuído  
01 Cartão emitido no Brasil  
02 Cartão emitido no Exterior  
03 MDR por Tipo de Cartão - Inicial  
04 MDR por Tipo de Cartão - Intermediário  
05 MDR por Tipo de Cartão - Superior  

Tabela XII - Tipo de Cartão

Código Descrição
00 Serviço não atribuído
01 Visa Classic
02 Visa Empresarial
03 Visa Gold
04 Visa Platinum
05 Visa Infinite
06 Visa Corporate
07 Visa Electron
08 Visa Compras
09 Master Platinum
10 Master Standard
11 Master Gold
12 Master Pré-Pago
13 Master Black
14 Master Corporativo
15 Master Cartão Viagem
16 Master Cartão Benefício
17 Master World
18 Master Agro
19 Elo Bndes
20 Elo Classic
21 Elo Empresarial
22 Elo Insumos
23 Elo Corporativo
24 Elo Mais
25 Elo Grafite
26 Elo Nanquim
27 Elo Pré Pagos Geral / Gift Card
28 Elo Vale Cultura
29 Elo Nacional PJ Empresarial
30 Elo Compras
31 Elo Viagem
32 Elo Premiação Inc de Vendas PJ

Transmissão e Reenvio de arquivo

Para receber o Extrato Eletrônico, é necessário que o cliente entre em contato com o Atendimento EDI e preencha o formulário de cadastro. Os arquivos serão disponibilizados na caixa postal diariamente, exceto o arquivo de saldo em aberto que será enviado mensalmente. Quando não houver movimento, o arquivo será enviado somente com o "Header" e o "Trailer". Caso ocorra alguma inconsistência na transmissão do(s) arquivo(s), o cliente deverá informar à Cielo, contatando o Atendimento EDI (edi@cielo.com.br

Reenvio de Arquivos

Em caso de perda do arquivo ou não recebimento, a Cielo disponibilizará na caixa postal o mesmo arquivo enviado diariamente (arquivo backup). O cliente poderá contatar o Atendimento EDI para solicitar o reenvio

Recuperação de Arquivos

Conceitos Financeiros/Glossário

Ajuste: lançamento financeiro à crédito ou a débito realizado para regularizar uma cobrança indevida, cancelar uma venda ou repassar um chargeback para o cliente.

Alteração do Plano Parcelado: ocorre quando o portador solicita ao cliente uma alteração no plano parcelado contratado no início, como cancelamento total ou parcial da venda e alteração na quantidade ou valor de parcelas.

Antecipação de Recebíveis (ARV): serviço oferecido ao cliente afiliado à Cielo ou Alelo que deseja antecipar o recebimento de suas vendas crédito à vista e parceladas.

Cadeia de Pagamento Centralizado: é um grupo de clientes com a mesma raiz de CNPJ, regras de travas e antecipação, domicílio bancário e as mesmas condições comerciais de comissão e prazo. Uma cadeia possui apenas uma matriz, escolhida pelo cliente, onde estão cadastrados todos os produtos e taxas aplicados nas filiais.

Cessão de Recebíveis: operação de antecipação dos recebíveis realizada no domicílio bancário, disponível para o banco Bradesco.

Chargeback: devolução da transação pelo banco emissor, por contestação do portador.

Data da Venda: dia em que a venda foi realizada pelo cliente Cielo. No caso de clientes que operam com soluções ecommerce, esta é a data na qual o portador realizou a compra no site e não a data na qual foi feita a confirmação da venda pelo cliente Cielo.

Data da Apresentação: dia em que a venda foi submetida para processamento na Cielo, podendo ser um sábado, domingo ou feriado. Essa é a data base para o cálculo da programação de pagamento e pode ser diferente da data da venda, de acordo com o tipo de solução de captura utilizado.

Data da Captura: data em que a transação foi capturada no sistema Cielo. Para clientes Cielo que operam com soluções e-commerce, esta é a data na qual a transação foi confirmada pelo cliente.

Data do Envio ao Banco: data em que o arquivo de pagamento (crédito ou débito) foi enviado para o banco de domicílio do cliente.

Data do Pagamento: dia do efetivo pagamento do valor na conta-corrente do cliente, considerando o prazo de pagamento acordado. Caso a data calculada não seja dia útil, o pagamento será realizado no primeiro dia útil posterior. Inicialmente, após a captura da venda, é informada a data prevista de pagamento, que poderá ser postergada no caso do valor ser utilizado para compensar a cobrança de algum débito proveniente de cancelamento de venda, chargeback ou cobrança de serviços. O pagamento também poderá ser antecipado caso o cliente realize uma operação de antecipação.

Matriz de Extrato: cadastro que permite a inclusão de todos os estabelecimentos controlados pelo cliente, independente do tipo de pagamento (centralizado ou individual).

Número Único da Transação: é atribuido pela Cielo e identifica cada transação de forma única, permitindo que a conciliação das ações de ajustes e antecipação de recebíveis realizadas tanto no RO quanto no CV sejam conciliadas por essa chave, Para isso, a solução de conciliação deverá usar somente as partes fixas do número único, seguindo esta composição.

Partes Composição
1 15 posições fixas que identificam o resumo de operações (RO) de forma única, mantendo o histórico na Cielo.
2 07 posições variáveis. Identificam as alterações realizadas no RO.
3 04 posições fixas que identificam o Comprovante de Venda (CV) dentro de um RO mantendo o seu histórico na Cielo.
4 03 posições variáveis. Elas identificam as alterações realizadas no CV.

Parcelado Loja Arredondamento do Valor da Parcela: é sempre realizado na 1ª parcela e ocorre nos casos em que o resultado da divisão do valor da venda pela quantidade de parcelas for uma dízima periódica. Neste caso, a 1ª parcela será maior do que as demais.

Parcelado Loja - Prazo: no extrato de Vendas com Plano Parcelado, todas as parcelas serão enviadas com a data de apresentação original. No entanto, no extrato de pagamentos, será demonstrada a data de liberação da respectiva parcela. O cálculo da data de pagamento de todas as parcelas tem como base a data da apresentação da 1ª parcela e possui uma lógica diferente para transações de cada uma das bandeiras, conforme abaixo:

VISA, ELO, DINERS e demais bandeiras: As parcelas serão liberadas mensalmente no mesmo dia da 1ª parcela, não importando se o dia é útil ou não. Desta forma, uma venda em 04 parcelas apresentada em 10/01/2015 terá o seguinte plano de liberação (prazo de pagamento: 30 dias):

Parcela Data da apresentação Data de depósito (Liberação da Parcela) Data de pagamento
01/04 10/01/2015 10/01/2015 09/02/2015
02/04 10/01/2015 10/02/2015 12/03/2015
03/04 10/01/2015 10/03/2015 09/04/2015
04/04 10/01/2015 10/04/2015 11/05/2015

A única exceção para a regra acima ocorre quando o dia não existir no mês de liberação da parcela. Exemplo: venda cuja 1ª parcela foi apresentada em 31/01/2015. Como não existe dia 31 no mês de fevereiro, a parcela deste mês será apresentada no último dia do mês, ou seja, 28/02/2015.

MASTERCARD: a data de apresentação da 1ª parcela também será a data base para liberação de todas as parcelas do plano, no entanto, as parcelas futuras serão sempre 30 dias após apresentação da primeira parcela, mantendo essa lógica até a conclusão do plano. No exemplo da venda apresentada em 10/01/2015 utilizado anteriormente, notamos que as parcelas serão liberadas em 30, 60, 90 após a apresentação da primeira parcela (prazo de pagamento: 30 dias):

Parcela Data da apresentação Data de depósito (Liberação da Parcela) Data de pagamento
01/04 10/01/2015 10/01/2015 09/02/2015
02/04 10/01/2015 09/02/2015 11/03/2015
03/04 10/01/2015 11/03/2015 10/04/2015
04/04 10/01/2015 10/04/2015 11/05/2015

Rejeição de Transação: ocorre quando o cliente ou a venda não possuem os atributos necessários para o correto processamento e agendamento do pagamento.

Revenda: ocorre quando existe uma alteração no plano de pagamento de uma venda parcelada, seja na quantidade de parcelas, ou no valor total da transação.

Solução de Captura: equipamento e/ou software de processamento de dados (POS, PDV, e-commerce, mobile payment, EDI etc.) que se conecta à rede Cielo para autorização e captura de transações.

Resumo de Operações (RO): o número do RO identifica um agrupamento de vendas em determinada data. Tem 7 posições e será formatado conforme abaixo.

Posição Descrição Edição de dados
1 Tipo de produto 0 - crédito à vista
3 - parcelado emissor
4 - parcelado loja
5 - cartão de débito
6 - parcelado cliente
2 e 3 Ano que a transação foi realizada AA
4 e 5 Mês que a transação foi realizada MM
6 e 7 Dia que a transação foi realizada DD  

Saldo em Aberto: compreende todos os lançamentos à receber com a Cielo. Devem ser considerados os pagamentos da Cielo não realizados no passado devido à cancelamentos e contestações.

Tipos de cadastro: com o cadastro por Grupo Comercial, que utiliza a raiz de CNPJ, todos os novos estabelecimentos da raiz são automaticamente inclusos no extrato eletrônico, evitando perdas de informações.

Níveis Extrato Eletrênico

Importante

Observação: as atualizações citadas abaixo, estarão disponíveis a partir do dia 17 de fevereiro de 2021.

Manual de Extrato Eletrônico

Atualização de Layout EE - Registro de Recebíveis