Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Billing Operations

  1. You are here:
  2. Billing Operations

Welcome to the Billing Ops Handbook

Charter

The Billing team orchestrates and owns the customer billing cycle from invoicing to cash, while working closely with the Deal Desk team.

Key Focus Areas

Communicating with Billing

Please contact Billing team by emailing ar@gitlab.com or by chattering @billing-ops on an opportunity in Salesforce. Doing so will automatically create a case in the Billing queue that is monitored throughout the day. We will respond to the case as soon as we can during business hours. Please note that Billing should not be chattered for assistance with quote creation. The Deal Desk team is able to assist with opportunities and quotes by chattering @sales-support on the opportunity.

Please avoid tagging Billing team members directly in chatter, instead use @billing-ops as this way your request will be seen by all Billing team members which helps avoid delays.

Please avoid contacting any Billing team members directly via Slack. Please tag @billing-ops in the #Finance channel.

The scope of our tasks:

Approving and invoicing orders

In short the approval and invoicing process comprises the following steps:

  1. Reviewing the opportunity in SFDC
  2. Ensuring the data is correct in Zuora and customer portal
  3. Approving the opportunity and sending the quote to Zuora - (if the opportunity doesn’t meet the requirements listed below it will be rejected and all the reasons for rejection will be provided)
  4. Creating and posting the invoice in Zuora
  5. Updating SFDC with invoice information

In order to approve an opportunity the following systems are used SFDC, Zuora and customer portal. The below points/fields need to be reviewed in the process:

I. Salesforce:

Opportunity page:

  1. Opportunity (navigate to the Billing Pending Approvals report)
  2. To assign opportunity update the Billing Specialist field to your name
  3. Make sure the opportunity type is correct (e.g. if in doubt check with the AE whether it’s new business or an add-on)
  4. Opportunity record type - Standard for standard opportunities
  5. Chatter for any additional information or approvals on discounts, non-standard payment terms and any other manually added information. Check for information on credit card payments - if so, where available process the card after billing. If aware that the company has filed for bankruptcy, legal and finance approval is required, in addition to upfront payment.
  6. Start date (due to revenue recognition requirements cannot be more than 60 days in advance) and end date
  7. Amount
  8. Upon processing - Invoice number, Invoice Date, Invoice Status (Completed), Entity

Quote object:

  1. Quote template
  2. Amount - compare between documents and opportunity
  3. Sold to contact - search in Zuora and the portal to make sure it’s assigned to the correct account, for reseller orders ensure sold to email address is that of end-user
  4. Bill to - compare between Zuora and the documents - no need to change if Zuora bill to address is an accounts payable address (Please ensure that all orders for India have been submitted through a partner regardless the payment method.)
  5. Invoice owner and Invoice owner contact - needed for reseller orders
  6. Click through EULA - required for new-business and add-on reseller orders. This field should be set to No if no EULA required.
  7. Payment method and payment term - compare between documents and Zuora, check approvals where required
  8. PO number where available
  9. Auto-renew - ‘no’ for sales assisted purchases
  10. Start date - cannot be more than 60 days in advance - orders with with a date beyond 60 days will be processed once the start date falls into the 60 days window
  11. Zuora account ID - check if the Zuora account ID isn't filled out for new business and is filled out for renewals and add-ons, check if the correct account was chosen.
  12. Product, quantity, discount, check whether the add-ons and updates on the product were done correctly (e.g. not added as separate product). Also, in case of two or more lines of product check if approvals are needed.
  13. Discount approvals - fulfillment reseller and direct deals discounts need to be checked with the matrix and authorized reseller discounts to be checked on Reseller account or Distribution agreements

Order Form:

  1. Entity - renewal/new business vs. add-on. For contract resets make sure orders from different entities were not place on one order form. For authorized resellers check the distribution agreement to ensure correct entity was used.
  2. Start date
  3. Term
  4. Where required VAT ID need to be validated and added to Zuora - valid VAT number is required if we bill cross-country to EU countries.
  5. Bill to and sold to address - must be complete
  6. Product, quantity, discount, net amount, tax and total amount
  7. Annual payments outlined where required
  8. Ramps outlined where required
  9. Special terms - check for approval - any custom language on the order forms needs approval and should be documented in chatter or through a Legal request case
  10. Payment method
  11. Payment term
  12. Terms, reference to special agreements - if a special agreement is in place the order must reference it
  13. Signature, Title, Date - for full requirements view here.
  14. Any other information added manually to the order.
  15. If the documentation requires countersignature, check if countersigned before processing.

