From March 28, 2024, the GET /customer operation in the Customer service returns information whether the user account is active. The information is returned in a new status field with possible values: ACTIVE or INACTIVE
Improve reliability of services under IC APIs
At the end of March, technical changes were made to most IC API services in order to reduce service dependencies to other components. The goal of the changes is to make the IC API more accessible to all customers.
New information about goods has been added
From March 28, 2024, new information about goods is returned in the Inventory, Price List, Sales services, i.e.:
- index - product index
- name - product name
- description - product description
- gtuCode - GTU code
Adding the functionality of calling services using the product index
From March 26, 2024, it was possible to call services using the item index instead of the sku code. Functionality added in services:
- Inventory
- Pricing
- Sales
Example of calling the Invetory POST /stock operation
{
"index": "290 887,500317793"
}
Adding the functionality of placing orders with choosing the delivery method for UA users
On March 13, 2024, the ability to place orders by specifying the delivery method was added for UA accounts. To use the new function, you must send the deliveryMethod element with the SHOP or SHIPMENT value in the message body.
Example of calling the POST /sales/requisition operation of the Sales service with a delivery method:
{
"deliveryMethod": "SHIPMENT",
"lines": [
{
"index": "LY1121",
"requiredQuantity": 1
}
]
}
Returning new information about a user's finances
On February 28, 2024, a new version of Customer Service was released. New information about finances has been added in the GET /finances operation, i.e.:
- availableCreditLimit
- notInvoicedOrders
Vat invoice number in Delivery services
On 12.20.2023, a new version of the delivery service was implemented allowing to directly retrieve the associated invoice number. The additional field is available as fiscalDocumentNumber:
[
{
"id": "193834/AAA/2024",
"orderId": "154548/AAA/2024",
"billTo": "112790",
"shipTo": "112790",
"shipFrom": "AAA",
"deliveryMethod": "I",
"creationDate": "2024-04-11T13:23:20+02:00",
"currencyCode": "PLN",
"fiscalDocumentNumber": "00037557/AAA/24/F",
"lines": [
{
"index": "111 2222 31",
"sku": "AAAAAA",
"name": "Rozrząd kpl. (pasek + rolka + pompa cieczy)",
"shippedQuantity": 1,
"returnedQuantity": 0,
"unitPriceNet": 265.05,
"unitPriceGross": 326.01,
"vatPercentage": 23,
"totalNet": 265.05,
"totalGross": 326.01
}
]
}
]
Sku parameter validation
On December 6, sku parameter validation was introduced in the Inventory and Price services. If an invalid value is provided in the response, an HTTP header named "skipSkuList" will be returned with information about the sku that has been ignored. If none of the parameters are valid, a validation error message will be returned.
Adding alternative delivery methods when placing orders
From November 22, 2023, it is possible to place orders using alternative delivery methods, i.e. PARCEL LOCKERS and XPRESS DELIVERY. In order to use the added functionality, the user account must be properly configured in the IC system, and when placing an order, the user must add the deliveryMethod element with the appropriate value to the POST operation /ic/sales/requisition.
Possible values for deliveryMethod:
- 5 - XPRESS DELIVERY
- 6 - PARCEL LOCKERS
Returning information about a split order
On September 4, 2023, a change was introduced to the POST /ic/sales/requisition ordering operation. Now the operation response can return several orders instead of one. This happens when an order is divided into several orders.
