Fastmag integration

Fastmag + Le New Black integration overview

Fastmag is a French ERP and POS software specialised in retail and fashion. Le New Black offers a collaborative B2B portal for your team and retailers, and an order-taking iPad app for your sales team.

 

	The connector uses the Fastmag API and the Le New Black API to exchange data (read docs)
	Fastmag and Le New Black both push and pull data
	The connector requires basic configuration in Le New Black and Fastmag

 

Data flows

Type	Flow
Customers	Fastmag ⇢ Le New Black
Products	Fastmag ⇢ Le New Black
Product images	Fastmag ⇢ Le New Black
Prices	Fastmag ⇢ Le New Black
Inventory stock levels	Fastmag ⇢ Le New Black
Orders	Fastmag ⇠ Le New Black

 

Data flow: Customers

Reference

Trigger: Sent by Fastmag through the Le New Black API.

Required fields: Customer: reference and name. Buyer: e-mail, first name and last name. Delivery address: reference, company and country.

Matching keys: Customer: retailer reference (the Fastmag customer code, also used to send the orders). Delivery address: address reference.

Import mode: Create or update → new customers are created, existing ones are updated.

Rejected rows: A customer missing a required field is rejected, and the Le New Black API returns the error to Fastmag.

Callouts

 

Data flow: Products

Reference

Trigger: Sent by Fastmag through the Le New Black API.

Required fields: Product: model, name, category, collection code and name, size range name and sizes. Variant: fabric code, fabric name and reference. Size: size name.

Matching keys: Product: model. Variant: fabric code. Collection: collection code. Category: category name. Size: size name, with its EAN13.

Import mode: Create or update → new products and variants are created, existing ones are updated.

Created on the fly: Collections, categories on three levels, fabrics and size ranges

Rejected rows: An EAN13 or SKU already used by another item in Le New Black is ignored and reported in the API response.

Callouts

 

Data flow: Product images

Reference

Trigger: Sent by Fastmag through the Le New Black API.

Required fields: Model, fabric code and image position (1 to 8), with the image file

Matching keys: Product: model. Variant: fabric code.

Import mode: Replace → the image sent replaces the image at the same position of the variant.

Rejected rows: An image whose model or fabric code is unknown in Le New Black is rejected: import products first.

 

Data flow: Prices

Reference

Trigger: Sent by Fastmag through the Le New Black API.

Price level: Per variant, or per size when Fastmag sends size-level prices.

Matching keys: Price list: price list code. Product: model. Variant: fabric code. Size: size name (size-level prices only).

Callouts

 

Data flow: Inventory stock levels

Reference

Trigger: Scheduled task, active once Le New Black has set up the flow for your brand. It can also be run on demand from the Integration center.

Quantity imported: The stock of the Fastmag store set in the global configuration, summed per EAN13: the on-hand stock by default, or the on-hand stock minus the quantities still to deliver on open Fastmag orders (setting stock_type)

Matching keys: Size: EAN13.

Import mode: Add by default → only the sizes in the Fastmag data are updated, the others keep their quantity. Replace, when set up → the stock of every size is set to 0 before the quantities are applied. Negative quantities are imported as 0.

Rejected rows: A Fastmag EAN13 unknown in Le New Black is ignored and reported in the task log: import products first.

Configuration

Setting	Values	Type	Comment
import_mode	add (default) / replace	string	With replace, the stock of every size is set to 0 before the quantities are applied
lnb_sku_identifier_column	ean13 (default) / sku	string	Le New Black key the stock rows are matched against
lnb_stock_column	quantity (default) / incoming_quantity	string	Le New Black quantity updated

Callouts

 

Data flow: Orders

Reference

Trigger: Scheduled task, active once Le New Black has set up the flow for your brand. It can also be run on demand from the Integration center.

Orders exported: Status Invoicing

Integration status: Only orders whose integration status is Pending are exported, and it becomes Successfully sent after export. The selection can be adapted during set-up.

Status after export: Closed

Blocked orders: An order that fails a check keeps its status and gets the integration status Blocked, with the reason in the task log. It is not sent again until you set its integration status back to Pending from the orders list (action Set integration status to Pending).

Limit: No limit

Sales order: A Fastmag order (COMMANDE) of the store set in the global configuration, for the order's customer, dated with the order's creation date, with the reference PO- followed by the Le New Black order number and a customer field as sector (setting lnb_retailer_secteur_column), and one line per ordered size (EAN13, quantity, unit price)

Matching keys: Customer: LNB retailer reference, sent as the Fastmag customer code. Products: EAN13.

Not synchronised: Discounts, shipping costs, delivery addresses and comments are not part of the order sent.

Configuration

Setting	Values	Type	Comment
lnb_retailer_secteur_column	retailer_extra_1 (default) / another Le New Black customer field	string	Le New Black customer field sent as the Fastmag sector of the order
validate_stock_ats	true / false	bool	With true, the orders are exported in stock allocation order: by status (Invoicing first), then by date

Callouts

 

Global configuration

Configuration

Setting	Values	Type	Comment
serveur	Fastmag server address	string	Address of your Fastmag account
enseigne	Fastmag chain code	string	Your chain in Fastmag
magasin	Fastmag store code	string	Store whose stock is imported and in which the orders are created
compte / motpasse	Fastmag account credentials	string	Credential of your Fastmag account, set up with your account manager
stock_type	on-hand (default) / available	string	Stock imported: the on-hand stock, or the on-hand stock minus the quantities still to deliver on open orders

 

Integration project

Who's assigned from your team?

Your Fastmag administrator, or an IT profile within your company who is familiar with your specific setup. A Sales Manager who understands your business and your merchandising strategy.

Who's in charge at Le New Black

Your account manager at Le New Black takes care of the whole process from day 1:

• Asking questions about your specific Fastmag setup and sales process.
• Setting up the connection with your Fastmag account.
• Generating and exporting test orders to Fastmag.
• Keeping your team updated throughout the process and addressing delays on either side.
• Working with you and Fastmag to troubleshoot any unexpected issue after launch.

Timeline

A standard integration will take 2-4 weeks to get up and running.

 

Integration monitoring

Once the connector is set up, the Integration center of your back-office gives you a set of tools to manage and monitor the integration:

• Task logs, for continuous monitoring and troubleshooting (for example a missing EAN13 or retailer reference that prevents an order from being exported)
• Running a task on demand, to push or pull data at once
• A preview of the data before the actual import (only available on some connectors)
• E-mail notifications per task, set up on request: exported and blocked orders, import errors
• The integration status of each order in the orders list (Pending, Successfully sent, Blocked), which you can set back to Pending to send an order again