MGCLatticeSalesReturnService
Custom service for sales returns (Accounts receivable): create a return order, receive it (registration and return packing slip) and credit it (credit note). Purchase returns are MGCLatticePurchaseReturnService.
Methods
new
Initializes a new instance of the MGCLatticeSalesReturnService class.
- Visibility:
public - Returns:
void
No parameters.
construct
Creates a new instance of the MGCLatticeSalesReturnService class.
- Visibility:
public - Returns:
MGCLatticeSalesReturnServiceA new MGCLatticeSalesReturnService instance.
No parameters.
createSalesReturn
Creates a sales return order (SalesType::ReturnItem) for a customer with one or more return lines, via the AxSalesTable / AxSalesLine business-document framework so the order and lines are defaulted and validated the standard way. Every line needs a quantity (its size is used; a line without one is refused), and return quantities are stored negative. Idempotent by RequestId.
- Visibility:
public - Returns:
MGCLatticeOrderOperationResponseContractAn MGCLatticeOrderOperationResponseContract carrying the created SalesId, or a failure.
| Name | Type | Optional | Description |
|---|---|---|---|
_request | MGCLatticeCreateSalesReturnRequestContract | No | Request with CustAccount, ReturnReasonCodeId, optional ReturnDeadline, and lines. |
receiveSalesReturn
Posts a return receipt (packing slip) for a sales return order.
- Visibility:
public - Returns:
MGCLatticeOrderOperationResponseContractAn MGCLatticeOrderOperationResponseContract indicating success or failure with details.
| Name | Type | Optional | Description |
|---|---|---|---|
_request | MGCLatticeSalesReturnReceiveRequestContract | No | The request containing SalesOrderId, PostingDate, and standard header fields. |
creditSalesReturn
Posts a credit note (invoice) for a sales return order.
- Visibility:
public - Returns:
MGCLatticeOrderOperationResponseContractAn MGCLatticeOrderOperationResponseContract indicating success or failure with details.
| Name | Type | Optional | Description |
|---|---|---|---|
_request | MGCLatticeSalesReturnCreditRequestContract | No | The request containing SalesOrderId, PostingDate, and standard header fields. |
receiveSalesReturnBatch
Receives multiple sales returns in a single bulk operation. A missing (null) item fails on its own as ValidationFailed (addBulkNullItemResult) without stopping the batch.
- Visibility:
public - Returns:
MGCLatticeBulkOperationResponseContractAn MGCLatticeBulkOperationResponseContract containing per-item results.
| Name | Type | Optional | Description |
|---|---|---|---|
_requests | List | No | List of MGCLatticeSalesReturnReceiveRequestContract. |
creditSalesReturnBatch
Credits multiple sales returns in a single bulk operation. A missing (null) item fails on its own as ValidationFailed (addBulkNullItemResult) without stopping the batch.
- Visibility:
public - Returns:
MGCLatticeBulkOperationResponseContractAn MGCLatticeBulkOperationResponseContract containing per-item results.
| Name | Type | Optional | Description |
|---|---|---|---|
_requests | List | No | List of MGCLatticeSalesReturnCreditRequestContract. |
createSalesReturnBatch
Creates multiple sales return orders in a single bulk operation. A missing (null) item fails on its own as ValidationFailed (addBulkNullItemResult) without stopping the batch.
- Visibility:
public - Returns:
MGCLatticeBulkOperationResponseContractAn MGCLatticeBulkOperationResponseContract containing per-item results.
| Name | Type | Optional | Description |
|---|---|---|---|
_requests | List | No | List of MGCLatticeCreateSalesReturnRequestContract. |