CRM in Cloud Web API documentations

Security

This controller works under the system security rules and constraints.
For more details, refer to the Authentication section

Note

The following guidelines are intended to illustrate the features and features of this Web API controller.

Aliases

This controller can be invoked by other names besides the default one.

This means that, referring to the routing grammar ({schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}) it is possible to use a different fragment for the {controller} component.

Below is the list of these aliases for the fragment {controller}, sorted by suggested preference of use.

Alias	Path
Invoices	/api/v1/Invoices
Invoice	/api/v1/Invoice

Authentication

JWT Token

In order to invoke the REST API, it is necessary to obtain an authentication token via the appropriate service /Auth/Login

For more details, please see the appropriate section of the documentations.

Bearer Authentication

Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens.

For more details, please see the appropriate section of the documentations.

Identification of the calling application

Some of the REST API functions can only be used if (in addition to proper user authentication) a declaration of the calling application is also performed.

For more details, please see the appropriate section of the documentations.

Actions & Paths

These are the REST actions that can be performed via the Web API infrastructure.
The actions are grouped by "topic".
Click on a "topic" to view the different actions contained in it.

Each action corresponds to a method in the class of the Web API controller, and a set of routing paths that can be used to invoke it.

Explore by topics

Topic name	Most commonly used actions
CRUD	/api/v1/Invoice/CreateOrUpdate /api/v1/Invoice/ /api/v1/Invoice/Exists /api/v1/Invoice/ /api/v1/Invoice/Humanize /api/v1/Invoice/GetFull /api/v1/Invoice/GetNewInstance
Multiple CRUD	/api/v1/Invoice/MultipleDelete /api/v1/Invoice/MultipleExists /api/v1/Invoice/MultipleGet
External References	/api/v1/Invoice/SearchIdsByExternalReference /api/v1/Invoice/GetByExternalReference /api/v1/Invoice/DeleteByExternalReference /api/v1/Invoice/MapByExternalReference /api/v1/Invoice/ResetExternalReferences /api/v1/Invoice/UnmapByExternalReference /api/v1/Invoice/GetIdsMappedByExternalReference /api/v1/Invoice/GetItemsMappedByExternalReference /api/v1/Invoice/GetIdsNotMappedByExternalReference /api/v1/Invoice/GetIdsByExternalReference /api/v1/Invoice/GetItemsNotMappedByExternalReference
Misc	/api/v1/Invoice/GetNewInvoiceTypes /api/v1/Invoice/RequestedByChanged /api/v1/Invoice/OnAnagraphicChanged /api/v1/Invoice/GetPriceListCurrency /api/v1/Invoice/SendEmailWithPrintTemplate /api/v1/Invoice/OnGetNewEmptyGroupRow /api/v1/Invoice/OnGroupByRowType /api/v1/Invoice/OnGroupByProductCategory /api/v1/Invoice/OnDiscountFormulaGroupingChanged /api/v1/Invoice/OnGroupTaxableAmountWithDiscountChanged /api/v1/Invoice/GetInfo /api/v1/Invoice/AddProductsByCode /api/v1/Invoice/CloneRowsGroups /api/v1/Invoice/ImportRows /api/v1/Invoice/GetNewRowInstance /api/v1/Invoice/ApplyCalculateTotalDocument /api/v1/Invoice/ApplyCalculateTotalDocumentWithFooterTotals /api/v1/Invoice/NewEmptyRow /api/v1/Invoice/CatalogCodeChanged /api/v1/Invoice/LinkedProducts /api/v1/Invoice/PriceListChanged /api/v1/Invoice/UnitPriceChanged /api/v1/Invoice/QtaChanged /api/v1/Invoice/UnitMeasureChanged /api/v1/Invoice/TaxCodeChanged /api/v1/Invoice/DiscountFormulaChanged /api/v1/Invoice/CostChanged /api/v1/Invoice/GainChanged /api/v1/Invoice/PercentageGainChanged /api/v1/Invoice/ProcessOnChangeListId /api/v1/Invoice/ProcessOnChangeCurrency /api/v1/Invoice/ExportRowsInExcel /api/v1/Invoice/RebuildGrouping /api/v1/Invoice/RecalcDocumentTotal /api/v1/Invoice/Templates /api/v1/Invoice/HtmlPreview /api/v1/Invoice/PrintHtml /api/v1/Invoice/GetDownloadUrl /api/v1/Invoice/GetPostDownloadUrl /api/v1/Invoice/Archive /api/v1/Invoice/AsDataProduct /api/v1/Invoice/GetBoDeleteModes /api/v1/Invoice/FreeFields /api/v1/Invoice/GetHash /api/v1/Invoice/PrintableFields /api/v1/Invoice/Photo /api/v1/Invoice/Recent /api/v1/Invoice/GetSample
OData	/api/v1/Invoice/Count /api/v1/Invoice/SearchIds /api/v1/Invoice/Search
Preview	/api/v1/Invoice/Previews /api/v1/Invoice/Preview
Swagger	/api/v1/Invoice/GetDataProductSchema /api/v1/Invoice/GetPolymorphicSchema /api/v1/Invoice/GetPolymorphicStandardSchema /api/v1/Invoice/GetStandardSchema /api/v1/Invoice/GetSwagger

