Visma eAccounting API news

Moving forward this will be the new format of delivering news, we'll make our best to publish news once every month. A lot of new stuff since last time 😄 Enjoy!

🆕 Added

• New endpoint: POST /v2/customerinvoices/{invoiceId}/einvoice. This endpoint lets you send a existing customer invoice electronically using e-invoice.
• New endpoint: GET /v2/foreignpaymentcodes/{foreignPaymentCodeId}. This endpoint lets you fetch a foreign payment code by id.
• New properties for CustomerInvoiceApi. Affected endpoints: GET /v2/customerinvoices, GET /v2/customerinvoices/{invoiceId} and POST /v2/customerinvoices.
  • PaymentRemindersCount - Read only. Number of payment reminders sent for the overdue invoice.
  • LastPaymentReminderSentDate - Read only. Last payment reminder date for the overdue invoice. Null if no payment reminder has been sent.
  • TaxDeductionStatus- Read only. Represents the status of an invoice with applicable tax deduction in relation to export to tax authority. Possible values:
    • 0 - None. The invoice has not yet fully been paid by the customer.
    • 1 - ApplicableForDeductionExport. The invoice has been fully paid and can be exported to tax authority.
    • 2 - ExportedToTaxAuthority. The invoice has been exported to tax authority.
    • 3 - RejectedByTaxAuthority. The invoice has been rejected by tax authority.
  • IsQuickInvoice - Read only. Indicates if the invoice was created from journal entries posted manually or imported from another program.
  • IsCollectiveInvoice- Read only. Indicates if the invoice was created from more than one order.
  • CollectiveCustomerInvoiceRowsRelationToOrders- Read only. When IsCollectiveInvoice is true, this property is a populated list of the relation between the collective invoice rows and the orders that the invoice is generated from.
• New properties for CustomerApi. Affected endpoints: GET /v2/customers, GET /v2/customers/{customerId}, POST /v2/customers and PUT /v2/customers/{customerId}.
  • PropertyType- Represents type of property, Possible values:
    • 1 - Apartment
    • 2 - Property
  • PropertyReference- Reference of the property.
  • TaxDeductionNumber- Tax Deduction Number related to the customer/property.
• New property for ArticleApi. Affected endpoints: GET /v2/articles, GET /v2/articles/{articleId}, POST /v2/articles and PUT /v2/articles/{articleId}.
  • SupplierId- Id of the main supplier for the article. Clear by setting to empty GUID. Only available when stock module is activated.
  • OrderingPoint- Sets the ordering point of the article. Used when stock module is activated and article sales category type is Goods.
• New property for SupplierInvoiceDraftApi. Affected endpoints: GET /v2/supplierinvoicedrafts and GET /v2/supplierinvoicedrafts/supplierInvoiceDraftId.
  • IsAutoInvoiceInterimSupplier - Read only. If e-invoice and doesn't have a supplier already registered then this value is true.
• New property for SupplierApi. Affected endpoints: GET /v2/suppliers and GET /v2/suppliers/supplierId.
  • LastInvoiceDate - Read only. If there's been an invoice sent from this supplier the last invoice date will be represented here.
• New property for CompanySettingsApi. Affected endpoints: GET /v2/companysettings and PUT /v2/companysettings.
  • VismaWebshopStatus - Read only. Status of synchronization with Visma Webshop. Possible values:
    • 0 - No synchronization
    • 1 - Synchronization is enabled
    • 2 - Synchronization not wanted (disabled)
    • 3 - Synchronization requested
  • UsesVatTriangulationRules- When set to true, EU triangular transactions involve three parties and direct goods shipping, with the end VAT-registered customer liable for VAT.
• New property for OrderApi. Affected endpoints: GET /v2/orders, GET /v2/orders/{id}, POST /v2/orders/ and PUT /v2/orders/{id}.
  • CreatedFromQuoteId- Read only. If order was created from a quote, the quote id will be represented here.
  • TermsOfPaymentId- If this is set, the specific term of payment id will be used for this specific order instead of using the default term from the customer.
• New properties for WebshopOrderApi. Affected endpoints: GET /v2/webshoporders and GET /v2/webshoporders/{webshopOrderId}. Added several properties related to customer information, notes and message threads.

❗ Changed

• Changed the property IsVatFree to no longer be read only. Affected endpoints: POST /v2/quotes, PUT /v2/quotes/{id}, POST /v2/quotedrafts and PUT /v2/quotedrafts.
• Changed the property Phone to no longer be required for Swedish companies. Affected endpoint: PUT /v2/companysettings.
• Changed POST /v2/salesdocumentattachments/order and POST /v2/salesdocumentattachments/quote body to now accept multi-part upload of image files.

🐛 Fixed

• Fixed an issue where the property OrderDate was not queryable in the endpoint GET /v2/webshoporders.
• Fixed an issue with the property CcRecipients where sending null not ignoring default cc recipients properly. When sending with value null it will be correctly ignored now. Affected endpoints: POST /v2/customerinvoices/{invoiceId}/email, POST /v2/orders/{id}/email and POST /v2/quotes/{id}/email.
• Fixed an issue where the property Gln wasn't mapped correctly in the response. Affected endpoint: GET /v2/companysettings.
• Fixed an issue where the property TermsOfPayment wasn't mapped correctly in the response. Affected endpoints: GET /v2/customers and GET /v2/customers/{customerId}.
• Fixed an issue where time stamps did not take the time zone of the company into consideration when sending payments around midnight. This would cause payment date to be parsed as the following day, which would throw false validation errors. Affected endpoints: POST v2/supplierinvoices/{invoiceId}/payments and POST v2/customerinvoices/{invoiceId}/payments.
• Fixed an issue where wrong validation error is given when posting an order with a order date in a non existing fiscal year. Error 3001 is now correctly thrown instead. Affected endpoint: POST /v2/orders.
• Fixed an issue where wrong order date was set on a newly created order that was converted from a quote using POST /v2/quotes/{id}/converttoorder.