---
title: "Create an e-invoice lifecycle status update"
method: POST
path: "/v1/e-compliance/lifecycle/status-update"
tags: ["E-Invoicing"]
---

# Create an e-invoice lifecycle status update

`POST /v1/e-compliance/lifecycle/status-update`

Creates a seller-initiated status update request for an e-invoice lifecycle.  Use this operation to notify the tax authority when the business status of a source  document changes, such as when payment is collected, the document is canceled, or the  lifecycle is completed.

**Note**: In the broader e-compliance workflow, this operation can work alongside the  "Reconcile an e-compliance request" operation that is shared across e-reporting and e-invoice business lifecycle processing.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- EInvoiceLifecycleStatusUpdateRequest
  - `sourceObjectId` string, required — The UUID of the source document in Zuora. Use an invoice ID, credit memo ID, or debit memo ID.
  - `sourceObjectType` 'INVOICE' | 'CREDIT_MEMO' | 'DEBIT_MEMO', required — The type of source document.
  - `requestedStatus` 'Completed' | 'Cancelled' | 'DirectPaymentRequest' | 'Affidaute' | 'AffiledConfidential' | 'ChangeOfAccountToPay' | 'NotBilled', required — The business status to request for the source document.
  - `reason` unknown

## Response `200`

OK

- EInvoiceLifecycleStatusUpdateResponse
  - `id` string — The unique ID of the lifecycle status update record.
  - `sourceObjectId` string — The ID of the source document.
  - `sourceObjectType` 'INVOICE' | 'CREDIT_MEMO' | 'DEBIT_MEMO' — The type of source object.
  - `requestedStatus` 'Completed' | 'Cancelled' | 'DirectPaymentRequest' | 'Affidaute' | 'AffiledConfidential' | 'ChangeOfAccountToPay' | 'NotBilled' — The business status requested by the seller.
  - `status` 'Scheduled' | 'Submitted' | 'UnderReconciliation' | 'Completed' | 'Failed' | 'ChangeDetected' — The current processing status of the lifecycle update request.
  - `createdOn` string, date-time — The date and time when the status update was created.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)