---
title: "Create a delivery report from an external adapter (Shopify, WooCommerce, etc.) for observability"
method: POST
path: "/api/v1/transactions/{transactionId}/delivery-reports"
tags: ["Transactions"]
---

# Create a delivery report from an external adapter (Shopify, WooCommerce, etc.) for observability

`POST /api/v1/transactions/{transactionId}/delivery-reports`

Create a delivery report from an external adapter (Shopify, WooCommerce, etc.) for observability

## Path parameters

- `transactionId` string, required — The transaction number (not UUID)

## Request body

- DeliveryReportInput — Report from an external adapter about a finalization call to the external platform
  - `platform` string, required — Platform that performed the finalization
  - `finalization_type` string, required — Type of finalization performed
  - `external_reference` string — External platform reference ID (e.g., Shopify GID)
  - `request_payload` object — The payload sent to the external platform
  - `response` object — The response received from the external platform
  - `status` union, required — Whether the finalization call succeeded or failed
    - 'success'
    - 'failure'
  - `http_status` number — HTTP status code from the external platform
  - `duration_ms` number — How long the finalization call took in milliseconds
  - `payment_provider_status_id` string, uuid — Correlation ID linking to the PaymentProviderStatus that triggered this

## Response `200`

Success

- DeliveryReportResponse
  - `success` boolean, required
  - `data` object, required
    - `id` string, uuid, required
    - `message` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

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