# @univerjs-pro/pdfs-exchange-client

- Human documentation: [https://docs.univer.ai/reference/packages/plugins/univerjs-pro/pdfs-exchange-client](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/pdfs-exchange-client)

- Agent Markdown: [https://docs.univer.ai/reference/packages/plugins/univerjs-pro/pdfs-exchange-client.md](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/pdfs-exchange-client.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [packages/plugins/univerjs-pro/pdfs-exchange-client.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/pdfs-exchange-client.mdx)

---

PDF import and export client integration for Web SDK.

```typescript
import { UniverPdfsExchangeClientPlugin } from '@univerjs-pro/pdfs-exchange-client'

univer.registerPlugin(UniverPdfsExchangeClientPlugin)
```

The plugin config accepts an optional `menu` value, which is merged into the shared Univer menu configuration. The root entry exports `PdfsExchangeClientMenuSchema` and `IPdfExchangeService` for custom integrations, but not the config type.

## Entry points

* Facade: `@univerjs-pro/pdfs-exchange-client/facade`
* Locale: `@univerjs-pro/pdfs-exchange-client/locale/*`

## Facade API

```typescript
import '@univerjs-pro/pdfs-exchange-client/facade'

importPdfToUnitIdAsync(file: File | string): Promise<string | undefined>
importPdfToSnapshotAsync(file: File | string): Promise<IPdfUnitData | undefined>
exportPdfByUnitIdAsync(unitId: string): Promise<File | undefined>
exportPdfBySnapshotAsync(snapshot: IPdfUnitData): Promise<File | undefined>
transformSnapshotJsonToPdfDataAsync(json: ISnapshotBlockJsonResponse): Promise<IPdfUnitData>
transformPdfDataToSnapshotJsonAsync(pdfData: IPdfUnitData): Promise<ISnapshotBlockJson>
```

Import `@univerjs-pro/exchange-client/facade` as well when using the shared `downloadFile(file, filename, fileExt)` helper. See [PDF import and export](https://docs.univer.ai/guides/pdfs/features/import-export.md) for the complete workflow.