Arquivo de Reembolso em lote.
1. Introdução
1.1 Objetivos
Este documento descreve a estrutura do Arquivo de Reembolso em lote 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.
1.3 Nomes dos Arquivos
O nome do arquivo de Reembolso terá o seguinte padrão:
<Tipo do Arquivo>_ <id. do arquivo de controle>.csv
Exemplo:
REFUND_fdf613d2-187e-4d49-aaaf-9a1fb2d33297.csv
2. Descrição dos Registros Contidos no Arquivo
2.1 Tipos de Arquivos
| TIPO DO ARQUIVO |
DESCRIÇÃO |
| Simplificado |
Processamento onde o único dado fornecido é o número do pedido. |
| Detalhado |
Processamento com mais detalhes para reembolso. |
2.2 Registros de reembolso.
2.2.1 Simplificado
| ID |
NOME DO CAMPO |
DESCRIÇÃO |
| 01 |
Número do pedido |
Número do pedido. |
2.2.2 Detalhado
| ID |
NOME DO CAMPO |
DESCRIÇÃO |
| 01 |
Tipo de Registro |
Conforme tabela nº 1. |
| 02 |
transaction id |
Identificador único da transação a ser reembolsada. |
| 03 |
gw transaction id |
Identificador único da transação no gateway de pagamento. |
| 04 |
Tipo de Reembolso |
Conforme tabela nº 2. |
| 05 |
Modalidade |
Conforme tabela nº 3. |
| 06 |
Descrição |
Descrição do reembolso. |
| 07 |
Tipo de operação |
Conforme tabela nº 4. |
| 08 |
Split Data |
Dados da(s) split(s), no padrão CPF/CNPJ:valor podendo haver múltiplos registros separados por "," (vírgula) na mesma célula. |
3. Tabelas
Tabela 1 - Tipos de Registros
| Sigla |
Descrição |
| C |
Criação |
Tabela 2 – Tipos de Reembolso
| Identificador |
Descrição do tipo de Reembolso |
| TOTAL |
Total, utilizando o valor inteiro da transação |
| PARTIAL |
Parcial, utilizando o valor passado no campo de split data |
Tabela 3 – Tipos de Modalidade de pagamento
| Identificador |
Descrição do tipo da modalidade |
| CREDIT |
Crédito abrangendo transações efetuadas em terminais fisicos e e-commerce. |
| DEBIT |
Débito abrangendo transações efetuadas em terminais fisicos e e-commerce. |
| PIX |
Pix gerados/processados pela plataforma GSURF. |
Tabela 4 – Tipos de operação
| Identificador |
Descrição do tipo de operação |
| 0 |
Reembolsos normais. |
| 1 |
Reembolsos que devem ser gerados de forma administrativa. |
| 2 |
Reembolsos que devem ser gerados como Chargeback. |
Histórico de Revisões
| Versão |
Modificações |
Autor |
Data |
| 1.0 |
Publicação Inicial |
Gustavo Carpes |
06/08/2024 |
| 1.1 |
Adicionado processamento layout arquivo simplificado |
Arthur Miada |
12/03/2025 |
