ZOEY - Releasing services and charges
The Billing Exports app with ZOEY
Services and charges are released to ZOEY from the Billing Exports app, which is opened from the Apps menu. Choose ZOEY in the billing platform menu in the top-right.
A user must have the App - Billing Exports user role to access the app.
On the ZOEY platform the app has four tabs:
Service Charges: lines ready to release.
Ignored Billing: lines set to Ignore Billing.
Service Charges History: every line sent to ZOEY, with ZOEY's answer.
Batch History: every release, as a batch.
Which lines appear
The Service Charges tab lists products and services with the Bill State of Ready to Bill whose upfront or recurring billing route is ZOEY. As with other billing platforms, lines reach this state once order processors have converted them to assets. Nothing is sent to ZOEY until you release it.
The ZOEY columns
Column | Shows |
Needs Attention | An orange mark on a line that cannot be released or needs a look first. The ZOEY Validation column says why. |
ZOEY Validation | Why the line cannot be released, what needs attention, and notes such as an account or cost centre that the release will create, or why the last release failed. |
CLI | The number ZOEY will hold, with spaces, brackets, dashes and full stops removed and +44 written as 0. A line with no number shows a grey placeholder: LYR and the asset ID for a service, LYRP and the asset ID for a product. The placeholder is never written back to the asset. |
Tariff Code | The product's External SKU: the ZOEY tariff of a service, or the ZOEY charge of a product. |
Account Code | The customer's ZOEY account, or "created on release". |
Cost Centre | The cost centre of the line's site, or the customer's default site when the line has no site. Shows "created on release" when there is none yet. |
Service Code | The ZOEY service the line's service was connected as. |
Lines that cannot be released
A line that ZOEY would refuse has its tick box greyed out, and the ZOEY Validation column says why:
External SKU (ZOEY tariff code or charge code) missing on the product.
Billing start date missing.
Quantity less than 1.
CLI does not start with a letter or digit.
A service whose billing start date is more than 90 days from today. ZOEY only connects a service from a date within 90 days. Set it up in ZOEY by hand and use Change to In Billing, or release it once the date is within range.
Lines that need attention
These lines can be released, but are marked Needs Attention so they get a second look first:
No monthly price in The Layer: a service with no recurring price. ZOEY will bill the tariff's own price.
Delayed billing: the line has a billing start date override (see below).
Marked Needs Attention on the order line: someone ticked Needs Attention on the line in Data Capture.
Last release failed: ZOEY refused the line before, with its reason.
The Release to ZOEY window also counts the services with no monthly price and the lines with a delayed billing start among the lines you ticked.
To check one customer's lines against ZOEY before releasing, including whether ZOEY recognises each tariff and charge code and what a tariff will bill, press Sync to ZOEY on the customer and read the report without clicking Continue. See ZOEY - Customer and Site sync.
Delayed billing
A line's billing start date is normally its connection date. When billing should start later, for example a hosted service that bills months after it connects, set the Billing Start Date Override on the line in Data Capture. Only users with the role that allows it can change the override (see User Role Reference).
The service is connected in ZOEY from the override date, and its charges start then.
The line is marked Needs Attention in the billing queue, with the override and connection dates.
If your company uses the Needs Attention column in Data Capture, setting an override ticks it on the line.
ZOEY's 90-day rule applies to the override date: release the line once it is within 90 days.
Releasing lines
Tick the lines to release, individually or with Check All, then click Release to ZOEY. A window lists the lines per customer, any ZOEY accounts and cost centres the release will create, and anything that needs attention. Confirm to start.
The release runs in the background as a batch, which appears on the Batch History tab. Lines sent successfully change to In Billing and leave the Service Charges tab.
What is sent
Line | In ZOEY |
Service | A service on the External SKU tariff, on the customer's account and the site's cost centre, with the CLI, the billing start date as its connect date and the product name as its name. The asset ID and order reference are stored on the service, so it can be found from the asset later. |
Service, recurring price | Billed by the ZOEY tariff. If The Layer's price is different and the tariff has a single charge, The Layer's price is set on the service when it is connected. If the tariff has more than one charge, the line fails: set the price on the service in ZOEY, then use Change to In Billing. If The Layer has no monthly price, ZOEY bills the tariff's own price and the line is marked Needs Attention. |
Service, upfront price | A one-off charge using the code in the product's Data Description. |
Product | Service charges on the line's parent service: a one-off charge for the upfront price and a recurring charge for the recurring price, from the billing start date (to the billing end date, if there is one). Each unit of quantity is its own charge in ZOEY. |
Product with no parent service | A service on the Tariff for products tariff with a placeholder CLI, carrying the product's charges. That tariff must have no fixed charge of its own; if it has one, the line fails and nothing is connected, so the product is never billed twice. |
Release a service before the products that sit on it. A product whose parent service is not in ZOEY yet fails and asks for the service to be released first.
A price of zero is not sent.
Nothing is sent twice. A service already connected for the line is reused, and a charge already sent is skipped.
Only prices whose billing route is ZOEY are sent.
If Disconnect replaced services is ticked on the ZOEY billing platform, releasing a New and Cease line also disconnects the service it replaces, at the end of its cease date.
When a release fails
A line that ZOEY rejects stays on the Service Charges tab. Its ZOEY Validation column starts with Last release failed and gives ZOEY's reason, and the line is marked as needing attention. The Service Charges History tab shows each attempt with ZOEY's message.
Fix the cause, such as a product mapping or a customer detail, then release the line again.
Batch History
The Batch History tab lists each release. Two buttons are available for the ticked batches:
Re-sync batch continues a batch that stopped before it finished, for example because ZOEY's hourly call limit was reached or ZOEY could not be reached. Only lines that were never sent are picked up. Lines that ZOEY rejected are not sent again: fix them and release them from the Service Charges tab.
Export Billing Batch downloads every line of the batch with the ZOEY code it created and ZOEY's response.
ZOEY allows 500 API calls an hour. A release stops when about 20 are left and leaves the rest of the batch waiting, without marking any line as failed. Use Re-sync batch once the hour has passed.
Checking The Layer against ZOEY
On the ZOEY route, click Reconciliation at the top of the app to compare every service The Layer bills on the route with the services ZOEY holds. It lists services missing from ZOEY, services ended in ZOEY that The Layer still bills, ceased services still active in ZOEY, and ZOEY services that The Layer does not bill. See ZOEY - Billing tab, contacts and reconciliation.
Using upload files instead
If you prefer to load lines into ZOEY yourself, tick them on the Service Charges tab and use these buttons. Each file is laid out to match ZOEY's upload templates. Upload them in this order:
ZOEY Add Accounts: customers with no ZOEY account yet.
ZOEY Add Cost Centres: sites with no cost centre yet.
ZOEY Connect Service: services and placeholder services not yet connected.
ZOEY Service Charges: the charges, leaving out any already sent.
When the upload is done, tick the same lines and click Change to In Billing.
Change to In Billing / Change to Ignore Billing
These buttons are visible if the user has the Allow update billing user role.
Change to In Billing sets the ticked lines to In Billing without sending anything to ZOEY. Use it for lines you have set up in ZOEY yourself.
Change to Ignore Billing moves the ticked lines to Ignore Billing, for example items that do not need to be billed.
We recommend giving the Allow update billing user role to finance users only. If order processors have it, lines could be set to In Billing in Data Capture and never reach the Billing Exports app.
Audit trail
Releases, file exports and billing status changes are recorded on each customer's audit trail, with the user, the number of lines and the batch or file.