> This page is for version V1 (default).
> For other versions, use one of these documentation indexes:
> - V1 (default): https://docs.ottimate.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ottimate.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ottimate.com/_mcp/server.

# Changelog

This update introduces Purchase Orders, Receipts, and Batch processing endpoints, adds bulk operations across several existing APIs, and establishes availability status tags across the API Reference.

## New APIs (In Development)

The following APIs are currently in development and being tested. They are documented here for planning purposes and are not yet available for use. Availability will be announced in a future changelog entry.

### Purchase Orders

Full CRUD for purchase orders, enabling two-way and three-way matching workflows in Ottimate.

| Endpoint                             | Description                                                   |
| ------------------------------------ | ------------------------------------------------------------- |
| `GET /purchase-orders`               | List purchase orders with filtering and pagination            |
| `GET /purchase-orders/{id}`          | Retrieve a specific purchase order                            |
| `POST /purchase-orders`              | Create a new purchase order                                   |
| `PATCH /purchase-orders/{id}`        | Update an existing purchase order                             |
| `POST /purchase-orders/bulk-upsert/` | Create or update multiple purchase orders in a single request |

### Receipts

Manage purchase receipts to support goods-received workflows and three-way matching.

| Endpoint                      | Description                                            |
| ----------------------------- | ------------------------------------------------------ |
| `GET /receipts`               | List receipts with filtering and pagination            |
| `GET /receipts/{id}`          | Retrieve a specific receipt                            |
| `POST /receipts`              | Create a new receipt                                   |
| `PATCH /receipts/{id}`        | Update an existing receipt                             |
| `POST /receipts/bulk-upsert/` | Create or update multiple receipts in a single request |

### Batch Processing

Track the progress and results of long-running bulk operations.

| Endpoint                   | Description                                     |
| -------------------------- | ----------------------------------------------- |
| `GET /batch/{id}/progress` | Poll the completion status of a batch job       |
| `GET /batch/{id}/results`  | Retrieve the results once a batch job completes |

## New Bulk Endpoints (In Development)

Bulk operations added to existing APIs for high-volume integrations. These are currently in development and being tested. They accept arrays of records and return per-item success/error results.

| Endpoint                        | Description                                           |
| ------------------------------- | ----------------------------------------------------- |
| `POST /catalog/entries/bulk`    | Create or update catalog entries in bulk              |
| `POST /catalog/allowances/bulk` | Create or update catalog allowances in bulk           |
| `POST /catalog/prices/bulk`     | Create or update catalog prices in bulk               |
| `POST /dimensions/bulk-create/` | Create multiple dimensions in a single request        |
| `POST /vendors/bulk-create/`    | Create or update multiple vendors in a single request |

## Documentation Updates

### Availability Status Tags

All endpoints in the API Reference now display a status badge indicating their maturity level. See [Release Plan](/releases) for full definitions.

* **Beta** — All previously released endpoints (Accounts, Catalog, Dimensions, Invoices, OAuth, Vendors) are now tagged as beta, reflecting that they are functional and available for integration but may receive minor changes before GA.
* **In Development** — New endpoints introduced in this release are tagged as in-development and are not yet available for use.

## Migration Notes

No breaking changes. All existing endpoints and request/response schemas remain unchanged. If you are already integrated with V1.0.0, no action is required.