Purchases | Process Order

Service to allow picking of order to process for invoice creation purpose.

Overview

URL	api/{tenantKey}/{orgKey}/invoiceReceipt/processOrders
Methods Supported	GET, POST

All Operations

This service includes the following operations:

• GET:
  • GET Process Order
• POST:
  • POST Process Order

All Resources

This service uses the following resources:

• InvoiceReceiptOrder
• InvoiceReceiptOrderLine

GET Operations

GET Process Order

Returns the list of entity records that can be processed by the 'Invoices' service.

The following elements are required:

pageIndex	(int) The index of the page of the list that should be returned.
pageSize	(int) The number of page elements that should be returned (max. is 1000).

The following elements are optional:

company	(string) The company code is the central organizational unit within the system. This is a query string parameter.
accountingSupplierParty	(string) The supplier designated in the party as the party to whom should be sent the invoice. It may or may not be the party to whom the goods or services are delivered. This is a query string parameter.
invoiceType	(string) Defines the invoice's purpose. Distinguishes the business transactions to be posted. The default delivery type is defined in the purchases configuration setting. This is a query string parameter.
invoiceReceiptNotificationDateFrom	(DateTime?) The invoice receipt notification starting date. Ignored if not set, is used to filter the date in which you received the goods. Only invoice recepit notifications with delivery date greater than or equal to this value will be displayed. Orders will also be displayes in case their document type is set as "Delivery on invoice". This is a query string parameter.
invoiceReceiptNotificationDateUntil	(DateTime?) The invoice receipt notification end date. Ignored if not set, is used to filter the date in which you received the goods. Only invoice recepit notifications with delivery date less than or equal to this value will be displayed. Orders will also be displayes in case their document type is set as "Delivery on invoice". This is a query string parameter.
currency	(string) The money unit used by the system, such as Euros (EUR) or United States Dollars (USD). This value is important for currency exchanges or to set the number of decimal places used to represent values. The default is defined on the supplier party. This is a query string parameter.
sourceDoc	(string) The original document to be settled. The source document is usually an order. Ignored if not set, is used to filter de invoice receipt notifications to the ones whose source document is this document. This is a query string parameter.
goodsReceiptNoteKey	(string) The goods receipt document. Ignored is not set, is used to filter de invoice receipt notifications to the ones originated by this goods receipt note. This is a query string parameter.

Response:

When successful, the response body contains the list of entity records available for processing. See InvoiceReceiptOrderLine.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

POST Operations

POST Process Order

Instructs the 'Invoices' service to process the specified entity records.

The following elements are required:

list	(InvoiceReceiptOrderLine) List of the entity records that should be processed. See InvoiceReceiptOrderLine.
companyKey	(string) The company key.

Response:

When successful, the response body is empty. The URL of the processed items is returned in the response location header.

Response status codes:

201	Created. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

Resources

InvoiceReceiptOrder

The following elements are required:

selectedCount

(int) The number of lines selected. Internally calculated.

The following elements are optional:

company	(string) The company code is the central organizational unit within the system.
accountingSupplierParty	(string) The supplier designated in the party as the party to whom should be sent the invoice. It may or may not be the party to whom the goods or services are delivered.
invoiceType	(string) Defines the invoice's purpose. Distinguishes the business transactions to be posted. The default delivery type is defined in the purchases configuration setting.
invoiceReceiptNotificationDateFrom	(DateTime) The invoice receipt notification starting date. Ignored if not set, is used to filter the date in which you received the goods. Only invoice recepit notifications with delivery date greater than or equal to this value will be displayed. Orders will also be displayes in case their document type is set as "Delivery on invoice".
invoiceReceiptNotificationDateUntil	(DateTime) The invoice receipt notification end date. Ignored if not set, is used to filter the date in which you received the goods. Only invoice recepit notifications with delivery date less than or equal to this value will be displayed. Orders will also be displayes in case their document type is set as "Delivery on invoice".
currency	(string) The money unit used by the system, such as Euros (EUR) or United States Dollars (USD). This value is important for currency exchanges or to set the number of decimal places used to represent values. The default is defined on the supplier party.
sourceDoc	(string) The original document to be settled. The source document is usually an order. Ignored if not set, is used to filter de invoice receipt notifications to the ones whose source document is this document.
goodsReceiptNoteKey	(string) The goods receipt document. Ignored is not set, is used to filter de invoice receipt notifications to the ones originated by this goods receipt note.

InvoiceReceiptOrderLine

The following elements are required:

selected

(bool) Indicates if the line has been selected to be included on the invoice.

The following elements are optional:

currency	(string) The curreny of then unit of the purchase item. Infered from the invoce receipt notification.
goodsReceiptNoteKey	(string) The goods receipt document. Infered from the invoice receipt notification line.
goodsReceiptNoteLineNumber	(int) The goods receipt document line number. Infered from the invoice receipt notification line.
description	(string) The description of the purchase item. Infered from the invoce receipt notification.
orderKey	(string) The order document. Infered from the invoice receipt notification line.
orderLineNumber	(int) The order document line number. Infered from the invoice receipt notification line.
quantity	(decimal) The quantity to be included on the invoice to be created.
purchasesItem	(string) The purchase item included on invoice. Infered from the invoce receipt notification.
unit	(string) The unit of the purchase item. Infered from the invoce receipt notification.
unitPrice	(decimal) The unit of the purchase item. Infered from the invoce receipt notification.
invoiceReceiptNotificationId	(Guid) The unique identifier of the invoce receipt notification. Internally determined.
invoiceReceiptNotificationLineId	(Guid) The unique identifier of the invoce receipt notification line. Internally determined.