API Changelog

Integrate weclapp with other applications or services with our REST API. Sign up here for our API newsletter.

Our complete API documentation can be found here: weclapp API. Previous API changes and other changes can be read in the changelog.

Preview Version 22.12.1 - June 30th, 2022

Changes in /paymentMethod

  • Reading clearingAccountId requires app „Accounting administrator“/“Accounting“.
  • Updating autoClearingAccountTransaction requires app „Accounting administrator“/“Accounting“.

Changes in /shipment

  • /shipment now supports DELETE.

Changes in /incomingGoods

  • /incomingGoods now supports DELETE.
  • /incomingGoods property relatedShipmentId is only visible for users with permission „Shipment read“.

Version 22.11.1 - June 15th, 2022

Articles

  • Breaking API Change: The field articleCategoryId in /article/priceCalculationParameters has been removed.
  • /articleSupplySource now supports DELETE.

Improved error handling

weclapp API error responses are now basically conformant to RFC 7807, with some notable differences:

  • The migration to the RFC 7807 structure is an ongoing process, so some compatibility mechanisms are in place until further notice:
    • The responses come with „Content-Type: application/json“ instead of „Content-Type: application/problem+json“
    • The „unstructured“ error responses that have been in use until now are still part of the response JSON, so existing code should work without changes.
    • Detail information that should be there according to the new structure may be still missing. This applies especially to validation errors.
  • Two custom fields have been added to the response structure: „location“ and „validationErrors“.

The detailed documentation for the response structure and individual errors is part of the weclapp API documentation.

Version 22.10.1 - June 2nd, 2022

Users

Extension of the endpoint /user. For „My weclapp administrator“ the endpoint now supports:

  • POST
  • PUT
  • DELETE

Articles

Added properties in /article:

  • launchDate (integer)
  • sellFromDate (integer)
  • sellByDate (integer) – must be after sellFromDate
  • supportUntilDate (integer)

Quotations

Added properties to /quotation

  • requestDate (integer)
  • defaultShippingCarrierId (string)
  • defaultShippingCarrierName (string)

Purchase Invoices

Added properties to /purchaseInvoice:

  • deliveryAddress (object)
  • invoiceAddress (object)

The new properties deliveryAddress and invoiceAddress will show „my delivery address“ and „my invoice address“ now, just how it’s implemented for purchase orders.

The property recordAddress will now provide the address of the supplier of the record (also same behaviour as for purchase orders).

Contracts

Changes to /contract. The fields cancellationPeriodUnit and cancellationPeriodSoftframe can no longer be set to null, if the field cancellationPeriodQuantity isn’t empty.

Version 22.09.1 - May 19th, 2022

Changes in /article

Added properties:

  • plannedWorkingTimePerUnit (string)
  • invoicingType (string) – possible values: [EFFORT; FIXED_PRICE]

Added value to marginCalculationPriceType: EMPLOYEE_COST

Changes in /quotation

Added properties in quotationItem:

  • serviceItem (boolean)
  • plannedWorkingTimePerUnit (string)
  • invoicingType (string) – possible values: [EFFORT; FIXED_PRICE]

Changes in /salesOrder

Added properties in salesOrderItem:

  • serviceItem (boolean)
  • plannedWorkingTimePerUnit (string)
  • invoicingType (string) – possible values: [EFFORT; FIXED_PRICE]

New endpoint /placeOfService

Added properties:

  • active (boolean)
  • description (string)
  • name (string)
  • positionNumber (integer)

Changes in /customAttributeDefinition

Add values to attributeEntityType:

  • blanketPurchaseOrder
  • performanceRecord

Changes in /sepaDirectDebitMandate

Property firstDebit (boolean) is required.

Changes for several record endpoints

Following endpoints do not longer support service items:

  • /blanketPurchaseOrder
  • /incomingGoods
  • /productionOrder
  • /purchaseOrder (purchaseOrderType: TRIANGULAR, BLANKET_PURCHASE_ORDER)
  • /purchaseOrderRequest
  • /salesOrder (salesOrderPaymentType: COUNTER_SALES, invoicingType: EFFORT)
  • /shipment

Version 22.08.1 - April 21st, 2022

Changes in /purchaseInvoice

/purchaseInvoice now supports DELETE.

Changes in /purchaseOrder

/purchaseOrder now supports DELETE.

Changes in /bankAccount

Added enum property automaticProcessing.

Possible values:
NONE, CLEAR, BOOK, PROCESS.

