Esta seção descreve como criar um relatório de conciliação para fazer upload dele usando a Central para Hotéis.
Requisitos básicos
Cada arquivo CSV de reconciliação precisa conter:
- uma linha de cabeçalho com os nomes das colunas;
- zero ou mais linhas de detalhes de reservas (uma para cada reserva);
- (opcional) uma linha que especifica as taxas de serviço.
O formato do arquivo CSV que usamos para o relatório de conciliação está em conformidade com RFC 4180. Aplicam-se as seguintes regras gerais:
- Codificação UTF-8
- Marcas de ordem de bytes são permitidas, mas não necessárias.
- Os números precisam usar um ponto "." como separador decimal, em vez de uma vírgula ",". Por exemplo, o valor de 10 euros precisa ser formatado como "10.00", e não "10,00".
- Strings com vírgulas, aspas ou retornos de carro/feeds de linha precisam ser colocadas entre "aspas duplas".
- Cada linha precisa terminar com um CRLF.
Linha de cabeçalho
A linha de cabeçalho define os nomes das colunas e precisa conter 23 ou 28 campos no total:
- 23 campos: se você não inclui taxas de serviço.
- 28 campos: se você inclui taxas de serviço.
Inclua linhas de taxas de serviço opcionais se você cobrar taxas relacionadas à coleta de comissões dos seus hotéis. Trata-se de uma taxa menor para cada reserva que se destina à administração do Programa de comissões, normalmente calculado como uma cobrança menor ou um percentual adicional. Os campos relacionados às taxas de serviço são opcionais e não são processados pelo Google.
A linha de cabeçalho do exemplo a seguir mostra todos os 28 campos com os nomes exatamente como aparecem:
Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel Postal
Code,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and
Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking
Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency
Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency
to Billing Currency Conversion Rate,Payment Date,Payment Status
Campos opcionais:
Service Fee, Service Fee Currency, Service Fee Currency to Billing Currency Conversion Rate, Total Payment, Billing Currency
Em seu arquivo CSV, os nomes das colunas precisam estar na ordem em que aparecem no exemplo anterior.
Linhas de detalhes da reserva
Linhas de reserva contêm informações sobre cada reserva confirmada. Essas informações geralmente indicam quando uma reserva foi utilizada, e também se foi cancelada ou se não foi cobrada comissão por outros motivos. Você não paga comissões sobre reservas canceladas nem reservas em que os hóspedes não aparecem.
Cada linha de detalhes da reserva no arquivo CSV precisa conter exatamente o mesmo número de colunas que a linha de cabeçalho.
DICA: todos os campos são obrigatórios a menos que especificado de outra forma. Para um campo opcional em que você não insere dados, inclua apenas uma vírgula.
A tabela a seguir descreve as colunas em cada linha de detalhes da reserva:
| Coluna |
Descrição |
| ID do hotel |
Um ID exclusivo usado pelo hotel reservado. Esse código precisa ser o mesmo usado no seu Feed de lista de hotéis. Por exemplo, "661378545442". |
| Hotel Name |
O nome do hotel reservado. Por exemplo, "Capybara Motel". |
| Hotel Address |
O endereço do hotel reservado. Por exemplo, "123 Electric Avenue". |
| Hotel City |
A cidade na qual o hotel reservado está localizado. Por exemplo, "Cambridge". |
| Hotel State/Region |
O estado/região em que o hotel reservado está localizado. Por exemplo, "MA".
Este campo é opcional.
|
| Hotel Postal Code |
Um código postal flexível no qual o hotel reservado está localizado. Por exemplo, "02472-1234". |
| Hotel Country Code |
O código do país de duas letras em que o hotel reservado está localizado. Por exemplo, "US". |
| Hotel Phone Number |
Número de telefone do hotel reservado. O formato desse campo é flexível. Por exemplo, "+1-617-867-5309". |
| Booking Reference |
Uma string exclusiva que identifica a reserva. Por exemplo, "108BDYKNI". |
| Booking Date and Time |
A data e a hora no formato ISO 8601 em que foi feita a reserva, no horário local do hotel, incluindo o fuso horário. Por exemplo, "2016-07-07T19:43:21+08:00:". |
| Check-in Date |
A data de check-in, na hora local do hotel. Use o formato AAAA-MM-DD, em que AAAA é o ano de 4 dígitos, MM é o mês e DD é o dia. Por exemplo, "2016-09-01". |
| Check-out Date |
A data de check-out, na hora local do hotel. Use o formato AAAA-MM-DD, em que AAAA é o ano de 4 dígitos, MM é o mês e DD é o dia. Por exemplo, "2016-09-01". |
| Number of Rooms |
O número de quartos nesta reserva. Por exemplo, "1". |
| Number of Guests |
O número de hóspedes nesta reserva. Por exemplo, "2". |
| Booking Revenue |
A receita gerada com essa reserva. Esse valor pode ser a receita bruta ou líquida e deve refletir o valor da conversão. Por exemplo, "1.066,42". |
| Booking Revenue Currency |
O código de três letras da moeda utilizada para o campo "Booking Revenue". Por exemplo, "EUR". |
| Booking Revenue Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda usada no campo "Booking Revenue Currency" para a moeda utilizada no campo "Billing Currency". Esse valor precisa refletir as taxas de conversões usadas para a reserva. Por exemplo, "1,113".
Quando a moeda da receita de reserva e a moeda de faturamento são as mesmas, defina o campo como 1.
|
| Booking Status |
O status da reserva pode ser um dos seguintes valores:
- "Stayed": a reserva foi concluída e a estadia dos hóspedes foi efetivada, como esperado.
- "Cancelled": os hóspedes cancelaram a reserva antes da data do check-in. Se você define Booking Status como "Cancelled", configure Commission como 0.
- "No-show": os hóspedes não aparecem nem cancelam a reserva com antecedência. Se você define Booking Status como "No-show", configure Commission como 0.
- "Non-commissionable": essa reserva não pode incluir uma comissão. Se você define Booking Status como "Non-commissionable", configure Commission como 0.
|
| Commission |
O total a ser pago para o Google por esta reserva. Para reservas canceladas, ausências ou reservas não comissionáveis, defina o valor desse campo como "0". Por exemplo, "3,42". |
| Commission Currency |
O código de três letras da moeda utilizada no campo "Commission". Por exemplo "USD".
|
| Commission Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda usada no campo Commission Currency para a moeda utilizada no campo opcional Billing Curency. O valor desse campo precisa ser a taxa de conversão utilizada para a comissão. Por exemplo, "0,88942".
Quando a Commission Currency e a Billing Currency são as mesmas, defina esse campo como 1.
|
| Payment Date |
Deixe esse campo em branco. |
| Payment Status |
Use a opção "Invoice Required". |
(Opcional) Campos de taxas de serviço
Os campos descritos nesta seção são opcionais.
|
| Service Fee |
O total de taxas de serviço especial. Por exemplo, "1,23". |
| Service Fee Currency |
O código de três letras para a moeda em que a taxa de serviço opcional é paga. Por exemplo, "EUR". |
| Service Fee Currency to Billing Currency Conversion Rate |
A taxa de conversão da moeda de taxa de serviço para a moeda de faturamento. Por exemplo, "0,88998".
Quando a moeda da taxa de serviço e a moeda de faturamento são as mesmas, defina esse campo como 1.
|
| Total Payment |
O valor total do pagamento, incluindo a taxa de serviço opcional. Por exemplo, "1.420,39". |
| Billing Currency |
O código de três letras representando a moeda na qual o pagamento é feito, incluindo a taxa de serviço. Por exemplo, "USD". |
Exemplo de arquivo CSV
O seguinte arquivo CSV de exemplo mostra a linha do cabeçalho e três linhas de reserva:
Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel Postal
Code,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and
Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking
Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency
Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency
to Billing Currency Conversion Rate,Payment Date,Payment Status
111,"Capybara Hotel & Spa",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04T12:12:12-07:00,2016-01-01,2016-01-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required
211,"Mabel's Gabels",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-01-04T12:12:12-07:00,2016-02-01,2016-02-03,1,3,414.21,GBP,1.57,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required
311,"No-Tell Motels",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-01-04T12:12:12-07:00,2016-03-01,2016-03-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,,Invoice Required
Uma vírgula é necessária para delimitar todos os campos, mesmo que não haja nenhum valor nesse campo (se ele for opcional).
Observe neste exemplo que devido ao fato de a informação da taxa de serviço estar incluída (como a última linha), todas as outras linhas usam vírgulas para indicar valores vazios para essas colunas. Se não houvesse nenhuma linha para a taxa de serviço, o exemplo excluiria as vírgulas à direita.
