---
title: "PlannedSalesReturns (Exact Online)"
description: "Planned Sales Returns"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/exactonline/ExactOnlineREST.SalesOrder.PlannedSalesReturns
original: https://documentation.invantive.eu/en/datamodels/exactonline/ExactOnlineREST.SalesOrder.PlannedSalesReturns
updated: 2026-11-01T17:55:09Z
license: https://documentation.invantive.eu/en/
---

# PlannedSalesReturns: Exact Online Planned Sales Returns

`insert` `update` `delete` `per partition` `REST`

- Catalog: `ExactOnlineREST`
- Schema: `SalesOrder`
- Primary Keys: `PlannedSalesReturnID`
- Label: Planned Sales Returns

The data in this table is partitioned per value of the `Division` column.

Can retrieve data and change data using `insert`, `update` and `delete`.

## API Source

- Endpoint: `/api/v1/{division}/salesorder/PlannedSalesReturns`
- Metadata: `/api/v1/{division}/salesorder/$metadata`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 5 |
| Full scan rows per minute | 7,200 |
| Point query rows per minute | 300 |
| Write rows per minute | 300 |

The result can be cached on the client.

## Table Columns

The columns of the table `PlannedSalesReturns` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `Created` | `datetime` | Created | [ ] | filters on the platform, writable | Creation date. |
| `CreatedUtc` | `datetime` | Created (UTC) | [ ] | writable | Creation date in UTC. |
| `Creator` | `guid` | Creator | [ ] | filters on the platform, writable | User ID of the creator. |
| `CreatorFullName` | `varchar2` | Creator Full Name | [ ] | filters on the platform, writable | Name of the creator. |
| `DeliveredTo` | `guid` | itgen_eol_deliveredto | [x] | filters on the platform, writable | Reference to the customer where item is delivered to/customer returning items. |
| `DeliveredToContactPerson` | `guid` | itgen_eol_deliveredtocontactperson | [ ] | filters on the platform, writable | Reference to the contact person of customer where item is delivered to/customer returning items. |
| `DeliveredToContactPersonFullName` | `varchar2` | itgen_eol_deliveredtocontactpersonfullname | [ ] | filters on the platform, writable | Name of contact person of delivered to customer. |
| `DeliveredToName` | `varchar2` | itgen_eol_deliveredtoname | [ ] | filters on the platform, writable | Name of delivered to customer. |
| `DeliveryAddress` | `guid` | Delivery Address | [ ] | filters on the platform, writable | Delivered to address. |
| `Description` | `varchar2` | Description | [ ] | filters on the platform, writable | Description of the planned sales return. |
| `Division` | `int32` | Division | [ ] | filters on the platform, writable | Division code. |
| `DivisionCompanyCoCNumber` | `varchar2(60)` | Division Chamber of Commerce Number | [ ] | writable | Chamber of commerce number of the Exact Online division. |
| `DivisionCompanyIBANNumber` | `varchar2(50)` | Division IBAN Number | [ ] | writable | IBAN number of the Exact Online division. |
| `DivisionCompanyName` | `varchar2(50)` | Division Company Name | [x] | writable | Company name of the Exact Online division. |
| `DivisionCompanyRSINNumber` | `varchar2(9)` | Division RSIN Number | [ ] | writable | RSIN number of the Exact Online division. |
| `DivisionCompanyVATNumber` | `varchar2(35)` | Division VAT Number | [ ] | writable | VAT number of the Exact Online division. |
| `DivisionCompanyWageTaxNumber` | `varchar2(60)` | Division Wage Tax Number | [ ] | writable | Wage tax number of the Exact Online division. |
| `DivisionLabel` | `varchar2(128)` | Division Label | [x] | writable | Label of the Exact Online division. |
| `DivisionName` | `varchar2(50)` | Administration Name | [x] | writable | Name of the Exact Online division. |
| `DivisionOwnerCompanyName` | `varchar2(50)` | Subscription Holder Name | [x] | writable | Name of the customer account in division 1 owning the Exact Online subscription to which this division belongs. |
| `DivisionOwnerCompanyNumber` | `varchar2(18)` | Subscription Holder Number | [x] | writable | Number of the customer account in division 1 owning the Exact Online subscription to which this division belongs. |
| `DivisionShortName` | `int64` | Division Short Name | [x] | writable | Short name of the Exact Online division. |
| `Document` | `guid` | Document | [ ] | filters on the platform, writable | Document that is manually linked to the planned sales return. |
| `DocumentSubject` | `varchar2` | Document Subject | [ ] | filters on the platform, writable | Subject of Document. |
| `Modified` | `datetime` | Modified | [ ] | filters on the platform, writable | Last modified date. |
| `ModifiedUtc` | `datetime` | Modified (UTC) | [ ] | writable | Last modified date in UTC. |
| `Modifier` | `guid` | Modifier | [ ] | filters on the platform, writable | User ID of modifier. |
| `ModifierFullName` | `varchar2` | Modified Full Name | [ ] | filters on the platform, writable | Name of modifier. |
| `PlannedSalesReturnID` | `guid` | itgen_eol_plannedsalesreturnid | [x] | filters on the platform | Primary key. |
| `Remarks` | `varchar2` | Remarks | [ ] | filters on the platform, writable | Remarks. |
| `ReturnDate` | `datetime` | Return Date | [ ] | filters on the platform, writable | Date of planned sales return. |
| `ReturnNumber` | `int32` | Return Number | [x] | filters on the platform, writable | Human readable id of the planned sales return. |
| `Source` | `int16` | Source | [ ] | filters on the platform, writable | Source of planned sales return entry: 1-Manual entry, 2-Web service. |
| `Status` | `int16` | Status | [x] | filters on the platform, writable | Planned sales return status: 20-Open, 30-Confirmed, 50-Processed. |
| `Warehouse` | `guid` | Warehouse | [x] | filters on the platform, writable | ID of warehouse to receive the returning items. |
| `WarehouseCode` | `varchar2` | Warehouse Code | [ ] | filters on the platform, writable | Code of warehouse to receive the returning items. |
| `WarehouseDescription` | `varchar2` | Warehouse Description | [ ] | filters on the platform, writable | Description of warehouse to receive the returning items. |