Changes in /article

  • /article: the following properties are reset to null if the provided article type is „SERVICE“ or „SHIPPING_COST“ since they are unused:
    • articleGrossWeight
    • articleNetWeight
    • articleLength
    • articleWidth
    • articleHeight
    • countryOfOriginCode
    • customsDescription
    • customsTariffNumber
    • customsTariffNumberId
    • manufacturerId
    • manufacturerName
    • manufacturerPartNumber
    • producerType
  • /article: the following additional properties are reset if the provided article type is „SHIPPING_COST“ since they are unused:
    • articleImages -> [] (existing images for this article will be removed)
    • applyCashDiscount -> false
    • description -> null
    • ean -> null
    • longText -> null
    • quantityConversions -> [] (existing quantity conversions for this article will be removed)
    • recordItemGroupName -> null
    • shortDescription1 -> null
    • shortDescription2 -> null
  • /article property productionBillOfMaterialItems will only be visible for ERP administrators of ERP retail license.
  • /article property productionArticle will only be editable for ERP administrators of ERP retail license.

Version 22.07.1 - April 7th, 2022

Changes in /article

Added some article related properties:

  • barcode (string)
  • producerType (string)
  • quantityConversions (array)
  • priceCalculationParameters (array)

Added support for collective incoming shipments

Affected existing endpoint: /purchaseOrder/id/<id>/createIncomingGoods

Add the optional parameter additionalPurchaseOrderIds (array(string)). It is possible to pass orders to add one or more Order/OrderItems as incoming goods.

New endpoint: /incomingGoods/id/<id>/addPurchaseOrders

Adds purchase orders with provided ids (array(string)) to given incomingGoods.

Changes in /bankAccount

Fixed bug at DELETE: Restrict deletion of a bank account the same way as the UI would do.

Add connection failure message – Added property:

  •  connectionFailure (string)

Further Changes

Added property in /notification:

  • priority (string)

Version 22.06.1 - March 24th, 2022

General improvements

  • Improve handling for PUT requests and ignoreMissingProperties=true. Setting nested objects to „null“ or removing their values will be handled correctly from now on.
  • Improve error handling for invalid POST + PUT requests. An improved error message is now displayed.

Purchase Order

Added tracking information in /purchaseOrder.

Added properties:

  • shippingCarrierId (string)
  • packageTrackingNumber (string)
  • packageTrackingUrl (string)

Production Order

Changes in /productionOrder:

The status can be set back to „ENTRY_IN_PROGRESS“.

Sales Order

PUT /salesOrder:

When switching the invoice recipient of a sales order, also switch the invoice recipient of all connected and uncancelled shipments.

Incoming Goods

New endpoint /incomingGoods/id/<id>/createSupplierReturn.
Provide new endpoint to allow creating a supplier return for a customer return.

Properties:

  • purchaseOrderId (string)
  • supplierId (string)

External Connections

/externalConnection:

Removed connectionType „EPOST“.

Version 22.05.1 - March 10th, 2022

Change in /calendarEvent

Breaking API Change:

Changed /calendarEvent to return the standard entity reference structure in the „references“ property instead of the previous custom one. Now the property is an array of objects, each with „entityName“ (name of the referenced endpoint) and „entityId“ (ID of the referenced entity) and nothing else.

Permission change in /article

Users can only update the properties batchNumberRequired and serialNumberRequired, if they are assigned app „Cloud ERP retail: ERP administrator“ or „Enterprise Resource Planning: Administrator“. Users with app „Cloud ERP service: ERP administrator“ will no longer be able to update these properties.

Version 22.04.1 - February 24th, 2022

Sales Invoice

PUT /salesInvoice

Title of sales invoice item is now editable for sales invoices with sales invoice type „FINAL_INVOICE“.

Improvements for Purchase Invoice

Extend /purchaseInvoice

Add read-only property purchaseInvoiceItems.purchaseInvoiceItemRelationship to be able to access the multi-relationship on items layer. This property provides full path filter support.

Included properties:

  • purchaseInvoiceItemId (string)
  • quantity (string)
  • shipmentItemId (string)
  • supplierOrderItemId (string)

Improve curreny conversion

The behavior when changing the currency of a purchase invoice has been improved and now results in a correct currency conversion.

Forms

Add factoring property to customer and records.

New boolean property „factoring“ available for /party (customer = true required) and the following record endpoints:

  • /contract (contract party must be a customer)
  • /quotation
  • /salesInvoice
  • /salesOrder 

Extend /serialNumber

customAttributes are now updatable via PUT.

Provide contracts

New endpoint /contract

Supported methods: GET, POST, PUT, DELETE

