Access token

Fixed

• Fixed a bug in the customers responses. The is_invoice_to_be_emailed field returned an integer. This now correctly returns a boolean.
• Fixed a bug in the customers POST and UPDATE endpoints where the coc_number was not set.
• Fixed a bug in the orderlines UPDATE endpoint where it was not possible to add new serialnumbers.

Added

• Added colli_packaging_id to the orderline endpoint.
• Added tags endpoints. There is a global endpoint and there are endpoints for orders, products, invoices, customers and suppliers.
• Added batch_id, batch_description and batch_date to batch_distribution in the orderline endpoint.
• Added salutation endpoint.
• Added shipment endpoint.
• Added shipments to order endpoint.
• Added is_archived filter for order endpoint.
• Added api users to user endpoint.
• Added surcharges to orderline INDEX and GET endpoints.
• Added supplier_id filter to product endpoint.
• Added customer_shipping_address, customer_contact and supplier_contact to the order endpoint. There is no longer the need to retrieve those seperately.
• Added the option to remove orderlines.

Changed

• Changed the validation for quantity_picked in the orderlines. If the quantity was negative, it could not be picked. We now use the absolute value of the quantity. For example: if you have a quantity of -5, the quantity_picked will have to be between 0 and 5.
• Changed the maximum limit on the customer and supplier INDEX to 50.
• Changed the minimum limit on all requests to 1.

Fixed

• Fixed bug in the user endpoint. Users who haven't logged in yet, will not throw an error anymore.
• Fixed bug in the payment and send methods endpoints with descriptions. They are now saved properly.
• Fixed bug in the product endpoint with descriptions. They are now returned properly.
• Fixed bug in sorting the orderlines. In rare cases the sorting was not correct.
• Fixed bug where an invalid filter was used. The error handling is improved and will now return a proper error message.
• Fixed bug where an invalid quantity was used in the orderline endpoint. The error handling is improved and will now return a proper error message.
• Fixed bug orderline endpoint with the purchase_price. In rare cases it was not calculated correctly.
• Fixed bug in the orderline endpoint with custom_description.
• Fixed bug in the tag, tradename and volume_discount endpoints. It was not possible to use an offset.

Added

• Added batch_description and batch_date to batch_distribution in orderline endpoint

Fixed

• Fixed bug in orderlines multiple patch endpoint, where only the first orderline was changed.

Changed

• Rate limit is now on a per user basis

Fixed

• Fixed another bug in orderlines with colli products. They were not returned correctly.
• Fixed bug in description for endpoints product, payment method and send method

Added

• Added first part of stocktaking list endpoint
• Added parent_order_id to the order post endpoint. Using this creates a suborder

Fixed

• Fixed bug in suppliers with tags. They are now deleted and will be re-added later.
• Fixed bug in orderlines with colli products.

Added

• Added filter on is_shown_in_portal for product INDEX endpoint
• Added field user_defined_1 in order endpoint
• Added field custom_description in orderline endpoint
• Added specifications to the product endpoint
• Added videos to the product endpoint
• Added weight field to the product endpoint
• Added stock information to the product endpoint with type colli
• Added packaging_id in orderline for colli products, but only if it can be found. If not, it will be null.
• Added colli packaging endpoint for filtering on code, barcode or packaging_id_list
• Added batch_distribution on orderline endpoint

Fixed

• Fixed bug in product endpoints where the is_shown_in_portal was not returned
• Fixed bug in product batch endpoint where the batches were not filtered by given product

Added

• Added custom_description to orderline endpoint

Added

• Added global colli packaging endpoint for searching on code, barcode or uuid list

Fixed

• Fixed bug in orderline endpoint. When 0 was given for gross and discount, the gross and discount were calculated from the product. Now only null will use the product values.

Added

• Added colli unit and amount to the orderline endpoint
• Added weight to the product endpoints
• Added specifications to the product GET endpoints
• Added videos to the product GET endpoints

Added

