Sicurezza
Questo controller è sottoposto alle regole di security del sistema.
Per maggiori dettagli, fare riferimento alla sezione Authentication
Note
Le indicazioni riportate di seguito hanno lo scopo di illustrare le funzionalità e le caratteristiche di questo Web API controller.
Aliases
Questo controller è invocabile tramite altri nomi oltre a quello di default.
Ciò significa che, facendo riferimento alla grammatica di routing ({schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}) è possibile utilizzare un fragment differente per il componente {controller}.
Di seguito è riportata la lista di tali alias per il fragment {controller}, in ordine di preferenza d'uso.
Alias | Path |
---|---|
Orders | /api/v1/Orders |
Order | /api/v1/Order |
Authentication
Token JWT
Al fine di potere invocare le API REST, è necessario ottenere un token di autenticazione tramite l’apposito servizio /Auth/Login.
Per maggiori informazioni fare riferimento all'apposita sezione di questa guida.
Bearer Authentication
La "Bearer Authentication" (tradotta "autenticazione al portatore", detta anche "autenticazione token") è uno schema di autenticazione HTTP che coinvolge un token di sicurezza denominato bearer token.
Per maggiori informazioni fare riferimento all'apposita sezione di questa guida.
Identificazione dell’applicazione chiamante
Alcune delle funzioni delle API REST possono essere utilizzate solamente se (oltre ad una corretta autenticazione dell’utente) si esegue anche una dichiarazione dell’applicazione chiamante.
Per maggiori informazioni fare riferimento all'apposita sezione di questa guida.
Actions & Paths
Di seguito sono elencate le azioni REST eseguibili tramite le Web API.
Le azioni sono raggruppate per "topic".
Clicca un "topic" per visualizzare le diverse azioni in esso contenute.
Ad ogni azione corrisponde un metodo interno alla classe del controller Web API, ed un set di paths di routing utilizzabili per invocarla.
GET: /api/v1/Order/
Routing template:
/api/{version}/Order/
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
DELETE: /api/v1/Order/{id}
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: Boolean as application/json
- HTTP 200: Boolean as text/json
- HTTP 200: Boolean as application/xml
- HTTP 200: Boolean as text/plain
- HTTP 200: Boolean as application/octet-stream
Response: 200 (Success) Boolean
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/Archive
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
template | string | NO | Query |
|
request | OrderPrintableRequest | NO | Query |
|
Produces:
- HTTP 400: integer as application/json
- HTTP 400: integer as text/json
- HTTP 400: integer as application/xml
- HTTP 400: integer as text/plain
- HTTP 400: integer as application/octet-stream
- HTTP 400: integer as text/xml
Response: 400 (Bad Request) integer
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/Exists
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: Boolean as application/json
- HTTP 200: Boolean as text/json
- HTTP 200: Boolean as application/xml
- HTTP 200: Boolean as text/plain
- HTTP 200: Boolean as application/octet-stream
Response: 200 (Success) Boolean
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/FreeFields
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: FreeFieldsBOItemDTO as application/json
- HTTP 200: FreeFieldsBOItemDTO as text/json
- HTTP 200: FreeFieldsBOItemDTO as application/xml
- HTTP 200: FreeFieldsBOItemDTO as text/plain
- HTTP 200: FreeFieldsBOItemDTO as application/octet-stream
Response: 200 (Success) FreeFieldsBOItemDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/GetDownloadUrl
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
template | string | NO | Query |
|
request | OrderPrintableRequest | NO | Query |
|
Produces:
- HTTP 400: string as application/json
- HTTP 400: string as text/json
- HTTP 400: string as application/xml
- HTTP 400: string as text/plain
- HTTP 400: string as application/octet-stream
- HTTP 400: string as text/xml
Response: 400 (Bad Request) string
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/GetFull
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/GetHash
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: String as application/json
- HTTP 200: String as text/json
- HTTP 200: String as application/xml
- HTTP 200: String as text/plain
- HTTP 200: String as application/octet-stream
Response: 200 (Success) String
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/{id}/HtmlPreview
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
template | string | NO | Query |
|
request | OrderPrintableRequest | NO | Query |
|
Produces:
- HTTP 200: String as application/json
- HTTP 200: String as text/json
- HTTP 200: String as application/xml
- HTTP 200: String as text/plain
- HTTP 200: String as application/octet-stream
Response: 200 (Success) String
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/Humanize
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
DELETE: /api/v1/Order/{id}/Photo
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/Photo
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/{id}/Photo
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Consumes:
- multipart/form-data
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/{id}/Preview
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
page | integer | NO | Query |
|
zoom | integer | NO | Query |
|
template | string | NO | Query |
|
request | OrderPrintableRequest | NO | Query |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/{id}/Previews
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
template | string | NO | Query |
|
request | OrderPrintableRequest | NO | Query |
|
Produces:
- HTTP 400: array of FilePreview as application/json
- HTTP 400: array of FilePreview as text/json
- HTTP 400: array of FilePreview as application/xml
- HTTP 400: array of FilePreview as text/plain
- HTTP 400: array of FilePreview as application/octet-stream
- HTTP 400: array of FilePreview as text/xml
Response: 400 (Bad Request) array of FilePreview
Samples
Download Postman collection sample
Provalo !
PUT: /api/v1/Order/{id}/Recent
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
id | integer | YES | Path |
|
Produces:
- HTTP 200: Boolean as application/json
- HTTP 200: Boolean as text/json
- HTTP 200: Boolean as application/xml
- HTTP 200: Boolean as text/plain
- HTTP 200: Boolean as application/octet-stream
Response: 200 (Success) Boolean
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/ApplyCalculateTotalDocument
Routing template:
/api/{version}/Order/ApplyCalculateTotalDocument
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/CatalogCodeChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
POST: /api/v1/Order/CostChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/Count
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
filter | string | NO | Query |
|
Produces:
- HTTP 200: Int32 as application/json
- HTTP 200: Int32 as text/json
- HTTP 200: Int32 as application/xml
- HTTP 200: Int32 as text/plain
- HTTP 200: Int32 as application/octet-stream
Response: 200 (Success) Int32
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/CreateOrUpdate
Routing template:
/api/{version}/Order/CreateOrUpdate
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
DELETE: /api/v1/Order/DeleteByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
Produces:
- HTTP 200: Boolean as application/json
- HTTP 200: Boolean as text/json
- HTTP 200: Boolean as application/xml
- HTTP 200: Boolean as text/plain
- HTTP 200: Boolean as application/octet-stream
Response: 200 (Success) Boolean
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/DeleteByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
Produces:
- HTTP 200: Boolean as application/json
- HTTP 200: Boolean as text/json
- HTTP 200: Boolean as application/xml
- HTTP 200: Boolean as text/plain
- HTTP 200: Boolean as application/octet-stream
Response: 200 (Success) Boolean
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/DiscountFormulaChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetBoDeleteModes
Routing template:
/api/{version}/Order/GetBoDeleteModes
Produces:
- HTTP 200: BoDeleteMode as application/json
- HTTP 200: BoDeleteMode as text/json
- HTTP 200: BoDeleteMode as application/xml
- HTTP 200: BoDeleteMode as text/plain
- HTTP 200: BoDeleteMode as application/octet-stream
Response: 200 (Success) array of BoDeleteMode
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetIdsByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
excludeDeletedItems | boolean | NO | Query |
|
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) Int64
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/GetIdsMappedByExternalReference
Routing template:
/api/{version}/Order/GetIdsMappedByExternalReference
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/GetIdsNotMappedByExternalReference
Routing template:
/api/{version}/Order/GetIdsNotMappedByExternalReference
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/GetItemsMappedByExternalReference
Routing template:
/api/{version}/Order/GetItemsMappedByExternalReference
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/GetItemsNotMappedByExternalReference
Routing template:
/api/{version}/Order/GetItemsNotMappedByExternalReference
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetNewInstance
Routing template:
/api/{version}/Order/GetNewInstance
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetNewRowInstance
Routing template:
/api/{version}/Order/GetNewRowInstance
Produces:
- HTTP 200: ERPRowDTO as application/json
- HTTP 200: ERPRowDTO as text/json
- HTTP 200: ERPRowDTO as application/xml
- HTTP 200: ERPRowDTO as text/plain
- HTTP 200: ERPRowDTO as application/octet-stream
Response: 200 (Success) ERPRowDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/GetNewRowInstance
Routing template:
/api/{version}/Order/GetNewRowInstance
Produces:
- HTTP 200: ERPRowDTO as application/json
- HTTP 200: ERPRowDTO as text/json
- HTTP 200: ERPRowDTO as application/xml
- HTTP 200: ERPRowDTO as text/plain
- HTTP 200: ERPRowDTO as application/octet-stream
Response: 200 (Success) ERPRowDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetPolymorphicSchema
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
serializePropertiesAsDictionary | boolean | NO | Query |
|
honorAcceptLanguageHeader | boolean | NO | Query |
|
generateSample | boolean | NO | Query |
|
sampleGenerationStrategy | SampleGenerationStrategy | NO | Query |
|
useExtensions | boolean | NO | Query |
|
includeExplicitlyDeclaredVirtualProperties | boolean | NO | Query |
|
Produces:
- HTTP 400: object as application/json
- HTTP 400: object as text/json
- HTTP 400: object as application/xml
- HTTP 400: object as text/plain
- HTTP 400: object as application/octet-stream
Response: 400 (Bad Request) object
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetSample
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
force | boolean | NO | Query |
|
sampleGenerationStrategy | SampleGenerationStrategy | NO | Query |
|
useExtensions | boolean | NO | Query |
|
Produces:
- HTTP 200: JObject as application/json
- HTTP 200: JObject as text/json
- HTTP 200: JObject as application/xml
- HTTP 200: JObject as text/plain
- HTTP 200: JObject as application/octet-stream
Response: 200 (Success) JObject
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetStandardSchema
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
honorAcceptLanguageHeader | boolean | NO | Query |
|
Produces:
- HTTP 400: object as application/json
- HTTP 400: object as text/json
- HTTP 400: object as application/xml
- HTTP 400: object as text/plain
- HTTP 400: object as application/octet-stream
Response: 400 (Bad Request) object
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/GetSwagger
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
honorAcceptLanguageHeader | boolean | NO | Query |
|
bestPracticeOnly | boolean | NO | Query |
|
Produces:
- HTTP 200: object as application/json
- HTTP 200: object as text/json
- HTTP 200: object as application/xml
- HTTP 200: object as text/plain
- HTTP 200: object as application/octet-stream
Response: 200 (Success) object
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/MapByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
internalItemId | integer | NO | Query |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
DELETE: /api/v1/Order/MultipleDelete
Routing template:
/api/{version}/Order/MultipleDelete
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: DeleteItemResult as application/json
- HTTP 200: DeleteItemResult as text/json
- HTTP 200: DeleteItemResult as application/xml
- HTTP 200: DeleteItemResult as text/plain
- HTTP 200: DeleteItemResult as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/MultipleDelete
Routing template:
/api/{version}/Order/MultipleDelete
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: DeleteItemResult as application/json
- HTTP 200: DeleteItemResult as text/json
- HTTP 200: DeleteItemResult as application/xml
- HTTP 200: DeleteItemResult as text/plain
- HTTP 200: DeleteItemResult as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/MultipleExists
Routing template:
/api/{version}/Order/MultipleExists
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: ExistsItemResult as application/json
- HTTP 200: ExistsItemResult as text/json
- HTTP 200: ExistsItemResult as application/xml
- HTTP 200: ExistsItemResult as text/plain
- HTTP 200: ExistsItemResult as application/octet-stream
Response: 200 (Success) ApiActionResult
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/MultipleGet
Routing template:
/api/{version}/Order/MultipleGet
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
- text/xml
- application/*+xml
Produces:
- HTTP 200: GetItemResult`1 as application/json
- HTTP 200: GetItemResult`1 as text/json
- HTTP 200: GetItemResult`1 as application/xml
- HTTP 200: GetItemResult`1 as text/plain
- HTTP 200: GetItemResult`1 as application/octet-stream
Response: 200 (Success) ApiActionResult[]>
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/NewEmptyRow
Routing template:
/api/{version}/Order/NewEmptyRow
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
POST: /api/v1/Order/PriceListChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/PrintableFields
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
includeFull | boolean | NO | Query |
|
includeNesting | boolean | NO | Query |
|
Produces:
- HTTP 400: array of LiquidStruct as application/json
- HTTP 400: array of LiquidStruct as text/json
- HTTP 400: array of LiquidStruct as application/xml
- HTTP 400: array of LiquidStruct as text/plain
- HTTP 400: array of LiquidStruct as application/octet-stream
Response: 400 (Bad Request) array of LiquidStruct
Samples
Download Postman collection sample
Provalo !
POST: /api/v1/Order/ProcessOnChangeCurrency
Routing template:
/api/{version}/Order/ProcessOnChangeCurrency
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/ProcessOnChangeListId
Routing template:
/api/{version}/Order/ProcessOnChangeListId
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/QtaChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/ResetExternalReferences
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
internalItemId | integer | NO | Query |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/Search
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
filter | string | NO | Query |
|
orderBy | string | NO | Query |
|
skip | integer | NO | Query |
|
top | integer | NO | Query |
|
select | string | NO | Query |
|
Produces:
- HTTP 200: OrderDTO as application/json
- HTTP 200: OrderDTO as text/json
- HTTP 200: OrderDTO as application/xml
- HTTP 200: OrderDTO as text/plain
- HTTP 200: OrderDTO as application/octet-stream
Response: 200 (Success) OrderDTO
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/SearchIds
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
filter | string | NO | Query |
|
orderBy | string | NO | Query |
|
skip | integer | NO | Query |
|
top | integer | NO | Query |
|
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) Int64
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
GET: /api/v1/Order/SearchIdsByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
Produces:
- HTTP 200: Int64 as application/json
- HTTP 200: Int64 as text/json
- HTTP 200: Int64 as application/xml
- HTTP 200: Int64 as text/plain
- HTTP 200: Int64 as application/octet-stream
Response: 200 (Success) Int64
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
POST: /api/v1/Order/TaxCodeChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/Templates
Routing template:
/api/{version}/Order/Templates
Produces:
- HTTP 400: array of string as application/json
- HTTP 400: array of string as text/json
- HTTP 400: array of string as application/xml
- HTTP 400: array of string as text/plain
- HTTP 400: array of string as application/octet-stream
- HTTP 400: array of string as text/xml
Response: 400 (Bad Request) array of string
Samples
Download Postman collection sample
Provalo !
POST: /api/v1/Order/UnitMeasureChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
POST: /api/v1/Order/UnitPriceChanged
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
rowIndex | integer | NO | Query |
|
Consumes:
- application/json
- application/xml
- text/plain
- application/json-patch+json
- text/json
- application/*+json
Produces:
- HTTP 400: ERPRowDTO as application/json
- HTTP 400: ERPRowDTO as text/json
- HTTP 400: ERPRowDTO as application/xml
- HTTP 400: ERPRowDTO as text/plain
- HTTP 400: ERPRowDTO as application/octet-stream
- HTTP 400: ERPRowDTO as text/xml
Response: 400 (Bad Request) ERPRowDTO
Samples
Download Postman collection sample
Provalo !
GET: /api/v1/Order/UnmapByExternalReference
Parameters:
Name | Type | Required | In | Features |
---|---|---|---|---|
externalReference | string | NO | Query |
|
internalItemId | integer | NO | Query |
|
Response:
Samples
Download HTTP 200 response sample
Download Postman collection sample
Provalo !
Definizioni
Le definizioni a seguire descrivono la struttura dei datamodels coinvolti nelle diverse operazioni REST eseguibili per questo controller.
Alcune definizioni sono sottoposte a serializzazione polimorfica, e pertanto il loro schema polimorfico completo viene riportato.
Name | Description |
---|---|
Account_SkillDTO | Account_Skill |
AccountAccessLevel | Account Access Level |
AccountDTO | Account |
AccountStatus | Account Status |
AccountTierAccessPermitDTO | Account Tier Access Permit |
AddressAccuracy | Address Accuracy |
AddressDTO | Address |
AddressesListDTO | Addresses List |
AnagraphicStatus | Anagraphic Status |
BoDeleteMode | Bo Delete Mode |
BusinessObjectType | Business Object Type |
ContactDTO | Contact |
ContactOtherCompanyDTO | Contact Other Company |
CRMTables | CRM Tables |
CrossType | Cross Type |
DDTDTO | DDT |
DeleteItemResult | Delete Item Result |
DirectionDTO | Direction |
DTOPropertyUsage | DTO Property Usage |
EMailNormalizedDTO | EMail Normalized |
EMailNormalizeType | EMail Normalize Type |
ERPBaseCalcTotalDocumentResultDTO | ERP Base Calc Total Document Result |
ErpDocumentStatus | Erp Document Status |
ErpGroupingType | Erp Grouping Type |
ERPRowDocumentReferenceDTO | ERP Row Document Reference |
ERPRowDTO | ERP Row |
ERPRowExtensionDTO | ERP Row Extension |
ERPRowGroupingDTO | ERP Row Grouping |
ERPRowGroupingExtensionDTO | ERP Row Grouping Extension |
ERPRowType | ERP Row Type |
ExistsItemResult | Exists Item Result |
ExternalReferenceDTO | External Reference |
FilePreview | File Preview |
FreeFieldsBOItemDTO | Free Fields BO Item |
FreeFieldsBOItemLocalizingDTO | Free Fields BO Item Localizing |
FreeFieldsBOTreeItemDTO | Free Fields BO Tree Item |
FreeFieldsType | Free Fields Type |
Gender | Gender |
GeoDTO | Geo |
GetIdsMappedByExternalReferenceRequest | Get Ids Mapped By External Reference Request |
GetItemResult`1[] | Get Item Result`1 |
GetItemsMappedByExternalReferenceRequest | Get Items Mapped By External Reference Request |
Gravity | Gravity |
InvoiceBOTaxSummaryDTO | Invoice BO Tax Summary |
InvoiceDTO | Invoice |
InvoiceInstallmentDTO | Invoice Installment |
InvoiceShip | Invoice Ship |
InvoiceType | Invoice Type |
JToken | J Token |
LinkItem | Link Item |
LiquidStruct | Liquid Struct |
ListMailingListRightsDTO | List Mailing List Rights |
LocalizeType | Localize Type |
LocalizingDTO | Localizing |
LocationDTO | Location |
MailingListRightsDTO | Mailing List Rights |
MultipleDeleteModel | Multiple Delete Model |
MultipleExistsModel | Multiple Exists Model |
MultipleGetModel | Multiple Get Model |
NormalizerNormalizeAddressDTO | Normalizer Normalize Address |
NormalizerNormalizeCityDTO | Normalizer Normalize City |
NotifyAppointmentMode | Notify Appointment Mode |
ObjectPolicy | Object Policy |
OrderDTO | Order |
OrderPrintableRequest | Order Printable Request |
OrderStage | Order Stage |
PaymentMovementsBOMovementRowsDTO | Payment Movements BO Movement Rows |
PaymentMovementsDTO | Payment Movements |
PhoneNormalizedDTO | Phone Normalized |
PhoneNormalizeType | Phone Normalize Type |
PolicyKind | Policy Kind |
PrivacyManagementDTO | Privacy Management |
PrivacyTypeManagementDTO | Privacy Type Management |
QuoteDTO | Quote |
QuoteStage | Quote Stage |
RelationDTO | Relation |
RowContentType | Row Content Type |
RowTypeGiftVatMode | Row Type Gift Vat Mode |
SampleGenerationStrategy | Sample Generation Strategy |
ServiceCrossType | Service Cross Type |
SharePermissionDTO | Share Permission |
SharingDTO | Sharing |
ShippedBy | Shipped By |
SubAccountType | Sub Account Type |
SyncPropertyFlag | Sync Property Flag |
TypePrivacy | Type Privacy |
WebApiKeyDomainDTO | Web Api Key Domain |
WebApiKeyDTO | Web Api Key |
Errori
Le actions del controller possono generare errori per i seguenti casi:
- Stato 400: query mal strutturate (es. parametri codificati non correttamente)
- Stato 401: errori di autenticazione (es. chiavi o credenziali non riconosciute)
- Stato 403: Proibito. La richiesta era valida, ma il server rifiuta l'azione. L'utente potrebbe non disporre delle autorizzazioni necessarie per una risorsa o potrebbe aver bisogno di un account di qualche tipo.
- Stato 404: Non trovato, o risorsa sconosciuta
- Stato 409: Conflitto. Indica che la richiesta non può essere elaborata a causa di conflitti nello stato corrente della risorsa, ad esempio un conflitto di modifica tra più aggiornamenti simultanei.
- Stato 500: Errore interno del del server
Gli errori sono formattati in JSON
Versioning
E’ possibile selezionare la versione dei web services tramite il token {version}
/api/{version}/{controller}/{details}/{action}/{id}?{querystring}
Il token {version} può contenere sia valori “esatti”, sia l’alias speciale “latest”, che identifica la versione più recente tra quelle esistenti nel sistema.
In linea generale si raccomanda vivamente l’utilizzo dell’alias speciale “latest”.
Qualora si desideri essere particolarmente “conservativi” ed aderenti ad una specifica versione, specificarne il nome in modo esplicito (es. “v1”).
Routing
Il sistema utilizza la seguente sintassi di routing, costituita da una sequenza di "path-tokens" (i parametri della request):
{schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}
I tokens identificano rispettivamente:
- {host} -> HOST dell’URL
- {version} -> versione dei web services
- {controller} -> nome del servizio (controller) che si desidera invocare
- {details} -> livello opzionale di dettaglio del JSON ritornato (se pertinente)
- {action} -> azione opzionale (metodo) invocata nel controller
- {id} -> singolo argomento opzionale (parametro) di primary key del metodo nel controller, qualora esso lo preveda
- {querystring} -> parametri aggiuntivi ed eventuali "modificatori" del processo di elaborazione e serializzazione
OData
Le API REST sono internamente basate sulla tecnologia Microsoft WebAPI, e sono largamente compliant con le specifiche REST, OData v3 e OData v4.
Funzioni ed approfondimenti relativi a OData
Per maggiori approfondimenti e dettagli relativi ai criteri generali d'uso delle funzioni OData, fare riferimento alla guida di base sull'argomento
Opzioni
Le funzioni delle API REST implementate in CRM in Cloud includono un vasto set di opzioni che consentono di adattare struttura e forma dei pacchetti JSON in base alle proprie esigenze e preferenze.
Al contrario dei parametri, che vengono specificati nella route dell’URL (attraverso i tokens e la querystring), le opzioni devono invece essere passate tramite gli headers HTTP della request.
Come da RFC6648 tutte le opzioni passate tramite headers HTTP hanno nel proprio nome il prefisso custom “Crm-”.
Qualora una certa opzione non venga specificata, il sistema utilizzerà il valore di default specifico alla {version} indicata nell’URL.
Per una disquisizione completa relativa alle opzioni ed alla serializzazione polimorfica, fare riferimento alla guida generale sull'argomento
Swagger
Di seguito è possibile scaricare il descrittore JSON in formato Swagger/OpenAPI