Reembolsos de cartão de compra
Devolver pontos de viagem resgatados quando os fornecedores cancelarem voos feitos com P-cards
Quando os planos dos viajantes são alterados pelas suas companhias aéreas, você pode facilitar a devolução dos pontos de fidelidade ganhos que eles usaram para uma reserva com cartão de compra (P-card). Você criará um arquivo e o enviará para o servidor SFTP da Expedia. Em um nível mais alto, isso significa que você irá:
- Solicite as informações de TPID, EAPID e SITEID da Expedia. Essas informações são uma parte essencial do nome do relatório para garantir que as informações de reembolso sejam mapeadas corretamente. Veja a seção Convenção de nomenclatura para mais detalhes.
- Crie um arquivo de acordo com o formato e a estrutura especificados e nomeie-o de acordo com as convenções de nomenclatura.
- Carregue o arquivo no servidor SFTP da Expedia.
Ao seguir as seções definidas nesta documentação, você pode garantir que o arquivo seja processado sem problemas, sem erros ou omissões durante o processo automatizado.
Obtendo as informações
Solicite que o emissor do seu P-card forneça um arquivo de dados diário que incluirá os pontos de dados de relatórios necessários para o relatório de reembolsos de cartão de compra que você enviar para a Expedia. Normalmente, o processador de pagamento P-card (por exemplo, TSYS) fornecerá este relatório.
Formato do arquivo
Para processar com sucesso um arquivo de reembolso, ele deve estar em conformidade com os seguintes padrões:
- O formato do arquivo deve ser
.csvpara arquivos não criptografados ou.pgppara arquivos criptografados. Ao enviar um arquivo criptografado, certifique-se de que todo o arquivo seja criptografado como uma única entidade usando criptografia PGP, em vez de criptografar cada linha individualmente. - A primeira linha do arquivo deve sempre conter os títulos das colunas.
- Todas as 10 colunas na tabela abaixo devem ser incluídas, na ordem listada. Nenhuma coluna adicional deve ser incluída.
- O conteúdo de cada linha deve ser separado por uma barra vertical (
|), não por vírgula. - Após os títulos das colunas, cada linha corresponde a um único registro de transação.
- Todas as colunas obrigatórias devem estar presentes e conter dados válidos. Registros com campos obrigatórios ausentes serão ignorados ou sinalizados para revisão do agente.
Estrutura de arquivos
As operadoras fornecerão AIR_CONFIRMATION_NUMBER ou AIR_TICKET_NUMBER, portanto, inclua ambos os atributos para garantir que os reembolsos sejam relatados.
É melhor que os campos obrigatórios condicionalmente (AIR_TICKET_NUMBER e AIRLINE_CARRIER_CODE) sejam incluídos no seu relatório, mas se a transportadora não fornecer os dados, o relatório não falhará quando ingerido pelo Expedia.
| Ordem | Nome da coluna | Descrição | Tipo de dados | Exemplo | Campo obrigatório? |
|---|---|---|---|---|---|
| 1 | AIR_TICKET_NUMBER | Número da passagem aérea. Deve ter 10 dígitos. Se este campo não tiver valor, será necessária uma revisão do agente para corresponder os registros com o Expedia. Observação: as transportadoras sem bilhete usarão o número de confirmação. | Sequência | 9607721439 | Obrigatório (condicionalmente) |
| 2 | AIRLINE_CARRIER_CODE | Código alfanumérico de 2 ou 3 caracteres da companhia aérea IATA. Se este campo não tiver valor, será necessária uma revisão do agente para corresponder os registros com o Expedia. | Sequência | DL (Delta) AC (Air Canadá) UA (United Airlines) | Obrigatório (condicionalmente) |
| 3 | TRANSACTION_AMOUNT | Número decimal 2 que representa o valor cobrado no cartão. Um valor negativo indica um reembolso. Observação: este campo é obrigatório para transações de reembolso, mas não para transações de crédito. | Número | 104,23 (cobrado) -104,23 (Reembolso) | Obrigatório |
| 4 | CURRENCY_CODE | Código de moeda ISO de 3 letras. | Sequência | CAD US$ | Obrigatório |
| 5 | POST_DATE | P-card data de publicação no formato mm/dd/aaaa. | Data | 11/07/2024 | Obrigatório |
| 6 | TRANSACTION_DATE | P-card data da transação no formato mm/dd/aaaa. | Data | 07/07/2024 | Obrigatório |
| 7 | TRAVELER_FIRST_NAME | Primeiro nome do viajante associado ao bilhete. Máximo de 50 caracteres. Não utilize caracteres de barra vertical. Valores permitidos: letras latinas (A-Z, a-z), letras acentuadas (como é, ü, ç), números, espaços. | Sequência | Parvati Maria Ana | Opcional |
| 8 | TRAVELER_LAST_NAME | Sobrenome do viajante associado ao bilhete. Máximo de 50 caracteres. Não utilize caracteres de barra vertical. Valores permitidos: letras latinas (A-Z, a-z), letras acentuadas (como é, ü, ç), números, espaços. | Sequência | Smith De La Cruz | Opcional |
| 9 | SUPPLY_INFO | Informações adicionais sobre o provedor, geralmente o nome Merchant. Máximo de 300 caracteres. Valores permitidos: letras latinas (A-Z, a-z), números, espaços. Caracteres especiais (como @, ', -, #, é, ç) não são permitidos. | Sequência | LATA DE AR 0111111111111 CARIBE AI1062222222222 BRUXELAS IA 0823333333333 | Opcional |
| 10 | AIR_CONFIRMATION_NUMBER | Número de confirmação aérea alfanumérico de 6 dígitos. Este campo é usado como um identificador quando um número de bilhete não está presente. É necessário somente quando se lida com uma transportadora sem bilhete. Valores permitidos: letras latinas (números A-Z, a-z),. Não use: espaços, caracteres especiais (como @, #, é, ç) | Sequência | ABCD12 | Opcional (necessário para processamento sem tíquete) |
Arquivo de amostra
Nome do arquivo: [PARTNERNAME]_ 5002_900188_ 900188_20241108.csv
AIR_TICKET_NUMBER|AIRLINE_CARRIER_CODE|TRANSACTION_AMOUNT|CURRENCY_CODE|POST_DATE|TRANSACTION_DATE|TRAVELER_FIRST_NAME|TRAVELER_LAST_NAME|SUPPLY_INFO|AIR_CONFIRMATION_NUMBER
9607721439|AC|104.23|CAD|11/07/2024|11/01/2024|Sam F.|Doe|AIR CAN 0111111111111|ABCD12
5954412772|WS|-550.9|CAD|02/08/2024|02/04/2024|John|Smith|CARIBBEAN AI1062222222222|WQJGL5
54412723|UA|-265.9|CAD|02/09/2024|02/04/2024||||Parâmetros de arquivo
Antes de enviar seu arquivo de reembolso, você precisará seguir algumas convenções padrão, incluindo definir o nome do arquivo e criptografar as informações.
Convenção de nomenclatura
Todos os arquivos enviados para reembolso devem seguir a convenção de nomenclatura descrita abaixo. Qualquer desvio deste formato resultará na exclusão do arquivo do processamento.
O nome do arquivo deve ser estruturado da seguinte forma: [PARTNERNAME]_TPID_EAPID_SITEID_YYYYMMDD.csv, onde:
- NOME DO PARCEIRO: Nome da sua organização.
- TPID: O ID do produto de viagem atribuído pela Expedia.
- EAPID: O ID do parceiro afiliado da Expedia atribuído pela Expedia.
- SITEID: O ID do ponto de venda do site atribuído pela Expedia.
- AAAAMMDD = ano, mês e dia em que o arquivo foi gerado, representado por 4 dígitos para o ano e 2 dígitos para o mês e o dia.
Não inclua caracteres especiais ou espaços no nome do arquivo. O tamanho do arquivo não deve exceder 5 GB.
Criptografia
Para maior segurança, você pode optar por criptografar o arquivo usando PGP. Solicite nossa chave PGP pública ao seu gerente de conta e:
- Proteja o arquivo inteiro, não apenas seu conteúdo.
- Adicione a extensão .pgp (por exemplo,
PARTNERNAME_0_1_1_20250101.pgp)
Instruções de upload
Para processar o arquivo com sucesso, ele deve ser enviado usando o nome do host SFTP do Expedia: eps-pcard-transactions-datafeed.transfer.expedia.com.
Para estabelecer uma conexão SFTP, você precisará fornecer os seguintes detalhes:
- Nome de usuário preferido para o usuário SFTP (alfanumérico, máximo de 20 caracteres)
- Chave pública SSH (Secure Shell)
- Sub-rede IP a ser adicionada à lista de permissões (a conexão SFTP só será permitida a partir desta sub-rede permitida)
Usando qualquer ferramenta de conectividade SFTP, abra uma nova conexão no cliente SFTP. Selecione o protocolo de transferência segura de arquivos e insira o servidor e o nome de usuário que seu gerente de conta da Expedia fornecerá.
Observação: Você só pode enviar arquivos de reembolso uma vez por dia.
Testes
Antes de lançar seu site modelo, recomendamos que você teste o processo de upload de reembolso. Para validação inicial, comece carregando um arquivo de relatório de exemplo com dados simulados. Verificaremos se o arquivo foi recebido e confirmaremos se os dados foram processados com sucesso.
Depois, valide com as reservas de produção antes do lançamento do site. Seu gerente de contas da Expedia coordenará com você o envio de um relatório para uma data específica, com base nas reservas de testes de produção feitas durante os testes de aceitação do usuário.