#Arquivo de Agenda e Liquidação SC3
#1. Introdução
#1.1 Objetivos
Este documento descreve a estrutura do Arquivo de Agenda e Liquidação Padrão 1.5.12 e explica o fluxo de funcionamento do envio de registros.
#1.2 Nomenclatura e Convenções
O arquivo possui formato .CSV (separado por ponto e virgulas) e os campos de acordo com cada tipo de registro incluído no arquivo.
O arquivo não conterá header ou trailer e o seu processamento deve ser considerado linha a linha até o final do arquivo. Cada linha contém exclusivamente um tipo de registro.
Os campos são unidos diretamente pelo caractere ;, sem aspas ou escape CSV, e cada linha é finalizada com CRLF (\r\n). Por isso, os valores dos campos não devem conter ponto e vírgula.
Nos registros RC, PM e AC, o Código do Pedido (campo 18), o Código de sub-pedido (campo 29) e a Descrição do pagamento (campo 42) recebem tratamento específico: os pontos e vírgulas são removidos e os caracteres acentuados são convertidos para ASCII. Esse tratamento não é aplicado aos demais campos ou tipos de registro.
Serão enviado arquivos diariamente, caso não tenha nenhuma movimentação naquele dia, o mesmo virá vazio, sendo um arquivo de previsão e outro arquivo de liquidação.
O arquivo de previsão conterá os registros da agenda em razão da data de competência (data de entrada na agenda) e o arquivo de liquidação conterá os registros das transações/parcelas e ajustes efetivamente liquidados no dia do movimento ou data futura quando a transação/parcela não mais puder ser alterada.
#1.3 Nomes dos Arquivos
O nome do arquivo de conciliação terá o seguinte padrão:
<Tipo do Arquivo>_<id. do subadquirente>_<data inicial>_<id. do movimento>.csv
A data inicial segue o formato YYYY-MM-DD.
Exemplo:
CREATION_2_2026-07-26_fdf613d2-187e-4d49-aaaf-9a1fb2d33297.csv
PAYMENT_2_2026-07-26_685f0301-1905-4d41-ac26-60d399b6da8d.csv
#1.4 Versões de layout
O layout do arquivo é versionado. A versão é acordada por subadquirente e vale para todos os tipos de registro do arquivo.
VERSÃO | DESCRIÇÃO |
v1 | Layout histórico. É a versão padrão de toda subadquirente. |
v2 | Igual à v1, acrescida dos identificadores únicos nos registros de ajuste (campos 19 e 20 do AD e campo 12 do AR). |
A versão não é sinalizada dentro do arquivo: não há header, trailer nem sufixo no nome do arquivo. A versão vigente de uma subadquirente pode ser consultada em GET /subacquirers/{id} (campo statement_layout_version) e a versão efetivamente usada em cada geração fica registrada no controle do extrato.
Uma solicitação avulsa de extrato pode informar layout_version no corpo da requisição para gerar o arquivo em uma versão específica, sem alterar a configuração da subadquirente. A regeração de um extrato já emitido preserva a versão original.
#2. Descrição dos Registros Contidos no Arquivo
#2.1 Registro do Tipo RC,PM E AC
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de Registro | RC, PM, AC |
02 | Modalidade | Conforme table nº4 |
03 | Tipo de transação | Conforme table nº3 |
04 | Identificador da lojista | Identificação do EC dentro do subadquirente, normalmente identificado pelo seu documento, como o CPF/CNPJ no caso do Brasil. |
05 | Canal | Identifica o Canal de Venda |
06 | Data e Hora da Criação do Recebível | (YYYY-MM-DDTHH:MM:SS.FFFFFF) em UTC |
07 | Data e Hora da Transação Original | (YYYY-MM-DDTHH:MM:SS) |
08 | Data de Agenda | YYYY-MM-DD |
09 | Valor Bruto Em Centavos | Em Centavos |
10 | Taxa MDR Em Centavos | Em Centavos |
11 | Taxa de Antecipação Pré-contratada em Centavos | Em Centavos |
12 | Valor Líquido Original em Centavos | Em Centavos |
13 | Taxa de Antecipação Pós-contratada em Centavos | Em Centavos |
14 | Valor Líquido Final em centavos | Em Centavos |
15 | Número da Parcela | |
16 | Quantidade Total de Parcelas | |
17 | Status do Recebível | Conforme Tabela nº2 |
18 | Código do Pedido | Identificador da transação de e-commerce, definido pelo lojista. |
19 | ID da Transação (TID) | Identificador único da transação. |
20 | Data de Liquidação Efetiva | Somente para Status PYD,ANT,ADJ |
21 | Campo dinânimo 1 | TEF: Sigla do Arranjo, conforme Definido Pela 3.952 ou PVT (cartão private) |
22 | Campo dinâmico 2 | TEF: Cartão Mascarado |
23 | Campo dinâmico 3 | TEF: NSU da autorização na adquirente. |
24 | Campo dinâmico 4 | TEF: Identificador da adquirente |
25 | Campo dinâmico 5 | TEF: Codigo de autorização |
26 | Campo dinâmico 6 | TEF: Nsu de confirmação |
27 | Campo dinâmico 7 | TEF: Identificador da Transação de Ecommerce no Provedor |
28 | Numero de Parcelas Da Transação Original | Numero da parcelas da transação que gerou o recebivel em questão, o campo em questão difere do 16 em casos de antecipação pré contrada. |
29 | Código de sub-pedido da Subadquirente | Identificador da transação de e-commerce. Atribuido especificamente a um integrante do split, será diferente do campo 18 caso enviado na criação da transação. |
30 | ID único da retenção | O campo será preenchido com o identificador único da retenção, caso a transação tenha sofrido alterações nos valores relacionados a retenção. |
31 | Valor retido | O campo será preenchido com o valor retido daquele recebivel. |
32 | Campo dinamico região 1 | Brasil: Em branco. |
33 | Campo dinamico região 2 | Todos: Valor da taxa fixa do produto financeiro, dividido conforme o fee_division aplicável ao respectivo lojista. |
34 | Campo dinamico região 3 | Brasil: Em branco. |
35 | Campo dinamico região 4 | Brasil: Em branco. |
36 | Campo dinamico região 5 | Brasil: Em branco. |
37 | Campo dinamico região 6 | Brasil: Em branco. |
38 | Campo dinamico região 7 | Brasil: Em branco. |
39 | Campo dinamico região 8 | Brasil: Em branco. |
40 | ID campanha | Identificador unico da campanha aplicada no produto que gerou o recebivel. |
41 | Descrição do ajuste | Descrição do motivo do ajuste. Será gerado com base na descricão passada durante a criação do ajuste manual ou com base na descricão da cobrança(aluguel de POS). Na falta do mesmo, será preenchido com N/A. |
42 | Descrição do pagamento | Descrição do pagamento, contendo o motivo da confirmação do pagamento ou do cancelamento. Na falta do mesmo, será preenchido com N/A. |
43 | Provedor de liquidação | Provedor usado na liquidação da mesma. Pode haver mais de um caso casos onde a UR foi liquidada parcialmente por provedores diferentes, em caso de mais um, virá separado por virgula. Exemplo: DOCK,RTM |
#2.2 Registro do Tipo AP e CC
O registro CC-cancelamento indicará uma transação já enviada através do registro RC, 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 contendo os lançamentos de liquidação, a transação pode ser cancelada através do CC. Cancelamentos após liquidação são tratados como ajustes (AD), precedidos sempre do registro AP enviados antes da liquidação efetiva do ajuste.
Os registros do AP referenciam os registros de previsão de ajustes a débito, podendo estarem vinculadas a vendas de TEF e SLIP. O lançamento efetivo do ajuste será confirmado no arquivo payment na data efetiva de sua liquidação, através do registro AD.
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de Registro | AP,CC |
02 | Modalidade | Conforme tabela nº4 |
03 | Tipo de transação | Conforme tabela nº3 |
04 | Identificador da lojista | Identificação do EC dentro do subadquirente, normalmente identificado pelo seu documento, como o CPF/CNPJ no caso do Brasil. |
05 | Canal | Identifica o Canal de Venda |
06 | Data e Hora da Criação do Ajuste | (YYYY-MM-DDTHH:MM:SS.FFFFFF) em UTC |
07 | Data e Hora da Transação de Cancelamento | (YYYY-MM-DDTHH:MM:SS) em UTC |
08 | Data e Hora da Transação Cancelada (original) | (YYYY-MM-DDTHH:MM:SS) em UTC |
09 | Data de Agenda do Ajuste | YYYY-MM-DD |
10 | Valor Bruto do Ajuste | Em Centavos |
11 | Taxa MDR | Em Centavos |
12 | Taxa de Antecipação Pré-contratada | Em Centavos |
13 | Valor Líquido Original | Em Centavos |
14 | Taxa de Antecipação Pós-contratada | Em Centavos |
15 | Valor Líquido Final | Em Centavos |
16 | Valor Já Liquidado | Em Centavos |
17 | Número da Parcela | |
18 | Quantidade Total de Parcelas | |
19 | Status do Ajuste | |
20 | Código do Pedido | Identificador da transação de e-commerce, definido pelo lojista. |
21 | ID da Transação (TID) | Identificador único da transação. |
22 | Data da Liquidação Efetiva do Ajuste | Preenchido quando o ajuste estiver pago. |
23 | Campo dinâmico 1 | TEF: Sigla do Arranjo, conforme Definido Pela 3.952 ou PVT (cartão private) |
24 | Campo dinâmico 2 | TEF: Cartão Mascarado |
25 | Campo dinâmico 3 | TEF: NSU da autorização na adquirente. |
26 | Campo dinâmico 4 | TEF: Identificador da adquirente |
27 | Campo dinâmico 5 | TEF: Codigo de autorização |
28 | Campo dinâmico 6 | TEF: Nsu de confirmação |
29 | Campo dinâmico 7 | TEF: Identificador da Transação de Ecommerce no Provedor |
30 | Motivo do Ajuste | Conforme tabela nº6 |
31 | Numero de Parcelas Da Transação Original | Numero da parcelas da transação que gerou o recebivel em questão, o campo em questão difere do 16 em casos de antecipação pré contrada. |
32 | Código de sub-pedido da Subadquirente | Identificador da transação de e-commerce. Atribuido especificamente a um integrante do split, será diferente do campo 18 caso enviado na criação da transação. |
33 | ID único da retenção | O campo será preenchido com o identificador único da retenção, caso a transação tenha sofrido alterações nos valores relacionados a retenção. |
34 | Valor retido | O campo será preenchido com o valor retido daquele recebivel. |
35 | Campo dinamico região 1 | Brasil: Em branco. |
36 | Campo dinamico região 2 | Todos: Valor da taxa fixa do produto financeiro, dividido conforme o fee_division aplicável ao respectivo lojista. |
37 | Campo dinamico região 3 | Brasil: Em branco. |
38 | Campo dinamico região 4 | Brasil: Em branco. |
39 | Campo dinamico região 5 | Brasil: Em branco. |
40 | Campo dinamico região 6 | Brasil: Em branco. |
41 | Campo dinamico região 7 | Brasil: Em branco. |
42 | Campo dinamico região 8 | Brasil: Em branco. |
43 | Descrição do ajuste | Descrição do motivo do ajuste, quando informada, para registros AP ou CC. Será gerada com base na criação de ajuste manual ou pelo módulo de cobranças. |
#2.3 Registro do Tipo AD
São identificadas por meio desse tipo de registro transações de Ajuste a Crédito ou Ajuste a Débito, podendo estarem vinculadas a vendas de TEF e SLIP ou para ajustes diversos sem referência a uma transação para o caso de uma diferença de crédito menor ou maior.
O registro AD originado de um ajuste tem 18 campos na v1 e 20 na v2 (campos 19 e 20).
Nos registros AD gerados diretamente a partir de um recebível, o registro tem 14 campos na v1 e 20 na v2. Nesse caso os campos 15 a 20 são enviados em branco.
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de registro | AD |
02 | Modalidade | Conforme tabela nº4 |
03 | Tipo de transação | Conforme tabela nº3 |
04 | Identificador da lojista | Identificação do EC dentro do subadquirente, normalmente identificado pelo seu documento, como o CPF/CNPJ no caso do Brasil. |
05 | Data e hora da criação do ajuste | (YYYY-MM-DDTHH:MM:SS.FFFFFF) em UTC |
06 | Data e hora da transação original | (YYYY-MM-DDTHH:MM:SS) |
07 | Data de pagamento | YYYY-MM-DD |
08 | Valor líquido | Em centavos, enviado com sinal negativo. |
09 | Número da parcela | |
10 | Quantidade total de parcelas | |
11 | Quantidade De Parcelas Da Transação Original | |
12 | Código de Pedido | Identificador da transação de e-commerce, definido pelo lojista. |
13 | ID da transação (TID) | Identificador único da transação. |
14 | Canal | Identifica o Canal de Venda |
15 | Descrição do ajuste | Descrição do motivo do ajuste. Será gerado com base na criação de ajuste manual ou pelo módulo de cobranças. |
16 | Modalidade do ajuste | |
17 | Codigo de arranjo | |
18 | Data de pagamento da unidade de ajuste | (YYYY-MM-DD) |
19 | ID único do registro de ajuste | (v2) Identificador único do item de ajuste. |
20 | ID único da unidade de ajuste | (v2) Identificador único da unidade que originou o ajuste. |
#2.4 Registro do tipo AR
São identificadas por meio desse tipo de registro de reversão de recebíveis, podendo estarem vinculadas a vendas de TEF, SLIP e PIX.
A reversão de recebível é utilizada para notificar todos os recebíveis que deixarão de ser liquidados para o CPF/CNPJ, por motivos de fraudes/chargeback ou quaisquer outros motivos em que se identifique que o recebível não deve ser pago ou foi liquidado por outro meio (EX.: TED, PIX) quando do encerramento da conta.
O registro AR tem 11 campos na v1 e 12 na v2 (campo 12).
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de registro | AR |
02 | Modalidade | TEF,SLIP,PIX |
03 | Tipo de transação | Tabela 2 |
04 | Identificador da lojista | Identificação do EC dentro do subadquirente, normalmente identificado pelo seu documento, como o CPF/CNPJ no caso do Brasil. |
05 | Data e hora da criação da reversão | (YYYY-MM-DDTHH:MM:SS.FFFFFF) em UTC |
06 | Data e hora da transação original | (YYYY-MM-DDTHH:MM:SS) |
07 | Data de reversão | YYYY-MM-DD |
08 | Valor líquido em centavos | Enviado com sinal negativo. |
09 | Número da Parcela | |
10 | Canal | Identifica o Canal de Venda |
11 | ID da transação (TID) | Identificador único da transação. |
12 | ID único do registro de reversão | (v2) Identificador único do item de reversão. |
#2.5 Registro NI–Antecipação
Registro de antecipação de recebíveis, será retornado um registro para cada parcela/venda antecipada.
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de registro | NI |
02 | Modalidade | TEF |
03 | Identificador da lojista | Identificação do EC dentro do subadquirente, normalmente identificado pelo seu documento, como o CPF/CNPJ no caso do Brasil. |
04 | Data e hora da criação do ajuste | (YYYY-MM-DDTHH:MM:SS.FFFFFF) em UTC |
05 | Data de agenda (original) | YYYY-MM-DD |
06 | Data de agenda antecipação | YYYY-MM-DD |
07 | Data de liquidação efetiva | YYYY-MM-DD |
08 | Valor líquido antecipado | Em centavos |
09 | Valor líquido original | Em centavos |
10 | Valor bruto original | Em centavos |
11 | Taxa de antecipação | Em centavos |
12 | Taxa de antecipação dia | % |
13 | Valor líquido original venda | Em centavos |
14 | Valor bruto original venda | Em centavos |
15 | ID do recebível que foi antecipado | |
16 | Número da parcela antecipada | |
17 | ID do registro de antecipação | |
18 | ID da antecipação (lote) | |
19 | TEF: Código da bandeira | TEF: sigla do arranjo, conforme 3.952 |
20 | Código do pedido | Identifica o código de pedido quando existente |
21 | Canal | Identifica o canal de venda |
#2.6 Registro RT–Retenção
Registro de retenção tributária. Os registros RT podem ser enviados ao final dos arquivos CREATION e PAYMENT, sendo gerada uma linha para cada imposto associado ao recebível.
O campo 09 é opcional. Quando não existir data de pagamento, o registro RT terminará no campo 08.
ID | NOME DO CAMPO | DESCRIÇÃO |
01 | Tipo de registro | RT |
02 | ID único da retenção | Identificador do registro de retenção associado ao recebível. |
03 | Documento do lojista | Número do documento tributário. Na ausência de documento registrado, será utilizado o identificador do lojista. |
04 | Tipo do documento | CUIT, CUIL ou NOT_REGISTRED. |
05 | Tipo do imposto | Identificador do imposto retido. |
06 | Valor retido | Em centavos. |
07 | Jurisdição | Jurisdição tributária da retenção. |
08 | Alíquota | Alíquota aplicada à retenção. |
09 | Data de pagamento | Campo opcional no formato YYYY-MM-DD. |
#3. Tabelas
#Tabela 1 - Tipos de Registros
Sigla | Descrição |
RC | Recebível (previsão) |
AP | Previsão de ajuste |
PM | Pagamento |
AC | Ajuste a Crédito |
AD | Ajuste a Débito |
CC | Cancelamento de Recebível (antes da Data de Liquidação) |
AR | Reversão de Recebíveis. |
NI | Registro de Antecipação de Recebíveis. |
RT | Registro de Retenção Tributária. |
#Tabela 2 – Status da transação
Identificador | Descrição do status |
SCH | Agendado |
ANT | Antecipado |
PYD | Liquidado (pago) |
CNC | Cancelado |
ERR | Erro (Retorno de erro em transação de reembolso) |
ADJ | Ajustado |
UND: | Indefinido (retornado quando o preenchimento do status não é possível no retorno da liquidação) |
#Tabela 3 – Tipo de transação
Identificador | Descrição do tipo da transação |
C | Crédito |
D | Débito |
V | Voucher |
S | Boleto |
P | Pix |
R | Reembolso |
O | Outro, ocorrerá quando não for originado por uma transação, como ajustes lançados direto na agenda. |
#Tabela 4 – Modalidades de pagamento
Identificador | Descrição da modalidade |
TEF | TEF no geral, abrangendo transações efetuadas em terminais fisicos e e-commerce. |
SLIP | Boletos gerados/processados pela plataforma GSURF. |
REFUND | Operações de reembolso de operações que não podem ser reembolsadas diretamente em seu provedor. |
PIX | Pix gerados/processados pela plataforma GSURF. |
GENERIC | Modelo referente à movimentações não geradas por transações financeiras. Exemplo: Ajuste a crédito/Ajuste a débito(não proveniente de um cancelamento de transação). |
1 - O valores de ajustes nos registros RC/AP(quando ajustes a crédito) não devem ser contabilizados aos AP/AD das outras linhas do arquivo, pois cada um refere-se a um ou mais AP/AD enviado no arquivo.
#Tabela 5 - 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 bandeira |
ACC | AMEX CREDITO | 11, 12 |
BCC | BANESCARD CREDITO | 14 |
BCD | BANESCARD DEBITO | 15 |
BVV | BEN VISAVALE | 18, 19 |
CBC | CABAL CREDITO | 20 |
CBD | CABAL DEBITO | 21 |
CBP | CABAL VOUCHER | 22 |
TAN | TARJETA NARANJA | 24 |
ECC | ELO CREDITO | 38 |
ECD | ELO DEBITO | 39 |
GCC | GOODCARD CREDITO | 108, 109 |
HCC | HIPERCARD | 49 |
JCC | J.C.B. | 52 |
MCC | MASTERCARD | 55 |
MCD | MASTERCARD DEBITO/MAESTRO | 53 |
SCC | SOROCRED CREDITO | 25, 71 |
VCC | VISA CREDITO | 85 |
VCD | VISA DEBITO | 86 |
VDC | VERDECARD | 84 |
MAC | CREDSYSTEM | 33 |
CZC | CREDZ | 34 |
DCC | DINNERS | 37 |
PVT | PRIVATE | 150 |
SLP | Boleto | 0 |
PIX | PIX | 0 |
GNR | Generic(Ajustes financeiros) | 0 |
RFD | Reembolso | 0 |
UKN | Desconhecido (Exceção para caso o sistema não o identifique dentro do registro) | 0 |
#Tabela 6 - Motivos de ajustes.
Códigos de ajuste, preenchido quando Ajuste a Débito.
Código | Descrição do código de ajuste |
001 | SALE CANCELLATION |
002 | SALE CONTESTATION |
003 | TRANSACTION FEE |
004 | SALE ADJUSTMENT |
005 | POS RENT |
006 | ADDITIONAL CHARGE |
007 | PINPAD |
008 | SMART POS |
009 | PROPERTY INSURANCE |
010 | HEALTH CARE |
#Histórico de Revisões
Versão | Modificações | Autor | Data |
1.0 | Publicação Inicial | Mateus Fornari e | 09/07/2021 |
1.1 | Inclusão dos registros AP e NI | Mateus Fornari e | 02/08/2021 |
1.2 | Ajuste de campos nos registros AP, CC, AD e AC | Mateus Fornari e | 07/09/2021 |
1.3 | Adição dos campos de taxa de antecipação pós-contratada e valor líquido | Alisson Pereira | 20/09/2021 |
1.3.1 | Ajustes visuais na visualização de algumas informações. | Alisson Pereira | 24/10/2022 |
1.4 | Adicionado os valores ajustados aos recebiveis. E adicionado o campo do E2E_id aos RC/PM de Pix. | Alisson Pereira | 01/11/2022 |
1.5 | Adicionando campo Motivo do ajuste, ID 29, em registro AP e criado tabela nº6 | Gustavo Carpes | 13/03/2024 |
1.5.1 | Adicionando campo código 007 na tabela nº 6. | Gustavo Carpes | 15/03/2024 |
1.5.2 | Adicionando campo Quantidade De Parcelas Da Transação Original nos registros RC,AC,PM,AP,CC,AD | Mateus Silvano | 02/04/2024 |
1.5.3 | Adicionando campos tid, nosso numero, codigo do banco nos registros RC,AC,PM,AP,CC,AD | Mateus Silvano | 10/04/2024 |
1.5.3.1 | Padronizada a inserção dos ultimos campos | Alisson Pereira | 12/04/2024 |
1.5.4 | Adicionado o TXID | Alisson Pereira | 18/04/2024 |
1.5.5 | Adicionado o campo Taxa da transação separado por split | Mahu Bogotto | 15/10/2024 |
1.5.6 | Revisada documentação do RC e AP, ajustados campos com descrições erradas e adicionados campos dinamicos por região. | Alisson Pereira | 18/11/2024 |
1.5.7 | Adicionado Descrição do motivo do ajuste no AP e no AD | Alisson Pereira | 07/02/2025 |
1.5.8 | Ajustada descrição dos campos de motivo de ajuste e pagamento | Alisson Pereira | 26/09/2025 |
1.5.9 | Adicionado Private na lista de bandeiras | Alisson Pereira | 30/09/2025 |
1.5.10 | Remoção do campo ID campanha do arquvio AP | Lucas Fernandes | 29/10/2025 |
1.5.11 | Adição do campo provedor de liquidação nos registros PM e ajustada descricão do campo de motivo da liquidação | Alisson Pereira | 19/03/2026 |
1.5.12 | Atualização do nome dos arquivos, layouts AD, AR e RT, regras de AP/CC, sinais dos valores, tratamento CSV e tabelas de domínio. | Alisson Pereira | 27/07/2026 |
1.6.0 | Versionamento do layout do arquivo (v1/v2). Os identificadores únicos de AD (campos 19 e 20) e AR (campo 12) passam a existir somente na v2, configurável por subadquirente. | Alisson Pereira | 25/08/2026 |
