Reconciliação de pontos de fidelidade
O arquivo de reconciliação diária de pontos (recon) tem como objetivo ajudar você a manter totais precisos de pontos de fidelidade para seus clientes. Como a Expedia não tem acesso para ajustar os totais do seu sistema, quando um cliente reserva uma viagem usando pontos de fidelidade, seus registros precisarão levar esse uso em consideração.
Todos os dias, seu site enviará um arquivo .csvcom informações sobre transações que ocorreram no seu site modelo no período de 24 horas entre 00:00 PST e 23:59 PST.
O arquivo será trocado diariamente via protocolo de transferência segura de arquivos (SFTP), que você combinará com seu gerente de lançamento da Expedia.
Nome do arquivo Recon
A convenção de nomenclatura padrão para o arquivo de reconhecimento de pontos diários é (em ordem) o nome da sua marca ou organização, o código do país em que o site modelo está operando e a data e hora da geração do arquivo. Cada elemento deve ser separado por um caractere de sublinhado (_), assim: YourBrand_countrycode_date.csv.
O formato da data deve ser dd_mm_yyyy_hhmm, e o código do país é case-sensitive. Observação: não há validação do código do país no Expedia — ele é usado apenas como metadados.
Por exemplo, o nome do seu arquivo pode ser assim: YourBrand_USA_28_04_2024_0800.csv.
Sobre o arquivo
O arquivo contém vários cabeçalhos padrão e valores correspondentes. Se você tiver campos adicionais que precisam de reconciliação, poderá incluí-los após os valores padrão.
Observação
Somente transações confirmadas precisam ser enviadas no arquivo. Transações canceladas devem ser ignoradas.
Certifique-se de cortar quaisquer espaços ou caracteres não visíveis ao redor dos nomes dos cabeçalhos para que reflitam com precisão o modelo do seu site.
| Cabeçalho padrão | Descrição | Formato de dados | Exemplo do valor |
|---|---|---|---|
| DATA DA TRANSAÇÃO | A data da transação | dd-month-yy hh.mm.ss (não nulo ou em branco) | 18 de agosto de -22 19.22.44 |
| ID DO PEDIDO | O ID do pedido da Expedia compartilhado na solicitação da API Nota: Se você abrir o arquivo no Excel, as regras de importação padrão podem corromper os valores deste campo | Sequência (não nulo ou em branco) | 9223371999748510705 |
| ID DO PEDIDO | Um identificador de solicitação exclusivo que a Expedia fornece para uso na reconciliação | Sequência (não nulo ou em branco) | |
| ID DE CONFIRMAÇÃO DO PARCEIRO | Um identificador de transação exclusivo que você fornece | Sequência (não nulo ou em branco) | varia |
| TIPO DE TRANSAÇÃO | O tipo de transação representada; os valores válidos incluem Resgatar ou Reembolsar | Sequência | Resgatar |
| QUANTIDADE TOTAL DE PONTOS | O número total de pontos na transação; deve ser sempre um número positivo | Inteiro | 15h |
| VALOR TOTAL DE PONTOS | O valor monetário dos pontos utilizados Observação: o gerente de lançamento da Expedia discutirá mais detalhes sobre esse valor com você para garantir que ele seja interpretado corretamente para todas as transações. | Inteiro | 500 |
| CÓDIGO DA MOEDA | O código de moeda padrão ISO usado para o valor dos pontos; por exemplo, USD, CAD, AUD | Sequência | US$ |
Etapas de integração e transferência de arquivos
Para transferir o arquivo de reconhecimento de pontos diários, você precisará configurar protocolos de comunicação que garantirão a segurança dos seus dados.
- Primeiro, você criará um par de chaves pública/privada SSH (secure shell) e compartilhará a chave pública conosco.
- Compartilharemos uma chave pública que você usará para criptografar e enviar o arquivo.
- Compartilharemos os detalhes do SFTP para que você possa se conectar por meio da sua chave privada SSH e carregar o arquivo criptografado no diretório especificado.
Detalhes do SFTP
| Servidor | Valores |
|---|---|
| TESTE | Anfitrião: secure-file-transfer-test.expedia.com UserName: <A ser fornecido pela Expedia> Pasta: /<arquivo a ser carregado dentro da pasta raiz> |
| PRODUÇÃO | Anfitrião: secure-file-transfer.expedia.com UserName: <A ser fornecido pela Expedia> Pasta: /<arquivo a ser carregado dentro da pasta raiz> |