• Added product locations GET endpoint for retrieving multiple product locations.
• Added French, Italian and Spanish translations for the product portal description.
• Added stock information for colli products in the product INDEX endpoint.
• Added filters barcode, code, packaging_id_list to product packaging INDEX endpoint.

Fixed

• Fixed bug in product PUT endpoint where fields category_id, vat_rate_id, code, description, price_excl_vat, were not required.

Added

• Added product suppliers GET endpoint for retrieving multiple product suppliers.

Added

• Added stock locations for products and product matrix variants GET.

Added

• Added PATCH for order_lines index to change quantity_picked.
• Added purchase_date sort for orders to purchase and purchase_dropship.
• Added creation_date sort for orders to quotation.
• Added expected_date_range filter for orders to backorder, purchase and purchase_dropship.
• Added order_date_range filter for orders to backorder and quotation.
• Added shipping_date_range filter for orders to sales.
• Added expiry_date_range filter for orders to quotation.
• Added supplier_id filter for orders to purchase and purchase_dropship.

Changed

• Renamed total_incl_vat sort for orders to total.incl_vat. total_incl_vat is now deprecated.
• Renamed total_excl_vat sort for orders to total.excl_vat. total_excl_vat is now deprecated.
• Renamed delivery_date sort for orders to delivery.date for backorder, sales and quotation. delivery_date is now deprecated for these types.
• Removed delivery_date sort for orders from purchase purchase_dropship.
• Renamed payment_method_id filter for orders to pay_method_id. payment_method_id is now deprecated.
• Removed order_date sort for orders from purchase purchase_dropship quotation.
• Removed customer_id sort for orders from purchase purchase_dropship.

Added

• Added expected_date for purchase orders
• Added expiry_date for quotation orders

Fixed

• Fixed bug in product packaging endpoint, where it was possible to create a duplicate with the same unit_id and packing_amount.
• Fixed bug in orderline PUT endpoint, where it was not possible to omit quantity.
• Fixed bug in supplier endpoint, where it was not possible to omit mobile.

Added

• Added json validation for all POST and PUT endpoints. When submitting an invalid JSON, a proper error will be returned.
• Added more validation for date filters. Invalid dates (like a 13th month) wil no longer be guessed, but an error will be returned.
• Added colli_packaging_amount and colli_packaging_unit_id in the orderline endpoint
• Added send_method_id in the customers endpoint

Fixed

• Fixed bug in all endpoints where a filter with a date beyond 2040 gives no results. Instead, an error is returned.
• Fixed bug in product variant endpoint, where the axes are now properly validated.

Added

• Added related products in product GET endpoint.

Added

• Added description for product variants

Added

• Added portal description for products
• Added delivery date for sales, sales quote, backorder orders.
• Removed price_nett_id and price_group_id from the orders endpoint. These were already automatically filled from the customer

Added

• Added sales_user_id for orders with the type sales, quotation and backorder

Fixed

• Fixed bug in product variant endpoint when manufacturer suggested retail price setting was off

Added

• Added user index endpoint
• Added product warehouse stock PUT endpoint to overwrite the current stock

Added

• Added filters on shipping_date in order index endpoint for sales orders
• Added filters on expected_date in order index endpoint for backorder orders
• Added search on order_number and order_reference in order index

Changed

• For the order, customers and supplier endpoints, a filter is no longer required when using a search.

Added

• Added orders connected endpoints
• Added backorder type in the orders, order_lines and orders connected endpoints
• Added href for orders, products and customers, to link to the corresponding web page.

Added

• Added retreiving price nett rows with filters
• Added manufactorer suggested retail price setting to the matrix and variant endpoints
• Added location to product index endpoint
• Added auto-fill from customer for price_nett_id and price_group_id in the order endpoint. When given in the request, they are ignored.

Changed

• Changed the way sorting is shown in the swagger documentation
• Changed the maximum of axes values on a axis to 100

Fixed