## Keys

| Key | Column | Refers to | Kind | Description |
|---|---|---|---|---|
| `PlannedSalesReturns_Creator_Users_fk` | `Creator` | [Users](ExactOnlineREST.Users.Users)`.UserID` | Key |  |
| `PlannedSalesReturns_DeliveredToContactPerson_Contacts_fk` | `DeliveredToContactPerson` | [Contacts](ExactOnlineREST.CRM.Contacts)`.ID` | Key |  |
| `PlannedSalesReturns_DeliveredTo_Accounts_fk` | `DeliveredTo` | [Accounts](ExactOnlineREST.CRM.Accounts)`.ID` | Key |  |
| `PlannedSalesReturns_DeliveryAddress_Addresses_fk` | `DeliveryAddress` | [Addresses](ExactOnlineREST.CRM.Addresses)`.ID` | Key |  |
| `PlannedSalesReturns_Document_Documents_fk` | `Document` | [Documents](ExactOnlineREST.Documents.Documents)`.ID` | Key |  |
| `PlannedSalesReturns_Modifier_Users_fk` | `Modifier` | [Users](ExactOnlineREST.Users.Users)`.UserID` | Key |  |
| `PlannedSalesReturns_Warehouse_Warehouses_fk` | `Warehouse` | [Warehouses](ExactOnlineREST.Inventory.Warehouses)`.ID` | Key |  |

## Referenced By

- [PlannedSalesReturnLines](ExactOnlineREST.SalesOrder.PlannedSalesReturnLines) `PlannedSalesReturnID` (Key)



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Exact Online](/en/release-notes/drivers?driver=exact-online)

