Version 2.33.0 of the Le New Black Wholesale API v2 is live. It lets you send the discount of an order when you archive it and the sales order reference of an order, saves the purchase order reference you send when you update an order, adds the proforma invoice sales document type, lets you schedule the email notification of a sales document to the retailer, and removes two promotion fields deprecated since 2.27.0.
What may need a change in your integration
-
Two promotion fields are removed.
GET /promotionsno longer returnsorder_scope_order_modeandorder_scope_product_minimum, deprecated since 2.27.0 and announced for removal in this version. Neither had any effect on how a promotion applies: if your integration still reads them, stop reading them. The tier conditions (minimum and maximum quantity, minimum and maximum amount) are unchanged. -
Archive orders. Nothing to change:
discount_rateis optional, and an archive order sent without it is created exactly as before. -
Order updates. If your integration sends
purchase_order_referencewhen it updates an order, check that it sends the value you want to keep: from this version, that value replaces the one on the order. -
Sales order reference. The field is optional: an order sent without it is handled exactly as before. If your integration already sent
sales_order_reference, for instance by sending back an order read withGET /orders, it used to be ignored and is now saved: check that it carries the value you want on the order. -
Sales document notification. Nothing is required:
status_notificationis optional, a sales document sent without it is created with no notification, as before, and an update without it keeps the current status. -
Sales document type. If your integration maps every sales document type, add
proforma.
New
-
Order discount on archive orders.
POST /orders_archiveaccepts a new optional field,discount_rate: the discount rate of the order in %, from 0 to 100, applied to the whole order. It is the same fieldGET /ordersreturns, and the same value as the "Order discount" column of the archive orders file import. Without it, the archived order carries no discount, as before. -
Validation. A negative value, a value above 100 or a value that is not a number, a numeric string such as
"10"included, refuses the order and returns an error namingdiscount_rate. -
Sales order reference.
POST /ordersandPOST /orders_archiveaccept a new optional field,sales_order_reference: the order number of your system, the same fieldGET /ordersreturns. It is saved when not empty, on a new order as on an order update; an empty or absent value keeps the current one. The order file imports take the same value in a new "Sales order reference" column. -
Proforma invoice.
POST /sales_documentsaccepts a newtypevalue,proforma, in theinvoicingcategory.GET /sales_documentsreturns it and can filter on it. The sales documents file import takes the same type. -
Notification status.
POST /sales_documentsaccepts a new optional field,status_notification, andGET /sales_documentsreturns it.none: no notification.scheduled: the retailer is notified by email by the next scheduled run, once the document has a file and at least one linked order.sent: the document is considered already notified and nothing is sent. The sales documents file import takes the same value in a new "Notification status" column.
Fixed
-
Purchase order reference on an order update. When you update an order with
POST /orders(referencegiven), thepurchase_order_referenceyou send is now saved on the order: it used to be accepted and ignored. Leave the field out to keep the current one.
The details are in the 2.33.0 release notes, and every version is listed on Wholesale API v2 versions.
Comments
0 comments
Please sign in to leave a comment.