• Fixed archived orders can no longer be changed
• Fixed http link in meta data on production
• Fixed bug in serial numbers on the order line endpoint
• Fixed that default sales/purchase warehouse was shown when multiple warehouse setting was off

Added

• At least 1 filters is now required for these endpoints:
  • Category
  • Customer
  • Invoices
    • Provisional
    • Sale
  • Order
    • Purchase
    • Sales
    • Quotation
    • Purchase_dropship
  • PriceGroup
  • PriceNett
  • Product
  • ProductMatrix
  • Supplier
  • VolumeDiscount

Added

• Added serial number endpoints under products.
• Added serial numbers in the order_line endpoints.

Added

• Added shipping_date for order INDEX endpoint.

Fixed

• Removed prefix from reference in order INDEX endpoint.

Added

• Added volume discount endpoint
• Added automatic price calculation in order line endpoint
• Added filter for customer INDEX to filter on multiple customer uuid's.
• Added filter for supplier INDEX to filter on multiple supplier uuid's.
• Added search for customer INDEX to search on code or company.
• Added search for supplier INDEX to search on code or description.

Added

• Added filter for product INDEX to filter on multiple product uuid's.

Added

• Extended API documentation online.

Changed

• Some fields are no longer required in the POST and PUT of the order endpoint. These fields are now optional: store_order_id (default null), is_webshop_order (default false), is_paid (default false) and order_reference (default empty string).

Fixed

• Fixed a bug where the product endpoint did not properly create a product code
• Fixed a bug where the customer endpoint did not properly create a company code

Added

• Started fase 2. This means that all POST, PUT and PATCH endpoints on sandbox are now also available on production.

Added

• Added filtering on barcode for product endpoint
• Added INDEX and GET for purchase dropship orders

Added

• Improved endpoint logging efficiency

Changed

• Removed several obselete properties from product packaging endpoint

Fixed

• Fixed bug for orders vat rate
• Fixed documentation for parts in product endpoint

Added

• Added validation for vat_type in orders

Changed

• Changed all timezones to Europe/Amsterdam. This will be visible for all created_at and updated_at properties
• Changed validation for orderLines with type product. The product_id and quantity are now required. The vat_rate is no longer required and will be filled with the vat_rate of the product

Fixed

• Fixed vat_rate validation on orders when a customer didn't have a vat_number
• Fixed pagination bug when the next was empty. Offset is now always a multiple of limit, or 0
• Fixed validation for sorting and filtering.

Added

• In the POST or PUT in the product endpoint, the product code is no longer required. When not given, it is automatically generated

Changed

• Changed the delivery time from/to for the orders endpoint. They are now required and only accept quaters of an hour
• The orderline list now returns all orderline properties

Fixed

• Fixed the return value of exchange rate in the order endpoints
• Fixed documentation for user defined fields for products
• Fixed documentation for customer discount agreements. The POST and PUT require a product_id and not a product resource.
• Fixed error message of descriptions. It sometimes gave a wrongly formatted language.

Added

• All filters now have a maximum length of 50 characters
• In the POST or PUT in the product endpoint, the code is now validated against a whitelist of allowed characters
• In the POST of a customer endpoint, code is no longer required. When not given, it is automatically generated

Changed

• Improved 403 errors to include explanation of the error
• Changed the email to email_general in the sorting of a supplier list
• Description in the product list endpoint is now returned as an object

Fixed

• Fixed an issue where 401 errors were not logged in the API insights
• Made sure that required uuid's are properly validated
• Fixed an issue where article_number was not saved for manual orderlines

Changed

• Removed the user_id property from the Orders endpoints since this is not used

Fixed

• The customer_contact_id, price_nett_id and price_group_id properties in the SalesOrders and Quotations endpoints are now nullable
• The supplier_contact_id property in the PurchaseOrders endpoint is now nullable

Added

• Added the Quotations endpoint
• Added the quotation acceptation url as a property in the response of the quotations endpoint
• Added the ProductImages endpoint
• Added the in_pricelist filter to the products INDEX endpoint
• Added validation for multiple languages in description fields. Because of this the structure for a POST or PUT request in those field is slightly changed. See the Swagger docs for an updated example.