Supported properties of /contract:

  • additionalAddresses (array)
  • authorizationUnitId (string)
  • automaticExtension (boolean)
  • billUntil (string)
  • billingDay (integer)
  • billingTargetInvoiceStatus (string)
  • billingType (string)
  • cancellationDate (integer)
  • cancellationPeriodQuantity (integer)
  • cancellationPeriodSoftframe (string)
  • cancellationPeriodUnit (string)
  • commercialLanguage (string)
  • commission (string)
  • contractDate (integer)
  • contractItems (array)
  • contractNumber (string)
  • contractNumberAtParty (string)
  • contractStatus (string)
  • correspondenceAddress (object)
  • customAttributes (array)
  • deliveryAddress (object)
  • deliveryEmailAddresses (object)
  • description (string)
  • differingCorrespondenceAddress (boolean)
  • differingDeliveryAddress (boolean)
  • differingInvoiceAddress (boolean)
  • endDate (integer)
  • extensionQuantity (integer)
  • extensionUnit (string)
  • factoring (boolean)
  • invoiceAddress (object)
  • invoiceRecipientId (string)
  • latestCancellationWarningQuantity (integer)
  • latestCancellationWarningUnit (string)
  • latestPossibleTerminationDate (integer)
  • name (string)
  • nextContractBillingDate (integer)
  • nonStandardInputTaxId (string)
  • orderNumberAtCustomer (string)
  • partyId (string)
  • paymentMethodId (string)
  • pricingDate (integer)
  • purchaseEmailAddresses (object)
  • recordComment (string)
  • recordCurrencyId (string)
  • recordEmailAddresses (object)
  • recordFreeText (string)
  • recordOpening (string)
  • reminderDate (integer)
  • reminderSendType (string)
  • reminderType (string)
  • responsibleUserId (string)
  • salesChannel (string)
  • salesInvoiceEmailAddresses (object)
  • salesOrderEmailAddresses (object)
  • startDate (integer)
  • template (boolean)
  • termOfPaymentId (string)
  • terminationReasonId (string)
  • types (array)
  • unlimited (boolean)

Contract Item properties

Supported properties of contract items:

  • addPageBreakBefore (boolean)
  • articleId (string)
  • articleNumber (string)
  • billingGroupId (string)
  • costTypeId (string)
  • customAttributes (array)
  • description (string)
  • descriptionFixed (boolean)
  • discountPercentage (string)
  • freeTextItem (boolean)
  • grossAmount (string)
  • grossAmountInCompanyCurrency (string)
  • groupName (string)
  • interval (string)
  • intervalType (string)
  • manualUnitPrice (boolean)
  • netAmount (string)
  • netAmountForStatistics (string)
  • netAmountForStatisticsInCompanyCurrency (string)
  • netAmountInCompanyCurrency (string)
  • nextContractBillingDate (integer)
  • note (string)
  • parentItemId (string)
  • positionNumber (integer)
  • previousContractBillingDate (integer)
  • quantity (string)
  • reductionAdditionItems (array)
  • taxId (string)
  • title (string)
  • type (string)
  • unitId (string)
  • unitPrice (string)
  • unitPriceInCompanyCurrency (string)
  • validFrom (integer)
  • validTo (integer)

New endpoint /contractBillingGroup

Supported methods: GET, POST, PUT, DELETE

Properties:

  • active (boolean)
  • description (string)
  • name (string)
  • positionNumber (integer)

New endpoint /contractTerminationReason

Supported methods: GET, POST, PUT, DELETE

Properties:

  • active (boolean)
  • description (string)
  • name (string)
  • positionNumber (integer)

New endpoint /contractAuthorizationUnit

Supported method: GET

Properties:

  • name (string)

Extend record items

Add descriptionFixed (boolean) to all record items.

Affected endpoints:

  • /incomingGoods
  • /purchaseInvoice
  • /purchaseOrder
  • /purchaseOrderRequest
  • /purchaseOrder
  • /quotation
  • /salesInvoice
  • /salesOrder
  • /shipment

Version 22.03.1 - February 10th, 2022

Sales Invoice

/salesInvoice

Added property:

  • cancellationNumber (String, readOnly)

Store

/warehouseStockMovement:

Add customAttribute support

Added properties:

  • userId (String)
  • customAttributes (Array)

Extend additional fields

/customAttributeDefinition

Added properties:

  • defaultStringValue (String)
  • defaultNumberValue (String)
  • defaultDateValue (Date)
  • defaultBooleanValue (Boolean)

Added property in selectableValuesdefaultValue (Boolean)

Version 22.02.1 - January 27th, 2022

Production Order

/productionOrder

Provides filter support for productionOrderItems.

Sales Order

/salesOrder