PO

  1. For fulfillment resellers: quote number, entity, amount (In case of the PO amount less than the quote amount we allow a difference of less than 1 USD. In case of an amount significantly higher than quote amount it will need to be checked with the reseller to avoid misunderstandings related to term etc.), currency (must be USD), term, product
  2. For direct customers where order was signed: currency (must be USD), amount (In case of the PO amount less than the quote amount we allow a difference of less than 1 USD. In case of an amount significantly higher than quote amount it will need to be checked with the customer to avoid misunderstandings related to term etc.)
  3. For direct customers where order was not signed: reason why the customer is refusing to execute the order form and documentation of the customer refusal followed by Legal and Finance approval (PAO)

Other documentation to be checked can include MSA, special subscription agreements, Distribution agreement with a reseller. If the documentation requires countersignature, check if countersigned before processing.

II. Zuora:

Account:

  1. Account - navigate to the correct account and review the following:
  2. Entity - if the entity of the account needs to be changed per renewal a new account for the customer/end user and reseller will need to be created in Zuora (before doing that check Zuora if the correct entity account already doesn’t exist there). For full process view the Billing WIKI pages. Make sure the end user is on the same entity as the reseller.
  3. Update the conversion rate for orders not billed through the US entity.
  4. Confirm the bill to and sold to addresses are correct (sold to address must match the portal sold to address)
  5. Payment terms
  6. VAT ID where required
  7. Default communication profile - needed in order to send the license and EULA for renewals and add-ons, especially important for reseller deals!
  8. Silent communication profile - for some ramped orders or special requests
  9. Check whether there are outstanding invoices older than 120 days - credit hold.
  10. Email history - upon processing the invoice ensure invoice was sent.
  11. Check for the callout - in case of error instruct the AE to contact Support team
  12. Credit card - process if it was requested.

Subscription:

  1. Renewal subscription field - link subscriptions if a new subscription was created for renewal
  2. PO number - if none was provided and there was one in the past enquire with the AE before posting the invoice
  3. Preview invoice for accuracy

Invoice: gets created after hitting the Create Bill Run button. Untick the Automatically renew auto-renew subscriptions field before processing. The following fields need to be reviewed on the PDF before posting. If the below are ok the invoice can be posted (Post).

  1. Entity
  2. Payment terms
  3. Customer data
  4. Amount
  5. VAT local currency amount (add in the Tax local currency amount field)
  6. PO number
  7. VAT ID where required
  8. Invoice Comments - e.g. End User name

III. Customer portal:

  1. By searching with sold to email address ensure the sold to contact:
    • has been updated to the correct one
    • has the correct Zuora account ID assigned Check the quote vs. Zuora vs. portal - all three need to have the same sold to email address in order for the EULA/license to be sent out to the end user/customer.
  2. In case of an upgrade for GitLab.com portal needs to be updated manually.

Other documentation - need to be reviewed for any discrepancies in the above fields e.g. payment terms, product, future price agreements.

Please note that EDU/OSS opportunities follow a slightly different process:

Points to note for professional services opportunities:

Points to remember while billing AWS orders can be viewed here.

Billing Entities

GitLab currently has the following billing entities:

This is a general rule for billing through the entities:

Entity Direct / Unauthorized Reseller Authorized Reseller
BV (Netherlands) NL Not AU, DE, UK, or US
GmbH (Germany) DE DE
Ltd (United Kingdom) UK UK
Inc (United States) Not AU, NL, DE, or UK US
Pty Ltd (Australia) AU AU

We bill customers and unauthorized (fulfillment) resellers:

We bill authorized resellers:

There are 3 reasons why an account for a customer or an unauthorized reseller based in the Netherlands, UK, Germany or Australia is billed through GitLab Inc:

  1. The account has been opened through the customer portal (web direct) as these accounts are automatically billed through GitLab Inc regardless of the country the customer is based in.
  2. The subscription has been billed before an entity in a given country has been opened.
  3. The end user’s account follows the entity of the reseller account it has been invoiced to - e.g. The customer is based in Germany but has been billed via a reseller account based in France - since the end user and reseller account need to be on the same entity - the end user account will be set to the US entity, the same as the reseller account. The entity of the end user account needs to follow the entity of the reseller.

The customers that bought their product over the portal and are renewing over the portal will continue to be billed through GitLab Inc. The customers or unauthorized resellers based in the UK, Netherlands, Germany and Australia that were billed through GitLab Inc will be moved to the appropriate entity where purchasing a renewal or initiating contract reset via a sales assisted quote (early termination of the existing contract and new term). Please note that add-on opportunities need to be billed via the entity of the opportunity that they are added to.

