How to override Visma.net Financials ERP number-series (Automatic) via API

[#1]

Override Visma.net Financials ERP number-series via API function has been implemented in Visma.net Financials ERP API version 8.25 (September 2020)

With this function, we can set different asset number / ID via API than the Number-series that have been configured in the Visma.net Financials ERP UI without breaking the auto-numbering sequence.

Currently, available in the following endpoints

POST Customer

POST CustomerDebitNote V2

POST SalesOrder

POST Supplier

POST Journal Transaction V2

POST PurchaseOrder

POST Supplier Invoice

POST CustomerCreditNote V2

POST CustomerInvoice V2

How to set it up?
1) Set "Allow manual numbering on imports" true in the Visma.net Financials ERP UI.
(Number Series - ScreenId=CS201010)

2) Include the following key-value pairs in the payload based on the aforementioned endpoint DTO syntax. ("ReferenceNumber" field may vary depending on the resource.)

Visma.net ERP API - Endpoint Documentation

...
 "overrideNumberSeries": {
    "value": true
  },
 "referenceNumber": {
    "value": "string"
  }
...

After a successful POST request, the value specified in the "ReferenceNumber" field would be assigned to the resource as an identifier.

Afterward, the end-user or any integration can continue using Financial Company's automatic numbering setup in the transactions without any number skipped from the defined number series.