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