Xero + Le New Black integration overview
Xero is a cloud-based accounting software for financial and accounting management. 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 Xero API to exchange data (read docs) |
|
Le New Black drives all data flows: it triggers every push and pull operation |
|
The connector requires basic configuration in Le New Black and Xero |
Data flows
| Type | Flow |
| Invoices | Xero ⇠ Le New Black |
| Credit notes | Xero ⇠ Le New Black |
Data flow: Invoices
Invoices created in Le New Black are sent to Xero as sales invoices. Their status in Xero is chosen during set-up.
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.
Integration status: Only invoices whose integration status is Pending are exported, and it becomes Successfully sent after export.
Blocked invoices: An invoice that fails a check 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 invoices list (action Set integration status to Pending).
Line amounts: Unit price of each line excluding tax, with the tax rate of the invoice and, when set up, your Xero account code; the shipping cost is added as a Shipping fee line
Currency: The currency of the document, which must be enabled in your Xero organisation
Matching keys: Customer: retailer name, matched against the name of the Xero contact. Products: SKU, sent as the Xero item code. Tax: LNB tax name, matched against the name of the Xero tax rate.
Created on the fly: A Xero contact for a customer that has none, with its name, contact person, e-mail and address
Fields mapping
Complete mapping: every field the connector reads is listed.
| Le New Black field | Xero field | Comment |
Customer |
Contact | Xero contact with the same name, created when missing |
Creation date |
Date | |
Due date |
DueDate | |
Invoice number |
Reference | |
Currency |
CurrencyCode | |
Link to the invoice |
Url | Opens the invoice in your Le New Black back-office |
SKU |
LineItems / ItemCode | |
Product name, colour, size and variant reference |
LineItems / Description | |
Quantity |
LineItems / Quantity | |
Unit price |
LineItems / UnitAmount | Amount excluding tax |
Tax |
LineItems / TaxType | Xero tax rate whose name is the name of the tax |
Shipping cost |
LineItems | Added as a Shipping fee line when not zero |
Callouts
- An invoice whose number already exists in Xero is blocked, and so is an invoice whose customer name matches several Xero contacts.
Data flow: Credit notes
Credit notes created in Le New Black are sent to Xero as credit notes. Their status in Xero is chosen during set-up.
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.
Integration status: Only credit notes whose integration status is Pending are exported, and it becomes Successfully sent after export.
Blocked credit notes: A credit note that fails a check 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 credit notes list (action Set integration status to Pending).
Line amounts: Unit price of each line excluding tax, with the tax rate of the credit note and, when set up, your Xero account code; the shipping cost is added as a Shipping fee line
Currency: The currency of the document, which must be enabled in your Xero organisation
Matching keys: Customer: retailer name, matched against the name of the Xero contact. Products: SKU, sent as the Xero item code. Tax: LNB tax name, matched against the name of the Xero tax rate.
Created on the fly: A Xero contact for a customer that has none, with its name, contact person, e-mail and address
Fields mapping
Complete mapping: every field the connector reads is listed.
| Le New Black field | Xero field | Comment |
Customer |
Contact | Xero contact with the same name, created when missing |
Creation date |
Date | |
Credit note number |
Reference | |
Currency |
CurrencyCode | |
SKU |
LineItems / ItemCode | |
Product name, colour, size and variant reference |
LineItems / Description | |
Quantity |
LineItems / Quantity | |
Unit price |
LineItems / UnitAmount | Amount excluding tax |
Tax |
LineItems / TaxType | Xero tax rate whose name is the name of the tax |
Shipping cost |
LineItems | Added as a Shipping fee line when not zero |
Callouts
- A credit note whose number already exists in Xero is blocked, and so is a credit note whose customer name matches several Xero contacts.
Global configuration
Configuration
| Setting | Values | Type | Comment |
xero_invoice_status |
DRAFT / SUBMITTED / AUTHORISED | string | Status of the invoices created in Xero |
xero_credit_note_status |
DRAFT / SUBMITTED / AUTHORISED | string | Status of the credit notes created in Xero |
xero_account_code |
Xero account code | string | Account code of every invoice and credit note line (optional) |
access_token |
Xero access token | string | Credential of your Xero account, set up with your account manager |
subscription_id |
Xero authorisation id | string | Authorisation given to Le New Black on your Xero account, used to renew the access token |
Integration project
Who's assigned from your team?
Your Xero 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 Xero setup and sales process.
- Setting up the connection with your Xero account.
- Generating and exporting test orders to Xero.
- Keeping your team updated throughout the process and addressing delays on either side.
- Working with you and Xero to troubleshoot any unexpected issue after launch.
Timeline
A standard integration of the invoices and credit notes data flows 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
Comments
0 comments
Please sign in to leave a comment.