There will be a separate permission for each salesOrderPaymentType. A /salesOrder update operation will only be possible, if the user has permission for its salesOrderPaymentType.

/party

Added property customerSalesOrderPaymentType (string)

Purchase Order

/purchaseOrder

Added property invoicedQuantity (String) to purchaseOrderItems.

Purchase Invoice

/purchaseInvoice

The invoiceDate is now used to calculate the dueDate when creating a purchaseInvoice via API instead of the former used createdDate.

Added property:

  • senderCountryCode (string)

Article Supply Source

/articleSupplySource

The field articleNumber can now contain commas and semicolons

New endpoints for calendar

/calendar

Properties:

  • caldavAccountId (string)
  • calendarColor (string)
  • calendarKey (string)
  • calendarSharingPermissions (array)
  • lastEventsSyncToken (string)
  • mailAccountId (string)
  • name (string)
  • ownerId (string)
  • sharePrivateEvents (boolean)
  • synchronize (boolean)

SharingPermission properties:

  • permissionType (string)
  • userId (string)

/calendarEvent

Properties:

  • calendarId (string, readOnly)
  • userId (string, readOnly)
  • subject (string)
  • description (string)
  • startDate (integer)
  • endDate (integer)
  • location (string)
  • privateEvent (boolean)
  • concerningId (string)
  • contactId (string)
  • deleted (boolean, readOnly)
  • allDayEvent (boolean)
  • reminderTime (integer)
  • reminderSendType (string)
  • showAs (string)
  • references (array)
  • recurringEvent (object)
  • attendees (array)

Reference properties:

  • calendarEventId (string)
  • entityName (string)
  • entityId (string)

RecurringEvent properties:

  • endsOn (integer)
  • eventType (string)
  • repeatOn (string)
  • eventInterval (integer)
  • eventOccurrenceCount (integer)

Attendee properties:

  • calendarEventId (string)
  • userId (string)
  • eventPermission (string)
  • attendeeStatus (string)

Article

/article

The specific permission „Article edit article type“ which currently only the role „ERP aministrator“ has, will be necessary to update the following /article properties:

  • articleType
  • storable
  • batchNumberRequired
  • serialNumberRequired
  • availableInSale
  • productionArticle
  • showOnDeliveryNote
  • billOfMaterialPartDeliveryPossible
  • useSalesBillOfMaterialItemPrices
  • useSalesBillOfMaterialItemPricesForPurchase

/article property articleCategoryId is only visible with permission „Merchandise category read“.

/article property articlePrices is only visible with permission „Article price read“.

/article query filter properties articleCategoryId, articleCategory are only available with permission „Merchandise category read“.

/article query filter properties minimumStockQuantity, targetStockQuantity, articleAlternativeQuantities are only available with permission „Supply source read“.

/article query filter property showOnDeliveryNote is only available with permission „Article edit delivery information“.

/article query filter properties articlePrices is only available with permission „Article price read“.

Variant Article

/variantArticle

Added property positionNumber (integer) to variantArticleVariant.

/variantArticleVariant

Added property positionNumber (integer, readonly)

New endpoints for CRM

/party

Added properties:

  • customerNonStandardTaxId(string)
  • supplierNonStandardTaxId (string)
  • invoiceBlock (boolean)

/customer

Added property:

  • nonStandardTaxId (string)
  • incoiceBlock (boolean)

/supplier

Added property:

  • nonStandardTaxId (string)

Version 22.01.1 - January 13th, 2022

Quotation

/quotation: If user does not have permission „Store read“, hide properties:

  • warehouseId
  • warehouseName

Sales Order

/salesOrder now supports DELETE.

Purchase Order

/purchaseOrder: Allow mapping of a purchase order item to an existing blanket purchase order.

Added properties:

  • blanketPurchaseOrderId (string)
  • blanketPurchaseOrderReleaseId (string, readonly)

/blanketPurchaseOrder: Indicate if the above mapping is possible for a blanket purchase order (residualQuantity > 0 is required).

Added property:

  • residualQuantity (string, readonly)

Fulfillment Provider

/fulfillmentProvider: If user does not have permission „Store read“, hide property warehouseId.

Creating Supplier Returns

From now a supplier return can also be created via the API.

with relation to supplier

endpoint: POST /shipment

mandatory field:

„shipmentType“: „SUPPLIER_RETURN“
„recipientPartyId“: <supplierId>

with relation to purchaseOrder

endpoint: POST /purchaseOrder/id/:id/createSupplierReturn

New endpoints for Accounting & Finance

/costType

New endpoint /costType is available for: GET, POST, PUT and DELETE.

