Arquivo de Extrato Eletrônico
1. Introdução
1.1 Objetivos
Este documento descreve a estrutura do Arquivo Conciliação Padrão versão inicial 2.a sugerido pela Software Express
às redes credenciadoras, acrescido dos registros de boleto e pix, e explica o fluxo de funcionamento do envio de registros.
1.2 Nomenclatura e Convenções
Nas tabelas que descrevem cada registro, encontraremos na última coluna a indicação de “M” quando o
campo for Mandatório e a indicação de “O” quando se tratar de um campo Opcional, ou seja, um campo que não
necessariamente será enviado pela POVIG. Os campos considerados como opcionais, quando não forem enviados,
serão preenchidos com zero quando numéricos e com brancos quando alfanuméricos. Os campos numéricos devem
ser alinhados à direita com zero à esquerda sem pontos ou vírgulas.
Serão enviados arquivos apenas quando houver movimento, sendo um arquivo de previsão e outro arquivo de
liquidação.
O arquivo de previsão conterá os registros de venda e cancelamento do dia anterior e o arquivo de liquidação
conterá os registros das transações/parcelas efetivamente liquidadas no dia do movimento ou data futura quando a
transação/parcela não mais puder ser alterada.
1.3 Nomes dos arquivos de conciliação
O nome do arquivo de conciliação terá o seguinte padrão:
Sigla_da_rede/ano/mês/dia/id_Do_movimento.txt
Exemplo: Rede “POVIG”
Um arquivo de conciliação será POVIG20201101000001.txt
2. Descrição dos registros contidos no arquivo
2.1 Registro A0-Header do arquivo
Identifica o arquivo de conciliação no geral: a versão de layout utilizada, data de geração, origem e destino do
arquivo.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Mandatório/Opcional |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | A0 | Registro do arquivo. | M |
| 02 | Versão do Layout | 03-08 | 06 | AN | VVV.RR | “002.3a” | M |
| 03 | Data de Geração do Arquivo | 09-16 | 08 | N | AAAAMMDD | Data da geração deste arquivo. | M |
| 04 | Hora de Geração do Arquivo | 17-22 | 06 | N | HHMMSS | Hora da geração deste arquivo. | M |
| 05 | Id. Do Movimento | 23-28 | 06 | N | Identificação sequencial do Movimento. Sugere-se que faça parte do nome externo do arquivo. | M | |
| 06 | Nome da Administradora | 29-58 | 30 | AN | Nome / Identificação da Administradora. | M | |
| 07 | Identificação do Remetente | 59-62 | 04 | N | Van de captura das transações do Arquivo 0000 = própria Rede. | O | |
| 08 | Identificação do Destinatário | 63-68 | 06 | N | Código da empresa destinatária do arquivo. | O | |
| 09 | Tipo de Processamento | 69 | 01 | A | ‘N’ = Normal e ‘R’ = Reprocessamento | ||
| 10 | NSEQ do registro | 70-77 | 08 | N | 00000001 | Número sequencial do registro no arquivo. | M |
A dupla de campos (Data de Geração do Arquivo, Id. Do Movimento) não pode assumir os mesmos valores em
arquivos diferentes, pois eles formam a chave de identificação única na base de dados.
2.2 Registro L0-Header de lote de transações
Identifica o início de um lote de informações relativas às transações de cartões da POVIG. Precede os
registros CV, AJ, CC, PB, AB, PX e AX.
Será gerado um registro do tipo L0 para cada tipo de moeda.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Mandatório/Opcional |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | L0 | Registro header de lote de vendas. | M |
| 02 | Data do movimento | 03-10 | 08 | N | AAAAMMDD | Data de Movimento do lote. | M |
| 03 | Identificação da moeda | 11-12 | 02 | AN | Indica a moeda corrente RE = Real, DO = Dólar e PE = Peso. | O | |
| 04 | NSEQ | 13-20 | 08 | N | Número sequencial do registro no arquivo. | M |
2.3 Registro CV-Comprovante de venda
São identificadas por meio desse tipo de registro, as informações de uma transação autorizada pelas
instituições financeiras, bem como seus respectivos créditos.
O campo Data de Lançamento pode refletir uma previsão ou a confirmação da data real de liquidação,
conforme o conteúdo do campo Tipo de Lançamento.
O registro de previsão é opcional, mas caso ele seja enviado, um registro de confirmação da liquidação será
obrigatoriamente enviado, antecedendo a data da liquidação.
Caso a transação seja parcelada, as informações relativas à parcela estarão presentes. Será enviado um
registro para cada parcela. Da mesma forma que nas transações à vista, poderão ser lançadas previsões e
posteriormente confirmações quanto à liquidação de cada parcela, ou apenas os registros de liquidação.
Dos registros previsão para os de confirmação alteram-se apenas o campo Tipo de Lançamento e,
opcionalmente, a Data de Lançamento quando da confirmação.
Não deve colocar o traço separador de dígito verificador no caso de Agência e Conta.
2.3.1 Especificação para Mascaramento do Cartão (campo 13 do CV)
- Se o número de dígitos válidos do cartão for maior ou igual a 16, deixa seis primeiros e quatro últimos e mascarar os do meio.
- Se o número de dígitos válidos do cartão for menor que 16 e maior ou igual a 13, deixar os quatro primeiros e quatro últimos, mascarando os outros.
- Se o número de dígitos válidos do cartão for menor que 13, não precisa mascarar.
| ID | Nome do Campo | Posição | Tamanho | Tipo | Formato/Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | CV | Registro comprovante de venda. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | NSU Host da transação | 18-29 | 12 | N | Número Sequencial Único da transação atribuída pela rede administradora. | M | |
| 04 | Data da transação | 30-37 | 08 | N | AAAAMMDD | Ano / Mês / dia em que a transação foi efetuada. | M |
| 05 | Horário da transação | 38-43 | 06 | N | HHMMSS | Hora / minuto / segundo em que a transação foi efetuada. | O |
| 06 | Tipo de lançamento | 44 | 01 | N | 0 = Previsão, 1 = Liquidação Normal e 2 = Liquidação Antecipada. | M | |
| 07 | Data de lançamento | 45-52 | 08 | N | AAAAMMDD | Data de Pagamento da trn a Loja. | M |
| 08 | Tipo do Produto | 53 | 01 | AN | C = Crédito, S = Split Crédito D = Débito e V = Voucher. | M | |
| 09 | Meio de Captura | 54 | 01 | N | 1 = Manual, 2 = Pos, 3 = Pdv, 4 = Trn Off, 5 = e-commerce, 6 = URA, 8= Indefinido e 9 = Outros. | M | |
| 10 | Valor Bruto da Venda | 55-65 | 11 | N | 9(09)V99 | Valor Bruto da Venda. | M |
| 11 | Valor Bruto do split | 66-76 | 11 | N | 9(09)V99 | Valor Bruto da Split referente ao lojista, caso a transação não possua split, será incrementado com o valor total da venda. | M |
| 12 | Valor do Desconto | 77-87 | 11 | N | 9(09)V99 | Valor da Taxa de Administração. | M |
| 13 | Valor Taxa Antecipação | 88-98 | 11 | N | 9(09)V99 | Valor da Taxa de Antecipação quando Tipo de Lançamento=2. | O |
| 14 | Valor Líq. Da Venda | 99-109 | 11 | N | 9(09)V99 | Valor Líquido da Venda. | M |
| 15 | Número do Cartão | 110-128 | 19 | AN | Completo com zero à esquerda | Num Cartão da Venda. | M |
| 16 | Número da Parcela | 129-130 | 02 | N | Zero ou Num. | Indica o número da parcela quando transação de venda parcelada, Transações a vista serão preenchidas com 01. | M |
| 17 | Número total de Parcelas | 131-132 | 02 | N | Zero ou Num. | Indica o número total de parcelas quando transação de venda parcelada, ou zero quando transação à vista. | M |
| 18 | Reservado | 133-144 | 12 | N | Zero ou Num. | Zerado. | M |
| 19 | Valor Bruto da Parcela | 145-155 | 11 | N | 9(09)V99 Zero ou Valor | Valor Bruto da Parcela. | M |
| 20 | Valor do Desconto da Parcela | 156-166 | 11 | N | 9(09)V99 Zero ou Valor | Valor Desconto da Parcela. | M |
| 21 | Valor Líquido da Parcela | 167-177 | 11 | N | 9(09)V99 | Valor Líquido da Parcela. | M |
| 22 | Valor Taxa Antecipação Parcela | 178-188 | 11 | N | 9(09)V99 Zero ou Valor | Valor da Taxa de Antecipação da parcela quando Tipo de Lançamento=2. | O |
| 23 | Banco | 189-191 | 03 | N | Banco para depósito. | M | |
| 24 | Agência | 192-197 | 06 | N | Agência para depósito. | M | |
| 25 | Conta | 198-208 | 11 | AN | Conta corrente para depósito. | M | |
| 26 | Código de Autorização | 209-220 | 12 | AN | Zero ou Valor | Cód. De Autorização da Trn. | O |
| 27 | Código da Bandeira | 221-223 | 03 | AN | Zero ou Valor | Código de identificação da bandeira do cartão. | O |
| 28 | Código do Produto | 224-226 | 03 | AN | Zero ou Valor | Subtipos dos Cartões. Preenchido com zeros. | O |
| 29 | Id da agenda | 227-246 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 30 | Identificador do Pedido | 247-266 | 20 | AN | M | ||
| 31 | Identificador do pedido secundário | 267-286 | 20 | AN | M | ||
| 32 | NSEQ | 287-294 | 08 | N | Número sequencial do registro no arquivo. | M |
2.4 Registro AJ – Ajuste a Crédito e Ajuste a Débito
São identificadas por meio desse tipo de registro transações ditas de Ajuste a Crédito ou Ajuste a Débito.
O registro AJ-Ajuste a Crédito é utilizado sempre que uma transação teve o seu valor informado a menor,
necessitando ser complementada ou, quando houver necessidade de suplementação de crédito ao Estabelecimento
por motivos diversos especificados pela própria rede. Ele contempla o valor da diferença a creditar. Este ajuste
refere-se apenas a uma transação original se tiver sua origem numa venda ou não referência nenhuma transação caso
não tenha sua origem numa venda.
O AJ-Ajuste a Débito é utilizado para restituir ao Cliente usuário do cartão o valor de uma transação já
liquidada. O valor restituído é subtraído do total a receber pelo Estabelecimento. Esta transação referencia apenas
uma transação original.
Esse registro pode ser utilizado também para contemplar outros motivos definidos pela própria POVIG.
Nesse caso não haveria uma transação original referenciada.
Não deve colocar o traço separador de dígito verificador no caso de Agência e Conta.
2.4.1 Especificação para Mascaramento do Cartão (campo 21 do AJ)
-
Se o número de dígitos válidos do cartão maior ou igual a 16, deixar seis primeiros e quatro últimos e mascarar os do meio.
-
Se o número de dígitos válidos do cartão menor que 16 e maior ou igual a 13, deixar os quatro primeiros e quatro últimos, mascarando os outros.
-
Se o número de dígitos válidos do cartão menor que 13, não precisa mascarar.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AJ | Registro de ajuste. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zeros à esquerda. | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | NSU Host da transação cancelada | 18-29 | 12 | N | Número Sequencial Único da transação cancelada | O | |
| 04 | Data da transação cancelada | 30-37 | 08 | N | AAAAMMDD | Ano / Mês / dia da transação cancelada | O |
| 05 | Número da Parcela | 38-39 | 02 | N | Indica o número da parcela da transação cancelada. Transações a vista serão preenchidas com 01. | O | |
| 06 | NSU Host da transação de cancelamento | 40-51 | 12 | N | Número Seqüencial Único da transação de cancelamento. | M | |
| 07 | Data da transação de cancelamento | 52-59 | 08 | N | AAAAMMDD | Ano / Mês / dia da transação de cancelamento. | M |
| 08 | Horário da transação de cancelamento | 60-65 | 06 | N | HHMMSS | Hora / minuto / segundo da transação de cancelamento. | O |
| 09 | Tipo de lançamento | 66 | 01 | N | 0 = Previsão, 1 = Liquidação e 2 = Liquidação Antecipada. | M | |
| 10 | Data de lançamento | 67-74 | 08 | N | AAAAMMDD | Data de previsão para o lançamento do ajuste. | M |
| 11 | Meio de Captura do Ajuste | 75 | 01 | N | 1 = Manual, 2 = Pos, 3 = Pdv, 4 = Trn Off, 5 = Internet, 6 = URA e 9 = Outros. | M | |
| 12 | Tipo de Ajuste | 76 | 01 | N | 1 ou 2 | 1 = Ajuste a Crédito e 2 = Ajuste a Débito. | M |
| 13 | Código do Ajuste | 77-79 | 03 | N | Número que representa o motivo do ajuste. | M | |
| 14 | Descrição do Motivo do Ajuste | 80-109 | 30 | AN | Texto que descreve o motivo do ajuste. | M | |
| 15 | Valor Bruto | 110-120 | 11 | N | 9(09)V99 | Valor Bruto. | M |
| 16 | Valor do Desconto ou Comissão | 121-131 | 11 | N | 9(09)V99 | Desconto ou comissão aplicado sobre o Valor Bruto. | M |
| 17 | Valor Líquido | 132-142 | 11 | N | 9(09)V99 | Valor Líquido do Ajuste. | M |
| 18 | Banco | 143-145 | 03 | N | Banco para depósito. | M | |
| 19 | Agência | 146-151 | 06 | N | Agência para depósito. | M | |
| 20 | Conta | 152-162 | 11 | AN | Conta corrente para o depósito. | M | |
| 21 | Número do Cartão da transação cancelada | 163-181 | 19 | AN | Completo com zeros à esquerda. | Número do Cartão da transação cancelada | M |
| 22 | Código da Bandeira | 182-184 | 03 | AN | Zero ou Valor | Código de identificação da bandeira do cartão | O |
| 23 | Código do Produto | 185-187 | 03 | AN | Zero ou Valor | Subtipos dos Cartões. Sempre enviados zeros. | O |
| 24 | Reservado para uso futuro | 188-198 | 11 | N | 9(09)V99 | Reservado para uso futuro. | M |
| 25 | Código de autorização da transação original | 199-209 | 12 | AN | Completo com zeros à esquerda. | Código de autorização da transação original. | M |
| 26 | Id da Agenda | 210-219 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 27 | Identificador do Pedido | 220-239 | 20 | AN | M | ||
| 28 | Identificador do pedido secundário | 240-259 | 20 | AN | M | ||
| 29 | NSEQ | 260-267 | 08 | N | Número sequencial do registro no arquivo. | M |
2.5 Registro CC - Cancelamento
O registro CC-Cancelamento indicará uma transação já enviada através do registro CV sinalizado como de
previsão, ainda não liquidada, e que foi cancelada, ou seja, não será paga. Desde o momento em que foi efetuada até o momento da geração do Arquivo com Lote de Confirmação contendo os lançamentos de liquidação, a transação pode
ser cancelada através do CC.
O registro CC somente se aplica caso a Rede Administradora opte por enviar registros CV de previsão. Caso
opte por enviar apenas registros CV de liquidação deve-se utilizar, em lugar deste, o registro AJ de débito
discriminando como motivo o cancelamento da transação.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | CC | Registro de cancelamento. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zeros à esquerda. | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | NSU Host da transação cancelada | 18-29 | 12 | N | Número Seqüencial Único da transação cancelada | M | |
| 04 | Data da transação cancelada | 30-37 | 08 | N | AAAAMMDD | Ano / Mês / dia em que a transação cancelada. | M |
| 05 | Número de Parcelas | 38-39 | 02 | N | Indica o número da parcela quando transação de venda parcelada. Transações a vista serão preenchidas com 01. | M | |
| 06 | NSU Host da transação de cancelamento | 40-51 | 12 | N | Número Seqüencial Único da transação de cancelamento | M | |
| 07 | Data da transação de cancelamento | 52-60 | 08 | N | AAAAMMDD | Ano / Mês / dia em que a transação foi cancelada. | M |
| 08 | Horário da transação de cancelamento | 61-65 | 06 | N | HHMMSS | Hora / minuto / segundo em que a transação foi cancelada.. | O |
| 09 | Meio de Captura | 66 | 01 | N | 1 = Manual, 2 = Pos, 3 = Pdv, 4 = Trn Off, 5 = Internet, 6 = URA e 9 = Outros. | M | |
| 10 | Código de Autorização | 67-79 | 12 | N | Zero ou Valor | Cód. De Autorização da transação de cancelamento. | M |
| 11 | Código de autorização da transação original | 82-93 | 12 | AN | Completo com zeros à esquerda. | Código de autorização da transação original. | M |
| 12 | Id da Agenda | 80-99 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 13 | Identificador do Pedido | 100-119 | 20 | AN | M | ||
| 14 | Identificador do pedido secundário | 120-139 | 20 | AN | M | ||
| 15 | NSEQ | 140-147 | 08 | N | Número sequencial do registro no arquivo. | M |
2.6 Registro PB - Pagamento Boleto
São identificadas por meio desse tipo de registro, as informações de boletos devidamente pagos.
O campo Data de Lançamento irá refletir a confirmação da data real de liquidação em conta corrente.
Não deve colocar o traço separador de dígito verificador no caso de Agência e Conta.
| ID | Nome do Campo | Pos | Tam | Tipo | Descrição / Conteúdo / Formato | Mandatório/Opcional | |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | PB Registro de pagamento de boleto. | M | |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero esquerda. Código de Estabelecimento que efetuou a venda (CNPJ). | M | |
| 03 | NSU Host da transação | 18-53 | 36 | AN | Identificador unico do boleto. | M | |
| 04 | Data da criação do boleto | 54-61 | 08 | N | Ano / Mês / dia em que o boleto foi criado. | M | |
| 05 | Horário da criação do boleto | 62-67 | 06 | N | Hora / minuto / segundo em que a o boleto foi criado. | M | |
| 06 | Data do pagamento do boleto | 68-75 | 08 | N | Ano / Mês / dia em que o boleto foi pago. | M | |
| 07 | Tipo de lançamento | 76-76 | 01 | N | 1 = Liquidação Normal. | M | |
| 08 | Data de lançamento | 77-84 | 08 | N | Data de Pagamento à Loja. | M | |
| 09 | Tipos de Produto | 85-85 | 01 | AN | B = Boleto , S = Boleto Split | M | |
| 10 | Meio de Captura | 86-86 | 01 | N | 5 = e-commerce. | M | |
| 11 | Valor Bruto da Venda | 87-97 | 11 | N | Valor Bruto da Venda. | M | |
| 12 | Valor Bruto do split | 98-108 | 11 | N | 9(09)V99 | Valor Bruto da Split referente ao lojista, caso a transação não possua split, será incrementado com o valor total da venda. | M |
| 13 | Valor do Desconto | 109-119 | 11 | N | Valor da Taxa de administração. | M | |
| 14 | Valor Líq. da venda | 120-130 | 11 | N | Valor Líquido da venda. | M | |
| 15 | Código de Barras - Linha digitável | 131-190 | 60 | N | Completo com zero esquerda. | M | |
| 16 | Banco | 191-193 | 03 | N | Banco para depósito. | M | |
| 17 | Agência | 194-199 | 06 | N | Agência para depósito. | M | |
| 18 | Conta | 200-210 | 11 | AN | Conta corrente para depósito. | M | |
| 19 | Id da Agenda | 211-230 | 20 | AN | Identificador único da agenda. | M | |
| 20 | Identificador do Pedido | 231-250 | 20 | AN | M | ||
| 21 | Identificador do pedido secundário | 251-270 | 20 | AN | M | ||
| 22 | NSEQ | 271-278 | 08 | N | Número sequencial do registro no arquivo. | M |
2.7 Registro AB - Ajuste de Boleto
São identificadas por meio desse tipo de registro as informações de ajustes referentes a boletos já liquidados.
| ID | Nome do Campo | Pos | Tam | Tipo | Descrição / Conteúdo / Formato | ||
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AB Registro do boleto. | M | |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero esquerda Código de Estabelecimento que efetuou a venda (CNPJ). | M | |
| 03 | NSU Host da transação original | 18-53 | 36 | AN | Número Sequencial Único da transação atribuída pelo gerador do boleto/banco original. | M | |
| 04 | Data da criação do boleto | 54-61 | 08 | N | AAAAMMDD Ano / Mês / dia em que o boleto foi criado. | M | |
| 05 | NSU Host da transação de ajuste | 62-97 | 36 | AN | Número Sequencial Único da transação atribuída ao registro de ajuste. | M | |
| 06 | Data da Criação da transação de ajuste | 98-105 | 8 | N | AAAAMMDD Ano / Mês / dia em que o ajuste do boleto foi criado. | M | |
| 07 | Horário da criação da transação de ajuste | 106-111 | 06 | N | HHMMSS Hora / minuto / segundo em que o ajuste do boleto foi criado. | O | |
| 08 | Data de lançamento | 112-119 | 08 | N | AAAAMMDD Data de Pagamento/Desconto à Loja. | M | |
| 09 | Meio de Captura | 120-120 | 01 | N | 5 = e-commerce. | M | |
| 10 | Tipo do ajuste | 121-121 | 01 | N | 1 = Crédito / 2= Débito. | M | |
| 11 | Código do Ajuste | 122-122 | 3 | N | Código do ajuste com 3 dígitos. | O | |
| 12 | Motivo do Ajuste | 125-154 | 30 | AN | Descrição do motivo do ajuste. | O | |
| 13 | Valor Bruto do Ajuste | 155-165 | 11 | N | 9(09)V99 Valor Bruto do Ajuste. | M | |
| 14 | Valor do Desconto | 166-176 | 11 | N | 9(09)V99 Valor da Taxa de administração. | M | |
| 15 | Valor Líq. do Ajuste | 177-187 | 11 | N | 9(09)V99 Valor Líquido do Ajuste. | M | |
| 16 | Código de Barras - Linha digitável | 188-247 | 60 | N | Completo com zero à esquerda. | M | |
| 17 | Banco | 248-250 | 03 | N | Banco para depósito. | M | |
| 18 | Agência | 248-250 | 06 | N | Agência para depósito. | M | |
| 19 | Conta | 257-267 | 11 | AN | Conta corrente para depósito. | M | |
| 20 | Id da Agenda | 268-287 | 20 | AN | Identificador único da agenda. | M | |
| 21 | Identificador do Pedido | 288-307 | 20 | AN | M | ||
| 22 | Identificador do pedido secundário | 308-327 | 20 | AN | M | ||
| 23 | NSEQ | 328-335 | 08 | N | Número sequencial do registro no arquivo. | M |
2.8 Registro PX - Pagamento Pix
São identificadas por meio desse tipo de registro, as informações de Pix devidamente pagas.
O campo Data de Lançamento irá refletir a confirmação da data real de liquidação em conta corrente.
Não deve colocar o traço separador de dígito verificador no caso de Agência e Conta.
| ID | Nome do Campo | Pos | Tam | Tipo | Descrição / Conteúdo / Formato | ||
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | NA | PX Registro de Pagamento Pix. | M | |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda Código de Estabelecimento que efetuou a venda (CNPJ). | M | |
| 03 | NSU Host da transação | 18-53 | 36 | AN | Número Sequencial Único da transação atribuída pelo Banco Central - E2EID. | M | |
| 04 | Data da criação do Pix | 54-61 | 08 | N | AAAAMMDD Ano / Mês / dia em que o Pix foi criado. | M | |
| 05 | Horário da criação do Pix | 62-67 | 06 | N | HHMMSS Hora / minuto / segundo em que a o pix foi criado. | M | |
| 06 | Data do pagamento do Pix | 68-75 | 8 | N | AAAAMMDD Ano / Mês / dia em que o pix foi pago. | ||
| 07 | Tipo de lançamento | 76-76 | 01 | N | 1 = Liquidação Normal. | M | |
| 08 | Data de lançamento | 77-84 | 08 | N | AAAAMMDD Data de Pagamento à Loja. | M | |
| 09 | Meio de Captura | 86-86 | 01 | N | 5 = e-commerce. | M | |
| 10 | Tipo de Produto | 85-85 | 01 | AN | X = Pix, S = Split Pix | M | |
| 11 | Meios de Captura | 86-86 | 01 | N | 5 = e-commerce | M | |
| 12 | Valor Bruto da Venda | 87-97 | 11 | N | 9(09)V99 Valor Bruto da Venda. | M | |
| 13 | Valor Bruto do split | 98-108 | 11 | N | 9(09)V99 | Valor Bruto da Split referente ao lojista, caso a transação não possua split, será incrementado com o valor total da venda. | M |
| 14 | Valor do Desconto | 109-119 | 11 | N | 9(09)V99 Valor da Taxa de administração. | M | |
| 15 | Valor Líq. da venda | 120-130 | 11 | N | 9(09)V99 Valor Líquido da venda. | M | |
| 16 | TxId | 131-190 | 60 | N | Numero de identificação único da transação Pix. | M | |
| 17 | Banco | 191-193 | 03 | N | Banco para depósito. | M | |
| 18 | Agência | 194-199 | 06 | N | Agência para depósito. | M | |
| 19 | Conta | 200-210 | 11 | AN | Conta corrente para depósito. | M | |
| 20 | Id da Agenda | 211-230 | 20 | AN | Identificador único da agenda. | M | |
| 21 | Identificador do Pedido | 231-250 | 20 | AN | M | ||
| 22 | Identificador do pedido secundário | 251-270 | 20 | AN | M | ||
| 23 | NSEQ | 271-278 | 08 | N | Número sequencial do registro no arquivo. | M |
2.9 Registro AX - Ajuste Pix
São identificadas por meio desse tipo de registro as informações de ajustes referentes a pix já liquidados.
| ID | Nome do Campo | Pos | Tam | Tipo | Descrição / Conteúdo / Formato | ||
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AX Registro de Ajuste do pix. | M | |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda Código de Estabelecimento que efetuou a venda (CNPJ). | M | |
| 03 | NSU Host da transação original | 18-53 | 36 | AN | Número Sequencial Único da transação atribuída pelo gerador do pix/banco original. | M | |
| 04 | Data da criação do pix | 54-61 | 08 | N | AAAAMMDD Ano / Mês / dia em que o pix foi criado. | M | |
| 05 | NSU Host da transação de ajuste | 62-97 | 36 | AN | Número Sequencial Único da transação atribuído ao registro de ajuste. | M | |
| 06 | Data da Criação da transação de ajuste | 98-105 | 8 | N | AAAAMMDD Ano / Mês / dia em que o ajuste do pix foi criado. | M | |
| 07 | Horário da criação da transação de ajuste | 106-111 | 06 | N | HHMMSS Hora / minuto / segundo em que o ajuste do pix foi criado. | O | |
| 08 | Data de lançamento | 112-119 | 08 | N | AAAAMMDD Data de Pagamento/Desconto à Loja. | M | |
| 09 | Meio de Captura | 120-120 | 01 | N | 5 = e-commerce. | M | |
| 10 | Tipo do ajuste | 121-121 | 01 | N | 1 = Crédito / 2= Débito. | M | |
| 11 | Código do Ajuste | 122-122 | 3 | N | Código do ajuste com 3 dígitos. | O | |
| 12 | Motivo do Ajuste | 123-154 | 30 | AN | Descrição do motivo do ajuste. | O | |
| 13 | Valor Bruto do Ajuste | 155-165 | 11 | N | 9(09)V99 Valor Bruto do Ajuste. | M | |
| 14 | Valor do Desconto | 166-176 | 11 | N | 9(09)V99 Valor da Taxa de administração. | M | |
| 15 | Valor Líq. do Ajuste | 177-187 | 11 | N | 9(09)V99 Valor Líquido do Ajuste. | M | |
| 16 | TxId | 188-247 | 60 | AN | Numero de identificação único da transação Pix. | M | |
| 17 | Banco | 248-250 | 03 | N | Banco para depósito. | M | |
| 18 | Agência | 248-250 | 06 | N | Agência para depósito. | M | |
| 19 | Conta | 257-267 | 11 | AN | Conta corrente para depósito. | M | |
| 20 | Id da agenda | 268-287 | 20 | AN | Identificador único da agenda. | M | |
| 21 | Identificador do Pedido | 288-307 | 20 | AN | M | ||
| 23 | Identificador do pedido secundário | 308-327 | 20 | AN | M | ||
| 24 | NSEQ | 288-295 | 08 | N | Número sequencial do registro no arquivo. | M |
2.10 Registros de aplicação de ajustes
São identificados por meio desses registros a aplicação de ajustes. Enquanto os registros AJ, AB e AP referem somente a previsão, os registros seguintes referem a aplicação e a liquidação desses ajustes, os quais irão sempre referenciar um ajuste a débito enviado anteriormente.
Registros de regime aplicado são registros cujo tipo de aplicação é unicamente do tipo 1(liquidação).
Logo, o resultado do valor liquidado efetivo do dia se dá por:
CV(1) + PB + PX - AT - AS - AP
2.10.1 Registro AT - Ajuste aplicado de TEF
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AT | Registro de ajuste aplicado de TEF. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda. | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | NSU Host da transação cancelada. | 18-29 | 12 | N | Completo com zero à esquerda. | Número Sequencial Único da transação cancelada. | M |
| 04 | Data da transação cancelada | 30-37 | 08 | N | AAAAMMDD | Ano / Mês / dia da transação cancelada. | M |
| 05 | Número da Parcela | 38-39 | 02 | N | Indica o número da parcela da transação cancelada. Transações a vista serão preenchidas com 01. | M | |
| 06 | NSU Host | 40-51 | 12 | N | Completo com zero à esquerda. | Número Sequencial Único da transação de cancelamento. | M |
| 07 | Data da transação de cancelamento | 52-59 | 08 | N | AAAAMMDD | Ano / Mês / dia da transação de cancelamento. | M |
| 08 | Hora da transação de cancelamento | 60-65 | 06 | N | HHMMSS | Hora / minuto / segundo da transação de cancelamento. | O |
| 09 | Data de liquidação do ajuste | 66-73 | 08 | N | AAAAMMDD | Data de lançamento do ajuste aplicado. | M |
| 10 | Valor | 74-84 | 11 | N | 9(09)V99 | Valor do Ajuste aplicado. | M |
| 11 | Número do Cartão da transação cancelada. | 85-103 | 19 | AN | Completo com zeros à esquerda. | Número do Cartão da transação cancelada. | M |
| 12 | Identificador da bandeira | 104-106 | 03 | N | Completo com zeros à esquerda. | Identificador da bandeira. | M |
| 13 | Código de autorização da transação cancelada | 107-118 | 12 | AN | Completo com zeros à esquerda. | Código de autorização da transação cancelada. | M |
| 14 | Id do ajuste | 119-155 | 36 | AN | Identificador único do ajuste aplicado. | M | |
| 15 | Id da agenda | 156-175 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 16 | Data de agenda da UR ajustada | 176-183 | 08 | N | AAAAMMDD | Data de agenda da UR afetada pelo ajuste. | M |
| 17 | Codigo do arranjo da UR ajustada | 184-186 | 03 | AN | Identificador do arranjo da UR afetada pelo ajuste. | M | |
| 18 | NSEQ | 187-195 | 08 | N | Número sequencial do registro no arquivo. | M |
2.10.2 Registro AS - Ajuste aplicado de boleto
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AS | Registro de ajuste aplicado de boleto. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda. | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | Identificador unico do boleto cancelado | 18-53 | 36 | AN | Identificador unico do boleto cancelado | M | |
| 04 | Data da criação do boleto | 54-61 | 08 | N | AAAAMMDD | Ano / Mês / dia em que o boleto foi criado. | M |
| 05 | Identificador unico do cancelamento do boleto | 62-97 | 36 | AN | Identificador unico do cancelamento do boleto | M | |
| 06 | Data do cancelamento do boleto | 98-105 | 08 | N | AAAAMMDD | Ano / Mês / dia em que o boleto foi cancelado. | M |
| 07 | Hora do cancelamento do boleto | 106-111 | 06 | N | HHMMSS | Hora / minuto / segundo em que o boleto foi cancelado. | O |
| 08 | Data de liquidação do ajuste | 112-119 | 08 | N | AAAAMMDD | Data de lançamento do ajuste aplicado. | M |
| 09 | Valor | 120-130 | 11 | N | 9(09)V99 | Valor do Ajuste aplicado. | M |
| 10 | Código de Barras - Linha digitável | 131-190 | 60 | N | Completo com zero à esquerda. | Linha de barras do boleto cancelado | M |
| 11 | Id do ajuste | 191-226 | 36 | AN | Identificador único do ajuste aplicado. | M | |
| 12 | Id da agenda | 227-246 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 13 | Data de agenda da UR ajustada | 247-254 | 08 | N | AAAAMMDD | Data de agenda da UR afetada pelo ajuste. | M |
| 14 | Codigo do arranjo da UR ajustada | 255-257 | 03 | AN | Identificador do arranjo da UR afetada pelo ajuste. | M | |
| 15 | NSEQ | 258-265 | 08 | N | Número sequencial do registro no arquivo. | M |
2.10.3 Registro AP - Ajuste aplicado de Pix
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | Opcional / Mandatório |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | AP | Registro de ajuste aplicado de Pix. | M |
| 02 | Identificação da Loja | 03-17 | 15 | AN | Completo com zero à esquerda. | Código de Estabelecimento que efetuou a venda (CNPJ). | M |
| 03 | Identificador unico do pix cancelado | 18-53 | 36 | AN | Completo com espaços em branco à direita. | Identificador unico do pix cancelado (E2E-ID). | M |
| 04 | Data da criação do pix | 54-61 | 08 | N | AAAAMMDD | Ano / Mês / dia em que o pix foi criado. | M |
| 05 | Identificador unico do pix devolução | 62-97 | 36 | AN | Completo com espaços em branco à direita. | Identificador unico do pix devolução (E2E-ID). | M |
| 06 | Data do cancelamento do pix | 98-105 | 08 | N | AAAAMMDD | Ano / Mês / dia em que o pix foi cancelado. | M |
| 07 | Hora do cancelamento do pix | 106-111 | 06 | N | HHMMSS | Hora / minuto / segundo em que o pix foi cancelado. | O |
| 08 | Data de liquidação do ajuste | 112-119 | 08 | N | AAAAMMDD | Data de lançamento do ajuste aplicado. | M |
| 09 | Valor | 120-130 | 11 | N | 9(09)V99 | Valor do Ajuste aplicado. | M |
| 10 | TxId | 131-190 | 60 | N | Completo com espaços em branco à direita. | Identificador unico da transação de pix. | M |
| 11 | Id do ajuste | 191-226 | 36 | AN | Identificador único do ajuste aplicado. | M | |
| 12 | Id da agenda | 227-246 | 20 | AN | Completo com espaços em branco à esquerda. | Identificador único da agenda. | M |
| 13 | Data de agenda da UR ajustada | 247-254 | 08 | N | AAAAMMDD | Data de agenda da UR afetada pelo ajuste. | M |
| 14 | Codigo do arranjo da UR ajustada | 255-257 | 03 | AN | Identificador do arranjo da UR afetada pelo ajuste. | M | |
| 15 | NSEQ | 258-265 | 08 | N | Número sequencial do registro no arquivo. | M |
2.11 Registro L9 - Trailer de lote de transações
Identifica o final de informações do Lote de Vendas corrente, iniciado pelo registro L0, totalizando a quantidade e valores dos registros que compõem este lote, excetuando-se cancelamentos.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | L9 | Trailer do lote de vendas. | M |
| 02 | Total de registros de transação | 03-10 | 08 | N | Somatória de registros tipo CV, AJ, CC, PB, AB, PX, AX, AT, AS e AP dentro do lote. | M | |
| 03 | Total de valores de créditos | 11-24 | 14 | N | 9(12)V99 | Módulo da Somatória dos campos Valor Bruto (vide registros CV + (AJc – AJd) – CC + PB – AB + PX - AX - AT- AS - AP dentro do lote. | M |
| 04 | NSEQ | 25-32 | 08 | N | Número sequencial do registro no arquivo. | M |
2.12 Registro A9 - Trailer de arquivo
Identifica o final do arquivo, totalizando a quantidade de registros.
| ID | Nome do Campo | Pos | Tam | Tipo | Formato / Conteúdo | Descrição | |
|---|---|---|---|---|---|---|---|
| 01 | Código do registro | 01-02 | 02 | AN | A9 | Fim de arquivo. | M |
| 02 | Total geral de registros | 03-10 | 08 | N | Inclui todos os tipos de registro, inclusive o próprio A9. | M | |
| 03 | NSEQ do registro | 11-18 | 08 | N | Número sequencial do registro no arquivo. | M |
Tabela 1 - Motivos de ajustes
001 – SALE CANCELLATION
002 - AJUSTE A CRÉDITO
003 – SALE CONTESTATION
004 - SALE ADJUSTMENT
005 - FINANCIAL ADJUSTMENT
100 - UNKNOWN
Tabela 2 - Arranjos de pagamento.
O código de arranjo tem como função identificar o arranjo no qual um ajuste foi aplicado.
| Sigla | Descrição | Identificação da banceira |
|---|---|---|
| ACC | AMEX CREDITO | 11 |
| BCC | BANESCARD CREDITO | 14 |
| BCD | BANESCARD DEBITO | 15 |
| CBC | CABAL CREDITO | 20 |
| CBD | CABAL DEBITO | 21 |
| ECC | ELO CREDITO | 39 |
| ECD | ELO DEBITO | 38 |
| GCC | GOODCARD CREDITO | 109 |
| HCC | HIPERCARD | 49 |
| HCD | HIPER DEBITO | 48 |
| JCC | J.C.B. | 52 |
| MCC | MASTERCARD | 55 |
| MCD | MASTERCARD DEBITO/MAESTRO | 53 |
| SCC | SOROCRED CREDITO | 25 |
| VCC | VISA CREDITO | 85 |
| VCD | VISA DEBITO | 86 |
| VDC | VERDECARD | 84 |
| CZC | CREDZ | 34 |
| DCC | DINNERS | 37 |
| DBC | DISCOVER | 101 |
| PVT | CREDITO PRIVATE LABEL | 150 |
| SLP | Boleto | 0 |
| PIX | PIX | 0 |
| GNR | Generic(Ajustes financeiros) | 0 |
| UKN | Desconhecido(Exceção para caso o sistema não o identifique dentro do registro) | 0 |
Histórico de Versões
| Versão Layout | Modificações | Gerente Autorizador | Data |
|---|---|---|---|
| 1.8a | Publicação Inicial | Marcel Almeida | 15/12/2020 |
| 1.8a | Criação do Tipo Produto = ‘S’ para os registros CV e PB indicando que a somatória das parcelas será igual ao valor líquido do registro em caso de transações com SPLIT, ou seja, parte do valor total da venda será creditado para outro canal/cliente. Remoção do registro CB, já que para boletos passaremos a enviar apenas o registro de liquidação e em caso de cancelamento/reembolso, enviaremos o ajuste (AB). | Marcel Almeida | 17/12/2020 |
| 1.8a | Substituição da data de pagamento do registro AB pela data de criação | Marcel Almeida | 11/01/2021 |
| 1.8a | Alterado o tamanho dos campos de ID "NSEQ" de todos os registros para 8. | Marcel Almeida | 16/06/2021 |
| 1.9a | Alterado o tamanho do campo "02 - Total de registros" dos Trailers L9 e A9 para 8. | Marcel Almeida | 16/07/2021 |
| 2.0a | Incluído registro PIX | Marcel Almeida | 10/11/2021 |
| 2.1a | Incluído campo do código de autorização nas transações de cancelamento | Marcel Almeida | 27/06/2022 |
| 2.2a | Incluído campo "Id do recebível" nos registros CV, AJ, CC, PB, AB, PX e AX | Marcel Almeida | 26/09/2022 |
| 2.3a | Adicionados os registros: AT, AS e AP. Corrigidas algumas descrições de especificações de alguns campos. | Alisson Pereira | 05/01/2023 |
| 2.3b | Adicionado Private label na tabela de bandeiras | Alisson Pereira | 05/01/2023 |
| 2.4 | Adicionado código de pedido e código de pédido secundário | Alisson Pereira | 01/05/2024 |
| 2.4a | Adicionado campo do valor bruto do split. | Alisson Pereira | 07/05/2024 |