How to initiate a refund request within 45 days from the initial invoice date:

Processing a refund in Zuora (credit card payments):

  1. A refund request has been received by e-mail or chatter in Salesforce.
  2. Log in to the customer’s account in Zuora.
  3. Find the invoice that needs to be refunded and then find the payment associated with the invoice. This can be found under the Payment tab.
  4. Click on the payment number and it will take you to the payment screen.
  5. On the payment screen, click on more and click on "Refund this payment."
  6. A new screen will appear, make sure that you have the Electronic Refund button selected.
  7. Then scroll down to the Transactions associated with the Original Payment and select create a refund. This will create a refund.
  8. Go back to the main page and you will see that the invoice has an open balance.
  9. You either need to cancel the subscription in Zuora using the first day of the service period to be refunded or remove/update the product that is to be refunded. (Depending on the reason for a refund, the client canceling the subscription or they purchased incorrectly)
  10. Create a bill run for the subscription cancellation/amendment.
  11. Make sure that the credit invoice amount matches the invoice total.
  12. Post the invoice and then go to More and select Transfer to Credit Balance.
  13. Now go to the original invoice and go to More and select Apply the credit balance. Make sure the credit balance of the account is 0.
  14. Go into the Salesforce account and find the original opportunity and clone it. (You can click on the CRM link in Zuora account)
  15. In the cloned opp you need to scroll to Refund opp Source and select From Finance and save.
  16. Make sure the refund opp is the same Opp Owner as the original Opp.
  17. Scroll down to invoice number and put the credit invoice information here.
  18. Next make sure that the amounts are a negative amount for the following sections: Renewal ACV, Renewal, and Amount. (if they are not negative change them to be by putting the “-” in front)
  19. Scroll to the Churn section and enter the following information: Churn Type, Churn Month (this will be the date you processed the credit), Churn ACV (this is a positive amount from the credit invoice), and Churn notes (copy the ticket link or chatter link).
  20. Go back to the main page in Salesforce and look at the opportunities and make sure that the refund opp has a negative amount and it matches the amount of the original opportunity.
  21. Inform the customer that the refund has been processed.

Handling Tax Exemption When Processing an Opportunity

Invoicing: Auto-Renewals

  1. Download the Accounts with Auto-generated Renewal Amendment report
  2. Copy the subscription number to Zuora and search
  3. Click on customer name and open in a separate tab
  4. Click on Subscription number and open in a separate tab
  5. Go into the Zuora subscription, click “more, Preview”
  6. Confirm there’s a “Preview Invoice” for the next renewal period
  7. On the Account page in Salesforce, look for any cases, activity history or chatter that needs review
  8. Go back to the Zuora Account and process the renewal
  9. Click create bill run
  10. Click on the BR#
  11. Click invoice number once it loads
  12. View invoice, then post it
  13. Click the invoice number under generated invoices
  14. Click more, then Process a Payment

If the payment goes through, go to the existing renewal opportunity:

If the payment doesn’t go through:

Cash Collections

Month end reconciliation:

  1. Check AR sheet for minus amounts (balance that was not transferred)
  2. Check if all opportunities were processed for the previous month (if not and they’ve been submitted before month end they'll need to be processed)
  3. Vlookup between invoice register and closed won opportunities to create missing items
  4. Note: the missing invoices will need the closed date of the reconciled month
  5. Fill out all missing info on closed won opportunities - invoice number, entity, start and end date
  6. Check closed won report for Opportunity Owners - this should be sales team members
  7. Re-run the report in Salesforce
  8. Sort the report by Account Name
  9. Note total of the closed won opportunities report
  10. Check Zuora for any invoices in draft and post them if that should be the case
  11. Prepare reconciliation document - clear data from previous month, add invoice register information, sort invoice register by Account Name, add Salesforce data
  12. Filter out EDU opportunities
  13. Reconcile based on invoice register
  14. Recon based on closed won report (do the vlookup based both on opportunity id and name)
  15. Add the closed won but not invoice opps on the Salesforce side of the report manually
  16. Create separate tab for every month in the final sheet
  17. For any items from previous month end reconciliations add opportunity info on SFDC side
  18. Keep the amount on these 0 (variance should stay as is)
  19. Tabular report add to report through G-connector
  20. Add tabular report amount to the reconciliation sheet
  21. Add explanation for manually added opportunities that were not invoiced yet
  22. Once reviewed add confirmation on Deal Desk month end close issue
Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license
View page source — Edit in Web IDE — please contribute. Creative Commons License