Property:

  • name (string)

/bankAccount

New endpoint /bankAccount is available for: GET, POST, PUT and DELETE.

Properties:

  • accountHolder (string)
  • accountId (string)
  • accountNumber (string)
  • active (boolean)
  • autoSync (boolean)
  • balance (string, readonly)
  • bankCode (string)
  • creditInstitute (string)
  • creditInstituteCity (string)
  • creditInstituteStreet (string)
  • creditInstituteZip (string)
  • creditLine (string)
  • currencyId (string)
  • differentSepaCreditorIdentifier (string)
  • enabledForElectronicPaymentTransactions (boolean)
  • iban (string)
  • incidentalCostsOfMonetaryTrafficAccountId (string)
  • incidentalCostsOfMonetaryTrafficTaxId (string)
  • lastDownload (integer, readonly)
  • primary (boolean)
  • qrIban (string)
  • qrIdentifier (string)
  • swiftBic (string)

/sepaDirectDebitMandate

New endpoint: /sepaDirectDebitMandate is available for: GET, POST, PUT and DELETE.

Required properties:

  • bankAccountId (string)
  • partyBankAccountId (string)
  • mandateReference (string)

Optional properties:

  • description (string)
  • signatureDate (integer)
  • cancellationDate (integer)
  • firstDebit (boolean)
  • runtime (string)
  • type (string)

/PaymentMethod

Improvements for /PaymentMethod

From now it’s possible to read and update the following values via API:

  • reference (string)
  • documentText (string)
  • discountPercentage (string)
  • discountValue (string)
  • type (string)
  • clearingAccount (string)
  • autoClearingAccountTransaction (boolean)

Comments

Added constraints for UPDATE/CREATE of shouts

      • if (privateComment AND publicComment)
        throw „comments cannot be private and published at the same time“
      • if (solution AND NOT publicComment)
        throw „comment marked as solution must be public
      • if isChildComment
        • if mixed entities ; eg. project comment with ticket subComment
          throw „referenced entities are not the same for parent and child comment
        • if subComment of subComment
          throw „only one level of child comments is allowed
        • if solution
          throw „comments with parent cannot be solution
        • if (privateComment OR publicComment)
          throw „comments with parent cannot be private or public
      • if service does not support public comments (this is currently only available for Tickets)
        • if (NOT privateComment AND NOT publicComment)
          throw „comments have to be either private or public“
        • if solution
          throw „comment cannot be a solution“

Version 21.20.1 - November 25th, 2021

Blanket Purchase Orders

Blanket purchase orders are now available via API with the new endpoint /blanketPurchaseOrder.

This endpoint can be used to create, read, edit and delete blanket purchase orders.

Available for: GET, POST, PUT, DELETE

Possible status:
NEW
DOCUMENT_PRINTED
CONFIRMED
CLOSED
CANCELLED

You can generate releases for a blanket purchase order with
POST /blanketPurchaseOrder/id/{id}/generateReleases

You can download the latest blanket purchase order document (if existent) with
GET /blanketPurchaseOrder/id/{id}/downloadLatestBlanketPurchaseOrderPdf

Endpoint /customsTariffNumber

Added property: description (string)

Affected endpoints:

  • /articleAccountingCode
  • /articleRating
  • /companySize
  • /costCenterGroup
  • /customerLeadLossReason
  • /customerTopic
  • /customsTariffNumber
  • /leadRating
  • /leadSource
  • /legalForm
  • /manufacturer
  • /opportunityTopic
  • /opportunityWinLossReason
  • /partyRating
  • /personalAccountingCode
  • /sector
  • /title

Dropshipping Improvements

  • /purchaseOrder: The order item quantity for a dropshipping purchase order is now validated such that it cannot be larger than the open shipping quantity of the linked sales order.
  • /salesOrder: The order item quantity is now validated such that it cannot be smaller than the quantity contained in possible linked dropshipping purchase orders.
  • /salesOrder/id/:id/createDropshipping: Creation of a dropshipping purchase order is not possible if all sales order items already belong to valid shipments or other dropshipping purchase orders.

Version 21.19.1 - November 11th, 2021

Articles: Added properties for disposition settings

Article related settings „Safety stock days“, „Avg. delivery time“, „Minimum order quantity“ and „Fixed order quantity“ data can be read and update through API from now. Also „Low-level code“ can be read through API.

Endpoint /article

Added properties:

    • fixedPurchaseQuantity  (string)
    • minimumPurchaseQuantity (string)
    • safetyStockDays (integer)
    • averageDeliveryTime (integer)
    • lowLevelCode (integer, readonly)

