---
title: "Adds a purchase order number to an invoice"
method: POST
path: "/public/invoice/v1/add-purchase-order-number-to-invoice"
tags: ["Invoice"]
---

# Adds a purchase order number to an invoice

`POST /public/invoice/v1/add-purchase-order-number-to-invoice`

Regenerates an existing invoice, with the purchase order number added to it.
If this operation is called multiple times for the same invoice, the purchase order number will be overwritten
with the latest value.

## Request body

- PurchaseOrderNumberAdditionRequestV1
  - `invoiceId` string, uuid, required
  - `purchaseOrderNumber` string, required — The purchase order number to add to the invoice. Maximum length is 12 characters.

## Response `200`

Successfully added the purchase order number to the invoice

- PurchaseOrderNumberAdditionResponseV1
  - `fileId` string, uuid

## Other responses

- `400` — The request could not be processed. This could be due to a number of reasons: * The request does not have all required data. * Data in the request is invalid. * Data in the request is inconsistent. * The operation is not allowed given the current state of the data.
- `401` — The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403` — The data that the request referred to is inaccessible to the caller.

---

[API](https://skmtc.net/maqqie/apis/maqqie-public-api.md) · [All operations](https://skmtc.net/maqqie/apis/maqqie-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maqqie/maqqie-public-api/revisions/41e5cd97d4d7/schema)