Developer Hub
Esta é uma tradução automática

Reembolsos de cartão de compras

Devolva os pontos de viagem resgatados quando os fornecedores cancelarem voos feitos com P-cards

Quando os planos dos viajantes são alterados pelos seus fornecedores de passagens aéreas, você pode facilitar a devolução dos pontos de fidelidade acumulados que eles usaram para uma reserva com cartão de compras (P-card). Você criará um arquivo e o enviará para o servidor SFTP da Expedia. Em linhas gerais, isso significa que você irá:

  1. Solicite à Expedia as informações de TPID, EAPID e SITEID. Essa informação é essencial para o nome do relatório, a fim de garantir que as informações de reembolso sejam mapeadas corretamente. Consulte a seção Convenção de nomenclatura para obter mais detalhes.
  2. Crie um arquivo de acordo com o formato e a estrutura especificados e nomeie-o de acordo com as convenções de nomenclatura.
  3. Faça o upload do arquivo para o servidor SFTP da Expedia.

Seguindo as instruções definidas nesta documentação, você garante que o arquivo seja processado sem problemas ou omissões durante o processo automatizado.

Obtendo informações

Solicite que a sua instituição emissora do cartão P-card forneça um arquivo de dados diário que inclua os pontos de dados necessários para o relatório de reembolsos de cartões de compra que você envia à Expedia. Normalmente, o processador de pagamentos P-card (por exemplo, TSYS) fornecerá este relatório.

Formato do arquivo

Para que um pedido de reembolso seja processado com sucesso, ele deve atender aos 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 o arquivo inteiro 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 cabeçalhos das colunas.
  • Todas as 10 colunas da tabela abaixo devem ser incluídas, na ordem em que são apresentadas. Não devem ser incluídas colunas adicionais.
  • O conteúdo de cada linha deve ser separado por um caractere de barra vertical (|), não por uma vírgula.
  • Após os cabeçalhos 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 por um 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.

É recomendável que os campos condicionalmente obrigatórios (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 apresentará erros ao ser processado pela Expedia.

OrdemNome da colunaDescriçãoTipo de dadosExemploCampo obrigatório?
1AIR_TICKET_NUMBERNúmero do bilhete aéreo. Deve ter 10 dígitos. Se este campo não tiver valor, será necessária uma revisão por um agente para comparar os registros com a Expedia. Observação: As companhias aéreas que não emitem bilhetes usarão o número de confirmação.Sequência9607721439Obrigatório (condicionalmente)
2AIRLINE_CARRIER_CODECompanhia aérea alfanumérica de 2 ou 3 caracteres Código IATA. Se este campo não tiver valor, será necessária uma revisão por um agente para comparar os registros com a Expedia.SequênciaDL (Delta)
AC (Air Canada)
UA (United Airlines)
Obrigatório (condicionalmente)
3TRANSACTION_AMOUNTNúmero com duas casas decimais 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úmero104,23 (Cobrado)
-104,23 (Reembolso)
Obrigatório
4CURRENCY_CODECódigo ISO de moeda com 3 letras.SequênciaCAD
US$
Obrigatório
5POST_DATEP-card data da postagem no formato mm/dd/aaaa.Data11/07/2024Obrigatório
6TRANSACTION_DATEP-card data da transação no formato mm/dd/aaaa.Data07/07/2024Obrigatório
7TRAVELER_FIRST_NAMEPrimeiro 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ênciaParvati
Maria Ann
Opcional
8TRAVELER_LAST_NAMESobrenome 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ênciaSmith
De La Cruz
Opcional
9SUPPLY_INFOInformaçõ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ênciaCANO DE AR ​​0111111111111
CARIBE AI1062222222222
IA de Bruxelas 0823333333333
Opcional
10AIR_CONFIRMATION_NUMBERNúmero de confirmação aérea alfanumérico de 6 dígitos. Este campo é usado como identificador quando não há número de bilhete. É necessário apenas ao lidar com uma companhia aérea que não emite bilhetes.
Valores permitidos: letras latinas (A-Z, a-z), números.
Não utilize: espaços, caracteres especiais (como @, #, é, ç)
SequênciaABCD12Opcional (obrigatório para processamento sem bilhete)

Arquivo de exemplo

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 do arquivo

Antes de poder 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 de Parceiro Afiliado da Expedia, atribuído pela Expedia.
  • SITEID: O ID do ponto de venda do site atribuído pela Expedia.
  • AAAAMMDD = o ano, mês e dia em que o arquivo foi gerado, representados 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 o 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 de host SFTP da Expedia: eps-pcard-transactions-datafeed.transfer.expedia.com.

Para estabelecer uma conexão SFTP, você precisará fornecer os seguintes detalhes:

  • Nome de usuário preferencial 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 será permitida somente a partir desta sub-rede permitida).

Utilizando qualquer ferramenta de conectividade SFTP, abra uma nova conexão no cliente SFTP. Selecione o protocolo de transferência de arquivos seguro e insira o servidor e o nome de usuário que o seu gerente de conta da Expedia lhe fornecerá.

Observação: Você só pode enviar arquivos de reembolso uma vez por dia.

Testes

Antes de lançar seu site com modelo, recomendamos que você teste o processo de reembolso. Para a validação inicial, comece enviando um arquivo de relatório de amostra com dados fictícios. Verificaremos se o arquivo foi recebido e confirmaremos se os dados foram processados ​​com sucesso.

Em seguida, valide com reservas de produção antes do lançamento do site. O seu gestor de conta da Expedia entrará em contacto consigo para enviar um relatório referente a uma data específica, com base nas reservas de teste de produção efetuadas durante os testes de aceitação do usuário.

Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.