Xentral - Integration steps

API account setup in Xentral

1. In Xentral navigate to: Administration > System > API account

2. Within the API Account click on New

3. Configure the API integration settings

1. 1. Enable options Active and UTF8 Clean
   2. Create Designation and Password
   3. Enable all Permissions

4. Forward the following details to Hive
   1. User name (mentioned above)
   2. Password (mentioned above)
   3. Xentral instance URL (can be found in the browser e.g. randomtext123.xentral.biz )

Warehouse set up in Xentral for inventory sync

1. In Xentral navigate to: Fulfillment → Warehouse management
2. Click on New to add a new warehouse dedicated for items fulfilled by Hive.
   

3. Navigate to the newly created warehouse → Storage Locations → Create new storage location

4. After the new storage location creation send the Designation (e.g HIVE001) to Hive.

Project and storage structure

Please provide details on how Project is utilised within your Xentral instance. In Hive, we can filter for which project the specific Products and Orders belong.

You can opt to have a simple setup where there is no need to filter for projects or a more advanced set-up with multiple brands and order sources. If possible, please share a basic schema on how your Xentral instance will be structured.

To find the numeric Project ID (not the text identifier), see:

Product Setup

The following product information attributes need to be filled out in Xentral and will then be synced to Hive:

1. 1. Product → Details
      1. Product name (Item)
      2. SKU code (Item no.)
      3. Barcode
      4. HS code (Customs tariff number)
      5. Country of origin
      6. Product images
         1. In order for product images to be sent to hive, the image file needs to be set to Shopbild.

7. Cost of items
   1. For the production cost to be exposed in the Xentral API, the information needs to be added in the section called Calculate and adopt the new calculated purchase price.

Check the box called Stock item, if you want inventory to be synced from Hive. The screenshots below show where you can input all the above mentioned data:

Fulfillment flow

1. Orders
   1. Orders are imported from the order source into Xentral
   2. For orders to be processed they need to be marked as completed and a Delivery note (Lieferschein) has to be generated.
   3. Orders are imported to Hive in bulk every hour.
      1. With this, we sync order updates from the last 24 hours
      2. We also sync order cancellations for the last 30 days
      3. If you would want a faster sync or a sync beyond the above statements, you can always hard-sync orders through the Hive App
         
2. Tracking
   1. Tracking information is sent back to Xentral via API right after the order is processed and shipped by Hive. If multiple shipments are related to the order, multiple tracking numbers are sent to the Xentral order.
      

Overall summary/notes regarding Xentral x Hive

• Regarding orders:
  • Xentral doesn’t send us timestamps back, thus not allowing us to do proper FIFO when it comes to orders. We still will do FIFO on a day-basis, not hourly.
    
  • We can separate B2B and B2C orders based on Projects in Xentral. Each Project will be integrated separately with Hive and we can set up on our end that all orders coming from that project are to be handled as B2B orders.
  • We bulk-sync orders on an hourly basis
    • With this, we sync order updates from the last 24 hours
    • We also sync order cancellations for the last 30 days
    • If you would want a faster sync or a sync beyond the above statements, you can always hard-sync orders through the Hive App
    • Note: for orders to be processed in Xentral they need to be marked as “completed” and a delivery note (Lieferschein) has to be generated. Only after that, orders will be synced in bulk to Hive
      
• Regarding inventory
  • Inventory sync works.
  • The following information will be forwarded to Hive:
    • Product name (Item)
    • SKU code (Item no.)
    • Barcode
    • HS code (Customs tariff number)
    • Country of origin
    • Product images
    • Cost per item