{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This article contains information about main flows that may be used in scope of web shop integration process.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"We have type safe proxies for C#, typescript (JS), Kotlin, swift - this guide is however aimed at developers who do not implement for native IOS, Android or typescript (e.g. php developers).","type":"text"}]},{"type":"paragraph","content":[{"text":"If you need access to our proxies please contact us","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"6c77d1ea-1b22-4a51-b589-7927ca7a6757"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"105e59b0-0502-495d-9f91-5fcf5b7f7065"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"General info","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"CRS public API is exposed via Swagger by following URL:","type":"text"}]},{"type":"paragraph","content":[{"text":"{host_url}","type":"text","marks":[{"type":"strong"}]},{"text":"/","type":"text"},{"text":"{microservice_name}","type":"text","marks":[{"type":"strong"}]},{"text":"/swagger/","type":"text"}]},{"type":"paragraph","content":[{"text":"where ","type":"text"},{"text":"{host_url}","type":"text","marks":[{"type":"strong"}]},{"text":"- URL of CRS instance to integrate (for example, ","type":"text"},{"text":"https://prod02shadow.cloudretailsystems.dk/","type":"text","marks":[{"type":"link","attrs":{"href":"https://prod02shadow.cloudretailsystems.dk/"}}]},{"text":"),","type":"text"}]},{"type":"paragraph","content":[{"text":"{microservice_name}","type":"text","marks":[{"type":"strong"}]},{"text":" - name of microservice, which feature is supposed to be used. In scope of web shop integration following microservice names will be used:","type":"text"}]},{"type":"paragraph","content":[{"text":"\"security\",","type":"text"}]},{"type":"paragraph","content":[{"text":"\"inventory\",","type":"text"}]},{"type":"paragraph","content":[{"text":"\"financial\",","type":"text"}]},{"type":"paragraph","content":[{"text":"\"media\",","type":"text"}]},{"type":"paragraph","content":[{"text":"\"actors\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Further I will provide only minimal request body that is needed for specific query/operation, extra request fields are exposed in Swagger UI.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also it is worth to read following document in order to get short CRS API reference: ","type":"text"},{"text":"https://mbsolutionsgroup.atlassian.net/wiki/spaces/MBSG/pages/44512/API","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/MBSG/pages/44512"}}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Basic information for all requests","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP word - POST","type":"text"}]},{"type":"paragraph","content":[{"text":"All requests should contain header Content-Type - application/json.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Work with Get[Something]Page requests","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"in CRS often used way possibility to fetch some entities page-by-page. All requests for such cases use some generic properties:","type":"text"}]},{"type":"paragraph","content":[{"text":"[offset]","type":"text","marks":[{"type":"strong"}]},{"text":" - current page start (for first page - 0),","type":"text"}]},{"type":"paragraph","content":[{"text":"[count]","type":"text","marks":[{"type":"strong"}]},{"text":" - current page size,","type":"text"}]},{"type":"paragraph","content":[{"text":"[includeOverallEntryCount]","type":"text","marks":[{"type":"strong"}]},{"text":" - optional fields that indicates that along with entities of current page response should contain information about how many entities exists at all for filter and sort info described in request.","type":"text"}]},{"type":"paragraph","content":[{"text":"Following approach may be used to fetch all entities by filter page-by-page:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"should be considered [page_size] (for example 100).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in first products page request","type":"text"},{"text":" [offset]","type":"text","marks":[{"type":"strong"}]},{"text":" should be 0, ","type":"text"},{"text":"[count]","type":"text","marks":[{"type":"strong"}]},{"text":" should be [page_size] and ","type":"text"},{"text":"[includeOverallEntryCount] ","type":"text","marks":[{"type":"strong"}]},{"text":"should be true. Then in response value along with 100 entities of first page in property \"entries\" will be available property [overallEntryCount]\" with entire count of products that can be fetched by this request parameters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For next request [offset] should be amount of already fetched entities, page size should be the same and ","type":"text"},{"text":"[includeOverallEntryCount] ","type":"text","marks":[{"type":"strong"}]},{"text":" should be false because we already know count for example: request 2: [offset] = 1*page_size, [count] = page_size, request 3: [offset] = 2*page_size, [count] = page_size, and so on till all products will be fetched.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"I suggest to set ","type":"text"},{"text":"[includeOverallEntryCount] ","type":"text","marks":[{"type":"strong"}]},{"text":"only for request of first page because for other pages with same filter overall count will remains immutable and its' calculation is time-consuming.","type":"text"}]},{"type":"paragraph","content":[{"text":"This offset/count management approach may be used in all cases when data should be fetched by pages.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next will be enlisted set of operations that will be needed for web shop integration.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Authentication ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Login/get user token","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/security/Authentication/Login","type":"text"},{"type":"hardBreak"},{"text":"Minimal Request: ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"userNameOrEMail\": \"your_username\",\n\t\"password\": \"your_password\",\n\t\"tenantDomainName\": \"your_tenant\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"In case of happy flow response will contain token ","type":"text"},{"type":"hardBreak"},{"text":"Response:","type":"text"},{"type":"hardBreak"},{"text":"All CRS responces contains errorOrValue property, which field [error] will be null in happy flow and field value will contain operation result.","type":"text"},{"type":"hardBreak"},{"text":"In case of successful authentication response will contain [\"token\"] field that need to be used as ","type":"text"},{"text":"[Authorization]","type":"text","marks":[{"type":"strong"}]},{"text":" header of all next requests.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Actors integration","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create actor","type":"text"}]},{"type":"paragraph","content":[{"text":"Actor creation flow is described in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://mbsolutionsgroup.atlassian.net/wiki/spaces/CPSP/pages/2958491652"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that customer need to have one of the customer roles (that have system name \"CustomerPerson\" or \"CustomerOrganization\");","type":"text"},{"type":"hardBreak"},{"text":"Response will contain list of variants of product.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get Actor","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/actors/Actor/GetActor","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n { \n \"id\":actor_id,\n \"propertiesToLoad\": { \"value\": }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"[propertiesToLoad] ","type":"text","marks":[{"type":"strong"}]},{"text":"- flag enumeration with following options:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"FieldSet = 1,\nWebAddresses = 2,\nEmails = 4,\nAddresses = 8,\nFields = 16,\nGroups = 32,\nPhones = 64,\nRoles = 128,\nUser = 256,\nRelations = 512,\nPaymentInfo = 1024,\nWorkingHours = 2048,\nExternalDataRecord = 4096","type":"text"}]},{"type":"paragraph","content":[{"text":"E.g. to load FieldSet and Email we need to either use bit AND operation or just sum, so 1+4=5 in our case.","type":"text"}]},{"type":"paragraph","content":[{"text":"[propertiesToLoad] ","type":"text","marks":[{"type":"strong"}]},{"text":"is an optional property, if it is not defined all actor properties will be loaded.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get actors(paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/actors/actor/GetActorsPage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"sortInfo\":[\n ],\n \"propertiesToLoad\": ,\n \"offset\":0,\n \"count\":page_size,\n \"includeOverallEntryCount\":true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"[propertiesToLoad] ","type":"text","marks":[{"type":"strong"}]},{"text":"- flag enumeration with same options that also used in GetActor call (see previous chapter).","type":"text"}]},{"type":"paragraph","content":[{"text":"Following optional filters are available and need to be mentioned:","type":"text"}]},{"type":"paragraph","content":[{"text":"[RoleSystemName]","type":"text","marks":[{"type":"strong"}]},{"text":"- allows to filter actors by specific role","type":"text"},{"type":"hardBreak"},{"text":"[SearchPattern]","type":"text","marks":[{"type":"strong"}]},{"text":" - allows to filter actor which person or organization name, phone, email or customer identifier satisfies search pattern","type":"text"},{"type":"hardBreak"},{"text":"[ModifiedAtFrom]","type":"text","marks":[{"type":"strong"}]},{"text":" - allows to filter actors modified after specific timestamp","type":"text"},{"type":"hardBreak"},{"text":"[ModifiedAtTo]","type":"text","marks":[{"type":"strong"}]},{"text":" - allows to filter actors modified before specific timestamp","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Get customers page:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"sortInfo\":[\n ],\n \"propertiesToLoad\": ,\n \"offset\":0,\n \"count\":50,\n \"includeOverallEntryCount\":true,\n \"roleSystemName\":{\n \"value\":\"Customer\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Get suppliers page:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"sortInfo\":[\n ],\n \"propertiesToLoad\": ,\n \"offset\":0,\n \"count\":50,\n \"includeOverallEntryCount\":true,\n \"roleSystemName\":{\n \"value\":\"Supplier\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Get page of actors by search pattern that were modified in date range:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"sortInfo\": [],\n \"propertiesToLoad\": ,\n \"offset\": 0,\n \"count\": 50,\n \"includeOverallEntryCount\": true,\n \"modifiedAtFrom\": {\n \"value\": \"2020-01-01T18:25:43.511Z\"\n },\n \"modifiedAtTo\": {\n \"value\": \"2021-01-01T18:25:43.511Z\"\n },\n \"searchPattern\": {\n \"value\": \"aa\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Inventory integration ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product categories ","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/ProductCategory/GetProductCategories","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain list of all product categories.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get products (paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/Product/GetProductPage","type":"text"}]},{"type":"paragraph","content":[{"text":"Detailed usage of GetProductPage method is described in ","type":"text"},{"text":"GetProductPage usage","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CPSP/pages/2952593414"}}]},{"text":" document. Please read this document first.","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"propertiesToLoad\": {\n\t\t\"value\": \n\t},\n\t\"offset\": 0,\n\t\"count\": page_size,\n\t\"includeOverallEntryCount\": true,\n\t\"modifiedAfter\": {\n\t\t\"value\": \"2017-09-26T12:52:29.960Z\"\n\t}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"[modifiedAfter]","type":"text","marks":[{"type":"strong"}]},{"text":" indicate that we need all products that were modified after specific date. In case when we are need all products - this field should be null.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each product have properties ","type":"text"},{"text":"[isProductInstancesSupported]","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"[isProductVariantsSupported]","type":"text","marks":[{"type":"strong"}]},{"text":", and ","type":"text"},{"text":"[productImages]","type":"text","marks":[{"type":"strong"}]},{"text":" that need to be analyzed in order to fetch additional product data.","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"[isProductInstancesSupported]","type":"text","marks":[{"type":"strong"}]},{"text":" is true, variants for products need to be fetched,","type":"text"},{"type":"hardBreak"},{"text":"If","type":"text"},{"text":" [isProductVariantsSupported]","type":"text","marks":[{"type":"strong"}]},{"text":" is true, product instances need to be fetched,","type":"text"},{"type":"hardBreak"},{"text":"If collection of ","type":"text"},{"text":"[productImages]","type":"text","marks":[{"type":"strong"}]},{"text":" is not empty - product image files may be fetched.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product variants","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/ProductVariant/GetProductVariants","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"productId\": {\n\t\t\"value\": product_id\n\t}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain list of variants of product.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that product variant entity does not contain overridable properties ","type":"text"},{"text":"[isEnabled] ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"[CostPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"and property ","type":"text"},{"text":"[SalesPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"of ProductVariant entity does does not contain overridable value for current stock organizational unit, it contains root sales price value.","type":"text"}]},{"type":"paragraph","content":[{"text":"To get actual values of ","type":"text"},{"text":"[isEnabled] ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"[CostPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"[SalesPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"properties of variants need to be considered ProductVariantInfo entity","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product variant infos","type":"text"}]},{"type":"paragraph","content":[{"text":"Product variant in","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/ProductVariant/GetProductVariantInfos","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"productId\": {\n\t\t\"value\": product_id\n\t}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain list of variants of product in ProductVariantInfo format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also may be specified parameter","type":"text"},{"text":" [OrganizationUnitId] ","type":"text","marks":[{"type":"strong"}]},{"text":"to be sure that ","type":"text"},{"text":"[isEnabled] ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"[CostPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"[SalesPrice] ","type":"text","marks":[{"type":"strong"}]},{"text":"overridable properties will be got for specific organizational unit. In case when ","type":"text"},{"text":"[OrganizationUnitId] ","type":"text","marks":[{"type":"strong"}]},{"text":"is not defined, overridable properties will be filled for Organizational unit to which user is logged in.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product variant infos (paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POS","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/ProductInstance/GetProductVariantInfoPage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"offset\": 0,\n\t\"count\": page_size,\n\t\"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain pages with product product variants according to filter.","type":"text"}]},{"type":"paragraph","content":[{"text":"[productIds]","type":"text","marks":[{"type":"strong"}]},{"text":" and","type":"text"},{"text":" [modifiedAfter] ","type":"text","marks":[{"type":"strong"}]},{"text":"may be specified in order to narrow paged result.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product instances (paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POS","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/ProductInstance/GetProductInstancePage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"productIds\": {\n\t\t\"value\": [\n\t\t\tproduct_id\n\t\t]\n\t},\n\t\"offset\": 0,\n\t\"count\": page_size,\n\t\"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain pages with product instances according to filter. Multiple products may be enlisted in request.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product /product variant image","type":"text"}]},{"type":"paragraph","content":[{"text":"Product and ProductVariant entities contains collection named ProductImages.","type":"text"},{"type":"hardBreak"},{"text":"Each product image along with other properties contain property [mediaItemId] using which product image can be fetched from media storage","type":"text"}]},{"type":"paragraph","content":[{"text":"First need to be fetched media item information:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/media/MediaItem/GetMediaItem","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"id\": media_item_id\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Response will contain information about mime type, file name and extension, creation information, file name etc.","type":"text"}]},{"type":"paragraph","content":[{"text":"Then need to be fetched media item itself:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" GET","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/media/MediaItem/GetMediaItemStream","type":"text"},{"type":"hardBreak"},{"text":"Parameters:","type":"text","marks":[{"type":"strong"}]},{"text":" Id:mediaItemId","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will contain media item stream.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product availability","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockEntry/GetProductAvailability","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"productIdentifier\": {\n\t\t\"productId\": product_id,\n\t},\n\t\"organizationalUnitId\": {\n\t\t\"value\": organizational_unit_id\n\t}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response will be list of availability records for product in selected organizational unit.","type":"text"},{"type":"hardBreak"},{"text":"In ","type":"text"},{"text":"[productIdentifier]","type":"text","marks":[{"type":"strong"}]},{"text":" parameter may be also set ","type":"text"},{"text":"[variantId]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[instanceId]","type":"text","marks":[{"type":"strong"}]},{"text":" (if product support variants and instances and we need to know availability for specific variant and instance).","type":"text"}]},{"type":"paragraph","content":[{"text":"In case when ","type":"text"},{"text":"[instanceId]","type":"text","marks":[{"type":"strong"}]},{"text":" is not set- in result will be availability rows for all instances for product/variant combination.","type":"text"},{"type":"hardBreak"},{"text":"In case when ","type":"text"},{"text":"[variantId]","type":"text","marks":[{"type":"strong"}]},{"text":" is not set - in result will be availability rows for all variants /instances for product.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get product availability (paged)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockEntry/GetProductAvalibilityPage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"organizationalUnitId\": organizational_unit_id,\n \"offset\": 0,\n \"count\": page_size,\n \"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"[updatedAtFrom]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[updatedAtTo] ","type":"text","marks":[{"type":"strong"}]},{"text":"may be specified to retrieve product availability results for products which availability was changed within specific time interval.","type":"text"}]},{"type":"paragraph","content":[{"text":"organizational_unit_id ","type":"text","marks":[{"type":"strong"}]},{"text":"is organizational unit id (Root organizational unit id = -1) for which availability need to be fetched.","type":"text"}]},{"type":"paragraph","content":[{"text":"[productIds]","type":"text","marks":[{"type":"strong"}]},{"text":" and","type":"text"},{"text":" [categoryIds] ","type":"text","marks":[{"type":"strong"}]},{"text":"may be specified in order to narrow paged result for specific product categories or products.","type":"text"}]},{"type":"paragraph","content":[{"text":"Paged result will contain page of entities of type ","type":"text"},{"text":"GetProductAvailabilityResult ","type":"text","marks":[{"type":"strong"}]},{"text":"each of them will contain availability items for specific organizational unit in ","type":"text"},{"text":"Items","type":"text","marks":[{"type":"strong"}]},{"text":" collection and ","type":"text"},{"text":"StockItem ","type":"text","marks":[{"type":"strong"}]},{"text":"property in which ","type":"text"},{"text":"ProductId ","type":"text","marks":[{"type":"strong"}]},{"text":"is product Id and properties ","type":"text"},{"text":"VariantId","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"InstanceId","type":"text","marks":[{"type":"strong"}]},{"text":" will be always null for this request.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note following:","type":"text"}]},{"type":"paragraph","content":[{"text":"a) For products that supports variants and instances availability items in response will be grouped by product so ","type":"text"},{"text":"GetProductAvailabilityResult ","type":"text","marks":[{"type":"strong"}]},{"text":"will contain availability entries for all variants and all instance of specific product in ","type":"text"},{"text":"Items","type":"text","marks":[{"type":"strong"}]},{"text":" collection and they need to be grouped by variant and instance on client side in case of need.","type":"text"}]},{"type":"paragraph","content":[{"text":"b) In case when ","type":"text"},{"text":"[updatedAtFrom]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[updatedAtTo] ","type":"text","marks":[{"type":"strong"}]},{"text":"is specified, will be returned availability for products which availability is changed within time interval but will be presented all availability records, not change (delta) rows. In other worls ","type":"text"},{"text":"[updatedAtFrom]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[updatedAtTo] ","type":"text","marks":[{"type":"strong"}]},{"text":"need to be used to narrow the range of products for which availability will be fetched but always all availability rows for product will be returned.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get stock entries (paged)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockEntry/GetStockEntryPage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"offset\": 0,\n\t\"count\": page_size,\n\t\"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"May also be specified product/variant/instance id and organizational_unit_id in order to narrow results.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"[updatedAtFrom]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[updatedAtTo] ","type":"text","marks":[{"type":"strong"}]},{"text":"may be specified to retrieve stock stock entries created or updated within specific time interval.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Missing/planning features :","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"filter [createdAtFrom] in order to get entries created after specific date","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"filter [productCategoryIds] in order to get entries for products of specific category","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"filters [productId], [variantId] and [instanceId] should be plural.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Stock integration","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"General information","type":"text"}]},{"type":"paragraph","content":[{"text":"It is may be needed to add/remove products from stock directly. Common flow to do it is :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"select stock draft;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create stock appendix for this stock draft;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add set of stock draft entries to created stock appendix;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Book stock draft (in case when stock draft have IsAutoBookPossible = true, booking will be performed on moment of stock draft entries creation);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that booking was ended with success.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get existing stock drafts","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraft/GetAllStockDraftsDescriptors","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method returns list of descriptors of existing stock drafts. Each descriptor have an Id property that may be used to create an appendix based on stock draft","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create stock appendix","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockAppendicies/CreateStockAppendix","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1,\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Extended request example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1,\n \"description\" -- optional: {\n \"value\": \"my appendix\"\n },\n \"stockAppendixSource\" -- optional: {\n \"value\": {\n \"sourceType\": \"invoice\",\n \"sourceId\": {\n \"value\": [my_invoice_id]\n },\n \"sourceIdentifier\": {\n \"value\": [my_invoice_identifier]\n },\n \"alternativeAppendixNumber\": {\n \"value\": [invoice_identifier for example]\n }\n }\n },\n \"userDefinedAppendixNumber\": -- optional:{\n \"value\": [my_invoice_identifier]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to mention that stock appendix was created based on invoice, sales order or other entity not from inventory by specifying stockAppendixSource in create command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also in some cases it is handy to specify userDefinedAppendixNumber to create appendix with custom number instead of auto-generated.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that userDefinedAppendixNumber should not be in range of any of stock appendix number series in this metadata record.","type":"text"}]},{"type":"paragraph","content":[{"text":"Method returns structure with created appendix Id and appendix number. Appendix Id will be used in next methods to create stock draft entries.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create stock draft entries","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraftEntry/CreateStockDraftEntries","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockAppendixId\": [stock appendix id of previous call result],\n \"stockDraftEntrySources\": [collection of stock draft entry sources.\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method allows to create multiple stock draft entries. Request property stockDraftEntrySources should contain a collection of StockDraftEntrySource objects of following format:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockAppendixId\": [stock appendix ,\n \"stockDraftEntrySources\": [\n {\n \"customerActorId\" --optional: {\n \"value\": [my customer actor id]\n },\n \"supplierActorId\": --optional{\n \"value\": [my supplier actor id]\n },\n \"description\": --optional{\n \"value\": \"[my stock draft entry description]\"\n },\n \"costPrice\": --optional{\n \"value\": [my cost price]\n },\n \"salesPrice\": --optional{\n \"value\": [my sales price]\n },\n \"source\": --optional{\n \"value\": {\n \"kind\": \"PurchaseDelivery = 1\",\n \"identifier\": \"string\"\n }\n },\n \"organizationalUnitId\": -1,\n \"stockDate\": \"2020-06-26T06:04:13.637Z\",\n \"productId\": 1,\n \"variantId\": [may be null],\n \"count\": 1,\n \"instanceIds\": --optional {\n \"value\": [\n \t1\n ]\n },\n \"productLocationId\": 1,\n \"externalReference\": --optional{\n \"value\": {\n \"sourceType\": \"[invoice for example]\",\n \"sourceId\": [invoice id for example]\n }\n },\n \"creditNoteExternalReference\": --optional: {\n \"value\": {\n \"sourceType\": \"string\",\n \"sourceId\": 0\n }\n }\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Response of this method will contain references for created stock draft entries with their ids.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some of stock drafts have a property IsAutoBookPossible = true. In this case created stock draft entries will be booked just after creation and response will also contain Book operation result. In \"Start booking of stock draft entries\" and \"Checking stock draft booking operation state\" sections below is described how to analyze booking operation result. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get stock draft entries (paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraftEntry/GetStockDraftEntriesPage","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockAppendixId\": 0,\n \"offset\": 0,\n \"count\": 10,\n \"includeOverallEntryCount\": false\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Extended request example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1,\n \"productId\": {\n \"value\": [product id filter]\"\n },\n \"description\": {\n \"value\": \"[description filter]\"\n },\n \"costPrice\": {\n \"value\": {\n \"from\": [cost price filter min],\n \"to\": [cost price filter max]\n }\n },\n \"productCategoryIds\": {\n \"value\": [\n product category ids to filter\n ]\n },\n \"productLocationIds\": {\n \"value\": [\n product location ids to filter\n ]\n },\n \"organizationalUnitIds\": {\n \"value\": [\n organizational unit ids to filter\n ]\n },\n \"calculateTotalCostPrice\": {\n \"value\": true\n },\n \"offset\": 0,\n \"count\": 10,\n \"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Method allows to fetch stock draft entries of stock draft page by page. Various filters may by be specified","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete stock draft entry","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraftEntry/RemoveStockDraftEntry","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftEntryId\": 1\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method allows to delete stock draft entry by Id","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete all stock draft entries from stock draft","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraft/ClearStockDraft","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method allows to delete all stock draft entries from stock draft.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Start booking of stock draft entries","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraft/BookStockDraftEntries","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Extended request example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"stockDraftId\": 1,\n \"productCategoryIds\": {\n \"value\": [\n 0\n ]\n },\n \"productLocationIds\": {\n \"value\": [\n 0\n ]\n },\n \"organizationalUnitIds\": {\n \"value\": [\n 0\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method is intended to start stock draft booking operation. In response will be following structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"\"requisitionId\": 1,\n \"state\": {\n \"state\": \"1\",\n \"resultCode\": \"1\",\n \"faultedAppendixNo\": 0,\n \"htmlErrorMessage\": \"string\"\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"where requisitionId property contains the created stock booking operation requisition using which it is possible to track booking operation state. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Property [state] contains state of booking operation at current moment. It is also contains property named [state], which is enum of type BookingOperationRequisitionStateKind with following values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"InProgress = 1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Success = 2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Failed = 3,","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Checking stock draft booking operation state ","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/inventory/StockDraft/GetStockBookingOperationState","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"id\": [requistion id of previous call result]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Method allows to check state of stock draft booking operation. As Id should be used requisitionId of result of BookStockDraftEntries call. Response of method have following structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"errorOrValue\": {\n \"value\": {\n \"resultCode\": \"11\",\n \"value\": {\n \"state\": \"1\",\n \"resultCode\": \"1\",\n \"faultedAppendixNo\": 0,\n \"htmlErrorMessage\": \"error_text\"\n }\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":" To make sure that operation was ended well, after BookStockDraftEntries need to be organized poling of GetStockBookingOperationState till [state] property of result will contain BookingOperationRequisitionStateKind.Success or BookingOperationRequisitionStateKind.Failed. In case of BookingOperationRequisitionStateKind.Failed [htmlErrorMessage] property need to be analyzed to get a clue about fail reason.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Financial integration ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"General information","type":"text"}]},{"type":"paragraph","content":[{"text":"In this section will be described integration with financial microservice - creating and processing of sales order and invoice.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to create and process sales order following steps need to be performed: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create sales order,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set sales order as ready.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Invoice (or set of invoices) based on sales order,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Book invoice.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In order to create and process invoice - following steps need to be performed: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create blank invoice,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Book invoice.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Sales prices and amounts are considered to include VAT part by default, e.g. price, discount or total amount on invoice.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get sales orders (paged)","type":"text"}]},{"type":"paragraph","content":[{"text":"Word: POST","type":"text"},{"type":"hardBreak"},{"text":"URL: {host_url}/api/financial/SalesOrder/GetSalesOrdersPage","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal request:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"offset\": 0,\n\t\"count\": page_size,\n\t\"includeOverallEntryCount\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Set of properties of sales order which will be included in response may be defined in propertiesToLoad property of request. This is a flag enum of type SalesOrderProperties with following values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Basic = 0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SalesOrderItems = 1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tasks = 2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ConvertRecord = 4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ConvertSource = 8","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type = 16","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EavFieldValues = 32","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SalesOrderItemState = 64","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SalesOrderItemDiscounts = 128","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TypeDetails = 256","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Flags may be combined by “|” operator in order to fetch more then one property.","type":"text"}]},{"type":"paragraph","content":[{"text":"So minimal request to specify sales order properties to load will be","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"propertiesToLoad\":{\n \"value\":32 // Eav field values in this case\n },\n \"offset\":0,\n \"count\":10,\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Following optional filters are available and need to be mentioned:","type":"text"}]},{"type":"paragraph","content":[{"text":"[createdAt]","type":"text","marks":[{"type":"strong"}]},{"text":"- filter by creation date;","type":"text"}]},{"type":"paragraph","content":[{"text":"[updatedAt]","type":"text","marks":[{"type":"strong"}]},{"text":"- filter by update date;","type":"text"}]},{"type":"paragraph","content":[{"text":"[numericIdentifier]","type":"text","marks":[{"type":"strong"}]},{"text":"- filter by numeric identifier range;","type":"text"}]},{"type":"paragraph","content":[{"text":"[salesOrderStates]","type":"text","marks":[{"type":"strong"}]},{"text":"- filter by states;","type":"text"}]},{"type":"paragraph","content":[{"text":"[salesOrderDispatchStates]","type":"text","marks":[{"type":"strong"}]},{"text":"- filter by dispatch states.","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal request which utilizes these filters will be:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"offset\":0,\n \"count\":10,\n \"createdAt\":{\n \"value\":{\n \"from\":\"2021-09-07T00:00:00+03:00\",\n \"to\":\"2021-09-07T23:59:59+03:00\"\n }\n },\n\n \"updatedAt\":{\n \"value\":{\n \"from\":\"2021-09-07T00:00:00+03:00\",\n \"to\":\"2021-09-07T23:59:59+03:00\"\n }\n },\n\n \"numericIdentifier\":{\n \"value\":{\n \"from\":100,\n \"to\":200\n }\n },\n \"salesOrderStates\":{\n \"value\":[\n 1\n ]\n },\n \"salesOrderDispatchStates\":{\n \"value\":[\n 3\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create sales order","type":"text"}]},{"type":"paragraph","content":[{"text":"To create sales order following data is need to be collected to create it:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Customer information - customer should be created/selected in Actors micro service","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Contact information - optional ( address, email, phone). Contact information is supposed to be entered by user in web shop but can be defaulted by customer data,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sale items information.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Get product financial and VAT data","type":"text"}]},{"type":"paragraph","content":[{"text":"To compose sales order item along with data presented on product also need to be provided VAT data from VAT type. VAT type to be taken from financial account.","type":"text"}]},{"type":"paragraph","content":[{"text":"Financial account need to be taken from accounting microservice by ","type":"text"},{"text":"[account_number]","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"In default case -","type":"text"},{"text":" [account_number]","type":"text","marks":[{"type":"strong"}]},{"text":" = ","type":"text"},{"text":"[SalesAccountNumber]","type":"text","marks":[{"type":"strong"}]},{"text":" taken from product's category","type":"text"}]},{"type":"paragraph","content":[{"text":"If product instance is specified and it is marked as used - ","type":"text"},{"text":"[account_number]","type":"text","marks":[{"type":"strong"}]},{"text":" = ","type":"text"},{"text":"[UsedSalesAccountNumber]","type":"text","marks":[{"type":"strong"}]},{"text":" taken from product's category","type":"text"}]},{"type":"paragraph","content":[{"text":"Product category financial accounts data is depends on Stock Organizational Unit in which Web Shop operates and may be retrieved from product (which for example retrieved by GetProductPage method with Category included) by following way:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"Product.Category.OverridableProperties.FirstOrDefault(it=>it.OrganizationalUnitId ==StockOrganizationalUnitId).Item","type":"text"}]},{"type":"paragraph","content":[{"text":"Item is an instance of tyoe ProductCategoryProps which have following properties:","type":"text"}]},{"type":"paragraph","content":[{"text":"SalesAccountNumber, ","type":"text"},{"type":"hardBreak"},{"text":"SalesAccountWithoutVatNumber,","type":"text"},{"type":"hardBreak"},{"text":"DiscountAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"UsedSalesAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"AdditionStockAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"SubstractionStockAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"UsedAdditionStockAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"UsedSubstractionStockAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"CostOfSalesAccountNumber,","type":"text"},{"type":"hardBreak"},{"text":"UsedCostOfSalesAccountNumber","type":"text"}]},{"type":"paragraph","content":[{"text":"And among them are presented properties ","type":"text"},{"text":"[SalesAccountNumber]","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"[UsedSalesAccountNumber]","type":"text","marks":[{"type":"strong"}]},{"text":" that is needed to continue.","type":"text"}]},{"type":"paragraph","content":[{"text":"To get financial account by number please use:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/accounting/FinancialAccount/GetFinancialAccountByNumber","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n { \n \"number\":account_number\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Account may have or may not have VAT type.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create sales order","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Before create of sales order we need to have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[customer] ","type":"text","marks":[{"type":"strong"}]},{"text":"- taken from actor microservice","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[address]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional) - user input, defaulted by actor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[email]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional)- user input, defaulted by actor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[phone]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional)- user input, defaulted by actor","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To compose sales order item we need to have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product]","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_category]","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_variant]","type":"text","marks":[{"type":"strong"}]},{"text":" if product supports variants - variant is required","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_instance]","type":"text","marks":[{"type":"strong"}]},{"text":" if product supports instances - instance is required","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[financial_account_number]","type":"text","marks":[{"type":"strong"}]},{"text":"- taken by rules described above","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[vat_type]","type":"text","marks":[{"type":"strong"}]},{"text":" - taken from accounting microservice by financial account number","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[sales_price] -","type":"text","marks":[{"type":"strong"}]},{"text":" calculated by following rule: If product instance is selected and its sales price is not null- product instance's sales price. If not- check variant. If variant is selected and its sales price is not null- variant's sales price. If sales price still not calculated - should be used sales price from product. [sales_price] is considered to include VAT part.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[quantity]","type":"text","marks":[{"type":"strong"}]},{"text":" - user input. Please note that quantity should be 1 for sales order items where product instance is defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[manual_discount]","type":"text","marks":[{"type":"strong"}]},{"text":" - user input. Sale item amount will be calculated as [sales_price] * [quantity]. If it is needed to register sale item with different amount - [manual_discount] should be specified","type":"text"},{"type":"hardBreak"},{"text":"All enlisted entities will be used in example below. [manual_discount] is considered to include VAT part.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[cost_price] - ","type":"text","marks":[{"type":"strong"}]},{"text":"the rule is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"take cost price from instance, if any","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"take cost price from variant, if any","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"take cost price from product, if it is null and ","type":"text"},{"text":"product.isDefaultCostPriceApplicable = true ","type":"text","marks":[{"type":"strong"}]},{"text":"then ","type":"text"},{"text":"product","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"text":"defaultCostPrice ","type":"text","marks":[{"type":"strong"}]},{"text":"should be used","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/SalesOrder/CreateSalesOrder","type":"text"}]},{"type":"paragraph","content":[{"text":"Command contain collection ","type":"text"},{"text":"[modelUpdates]","type":"text","marks":[{"type":"strong"}]},{"text":" and all sale manipulation should be done via model updates.","type":"text"},{"type":"hardBreak"},{"text":"Model update type can be specified by placing it's name to ","type":"text"},{"text":"[modelType]","type":"text","marks":[{"type":"strong"}]},{"text":" property.","type":"text"},{"type":"hardBreak"},{"text":"Following model updates are supported for invoice creation:","type":"text"}]},{"type":"paragraph","content":[{"text":"ChangeSalesOrderModelUpdate ","type":"text","marks":[{"type":"strong"}]},{"text":"- to manage sales order properties,","type":"text"},{"type":"hardBreak"},{"text":"CreateSalesOrderItemModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to create sales order item,","type":"text"},{"type":"hardBreak"},{"text":"ChangeSalesOrderItemModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to change sales order item,","type":"text"},{"type":"hardBreak"},{"text":"DeleteSalesOrderItemsModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to delete sales order item","type":"text"},{"type":"hardBreak"},{"text":"SetSalesOrderCustomerDataModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to specify actor and contact information.","type":"text"},{"type":"hardBreak"},{"text":"There may be many model updates of any type in command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are these model updates in detail:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"IChangeSalesOrderModelUpdate {\n\tpublic static readonly modelTypeName: string = \"ChangeSalesOrderModelUpdate\";\n\tcustomerReferenceNumber: IOptional|undefined;\n\tinternalNoteSource: IOptional|undefined;\n\tinvoiceDate: IOptional|undefined;\n\tisCostPriceOrder: IOptional|undefined;\n\tisExemptVat: IOptional|undefined;\n\tisPaymentTermChangedManually: IOptional|undefined;\n\tmaxTotal: IOptional|undefined;\n\torganizationalUnitId: IOptional|undefined;\n\totherPayer: IOptional|undefined;\n\tparentSalesOrder: IOptional|undefined;\n\tpaymentTerm: IOptional|undefined;\n\tpublicNoteSource: IOptional|undefined;\n\trequisitionNumber: IOptional|undefined;\n\tsalesOrderTypeId: IOptional|undefined;\n\tshipmondoShipmentId: IOptional|undefined;\n\tsubject: IOptional|undefined;\n\tmodelType = ChangeSalesOrderModelUpdate.modelTypeName;\n}\n\nICreateSalesOrderItemModelUpdate {\n\tpublic static readonly modelTypeName: string = \"CreateSalesOrderItemModelUpdate\";\n\tcalculatedDiscount: IOptional|undefined;\n\tcontraAccountSettings: IOptional|undefined;\n\tfinancialData: ISalesItemFinancialData;\n\tfixedPriceGroup: IOptional|undefined;\n\tinternalNote: IOptional|undefined;\n\tinventoryItemData: ISalesItemInventoryData;\n\tisExemptVat: IOptional|undefined;\n\tisFinancialDataChangedManually: IOptional|undefined;\n\tisPriceChangedManually: IOptional|undefined;\n\tisProductInstancePurchase: IOptional|undefined;\n\tlocation: IOptional|undefined;\n\tmanualDiscountAmount: number;\n\torder: IOptional|undefined;\n\tprice: number;\n\tpublicNote: IOptional|undefined;\n\tquantity: number;\n\trelatedItem: IOptional|undefined;\n\tstateId: IOptional|undefined;\n\tuuid: IOptional|undefined;\n\tmodelType = CreateSalesOrderItemModelUpdate.modelTypeName;\n}\n\n IChangeSalesOrderItemModelUpdate {\n\tpublic static readonly modelTypeName: string = \"ChangeSalesOrderItemModelUpdate\";\n\tcalculatedDiscount: IOptional|undefined;\n\tcontraAccountSettings: IOptional|undefined;\n\tdisplayName: IOptional|undefined;\n\tfinancialData: IOptional|undefined;\n\tfixedPriceGroup: IOptional|undefined;\n\tinternalNote: IOptional|undefined;\n\tinventoryItemData: IOptional|undefined;\n\tisExemptVat: IOptional|undefined;\n\tisFinancialDataChangedManually: IOptional|undefined;\n\tisPriceChangedManually: IOptional|undefined;\n\tisProductInstancePurchase: IOptional|undefined;\n\titemId: number;\n\tlocation: IOptional|undefined;\n\tmanualDiscountAmount: IOptional|undefined;\n\torder: IOptional|undefined;\n\tprice: IOptional|undefined;\n\tpublicNote: IOptional|undefined;\n\tquantity: IOptional|undefined;\n\trelatedItem: IOptional|undefined;\n\tstateId: IOptional|undefined;\n\tmodelType = ChangeSalesOrderItemModelUpdate.modelTypeName;\n}\n\nIDeleteSalesOrderItemsModelUpdate {\n\tpublic static readonly modelTypeName: string = \"DeleteSalesOrderItemsModelUpdate\";\n\tidsToDelete: number[] = [];\n\tmodelType = DeleteSalesOrderItemsModelUpdate.modelTypeName;\n}\n\nISetSalesOrderCustomerDataModelUpdate {\n\tactor?: IOptional;\n\taddress?: IOptional;\n\temail?: IOptional;\n\tphone?: IOptional;\n}\n\n\nISetSalesOrderCustomerDataModelUpdate {\n\tpublic static readonly modelTypeName: string = \"SetSalesOrderCustomerDataModelUpdate\";\n\tactor: IOptional|undefined;\n\taddress: IOptional|undefined;\n\temail: IOptional|undefined;\n\tphone: IOptional|undefined;\n\tmodelType = SetSalesOrderCustomerDataModelUpdate.modelTypeName;\n}\n\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Note 1 : Sales orders supports EAV fields and EAV field-related model updates may be used in Create/Update sales order command to set sales order-specific EAV field values. These model updates are described in following document : ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://mbsolutionsgroup.atlassian.net/wiki/spaces/CPSP/pages/2962325507"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Note 2 : Grouped products need custom handling. If it needed to add SalesOrderItem with grouped product to SalesOrder and it is expected that this item will be split to composed product parts, this iten meed to be added not via ChangeSalesOrderItemModelUpdate but via AddProductToSalesOrder command which is described below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateSalesOrderItemModelUpdate\",\n \"financialData\":{ \n \"priceIncludesVat\" // should always be true,\n \"saleFinancialAccountNumber\" // [financial_account_number],\n \"vatAccountNumber\" // should be taken from [vat_type] if presented, else - undefined\n \"vatRate\" // should be taken from [vat_type] if presented, else - undefined\n \"discountAccountNumber\" // should be taken from [vat_type] if presented, else - undefined\n \"usedVatFinancialAccountNumber\" // should be taken from [vat_type] else - undefined\n \"usedVatRate\" // should be taken from [vat_type] if presented, else - undefined\n },\n \"manualDiscountAmount\" // [manual_discount]\n \"quantity\" // [quantity],\n \"inventoryItemData\":{ \n \"displayName\" // from [product]\n \"productId\" // from [product]\n \"variantId\" // from [product_instance] if presented, , else - undefined,\n \"instanceId\" // from [product_instance] if presented, else - undefined\n \"productIdentifier\" // from [product_variant]\n \"isUserDefinedPriceAllowed // from [product]\n \"isCustomDisplayNameAllowed // from [product]\n \"costPrice\" // [cost_price]\n \"isUsed\"from [product_instance] if presented, else - undefined\n \"purchasePrice\" //from [product_instance] if presented, else - undefined\n \"isProductInstanceRequired\" from product.isProductInstancesSupported\n },\n \"price\" - [sales_price]\n },\n { \n \"modelType\":\"SetSalesOrderCustomerDataModelUpdate\",\n \"actor\":{ // this entire block may be undefined if [customer] is not defined \n \"value\":{ \n \"actorId\"// from [customer]\n \"fullName\"// Property [ActorText] from [customer]\n \"identification// Customer Identifier (from [customer])\n }\n },\n \"address\":{ // this entire block may be undefined if [address] is not defined \n \"value\":{ \n \"addressLine1\" // from [address], required\n \"addressLine2\" // from [address]\n \"postalCode\" // from [address], required\n \"postalDistrict\" // from [address]\n \"country\" // from [address], required\n \"latitude\" // from [address]\n \"longitude\" // from [address]\n }\n },\n \"email\":{ // this entire block may be undefined if [email] is not defined \n \"value\" // [email] itself\n },\n \"phone\":{ // this entire block may be undefined if [phone] is not defined \n \"value\" // [phone] itself\n }\n }\n ],\n \"modelType\":\"CreateSalesOrderCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"To take customer identifier from customer actor you should get first eav field from [","type":"text"},{"text":"eavFields","type":"text","marks":[{"type":"strong"}]},{"text":"] collection with ","type":"text"},{"text":"eavFieldValue.field.systemName == 'CustomerIdentifier'","type":"text","marks":[{"type":"strong"}]},{"text":" and get its ","type":"text"},{"text":"stringValue","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Example with real data based on which sales order may be created in test tenant:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateSalesOrderItemModelUpdate\",\n \"financialData\":{ \n \"priceIncludesVat\":true,\n \"saleFinancialAccountNumber\":1100,\n \"vatAccountNumber\":14262,\n \"vatRate\":25,\n \"discountAccountNumber\":7200,\n \"usedVatFinancialAccountNumber\":null,\n \"usedVatRate\":null\n },\n \"manualDiscountAmount\":300.14,\n \"quantity\":1,\n \"inventoryItemData\":{ \n \"displayName\":\"Sony Playstation 4 (cf18-4136-9f92-31764c4)\",\n \"productId\":106,\n \"variantId\":null,\n \"instanceId\":165,\n \"productIdentifier\":\"ID_108\",\n \"isUserDefinedPriceAllowed\":false,\n \"isCustomDisplayNameAllowed\":false,\n \"costPrice\":3000,\n \"isUsed\":false,\n \"purchasePrice\":null,\n \"isProductInstanceRequired\": true\n },\n \"price\":3001.45\n },\n { \n \"modelType\":\"SetSalesOrderCustomerDataModelUpdate\",\n \"actor\":{ \n \"value\":{ \n \"actorId\":8,\n \"fullName\":\"0000100001 a_person Customer\",\n \"identification\":\"0000100001\"\n }\n },\n \"address\":{ \n \"value\":{ \n \"addressLine1\":\"myStreet\",\n \"addressLine2\":\"222\",\n \"postalCode\":\"2100\",\n \"postalDistrict\":\"København Ø\",\n \"country\":\"Denmark\",\n \"latitude\":null,\n \"longitude\":null,\n }\n },\n \"email\":{ \n \"value\":\"example@gmail.com\"\n },\n \"phone\":{ \n \"value\":\"77777777\"\n }\n }\n ],\n \"modelType\":\"CreateSalesOrderCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"In response sales order Id will be presented.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Advanced flows:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some customers need to continue modifying sales order even after it is ready or invoiced (e.g. to add work hours to sales order and invoice it separately.). In this case sapera can be told that sales order should support such a flow by setting ","type":"text"},{"text":"AllowModifyingWhenReady = {value: true}","type":"text","marks":[{"type":"code"}]},{"text":" at creation time in root of ","type":"text"},{"text":"CreateSalesOrderCommand","type":"text","marks":[{"type":"code"}]},{"text":" body. When it is set - client app will ask at invoice time if sales order should be completed. User can choose to complete ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Update Sales Order","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to update sales order after creation (add or change customer data or contact info, add, change or remove sale items). All model updates described above that are used in CreateSalesOrderCommand may be used in UpdateSalesOrderCommand, they may be reviewed in Swagger.","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"}]},{"type":"paragraph","content":[{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/SalesOrder/UpdateSalesOrder","type":"text"}]},{"type":"paragraph","content":[{"text":"Example body","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"modelUpdates\":[\n {\n \"modelType\":\"ChangeSalesOrderItemModelUpdate\",\n \"price\":{\n \"value\":12000\n },\n \"isPriceChangedManually\":{\n \"value\":true\n },\n \"isProductInstancePurchase\":{\n \"value\":false\n },\n \"itemId\":17286\n },\n {\n \"modelType\":\"ChangeSalesOrderItemModelUpdate\",\n \"price\":{\n \"value\":250\n },\n \"isPriceChangedManually\":{\n \"value\":true\n },\n \"isProductInstancePurchase\":{\n \"value\":false\n },\n \"itemId\":17287\n },\n {\n \"modelType\":\"SetSalesOrderCustomerDataModelUpdate\",\n \"actor\":{\n \"value\":{\n \"actorId\":259,\n \"fullName\":\"Test actor full name\",\n \"identification\":\"10000000\",\n \"organizationIdentifier\":\"10000000\"\n }\n },\n \"address\":{\n \"value\":{\n \"id\":204,\n \"addressLine1\":\"TestAddressLine1\",\n \"addressLine2\":null,\n \"postalCode\":\"1111\",\n \"postalDistrict\":\"TestPostalDistict\",\n \"country\":null,\n \"latitude\":null,\n \"longitude\":null,\n \"addressType\":{\n \"id\":1,\n \"systemName\":\"Business\",\n \"displayName\":\"Firma\",\n \"isSystem\":true\n }\n }\n },\n \"email\":{\n \"value\":\"test_email@email.dk\"\n },\n \"phone\":{\n \n }\n },\n {\n \"modelType\":\"SetDateTimeEavValueModelUpdate\",\n \"fieldSystemName\":\"LeveringDato\",\n \"value\":\"2021-09-14T00:00:00+03:00\"\n }\n ],\n \"modelType\":\"UpdateSalesOrderCommand\",\n \"entityId\":1115\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add product to sales order","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/SalesOrder/AddProductToSalesOrder","type":"text"},{"type":"hardBreak"},{"text":"Request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \t\"salesOrderId\": sales order id,\n \t\"product\": { \n \t\"kind\": product descriptor kind, use 1 for Id, 2 for identifier \n\t\t\"id\": { // this block should be set only if kind = 1\n\t\t\t\"value\": \"1244\"\n\t\t},\n\t\t\"identifier\": { // this block should be set only if kind = 2\n\t\t\t\"value\": \"ZXC PRODUCT\"\n\t\t}\n\t},\n\t\"variantId\": { // this block can be undefined, if no variant is relevant\n\t\t\"value\": \"213\"\n\t},\n\t\"organizationalUnitId\": { // this block can be undefined, if item(s) should follow sales order's OU\n\t\t\"value\": \"1213213\"\n\t},\n\t\"quantity\": { // this block can be undefined, 1 is used by default\n\t\t\"value\": \"2\"\n\t},\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example with test data:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"salesOrderId\": 999,\n \t\"product\": { \n \t\"kind\": 2,\n\t\t\"identifier\": { \"value\": \"GROUPED_PRODUCT_IDENTIFIER\" }\n\t}\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Set Sales order as ready","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/SalesOrder/SetSalesOrderReady","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"salesOrderId\": sales order id\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create Invoice","type":"text"}]},{"type":"paragraph","content":[{"text":"Invoice is created based on sales order and its items or blank.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create blank invoice","type":"text"}]},{"type":"paragraph","content":[{"text":"Before create of invoice we need to have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[customer]","type":"text","marks":[{"type":"strong"}]},{"text":" - retrieved from actors microservice based on ","type":"text"},{"text":"[invoice]","type":"text","marks":[{"type":"strong"}]},{"text":" customer's data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[address]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional) - user input, defaulted by actor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[email]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional)- user input, defaulted by actor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[phone]","type":"text","marks":[{"type":"strong"}]},{"text":" (optional)- user input, defaulted by actor","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To compose sales order item we need to have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product]","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_category]","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_variant]","type":"text","marks":[{"type":"strong"}]},{"text":" if product supports variants - variant is required","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[product_instance]","type":"text","marks":[{"type":"strong"}]},{"text":" if product supports instances - instance is required","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[financial_account_number] ","type":"text","marks":[{"type":"strong"}]},{"text":"- taken by rules described above ([Get product financial and VAT data])","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[vat_type]","type":"text","marks":[{"type":"strong"}]},{"text":" - taken from accounting microservice by financial account number","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[sales_price] -","type":"text","marks":[{"type":"strong"}]},{"text":" calculated by following rule: If product instance is selected and its sales price is not null- product instance's sales price. If not- check variant. If variant is selected and its sales price is not null- variant's sales price. If sales price still not calculated - should be used sales price from product. [sales_price] is considered to include VAT part. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[quantity]","type":"text","marks":[{"type":"strong"}]},{"text":" - user input. Please note that quantity should be 1 for sales order items where product instance is defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[manual_discount]","type":"text","marks":[{"type":"strong"}]},{"text":" - user input. Sale item amount will be calculated as [sales_price] * [quantity]. If it is needed to register sale item with different amount - [manual_discount] should be specified. [manual_discount] is considered to include VAT part. ","type":"text"},{"type":"hardBreak"},{"text":"All enlisted entities will be used in example below.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For create invoice use following:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/Invoice/CreateInvoiceAndReserve","type":"text"}]},{"type":"paragraph","content":[{"text":"Command contain collection ","type":"text"},{"text":"[modelUpdates]","type":"text","marks":[{"type":"strong"}]},{"text":" and all invoice manipulation should be done via model updates.","type":"text"}]},{"type":"paragraph","content":[{"text":"Model update type can be specified by placing it's name to ","type":"text"},{"text":"[modelType]","type":"text","marks":[{"type":"strong"}]},{"text":" property.","type":"text"},{"type":"hardBreak"},{"text":"Following model updates are supported for invoice creation:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CreateInvoiceItemModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to create sales order item,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ChangeInvoiceItemModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to change sales order item,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DeleteInvoiceItemsModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to delete sales order item","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SetInvoiceCustomerDataModelUpdate","type":"text","marks":[{"type":"strong"}]},{"text":" - to specify actor and contact information.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"There may be many model updates of any type in command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateInvoiceItemModelUpdate\",\n \"financialData\":{ \n \"priceIncludesVat\" // should always be true,\n \"saleFinancialAccountNumber\" // [financial_account_number],\n \"vatAccountNumber\" // should be taken from [vat_type] if presented, else - undefined\n \"vatRate\" // should be taken from [vat_type] if presented, else - undefined\n \"discountAccountNumber\" // should be taken from [vat_type] if presented, else - undefined\n \"usedVatFinancialAccountNumber\" // should be taken from [vat_type] else - undefined\n \"usedVatRate\" // should be taken from [vat_type] if presented, else - undefined\n },\n \"manualDiscountAmount\" // [manual_discount]\n \"quantity\" // [quantity],\n \"inventoryItemData\":{ \n \"displayName\" // from [product]\n \"productId\" // from [product]\n \"variantId\" // from [product_instance] if presented, , else - undefined,\n \"instanceId\" // from [product_instance] if presented, else - undefined\n \"productIdentifier\" // from [product_variant]\n \"isUserDefinedPriceAllowed // from [product]\n \"isCustomDisplayNameAllowed // from [product]\n \"costPrice\" // from [product_instance] if presented, else - undefined\n \"isUsed\"from [product_instance] if presented, else - undefined\n \"purchasePrice\" //from [product_instance] if presented, else - undefined\n \"isProductInstanceRequired\" from product.isProductInstancesSupported\n },\n \"price\" - [sales_price]\n },\n { \n \"modelType\":\"SetInvoiceCustomerDataModelUpdate\",\n \"actor\":{ // this entire block may be undefined if [customer] is not defined \n \"value\":{ \n \"actorId\"// from [customer]\n \"fullName\"// from [customer]\n \"identification// from [customer]\n }\n },\n \"address\":{ // this entire block may be undefined if [address] is not defined \n \"value\":{ \n \"addressLine1\" // from [address], required\n \"addressLine2\" // from [address]\n \"postalCode\" // from [address], required\n \"postalDistrict\" // from [address]\n \"country\" // from [address], required\n \"latitude\" // from [address]\n \"longitude\" // from [address]\n }\n },\n \"email\":{ // this entire block may be undefined if [email] is not defined \n \"value\" // [email] itself\n },\n \"phone\":{ // this entire block may be undefined if [phone] is not defined \n \"value\" // [phone] itself\n }\n }\n ],\n \"modelType\":\"CreateInvoiceAndReserveCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Example with real data based on which sales order may be created in test tenant:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateInvoiceItemModelUpdate\",\n \"financialData\":{ \n \"priceIncludesVat\":true,\n \"saleFinancialAccountNumber\":1100,\n \"vatAccountNumber\":14262,\n \"vatRate\":25,\n \"discountAccountNumber\":7200,\n \"usedVatFinancialAccountNumber\":null,\n \"usedVatRate\":null\n },\n \"manualDiscountAmount\":300.14,\n \"quantity\":1,\n \"inventoryItemData\":{ \n \"displayName\":\"Sony Playstation 4 (cf18-4136-9f92-31764c4)\",\n \"productId\":106,\n \"variantId\":null,\n \"instanceId\":165,\n \"productIdentifier\":\"ID_108\",\n \"isUserDefinedPriceAllowed\":false,\n \"isCustomDisplayNameAllowed\":false,\n \"costPrice\":3000,\n \"isUsed\":false,\n \"purchasePrice\":null,\n \"isProductInstanceRequired\": true\n },\n \"price\":3001.45\n },\n { \n \"modelType\":\"SetInvoiceCustomerDataModelUpdate\",\n \"actor\":{ \n \"value\":{ \n \"actorId\":8,\n \"fullName\":\"0000100001 a_person Customer\",\n \"identification\":\"0000100001\"\n }\n },\n \"address\":{ \n \"value\":{ \n \"addressLine1\":\"myStreet\",\n \"addressLine2\":\"222\",\n \"postalCode\":\"2100\",\n \"postalDistrict\":\"København Ø\",\n \"country\":\"Denmark\",\n \"latitude\":null,\n \"longitude\":null,\n }\n },\n \"email\":{ \n \"value\":\"example@gmail.com\"\n },\n \"phone\":{ \n \"value\":\"77777777\"\n }\n }\n ],\n \"modelType\":\"CreateInvoiceAndReserveCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"In response sales order Id will be presented.","type":"text"},{"type":"hardBreak"},{"text":"It is possible to update sales order after creation (add or change customer data or contact info, add, change or remove items), to do UpdateInvoice operation may be used with same model updates as CreateInvoiceAndReserve, you may review it in Swagger","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create Invoice based on sales order","type":"text"}]},{"type":"paragraph","content":[{"text":"It is OK to create more then 1 invoice based on sales order and place some items into one sales order and some items from another.","type":"text"},{"type":"hardBreak"},{"text":"But first it is needed to fetch sales order from storage.","type":"text"}]},{"type":"paragraph","content":[{"text":"For fetch sales order from storage use following:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"}]},{"type":"paragraph","content":[{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/SalesOrder/GetSalesOrder","type":"text"},{"type":"hardBreak"},{"text":"Minimal request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"id\": sales order id\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"In response sales order along with its items will be presented, it is needed for invoice creation.","type":"text"}]},{"type":"paragraph","content":[{"text":"For create invoice use following:","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/Invoice/CreateInvoiceAndReserve","type":"text"}]},{"type":"paragraph","content":[{"text":"Command contain collection ","type":"text"},{"text":"[modelUpdates]","type":"text","marks":[{"type":"strong"}]},{"text":" and all invoice manipulation should be done via model updates.","type":"text"},{"type":"hardBreak"},{"text":"Main idea of creation invoice based on sales order is to fetch data from sales order and place it into invoice","type":"text"}]},{"type":"paragraph","content":[{"text":"Before create of invoice we need to have:","type":"text"},{"type":"hardBreak"},{"text":"[sale_order]","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"[customer]","type":"text","marks":[{"type":"strong"}]},{"text":" - retrieved from actors microservice based on ","type":"text"},{"text":"[sale_order]","type":"text","marks":[{"type":"strong"}]},{"text":" customer's data","type":"text"}]},{"type":"paragraph","content":[{"text":"To compose sales order item we need to have :","type":"text"},{"type":"hardBreak"},{"text":"[sale_order_item] from sales order.","type":"text"}]},{"type":"paragraph","content":[{"text":"These fields will be used in example below:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateInvoiceItemModelUpdate\",\n \"salesOrderItemReference\":{ \n \"value\":{ \n \"salesOrderId\" // from [sale_order]\n \"salesOrderIdentifier // from [sale_order]\n \"salesOrderItemId\" // from [sale_order_item]\n }\n },\n \"financialData\":{ // just copy from property with same name from [sale_order_item] or change if needed\n \"saleFinancialAccountNumber\"\n \"vatRate\"\n \"vatAccountNumber\"\n \"discountAccountNumber\"\n \"priceIncludesVat\"\n \"usedVatRate\"\n \"usedVatFinancialAccountNumber\"\n },\n \"manualDiscountAmount\"// just copy from property with same name from [sale_order_item] or change if needed\n \"quantity\"// just copy from property with same name from [sale_order_item] or change if needed\n \"inventoryItemData\":{ // just copy from property with same name from [sale_order_item] or change if needed\n \"displayName\"\n \"productId\"\n \"variantId\"\n \"instanceId\"\n \"productIdentifier\"\n \"isUserDefinedPriceAllowed\"\n \"isCustomDisplayNameAllowed\"\n \"costPrice\"\n \"isUsed\"\n \"purchasePrice\",\n \"isProductInstanceRequired\"\n },\n \"price\"// just copy from property with same name from [sale_order_item] or change if needed\n },\n { \n \"modelType\":\"SetInvoiceCustomerDataModelUpdate\",\n \"customerDescriptor\":{ // copy from property [customer] of [sale_order] or compose based on [customer]\n \"value\":{ \n \"actorId\"\n \"fullName\"\n \"identification\"\n }\n },\n \"firstName\":{ \n \"value\" // take from [customer] if possible or user input\n },\n \"lastName\":{ \n \"value\" // take from [customer] if possible or user input\n },\n \"organizationName\":{ \n \"value\" // take from [customer] if possible or user input\n },\n \"address\":{ // take from [customer] if possible or user input \n \"value\":{ \n \"addressLine1\"\n \"addressLine2\"\n \"postalCode\"\n \"postalDistrict\"\n \"country\"\n \"latitude\"\n \"longitude\"\n }\n },\n \"email\":{ \n \"value\" // take from [customer] if possible or user input\n },\n \"phone\":{ \n \"value\" // take from [customer] if possible or user input\n }\n }\n ],\n \"modelType\":\"CreateInvoiceCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Example with real data based on which sales order may be created in test tenant :","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{ \n \"modelUpdates\":[ \n { \n \"modelType\":\"CreateInvoiceItemModelUpdate\",\n \"salesOrderItemReference\":{ \n \"value\":{ \n \"salesOrderId\":1,\n \"salesOrderIdentifier\":\"0000000001\",\n \"salesOrderItemId\":1\n }\n },\n \"financialData\":{ \n \"saleFinancialAccountNumber\":1100,\n \"vatRate\":25,\n \"vatAccountNumber\":14262,\n \"discountAccountNumber\":7200,\n \"priceIncludesVat\":true,\n \"usedVatRate\":null,\n \"usedVatFinancialAccountNumber\":null\n },\n \"manualDiscountAmount\":300.14,\n \"quantity\":1,\n \"inventoryItemData\":{ \n \"displayName\":\"Sony Playstation 4 (cf18-4136-9f92-31764c4)\",\n \"productId\":106,\n \"variantId\":null,\n \"instanceId\":165,\n \"productIdentifier\":\"ID_108\",\n \"isUserDefinedPriceAllowed\":false,\n \"isCustomDisplayNameAllowed\":false,\n \"costPrice\":3000,\n \"isUsed\":false,\n \"purchasePrice\":null,\n \"isProductInstanceRequired\": true\n },\n \"price\":3001.45\n },\n { \n \"modelType\":\"SetInvoiceCustomerDataModelUpdate\",\n \"customerDescriptor\":{ \n \"value\":{ \n \"actorId\":8,\n \"fullName\":\"0000100001 a_person Customer\",\n \"identification\":\"0000100001\"\n }\n },\n \"firstName\":{ \n \"value\":\"a_person\"\n },\n \"lastName\":{ \n \"value\":\"Customer\"\n },\n \"organizationName\":{ \n \"value\":null\n },\n \"ean\":{ \n\n },\n \"address\":{ \n \"value\":{ \n \"addressLine1\":\"myStreet\",\n \"addressLine2\":\"222\",\n \"postalCode\":\"2100\",\n \"postalDistrict\":\"København Ø\",\n \"country\":\"Denmark\",\n \"latitude\":null,\n \"longitude\":null\n }\n },\n \"email\":{ \n \"value\":\"example@gmail.com\"\n },\n \"phone\":{ \n \"value\":\"77777777\"\n }\n },\n { \n \"modelType\":\"SetInvoiceProductInstanceModelUpdate\",\n \"productInstance\":{ \n \"productInstanceId\":null,\n \"displayValue\":\"\",\n \"productId\":null,\n \"productVariantId\":null\n }\n },\n { \n \"modelType\":\"SetInvoicePaymentDueDateModelUpdate\",\n \"paymentDueDate\":\"2018-09-27T13:38:46+03:00\"\n }\n ],\n \"modelType\":\"CreateInvoiceCommand\"\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"In response invoice Id will be presented.","type":"text"},{"type":"hardBreak"},{"text":"It is possible to update invoice after creation (add or change customer data or contact info, add, change or remove sale items), to do UpdateInvoice operation may be used with same model updates as CreateInvoice, you may review it in Swagger.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Book invoice","type":"text"}]},{"type":"paragraph","content":[{"text":"Word:","type":"text","marks":[{"type":"strong"}]},{"text":" POST","type":"text"},{"type":"hardBreak"},{"text":"URL:","type":"text","marks":[{"type":"strong"}]},{"text":" {host_url}/api/financial/Invoice/BookInvoice","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"invoiceId\": sales order id\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"After book sales order/invoice creation flow is completed","type":"text"}]}],"version":1}