Endpoint /articleSupplySource

Added properties:

    • fixedPurchaseQuantity (string)
    • minimumPurchaseQuantity (string)

Shipments

Endpoint /shippingCarrier

Added writeable property active (boolean) to shippingCarrier endpoint in order to be able to see which shipping carriers are active as well as the possibility of activating and deactivating shipping carriers.

Endpoint /shipment

New fields in shipment:

    • packageReturnTrackingNumber(string)
    • packageReturnTrackingURL(string)

General Improvements

Using system custom attributes to filter

Allow to filter entities using system custom attributes.

Add currency conversion information

Added read-only properties for currency conversion:

    • currencyConversionRate (string)
    • currencyConversionDate (integer)

Affected endpoints:

    • /purchaseInvoice
    • /purchaseOrder
    • /purchaseOrderRequestOffer
    • /quotation
    • /salesOrder
    • /salesInvoice
    • /shipment

Extend /termsOfPayment

From now it’s possible to read and update the following values via API:

    • reference (string)
    • validFrom (integer)
    • validTo (integer)

Extended validation

Properties of type boolean may no longer be null, which was still possible in certain cases up to now.

Version 21.18.1 – October 28th, 2021

Add more values to onlineAccount

  • AMAZON
  • EBAY
  • GOOGLE_DRIVE

New Endpoints for Personal Accounting Code and Article Accounting Code

New endpoints /articleAccountingCode and /personalAccountingCode are available for: GET, POST, PUT and DELETE. Only the field „name“ is mandatory for the POST method.

Changes for Endpoint Shipment

Regardless of the status of the shipment, the following fields are always editable:

  • shippingCarrierId
  • shippingCarrierName
  • shippingReturnCarrierId
  • shippingReturnCarrierName
  • additionalDeliveryInformation

Add more values to internalShippingCarrier

  • FEDEX_INTERNATIONAL_ECONOM
  • FEDEX_INTERNATIONAL_PRIORITY

Extensions at the /productionOrder endpoint

The following new properties are added:

  • allWithdrawalsConfirmed (boolean)
  • articleId (string)
  • articleNumber (string)
  • assignedPickingUserId (string)
  • assignedPickingUserUpdateDate (integer)
  • assignedPickingUserUsername (string)
  • pickingInstructions (string)
  • withdrawalsComplete (boolean)

Version 21.17.1 – October 14th, 2021

New endpoint for quotations

With the newly available endpoint /quotation/id/{id}/createQuotationPdf it is possible to create and download a quotation document.

Shipments & Incoming Goods

Shipment api: Shipments won’t be shown anymore if the recipientParty is a party which the user can’t see (Setting „May only view own contacts“ enabled at user)

Incoming goods api: Incoming goods won’t be shown anymore if the senderParty is a party which the user can’t see (Setting „May only view own contacts“ enabled at user)

User is added to documents API endpoint

When retrieving document information, the user, who uploaded the document, is now also displayed.
Fields: userId

New field for record endpoints

New field disableEmailTemplate (Boolean) for the following record endpoints:

/purchaseOrderRequest, /shipment, /incomingGoods, /purchaseOrder, /purchaseInvoice, /salesInvoice, /salesOrder, /quotation

Italy: Fattura Elettronica

If the optional invoice workflow action „Create Fattura elettronica-XML“ is active, sales orders of payment type „retail sale“ cannot be created anymore.

Version 21.16.1 – September 30th, 2021

External connections

New endpoint /externalConnection

Used to get the name and externalConnectionType of externalConnections. ExternalConnections are used in the new ecommerceOrder attribute of salesOrders.

New article fields

With our external connections improvements, system additional fields (per store connection) are added as customAttributes to articles. The following attributes were added:

  • Showare5, Shopware6, Magento1, Magento2, WooCommerce & Shopify: „Available in shop“, „Active in shop“ and „Sync stock“
  • Shopify: „Variant ID“ & „Product ID“
  • Shopware 6: „Sales Channel“.
  • ITscope & Synaxon: „Available in shop
  • Amazon: „Sync stock


Breaking API Change:
In this context the article fieldavailableInShopis removed
and will be listed under customAttributes of the article.


Removement of Amazon Article fields

Breaking API Change: Amazon fields  amazonSKU, amazonFBASKU, amazonSmallLightSku and amazonASIN have been removed from the API and will be listed under customAttributes of the article.

 

New field ecommerceOrder and attributes for sales orders and sales order items

ecommerceOrderis added as new field with the the following attributes:

  • ecommerceId ->Shop-ID for this sales order
  • externalConnectionId-> weclapp ID for external connection 
  • externalConnectionName -> name external connection
  • ecommerceOrderItemId -> for shops OrderId and for Amazon OrderItemId is listed