GET: /api/v1/Invoice/

Routing template:

/api/{version}/Invoice/

Produces:

HTTP 200: Int64 as application/json
HTTP 200: Int64 as text/json
HTTP 200: Int64 as application/json;IEEE754Compatible=false
HTTP 200: Int64 as application/json;IEEE754Compatible=true
HTTP 200: Int64 as application/xml
HTTP 200: Int64 as text/plain
HTTP 200: Int64 as application/octet-stream

Name	Type	Required	In	Features
id	integer	YES	Path	Format: int64
template	string	NO	Query
request	InvoicePrintableRequest	NO	Query

Name	Type	Required	In	Features
insertPosition	integer	NO	Query	Format: int32
overrideCurrent	boolean	NO	Query
lang	string	NO	Query

Name	Type	Required	In
exportDescription	boolean	NO	Query
exportDescriptionNewLine	boolean	NO	Query
exportExtensions	boolean	NO	Query
exportFreeFields	boolean	NO	Query

Name	Type	Required	In	Features
honorAcceptLanguageHeader	boolean	NO	Query	Default: False
includeExplicitlyDeclaredVirtualProperties	boolean	NO	Query	Default: False

Name	Type	Required	In	Features
externalReference	string	NO	Query
excludeDeletedItems	boolean	NO	Query

Name	Type	Required	In	Features
serializePropertiesAsDictionary	boolean	NO	Query	Default: True
honorAcceptLanguageHeader	boolean	NO	Query	Default: False
generateSample	boolean	NO	Query	Default: False
sampleGenerationStrategy	SampleGenerationStrategy	NO	Query
useExtensions	boolean	NO	Query	Default: True
includeExplicitlyDeclaredVirtualProperties	boolean	NO	Query	Default: False

Name	Type	Required	In	Features
force	boolean	NO	Query	Default: False
sampleGenerationStrategy	SampleGenerationStrategy	NO	Query
useExtensions	boolean	NO	Query	Default: True

Name	Type	Required	In	Features
taxableAmountWithDiscount	number	NO	Query	Format: double
extensionPartIdx	integer	NO	Query	Format: int32
decimals	integer	NO	Query	Default: 2 Format: int32

Name	Type	Required	In	Features
includeFull	boolean	NO	Query	Default: True
includeNesting	boolean	NO	Query	Default: True

Name	Type	Required	In	Features
crossId	integer	NO	Query	Format: int64
crossType	BusinessObjectType	NO	Query
erpType	BusinessObjectType	NO	Query

Name	Type	Required	In	Features
filter	string	NO	Query
orderBy	string	NO	Query
skip	integer	NO	Query	Format: int64
top	integer	NO	Query	Format: int64
select	string	NO	Query

Name	Type	Required	In	Features
parentId	integer	NO	Query	Format: int64
parentType	BusinessObjectType	NO	Query
templateName	string	NO	Query

