Update your purchase order number

A purchase order number (also called IO number, CPE, or client code) is an identifier that appears in the header of your invoices. This page describes how to set or update the purchase order number associated with your monthly invoice account.

Permissions required to manage purchase order numbers

To set or update the purchase order number used for your monthly invoice account, you need a role that includes the following permission on the Cloud Billing account:

To gain this permission, ask your administrator to grant you the role of Billing Account Administrator on your Cloud Billing account.

For more information about billing permissions, see:

View the purchase order associated with your invoice account

To view the purchase order that is on each invoice, do the following:

  1. In the Google Cloud console, go to the Documents page.

    Go to the Documents page

  2. At the prompt, choose the Cloud Billing account you want to view.

  3. In the Documents table, look for the Purchase order column. If the value is blank for any invoice, this indicates that no purchase order number was set on the Cloud Billing account at the time that the invoice was generated.

Set or update your purchase order number

To set or update the purchase order number that is associated with your invoiced Cloud Billing account, complete the following steps:

  1. In the Google Cloud console, go to the Documents page.

    Go to the Documents page

  2. At the prompt, choose the Cloud Billing account you want to view.

  3. On the Documents page, click Set purchase order number.

  4. Enter the new purchase order number.

  5. Click OK.

The new purchase order number is associated with subsequent invoices when those invoices are generated. To update the purchase order number on a previously-generated invoice, regenerate the invoice.

Why can't I see or access the Set purchase order number button?

If you are on the Documents page of your Cloud Billing account and you don't see or cannot access the Set purchase order number button, the reasons could include the following:

  • The Cloud Billing account you are viewing is not configured to be paid by invoice, but rather is an automatically paid, self-serve/online account. Purchase order numbers can only be set on Cloud Billing accounts that are configured as an invoiced account.
  • You do not have the Cloud Billing account permissions needed to set or update the purchase order number associated with your invoiced account. Contact your Cloud Billing account admin.

Update the purchase order number on previously-issued invoices

To change the purchase order number on invoices that have already been issued, after setting the new purchase order number, regenerate each invoice you want to update — one invoice at a time.

To regenerate an invoice, do the following:

  1. From the Documents table, click the row of the invoice to view its details. A pop-up opens, showing you document header details including the invoice or memo number, amount, status, purchase order number, account details, and more.
  2. In the top right of the invoice pop-up, select Actions.
  3. To request a revision to your invoice, including updating the purchase order number, select Regenerate invoice with updated information.
  4. Read the Request status confirmation, and then click Got it to return to the Documents table. Note that for each invoice you choose to regenerate, you must wait 48 hours to make another revision request on that same invoice.

To update the purchase order number for another invoice, repeat the steps above after the last invoice is successfully applied.