---
title: "Pull QuickBooks entities and emit outbound EDI (Invoice→810, PurchaseOrder→850)."
method: POST
path: "/v1/quickbooks/export"
tags: ["QuickBooks"]
---

# Pull QuickBooks entities and emit outbound EDI (Invoice→810, PurchaseOrder→850).

`POST /v1/quickbooks/export`

## Request

- Base URL: `https://signaledi.com/api`
- URL: `https://signaledi.com/api/v1/quickbooks/export`
- Auth: HTTP bearer

## Request body

- QuickBooksExportRequest
  - `entity` 'Invoice' | 'PurchaseOrder', required
  - `partnerId` string: Required unless dryRun.
  - `environment` 'CERTIFICATION' | 'PRODUCTION', required: Delivery environment for live exports. Bound to the partner connection readiness gate.
  - `ids` string[]
  - `since` string, date-time
  - `maxRows` integer
  - `dryRun` boolean

## Response `200`

Export results, or dry-run mapped payloads.

- QuickBooksExportResult
  - `ok` true, required
  - `entity` string, required
  - `documentTypeCode` string, required
  - `environment` 'CERTIFICATION' | 'PRODUCTION', required
  - `dryRun` boolean, required
  - `total` integer, required
  - `exported` integer, required
  - `failed` integer, required
  - `items` object[], required

## Other responses

- `400`: Request body failed validation (`code` e.g. VALIDATION_ERROR, NO_WORKSPACE, BATCH_TOO_LARGE).
- `401`: Missing or invalid API key (`code` AUTH_UNAUTHORIZED).
- `403`: API key lacks the required `platform` scope (`code` PLATFORM_SCOPE_REQUIRED), its lane is invalid (API_KEY_ENVIRONMENT_INVALID), the workspace is not entitled to the platform API (PLATFORM_NOT_ENTITLED), or a supplied `workspaceId` does not match the authenticated workspace (FORBIDDEN).
- `404`: Resource not found, or the /v1 platform is disabled (`code` NOT_FOUND / PARTNER_NOT_FOUND / WORKSPACE_NOT_FOUND).
- `429`: Rate limit exceeded (`code` RATE_LIMITED).
- `500`: Unexpected server error (`code` e.g. PARSE_FAILED, VALIDATE_FAILED, OUTBOUND_FAILED, INBOUND_FAILED, BATCH_FAILED, TRANSACTIONS_FAILED, DOCUMENT_RECEIPT_FAILED, DOCUMENT_PAYLOAD_FAILED). Sanitized bodies carry an opaque `correlationId` to quote to support; internal error text is never echoed.

---

[API](https://skmtc.dev/signaledi/apis/signaledi-developer-api.md) · [All operations](https://skmtc.dev/signaledi/apis/signaledi-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signaledi/apis/signaledi-developer-api/revisions/9bc596644a10?raw)