Name	Description
AccountAccessLevel	Account Access Level
ActiveModules	Active Modules
AddProductsByCodeRequest	Add Products By Code Request
AddressAccuracy	Address Accuracy
BoDeleteMode	Bo Delete Mode
Boolean	Boolean
BusinessObjectInvoker	Business Object Invoker
BusinessObjectLoadedType	Business Object Loaded Type
BusinessObjectType	Business Object Type
CatalogPriceListUsage	Catalog Price List Usage
CatalogType	Catalog Type
CloneRowsGroupsRequest	Clone Rows Groups Request
CRMTables	CRM Tables
DefaultDocumentCategories	Default Document Categories
DeleteItemResult	Delete Item Result
ErpGroupingType	Erp Grouping Type
ERPRowDTO	ERP Row
ERPRowGroupingDTO	ERP Row Grouping
ERPRowGroupingExtensionDTO	ERP Row Grouping Extension
ERPRowType	ERP Row Type
ExistsItemResult	Exists Item Result
ExternalReferenceDTO	External Reference
FileCrossAttributes	File Cross Attributes
FileCrossTypes	File Cross Types
FilePreview	File Preview
FreeFieldsBOItemDTO	Free Fields BO Item
FreeFieldsBOItemLocalizingDTO	Free Fields BO Item Localizing
FreeFieldsBOTreeItemDTO	Free Fields BO Tree Item
FreeFieldsType	Free Fields Type
GetIdsMappedByExternalReferenceRequest	Get Ids Mapped By External Reference Request
GetItemResult`1[]	Get Item Result`1
GetItemsMappedByExternalReferenceRequest	Get Items Mapped By External Reference Request
Gravity	Gravity
IBundle	Bundle
ICatalogAlternativeUnitBO	Catalog Alternative Unit BO
ICatalogBO	Catalog BO
ICatalogCodeChangeResponse	Catalog Code Change Response
ICatalogProductPriceBO	Catalog Product Price BO
ICrmBusinessObjects	Crm Business Objects
IDirection	Direction
IDocumentReference	Document Reference
IErpExportRowsExcelInfo	Erp Export Rows Excel Info
IERPRow	ERP Row
IERPRowExtension	ERP Row Extension
IERPRowGrouping	ERP Row Grouping
IERPRowGroupingExtension	ERP Row Grouping Extension
IExternalReference	External Reference
IFileCross	File Cross
IFreeFieldItemLocalizing	Free Field Item Localizing
IFreeFieldsItem	Free Fields Item
IGeo	Geo
ILocalizing	Localizing
ILocation	Location
ImportRowsRequest	Import Rows Request
InvoiceDTO	Invoice
InvoicePrintableRequest	Invoice Printable Request
InvoiceShip	Invoice Ship
InvoiceType	Invoice Type
IPackageResponse	Package Response
IPrintTemplate	Print Template
IQueryFragment	Query Fragment
IQueryMutators	Query Mutators
IQueryPaging	Query Paging
ISimpleCatalogLink	Simple Catalog Link
IStorageBO	Storage BO
ITaxSummary	Tax Summary
ITotalDocumentResult	Total Document Result
ITreeItem	Tree Item
IUserConfig	User Config
LinkItem	Link Item
LiquidStruct	Liquid Struct
LocalizeType	Localize Type
LocalizingDTO	Localizing
LoggedStatus	Logged Status
LoginResult	Login Result
MapExternalReferenceRequest	Map External Reference Request
MessageCode	Message Code
MultipleDeleteModel	Multiple Delete Model
MultipleExistsModel	Multiple Exists Model
MultipleGetModel	Multiple Get Model
NewInvoiceType	New Invoice Type
PrintHtmlRequest	Print Html Request
PrintTemplateDTO	Print Template
QueryFragmentKind	Query Fragment Kind
RecentRouteType	Recent Route Type
RowContentType	Row Content Type
RowTypeGiftVatMode	Row Type Gift Vat Mode
SampleGenerationStrategy	Sample Generation Strategy
ShippedBy	Shipped By
StandardSchemaVersion	Standard Schema Version
StoragePermission	Storage Permission
SubAccountType	Sub Account Type
Template	Template
TypeOfService	Type Of Service

APIv1EnglishInvoice

Invoice

Security

Note

Aliases

Authentication

JWT Token

Bearer Authentication

Identification of the calling application

Actions & Paths

GET: /api/v1/Invoice/

Routing template:

Produces:

Response: 200 (Success) ApiActionResult

Samples

Try this !

DELETE: /api/v1/Invoice/{id}

Parameters:

Produces:

Response: 200 (Success) Boolean

Samples

Try this !

GET: /api/v1/Invoice/{id}

Parameters:

Produces:

Response: 200 (Success) InvoiceDTO

Samples

Try this !

GET: /api/v1/Invoice/{id}/Archive

Parameters:

Produces:

Response: 400 (Bad Request) integer

Samples

Try this !

GET: /api/v1/Invoice/{id}/AsDataProduct

Parameters:

Produces:

Response: 200 (Success) InvoiceDTO

Samples

Try this !

GET: /api/v1/Invoice/{id}/Exists

Parameters:

Produces:

Response: 200 (Success) Boolean

Samples

Try this !

GET: /api/v1/Invoice/{id}/FreeFields

Parameters:

Produces:

Response: 200 (Success) FreeFieldsBOItemDTO

Samples

Try this !

GET: /api/v1/Invoice/{id}/GetDownloadUrl

Parameters:

Produces:

Response: 400 (Bad Request) string

Samples

Try this !

GET: /api/v1/Invoice/{id}/GetFull

Parameters:

Produces:

Response: 200 (Success) InvoiceDTO

Samples

Try this !

GET: /api/v1/Invoice/{id}/GetHash

Parameters:

Produces:

Response: 200 (Success) String

Samples

Try this !

GET: /api/v1/Invoice/{id}/GetPostDownloadUrl

Parameters:

Produces:

Response: 400 (Bad Request) string

Samples

Try this !

POST: /api/v1/Invoice/{id}/HtmlPreview

Parameters:

Produces:

Response: 200 (Success) String

API v1 English Invoice