Changed

• Removed the logistic_user_id and transporter_id properties from the SalesOrders endpoint since these are not used

Fixed

• Added max character length validation to the different languages inside a description object
• Orders created through the orders endpoints now all have get a unique order number
• User defined fields in the product resource are now filled with data
• It is not possible anymore to create multiple main suppliers through the ProductSupplier endpoint. When creating a new main supplier, the old main supplier is automatically demoted to a regular supplier
• The order lines POST and PUT requests now accept negative quantities

Changed

• Changed the urls for the invoice endpoints to make it more in line with the current naming of endpoints. See our Swagger documentation for the changes.

Added

• Added the quotation order type to the orders and order_lines endpoints
• Added the possibility to filter on customer_code in the customers INDEX endpoint
• Added the possibility to filter on product_code in the products INDEX endpoint
• Added the possibility to filter on supplier_code in the suppliers INDEX endpoint
• Added a few missing properties to the tradenames endpoint
• Added filtering on the created_at and updated_at properties for all endpoints
• Added sorting on the created_at and updated_at properties for all endpoints where it was still missing

Changed

• Changed warehouse filters that were in camel case to snake case
• Updated the documentation for all endpoints to display all properties and filters in snake case
• Removed the conditions property from the tradenames POST endpoint since this was not used
• Changed the max length of the visiting_city and postal_city properties from 50 to 100 in the tradenames endpoint

Fixed

• Fixed an issue where the validation did not validate if the posted currency_id was enabled

Added

• Stock is now updated when deleting a sales order
• Stock is now updated when creating, updating or deleting a sales order line
• Added missing sorting options for created_at and updated_at in the Swagger documentation for the PriceGroup INDEX endpoint
• Added missing sorting options for created_at and updated_at in the Swagger documentation for the PriceNett INDEX endpoint

Changed

• Removed the is_active filter from the Location INDEX endpoint since this was not used
• Disabled the ProductImage endpoint since this is not implemented yet

Fixed

• The CustomerPriceAgreement endpoint now correctly returns a filled created_at after making a successful POST request
• Fixed a bug where a filtered list (when filtered by an id of another resource) would set an invalid id for the returned resources.

Changed

• Major changes introduced for the Visma Developer Portal setup and token retrieval. We dropped support for interactive application types and we introduced support for non-interactive application types (service applications) in Visma Developer Portal. You can now retrieve an access token without having to authorize the request and refresh tokens are no longer needed to retrieve access tokens without user interaction. See our documentation page on how to setup a new application (of the type service) in Visma Developer Portal and how to retrieve an access token.

Changed

• Removed the favourite property and filter from the Suppliers endpoint, since this was not used
• Removed the discount property from the Suppliers endpoint, since this was not used
• Removed the price_group_rows property from the PriceGroup INDEX endpoint. This property should be fetched from the PriceGroup GET endpoint
• Removed the price_nett_rows property from the PriceNett INDEX endpoint. This property should be fetched from the PriceNett GET endpoint

Fixed

• Added the order_type parameter to the order_lines endpoints in the Swagger documentation
• Added missing created_at and updated_at properties to the PriceGroups endpoints
• Added missing created_at and updated_at properties to the PriceNett endpoints

Added

• Added the ExchangeRate GET endpoint
• Added the Invoice INDEX and GET endpoints
• Added the ProvisionalInvoice INDEX and GET endpoints
• Added the purchase order type to the order endpoints
• OrderLine endpoints are now also compatible with the purchase order type
• Added the ColliPackaging INDEX, POST, GET, PUT and DELETE endpoints

Changed

• The order endpoints are now prefixed with an order type.

Fixed

• The currency_id is now automatically set after creating or updating an order line
• Added missing created_at and updated_at properties to a lot of endpoints
• Fixed sorting on created_at and updated_at properties in a few endpoints