Custom Attributes

systemCustomAttribute is a new boolean attribute of /customAttributeDefinition. It’s not changeable or setable via the API (New creation sets “false”).

New fields & endpoint for articles

New fields expenseAccountId and expenseAccountNumber for endpoint /article.

New field customsDescription in endpoint /article.

Party Salutation

The field „salutation“ in /party now also accepts the value „NO_SALUTATION“.

Shipments

New endpoint for shipments

Create an invoice from shipment by using POST /shipment/id/{id}/createSalesInvoice

Thus an invoice can be created directly from shipment, before it was only possible from sales order.

New fields for shipment addresses

Incoming Goods

  • customerDeliveryAddress: Primary shipping address of the customer in case of a return
  • customerInvoiceAddress:Primary billing address of the customer in case of a return
  • invoiceAddress:Billing address

 Shipments

  • invoiceAddress: Different billing address
  • shippedFromAddress: Own company address

Additionally all fields are available via PUT.

Improved validation for /contact

When creating a contact, the API now tells the requester which mandatory field is not filled.

Italy

Fattura Elettronica

Breaking API Change: The field fatturaElettronicaXmlDocumentType in endpoint salesInvoice is removed and instead an additional attribute can be filled with the same values.

Habitual Exporter

New fields for endpoint /party

  • habitualExporter writable for customers
  • purchaseViaPlafond writable for suppliers
  • partyHabitualExporterLettersOfIntent writable for customers with habitualExporter = true and for suppliers with purchaseViaPlafond = true

New field for endpoints /purchaseInvoice and /purchaseOrder

  • supplierHabitualExporterLetterOfIntentId writable to select a letter of intent in purchase order or purchase invoice

New field for /salesInvoice and /salesOrder

  • customerHabitualExporterLetterOfIntentId writable to select a letter of intent in sales order or sales invoice

To write all of the above fields, „Habitual Exporter & Purchase via Plafond“ needs to be enabled in CRM settings.

Version 21.15.1 – September 16th, 2021

Description for sales and purchase prices

The field name has been added for reductionAdditions.

Available for endpoints:
/articlePrice
/articleSupplySource
/article

 

Reference between shipments and purchase orders

For shipments, the reference to a purchase order was added.

This is relevant for supplier returns.

The purchase orders are referenced via: purchaseOrders (Array[id])

Version 21.14.1 – September 2nd, 2021

Unification of the field type „description“

  • html tags are now included for /description and can be passed to weclapp via PUT.
  • description field  is added for /purchaseOrderRequest, /productionOrder, /shipment.
  • description can now be edited by API, if the document is no longer in capture (previously this was only possible in the application)

HTML text editor for form texts

  • html text editor available for all form texts
  • API fields/recordComment, /recordFreeText, /recordOpening:html tags are now included, via PUT they can also be passed to weclapp accordingly.

Version 21.13.2 – August 26th, 2021

New fieldadvancePaymentStatus for endpoint /salesOrder

advancePaymentStatus as new property for sales orders.

Possible values are: null, OPEN or PAID

Version 21.13.1 – August 19th, 2021

User Setting: Not allowed to use API token

Decide if specific users should not be able to use the API token (My weclapp > User).

New fieldreservationsfor endpoint/warehouseStock

Reservations show the reserved quantity of the stock and the production order or shipment item for which the reservation is made.

"reservations": [
{"productionOrderItemId": "X",
"shipmentItemId": "X",
"reservedQuantity": "X" }
]

 

New field customerBusinessType for endpoint /party

New field customerBusinessType for the endpoint /party.
Possible values are: B2B, B2C, B2G

Version 21.12.1 – August 5th, 2021

Invoices

SalesInvoice can now be canceled via API by using the „VOID“ status.

Incoming Goods

incomingGoods can be cancelled by using the status „INCOMING_CANCELLED“.

New endpoint: legalForm

New endpoint legalForm is available with: GET, PUT, POST, DELETE

With this endpoint, legal forms can be created and edited.

Purchase Order Request

New fields for endpoint purchaseOrderRequest

* purchaseOrderRequestNumber
* salesOrderId
* salesOrderNumber
* quotationId
* quotationNumber

API Changes only for italian customers (using FatturaPA)

  • validation for sales invoice/credit note number range
  • deactivation of invoices/credit notes cancellation for italian tenants

Further details can be read in our Changelog as soon as published.

Version 21.10.1 – July 8th, 2021

