Purchases | Invoice Type

Service to manage entities of type 'InvoiceType'.

Overview

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes

URL	api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes
Methods Supported	GET, POST, PUT, DELETE

All Operations

This service includes the following operations:

GET:
POST:
- POST InvoiceTypes
- POST Invoice Type
PUT:
DELETE:

All Resources

This service uses the following resources:

ApiInvoiceTypeDocumentTypeSeriesResource
ApiInvoiceTypeResource
InvoiceTypeResource
InvoiceTypeSerieResource

All Enumerations

This service uses the following enumerations:

AccountingSchema

GET Operations

GET InvoiceTypes

Returns the list of all the entity records available.

Response:

When successful, the response body contains the list of records available. See InvoiceTypeResource.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes

GET /purchasesCore/invoiceTypes

GET InvoiceTypes (paged)

Returns a page of the list of all the entity records available.

The following elements are optional:

page	(int) The index of the page of the list that should be returned. This is a query string parameter.
pageSize	(int) The number of page elements that should be returned (max. is 1000). This is a query string parameter.

Response:

When successful, the response body contains the list of records available. See InvoiceTypeResource.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes?page={page}&pageSize={pageSize}

GET /purchasesCore/invoiceTypes?page={page}&pageSize={pageSize}

GET InvoiceType by identifier

Returns the entity record that matches the specified identifier.

The following elements are required:

id	(string) The record identifier.

Response:

When successful, the response body contains the entity record. See InvoiceTypeResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{id}

GET /purchasesCore/invoiceTypes/{id}

GET InvoiceType by key

Returns the entity record that matches the specified key.

The following elements are required:

companyKey	(string) The company key.
typeKey	(string) The key for the invoice type.

Response:

When successful, the response body contains the entity record. See InvoiceTypeResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}

GET /purchasesCore/invoiceTypes/{companyKey}/{typeKey}

GET Print InvoiceType by identifier

Prints the specified entity record.

The following elements are required:

id	(string) The record identifier.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
404	NotFound. The specified resord does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{id}/print?template={template}

GET /purchasesCore/invoiceTypes/{id}/print?template={template}

GET Print InvoiceType by key

Prints the specified entity record.

The following elements are required:

companyKey	(string) The company key.
typeKey	(string) The key for the invoice type.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/print

GET /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/print

GET Original Print InvoiceTypeOriginal by identifier

Prints the specified entity record.

The following elements are required:

id	(string) The record identifier.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
404	NotFound. The specified resord does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{id}/printOriginal?template={template}

GET /purchasesCore/invoiceTypes/{id}/printOriginal?template={template}

GET Original Print InvoiceType by key

Prints the specified entity record.

The following elements are required:

companyKey	(string) The company key.
typeKey	(string) The key for the invoice type.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/printOriginal

GET /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/printOriginal

POST Operations

POST InvoiceTypes

Creates a new entity record.

The following elements are required:

invoiceTypeResource

(ApiInvoiceTypeResource) The request body should contain the entity record that should be created.
See ApiInvoiceTypeResource.

Response:

When successful, the response body contains the new entity record identifier. The resource header location property contains the URL for the new entity record. See ApiInvoiceTypeResource.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes

POST /purchasesCore/invoiceTypes

POST Invoice Type

Inserts a new 'Invoice Type Serie' in the 'Invoice Type'.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(ApiInvoiceTypeDocumentTypeSeriesResource) The ApiInvoiceTypeDocumentTypeSeriesResource instance. See ApiInvoiceTypeDocumentTypeSeriesResource.

Response:

When successful, the response body is empty.

Response status codes:

204	NoContent. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries

POST /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries

PUT Operations

PUT Set AccountingSchema InvoiceType

Updates the value of attribute 'AccountingSchema' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(enum AccountingSchema) The request body should contain the new value for the attribute. See AccountingSchema.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/accountingSchema

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/accountingSchema

PUT Set CashInvoice InvoiceType

Updates the value of attribute 'CashInvoice' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(bool) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/cashInvoice

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/cashInvoice

PUT Set Company InvoiceType

Updates the value of attribute 'Company' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/company

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/company

PUT Set ContactType InvoiceType

Updates the value of attribute 'ContactType' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/contactType

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/contactType

PUT Set DefaultCashFlowItem InvoiceType

Updates the value of attribute 'DefaultCashFlowItem' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultCashFlowItem

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultCashFlowItem

PUT Set DefaultCreditMemoType InvoiceType

Updates the value of attribute 'DefaultCreditMemoType' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultCreditMemoType

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultCreditMemoType

PUT Set DefaultDebitMemoType InvoiceType

Updates the value of attribute 'DefaultDebitMemoType' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultDebitMemoType

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultDebitMemoType

PUT Set DefaultFinancialAccount InvoiceType

Updates the value of attribute 'DefaultFinancialAccount' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultFinancialAccount

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultFinancialAccount

PUT Set DefaultMemoReason InvoiceType

Updates the value of attribute 'DefaultMemoReason' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultMemoReason

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/defaultMemoReason

PUT Set Description InvoiceType

Updates the value of attribute 'Description' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/description

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/description

PUT Set IsActive InvoiceType

Updates the value of attribute 'IsActive' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(bool) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/isActive

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/isActive

PUT Set IsDefault InvoiceTypeSerie

Updates the value of attribute 'IsDefault' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
lineId	(string) The detail identifier.
companyKey	(string) The company key.
value	(bool) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/isDefault

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/isDefault

PUT Set Notification InvoiceType

Updates the value of attribute 'Notification' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/notification

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/notification

PUT Set NumberOfCopies InvoiceTypeSerie

