# Return Receipts _(Realtime-enabled)_

`GET` _(Table: Return Receipt Header)_

```
eOne/core/v1.0/returnReceipts
```

Read-only posted sales return receipts, the customer-return counterpart of [sales shipments](https://eonesolutions.github.io/eone-bc-integration/core-salesShipments.md), and a **webhook source**: subscribe to be pushed the “return received” event the moment a return order is received.

## Receive vs. credit

A return receipt records that returned goods were **received** back into inventory; it is not the financial credit. The credit is a separate posted [sales credit memo](https://eonesolutions.github.io/eone-bc-integration/core-salesCreditMemos.md), posted when the return order is invoiced. Use this feed to reconcile physical returns; use the credit memo for the money.

## Subscribing to returns

Register a subscription against the entity set; Business Central notifies your endpoint when a return receipt is inserted (posted). The notification carries the record id. GET it (optionally `$expand=returnReceiptLines`) to read the detail.

```
POST /subscriptions
{
  "resource": "/returnReceipts",
  "notificationUrl": "https://your-endpoint",
  "clientState": "<secret>"
}
```

> **Note:** `integrationId` is the originating return order's eOne integration key (stamped at post time), and each line carries a `returnReasonCode`, so the notification tells you which order was returned and why.

## Return Receipts fields

_API column → BC field._

**Legend**

- _(req)_ required on create
- _(res)_ resolver
- _(cur)_ currency-translated
- _(ro)_ read-only
- _(ext)_ added to this endpoint by another extension (BC field name shown; its API column name is not known here)

| API | BC field | Notes |
| --- | --- | --- |
| `id` | SystemId | BC record GUID. _(ro)_ |
| `dimensionSetId` | Dimension Set ID | The dimension set this record carries. Join it to the dimensionSetEntries endpoint to resolve the full set of dimension codes and values, including any beyond the eight shortcut dimension columns. _(ro)_ |
| `bcCompanyId` | bcCompanyId | The company this row belongs to - the same GUID that appears in the request URL. Present on every endpoint so a store pooling several companies can keep them apart without relying on which URL it called. _(ro)_ |
| `bcCompanyName` | bcCompanyName | The name of the company this row belongs to. _(ro)_ |
| `integrationId` | EONE Integration Id | Originating return order's key, stamped at post time. _(ro)_ |
| `number` | No. | Posted return receipt number. _(ro)_ |
| `returnOrderNumber` | Return Order No. | Originating sales return order number. _(ro)_ |
| `sellToCustomerNumber` | Sell-to Customer No. | _(ro)_ |
| `sellToCustomerName` | Sell-to Customer Name | _(ro)_ |
| `postingDate` | Posting Date | _(ro)_ |
| `documentDate` | Document Date | _(ro)_ |
| `externalDocumentNumber` | External Document No. | _(ro)_ |
| `yourReference` | Your Reference | _(ro)_ |
| `locationCode` | Location Code | _(ro)_ |
| `shipmentMethodCode` | Shipment Method Code | _(ro)_ |
| `salespersonCode` | Salesperson Code | _(ro)_ |
| `currencyCode` | Currency Code | Raw BC code; blank is LCY. _(cur)_ |
| `shipToCode` | Ship-to Code | _(ro)_ |
| `shipToName` | Ship-to Name | _(ro)_ |
| `shipToAddressLine1` | Ship-to Address | _(ro)_ |
| `shipToAddressLine2` | Ship-to Address 2 | _(ro)_ |
| `shipToCity` | Ship-to City | _(ro)_ |
| `shipToCounty` | Ship-to County | _(ro)_ |
| `shipToCountryRegionCode` | Ship-to Country/Region Code | _(ro)_ |
| `shipToPostCode` | Ship-to Post Code | _(ro)_ |
| `shipToContact` | Ship-to Contact | _(ro)_ |
| `createdDateTime` | SystemCreatedAt | _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | _(ro)_ |

## Related pages

Collections nested under this endpoint:

- [Return Receipt Lines](https://eonesolutions.github.io/eone-bc-integration/core-returnReceiptLines.md)