This page explains the different steps to configure a new Zuora tenant.
...
3 Production tenants:
Tourisoft Sàrl (CH) - 5896
Hotel-Spider Germany GmbH (DE) - 3000206
Hotel-Spider India (IN) - 3000227
3 SANDBOX tenants:
Tourisoft Sàrl (CH) SANDBOX - 13635
Tourisoft GmbH (DE) SANDBOX - 2000392
Hotel-Spider India (IN) - Not configured yet
General information
Zuora has 2 datacenters :
...
Tenant | base endpoint | Extranet |
---|---|---|
US Production | https://rest.zuora.com | https://www.zuora.com/ |
US API Sandbox | https://rest.apisandbox.zuora.com | https://apisandbox.zuora.com |
EU Production | https://rest.eu.zuora.com | https://eu.zuora.com |
EU Sandbox | https://rest.sandbox.eu.zuora.com | https://sandbox.eu.zuora.com |
...
Field Label | API Name | Data Type | Required | Default value | Possible values | Description |
---|---|---|---|---|---|---|
bookingChannelId | bookingChannelId__c | text (5) | NO | Default booking channel ID applicable for Rate Plan. Used for CRS. | ||
product_type | product_type__c | Text (25) | YES | First value | crs,pms administrative callback channelmanager spiderbooking pms wbe crs gateway sms fax discount duplicatechannel | Declare the type of rateplan. This is used for the limitations |
SortOrder | SortOrder__c | Picklist | 0 | 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 | Sort order of the product, for display purpose | |
isviewable | isviewable__c | Picklist | YES | 1 | 0 1 | Define if a rateplan can be seen in the V4 |
Mandatory | Mandatory__c | Picklist | YES | 0 | 0 1 | Define if the rateplan is mandatory for a product This is currently not used |
Label | Label__c | Picklist | YES | First value | Administration V4Connectivity Communication Discount Commission Test | For display purpose, Declare what kind of rateplan this is |
IncludedCountries | IncludedCountries__c | Text (255) | YES | {"Continent": "ALL"} | JSON that determine which countries can see this rateplan This is based on the list of Continent, SubContinent and Countries in the V4 database | |
ExcludedCountries | ExcludedCountries__c | Text (255) | YES | {} | JSON that determine which countries can not see this rateplan This is based on the list of Continent, SubContinent and Countries in the V4 database |
...
Billing period
Billing Rules
Enable credit back for removing or canceling one time charges? | Yes |
Bill recurring charges for partial month (with monthly based billing periods)? | No |
Bill recurring charges for partial week (with weekly based billing periods)? | No |
Bill usage charges for partial month (with monthly based billing periods)? | No |
Bill usage charges for partial week (with weekly based billing periods)? | No |
When prorating a month, assume 30 days in a month or use actual days? | Use actual number of days |
When prorating periods greater than a month, prorate by month first, or by day? | Prorate by month first |
Support bill run auto-post? | Yes |
Default bill run to auto-post? | No |
Include invoices with negative totals in the Account Balance (included associated Debit Memos)? | Yes |
Include usage from child accounts when billing? | No |
How should errors be handled when generating multiple invoices for a single account via bill run? | Terminate processing of all invoices |
Preserve snapshot of bill-to and sold-to contacts when billing documents are posted? | No |
Invoice Past End-of-Term when Auto-Renew is OFF? | Yes: deprecated |
Invoice Past End-of-Term when Auto-Renew is ON? | Yes: deprecated |
Calculate taxes using information from Customer Account of: | Invoice owner |
Zuora Tax rounding rule for inclusive tax calculation | Round net amount |
When service period of an invoice item crosses multiple tax rate period, it will generate: | Multiple Tax Items |
...
Enable Charge Types / Models
Enable Charge Types
|
Enable Charge Models
|
Manage Billing Document Configuration
Manage Invoice Rules and Templates
Go to Settings > Billing > Manage Invoice Rules and Templates
The templates are setup in the following way:
- Per tenant (different template for Sàrl vs. GmbH)
- template for Hotels
- template for Whitelabels
- Per language:
- Sàrl:
- EN (default)
- DE
- ES
- FR
- NL
- GmbH:
- DE
- Sàrl:
To modify a template, click on the template name to download the existing word file (make sure to save a copy of the original and save the modified version under the latest version number, i.e. _v6). A folder with all templates exists under C:\Tourisoft\Accounting and Finance - General\Zuora. Make sure to save latest modifications there as backup.
Add the corresponding templates by clicking on "edit", select the template and save it. Use the preview function with existing customer data (to reflect reality) to make sure the latest modifications do not return errors.
The templates IDs will then need to be extracted from this page. Click on show ID:
Refer to the database section to store the template IDs in the v4.
Invoice prefix & Numbering
Go to Settings > Billing > Prefix & Numbering
Tourisoft Sàrl: INV
Tourisoft GmbH: RE
...
Configure Accounting Rules
Accounting Rules
Allow blank Accounting Codes | ||
Allow Subscription and Amendments to be created in a closed Accounting Period | ||
Allow Usage to be created in a closed Accounting Period | ||
Allow Revenue Schedules to have negative amounts in the Open-Ended Accounting Period |
...
Segments
Object | Field | Segment Name | System ID | Actions |
---|---|---|---|---|
Account | Market__c | Account Market | AccountMarket__s | [Edit] [Remove] |
Additional Configurations
Discount segment value | ||
Invoice owner segment value | ||
Revenue owner segment value |
Configure GL Segmentation Rules
by default AccountMarketSegment
to be furhter developped
...