Updates the value of attribute 'NumberOfCopies' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
lineId	(string) The detail identifier.
companyKey	(string) The company key.
value	(int) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/numberOfCopies

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/numberOfCopies

PUT Set TaxIncluded InvoiceTypeSerie

Updates the value of attribute 'TaxIncluded' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
lineId	(string) The detail identifier.
companyKey	(string) The company key.
value	(bool) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/taxIncluded

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}/taxIncluded

PUT Set TypeKey InvoiceType

Updates the value of attribute 'TypeKey' in the specified entity record.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

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

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/typeKey

PUT /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/typeKey

DELETE Operations

DELETE Invoice Type Serie by identifier

Deletes the entity record that matches the specified identifier.

The following elements are required:

typeKey	(string) The key for the invoice type.
companyKey	(string) The company key.
lineId	(string) The line identifier.

Response:

When successful, the response body is empty.

Response status codes:

204	NoContent. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}

DELETE /purchasesCore/invoiceTypes/{companyKey}/{typeKey}/documentTypeSeries/{lineId}

DELETE InvoiceType by identifier

Deletes the entity record that matches the specified identifier.

The following elements are required:

id	(string) The record identifier.

Response:

When successful, the response body is empty.

Response status codes:

204	Deleted. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{id}

DELETE /purchasesCore/invoiceTypes/{id}

DELETE InvoiceType by key

Deletes the entity record that matches the specified key.

The following elements are required:

companyKey	(string) The company key.
typeKey	(string) The key for the invoice type.

Response:

When successful, the response body is empty.

Response status codes:

204	Deleted. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/purchasesCore/invoiceTypes/{companyKey}/{typeKey}

DELETE /purchasesCore/invoiceTypes/{companyKey}/{typeKey}

Resources

ApiInvoiceTypeDocumentTypeSeriesResource

The following elements are required:

isDefault	(bool) Indicates if this is the default serie for the document.
numberOfCopies	(int) The number of copies of the document to print.
serie	(string) The range of identification values that group a set of product entities or objects.

The following elements are optional:

taxIncluded

(bool) When checked, the document unit prices will include taxes.

ApiInvoiceTypeResource

The following elements are required:

company	(string) The company code is the central organizational unit within the system.
typeKey	(string) The key for the invoice type.
cashInvoice	(bool) It is an invoice which also documents an on-time payment receipt in cash, unlike an invoice or a promise of payment.

The following elements are optional:

description	(string) The description for the invoice type.
documentTypeSeries	(List of ApiInvoiceTypeDocumentTypeSeriesResource) The list of available series for this document type. See ApiInvoiceTypeDocumentTypeSeriesResource.
defaultCashFlowItem	(string) The type of cash flow item to be used when CashInvoice is active.
defaultCreditMemoType	(string) The type of credit memo type for the invoice type.
defaultDebitMemoType	(string) The type of debit memo type for the invoice type.
accountingSchema	(enum AccountingSchema) The entity's accounting organization method. This organization can follow the rules of "Cash" or "Accrual". See AccountingSchema.
contactType	(string) The contact type for the invoice type.
notification	(string) The default notification for documents with this invoice type.
defaultFinancialAccount	(string) The default financial account to be used for invoice/receipt.
defaultMemoReason	(string) The default Memo Reason to be used in memos.

InvoiceTypeResource

The following elements are required:

company	(string) The company code is the central organizational unit within the system. (fk) Allowed value: the natural key of a record of type Company. These records are accessibly through the Companies service.
typeKey	(string) The key for the invoice type.
cashInvoice	(bool) It is an invoice which also documents an on-time payment receipt in cash, unlike an invoice or a promise of payment.

The following elements are optional:

description	(string) The description for the invoice type.
documentTypeSeries	(List of InvoiceTypeSerieResource) The list of available series for this document type. See InvoiceTypeSerieResource.
defaultCashFlowItem	(string) The type of cash flow item to be used when CashInvoice is active. (fk) Allowed value: the natural key of a record of type CashFlowItem. These records are accessibly through the CashFlowItems service.
defaultCreditMemoType	(string) The type of credit memo type for the invoice type. (fk) Allowed value: the natural key of a record of type MemoType. These records are accessibly through the MemoTypes service.
defaultDebitMemoType	(string) The type of debit memo type for the invoice type. (fk) Allowed value: the natural key of a record of type MemoType. These records are accessibly through the MemoTypes service.
accountingSchema	(enum AccountingSchema) The entity's accounting organization method. This organization can follow the rules of "Cash" or "Accrual". See AccountingSchema.
contactType	(string) The contact type for the invoice type. (fk) Allowed value: the natural key of a record of type ContactType. These records are accessibly through the ContactTypes service.
notification	(string) The default notification for documents with this invoice type. (fk) Allowed value: the natural key of a record of type Notification. These records are accessibly through the Notifications service.
defaultFinancialAccount	(string) The default financial account to be used for invoice/receipt. (fk) Allowed value: the natural key of a record of type FinancialAccount. These records are accessibly through the FinancialAccounts service.
defaultMemoReason	(string) The default Memo Reason to be used in memos. (fk) Allowed value: the natural key of a record of type MemoReason. These records are accessibly through the MemoReasons service.

InvoiceTypeSerieResource

The following elements are required:

isDefault	(bool) Indicates if this is the default serie for the document.
numberOfCopies	(int) The number of copies of the document to print.
serie	(string) The range of identification values that group a set of product entities or objects.

The following elements are optional:

currentNumber	(int) The current document's number.
currentDate	(DateTime) The current date for the invoice type serie.
taxIncluded	(bool) When checked, the document unit prices will include taxes.

Enumerations

AccountingSchema

1	Accrual	Accrual Accounting Schema.
2	Cash