Stay organized with collections
Save and categorize content based on your preferences.
A purchase order number (also called PO number, IO number, CPE, or client code)
is an
identifier that appears in the header of your invoices. This document 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:
At the prompt, choose the Cloud Billing account
you want to view.
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:
In the Google Cloud console, go to the Documents page.
At the prompt, choose the Cloud Billing account
you want to view.
On the Documents page, click
editSet purchase order number.
Enter the new purchase order number.
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.
If you're on the Documents page of your Cloud Billing
account and you don't see or can't access the
editSet purchase order number button, the reasons could include the
following:
The Cloud Billing account you are viewing isn't 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 don't 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 administrator.
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:
From the Documents table, click the row of the invoice to view its
details. A dialog opens, showing you document header details including the
invoice or memo number, amount, status, purchase order number, account
details, and more.
In the top right of the invoice dialog, select Actions.
To request a revision to your invoice, including updating the purchase order
number, select Regenerate invoice with updated information.
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 previous steps
after the last invoice is successfully applied.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003ePurchase order numbers (PO numbers) are identifiers found in the header of invoices and can be set or updated for monthly invoice accounts.\u003c/p\u003e\n"],["\u003cp\u003eTo manage PO numbers, you need the \u003ccode\u003ebilling.accounts.update\u003c/code\u003e permission, typically granted through the Billing Account Administrator role.\u003c/p\u003e\n"],["\u003cp\u003eYou can view the purchase order number associated with each invoice in the 'Documents' page of the Google Cloud console under the 'Purchase order' column.\u003c/p\u003e\n"],["\u003cp\u003eTo set or update the purchase order number, you can go to the 'Documents' page and use the 'Set purchase order number' option, as long as the account is an invoiced account.\u003c/p\u003e\n"],["\u003cp\u003ePreviously issued invoices can have their purchase order number updated by regenerating each individual invoice after the new purchase order number has been set, and please be aware it can take 48 hours to update.\u003c/p\u003e\n"]]],[],null,["# Update your purchase order number\n\n\u003cbr /\u003e\n\nA purchase order number (also called PO number, IO number, CPE, or client code)\nis an\nidentifier that appears in the header of your invoices. This document describes\nhow to set or update the purchase order number associated with your monthly\ninvoice account.\n\n### Permissions required to manage purchase order numbers\n\nTo set or update the purchase order number used for your monthly invoice\naccount, you need a role that includes the following\n[permission](/iam/docs/understanding-roles#billing-roles)\non the Cloud Billing account:\n\n- [`billing.accounts.update`](/billing/docs/how-to/billing-access)\n\nTo gain this permission, ask your administrator to grant you the role of\n[Billing Account Administrator](/billing/docs/how-to/billing-access)\non your Cloud Billing account.\n\nFor more information about billing permissions, see:\n\n- [Overview of access control](/billing/docs/how-to/billing-access)\n- [Create custom roles for Cloud Billing](/billing/docs/how-to/custom-roles#resource_associations)\n- [Understanding predefined Identity and Access Management roles for Cloud Billing](/iam/docs/understanding-roles#billing-roles)\n\n### View the purchase order associated with your invoice account\n\nTo view the purchase order that is on each invoice, do the following:\n\n1. In the Google Cloud console, go to the **Documents** page.\n\n [Go to the Documents page](https://console.cloud.google.com/billing/invoices)\n2. At the prompt, **choose the Cloud Billing account**\n you want to view.\n\n3. In the **Documents** table, look for the **Purchase order** column. If the\n value\n is blank for any invoice, this indicates that no purchase order number was\n set on the Cloud Billing account at the time that the invoice was\n generated.\n\n### Set or update your purchase order number\n\nTo set or update the purchase order number that is associated with your\ninvoiced Cloud Billing account, complete the following steps:\n\n1. In the Google Cloud console, go to the **Documents** page.\n\n [Go to the Documents page](https://console.cloud.google.com/billing/invoices)\n2. At the prompt, **choose the Cloud Billing account**\n you want to view.\n\n3. On the **Documents** page, click\n edit\n **Set purchase order number**.\n\n4. Enter the new purchase order number.\n\n5. Click **OK**.\n\nThe new purchase order number is associated with subsequent invoices when\nthose invoices are generated. To update the purchase order number on a\npreviously generated invoice,\n[regenerate the invoice](#update-invoice-po-number).\n\nIf you're on the **Documents** page of your Cloud Billing\naccount and you don't see or can't access the\nedit **Set purchase order number** button, the reasons could include the\nfollowing:\n\n- The Cloud Billing account you are viewing isn't configured to be paid by invoice, but rather is an automatically paid, [self-serve/online account](/billing/docs/concepts#billing_account_types). Purchase order numbers can only be set on Cloud Billing accounts that are configured as an [invoiced account](/billing/docs/concepts#billing_account_types).\n- You don't 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 administrator.\n\n### Update the purchase order number on previously issued invoices\n\nTo change the purchase order number on invoices that have already been issued,\nafter setting the new purchase order number, **regenerate** each\ninvoice you want to update --- one invoice at a time.\n\nTo regenerate an invoice, do the following:\n\n1. From the **Documents** table, click the row of the invoice to view its details. A dialog opens, showing you document header details including the invoice or memo number, amount, status, purchase order number, account details, and more.\n2. In the top right of the invoice dialog, select **Actions**.\n3. To request a revision to your invoice, including updating the purchase order number, select **Regenerate invoice with updated information**.\n4. 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.\n\nTo update the purchase order number for another invoice, repeat the previous steps\nafter the last invoice is successfully applied.\n| **Note:** Regenerating a past invoice might take some time. If after 48 hours you don't see the updated purchase order on your regenerated invoice, [contact Customer Support](/support/billing).\n\nRelated topics\n--------------\n\n- [Get an invoice, statement, or receipt](/billing/docs/how-to/get-invoice)\n- [Understand your monthly invoice](/billing/docs/how-to/read-invoice)\n- [Export Cloud Billing data to BigQuery](/billing/docs/how-to/export-data-bigquery)\n- [Split invoicing for agency model transactions](/billing/docs/how-to/split-invoice)"]]