Help Centre

How can I import bookings into SuperControl?

Updated on

Field nameData typeNotes
ownerIDNumberYou can find your owner ID in the top right of your SuperControl account.
ownerrefNumberYour booking numbers.
bookingdateyyyy-mm-ddDate booking placed. If unavailable use arrival date.
cottageIDNumberThe SuperControl property ID (You can view your property ID's in Properties > Edit).
Multiple properties can be separated by commas.
bookingstartdateyyyy-mm-ddArrival date of booking.
nightsNumberNumber of nights.
tot_rateNumberShould be the deposit + balance (including any VAT). This should NOT include any refundable deposit or booking extras.
tot_depositNumberThe amount of non-refundable deposit.
tot_refundableNumberThe amount of refundable deposit.
tot_refundNumberAny refunds that have been paid to the customer.
dep_paidyyyy-mm-ddDate deposit paid.
bal_paidyyyy-mm-ddDate balance paid. If no balance paid do not populate this field.  Note if more than one payment made use the date of last payment.
refund_dateyyyy-mm-ddDate when refunds paid. Note if more than one payment
made use the date of last payment.
vatNumberNote that all figures should be gross. Just add VAT % here.
bookingstatusCharacterConfirmed / Provisional / Cancelled.
adultsNumberNumber of adults in party.
childrenNumberNumber of children in party.
infantsNumberNumber of infants in party.
customertitleCharacter 
customerfirstnameCharacter 
customerlastnameCharacter 
customercompanyCharacter 
customeraddress1Character 
customeraddress2Character 
customertownCharacter 
customercountyCharacter 
customerpostcodeCharacter 
customercountryTwo letter ISO country codeYou must use the appropriate  "ALPHA 2" ISO country code. Click here to find the correct code.
customeremailCharacter 
customertelephoneCharacter 
customerfaxCharacter 
customermobileCharacter 
customernewsletterEnter the subscription ID. If multiple subscription options have been ticked, they can be separated by a comma eg. 123, 456You can find your subscription options within "Admin subscription options".

If you haven't added these before your import make sure you add them first so you can obtain the ID's required for the import.
sourceIDCharacterAdvertising source.
customernotesCharacterAppears on customer booking summary. Do not add private notes.
customernotescommentsCharacterAppears in customer notes (internal note). Added to guest record in database.
bookingnotesCharacterAppears in the booking history (internal note).
customerratingCharacter 
Previous Article How to process a repeat payment with a manually added card
Next Article How can I import all my guest details into SuperControl?