Sales order items

  • The fields invoicedQuantity and shippedQuantity are now available for sales order items. The fields show how much has already been shipped/invoiced.

Version 21.09.1 – June 24th, 2021

Party

The supplier number of customer (customerSupplierNumber) has been added to the party entity. The field is available as GET and PUT.

Article

The „revenue account field“ (accountId) has been added and is available via GET and PUT.

Quotations

Accept or reject quotations by API. Set the field status to ACCEPTED or REJECTED. When accepting a quotation all items will be transfered to the next record, for example sales order.

Shipments

The declared value amount of shipments is now availably by API. The fields declaredValueAmount, declaredValueAmountCurrencyId and declaredValueAmountCurrencyName have been added to /shipment.

Customer Return

The differing invoice recipient for customer returns is now available by API. UseinvoiceRecipientId for /incomingGoods for incomingGoodsType = „CUSTOMER_RETURN“.

Sales Invoices

New read-only field paymentStatus for /salesInvoice.

Read by API if the sales invoice or credit note has no open item, has an open item, is paid, or cleared (with a credit note).

Quotation-, Sales Order- and Sales Invoice Items

The fields ServicePeriodFrom and ServicePeriodTo are available via GET, PUT, POST for quotation-/ salesOrder- and salesInvoiceItems.

Purchase Order & Purchase Invoice

The fields ServicePeriodFrom and ServicePeriodTo are available via GET, PUT, POST.

Version 21.08.1 – June 10th, 2021

Supplier requests

Supplier requests are now available via API with the new endpoint /purchaseOrderRequest

This endpoint can be used to read, edit or create supplier requests.

Available for: GET, POST, PUT, DELETE

Possible status:

  • NEW
  • CLOSED
  • CANCELLED
  • DOCUMENT_PRINTED
  • OFFER_RECEIVED

Status for purchaseOrderRequestOffers:

  • OPEN
  • REQUESTED
  • OFFER_RECEIVED
  • ACCEPTED

You can create a purchase order or a blanket purchase order from the supplier request:

POST /purchaseOrderRequest/id/{id}/createPurchaseOrder

POST /purchaseOrderRequest/id/{id}/createBlanketPurchaseOrder

Purchase order items

The fields plannedDeliveryDate and plannedShippingDate have been added to purchaseOrderItems.

Quotations

The fields warehouseId and warehouseName have been added to /quotation.

Shipments

The link of shipment items to sales order items is now available by API.

New field salesOrderItemId in shipmentItems in /shipment (read-only).

Version 21.07.1 – May 27th, 2021

New endpoint for  sales orders (salesOrder)

POST /createDropshipping
POST /createPurchaseOrder

This endpoint can be used to create a purchase order or a dropshipping from a sales order.

Upload shipping labels for shipments

Shipping labels (only PDF files) can now be uploaded for shipments. Use the parameters name and description (optional).
POST /shipment/id/{ID}/createShippingLabelPdf?name=XYZ&description=XYZ

Article cost centers

Article cost centers are now available via the API. Extension of the endpoint /article with the fields:

  • purchaseCostCenterId
  • purchaseCostCenterNumber
  • salesCostCenterId and
  • salesCostCenterNumber

 

Accounting transactions (accountingTransaction)

Next to the transactionDetails, the currency is now also part of the /accountingTransaction. New fields currencyId and currencyName in endpoint /accountingTransaction.

Changing the data types of some properties from integer to string

  • /incomingGoods
    purchaseOrderId (int -> string)
  • /salesOrder
    defaultShippingCarrierId,defaultShippingReturnCarrierId (int -> string)
  • /shipment
    shippingCarrierId, shippingReturnCarrierId (int -> string)

Version 21.06.1 – May 12th, 2021

Opportunities
Opportunities can be filtered by topics and topics can be used as referenced entities:
/webapp/api/v1/opportunity?topics.name-eq=<name>&includeReferencedEntities=topics.id

Version 21.05.1 – April 29th, 2021

Sales Order
New endpoint /salesOrder/id/{id}/shipOrderForExternalFulfillment
available for: POST

 

Sales and Purchase Invoices
Extension to up to five “costCenterItems” per “salesInvoiceItems” or per “purchaseInvoiceItems”.

Version 21.04.1 – April 15th, 2021

Phone Number in Addresses
The field „phoneNumber“ has been added to all addresses (e.g. for the endpoints/party, /salesOrder, /salesInvoice).

 

Opportunities

New endpoint /opportunityTopic (topics of opportunities)

Available for: GET, POST, PUT, DELETE

Extension of the opportunity endpoint /opportunity with the array field “topics”.

 

Tasks

Pivate tasks must have an agent.