Articles in this section

EDI

Laura Molano
  • Updated
Follow

Topics Covered:

Introduction

Onboarding

Support

________________________________________________________________________________________________________________

Introduction

The content provided in this section is intended for users who wish to create a partnership with Olivela using an EDI integration.

 

Contacts

Olivela - Marthaluz Quiteno - marthaluz@olivela.com

Logicbroker - support@logicbroker.com 

* Please be sure to communicate through the same email thread we reach out to you on. If you need to create a new thread, include all the contacts above

 

Things to Note

  • Olivela does not support invoices (810), returns (180) or backorders.
  • You will only have access to the stage portal during onboarding. Once you have completed all onboarding steps outlined below, Logicbroker will push your account live - from here on you will have access to the production portal to upload live inventory and process live orders.

 

Helpful Links

Stage Portal - https://stageportal.logicbroker.com/ - where testing takes place

Production Portal - https://portal.logicbroker.com/ - where live orders are processed

Olivela Knowledge Base - https://olivela.logicbroker.com/hc/en-us - where you can look up any testing or production-related questions

Learn Logicbroker - https://learn.logicbroker.com/ - Logicbroker's Learning Management System that will walk you through the portal and provide a supplier overview

* Note that you will need to log in to access all of these links with the exception of the Knowledge Base so make sure you complete Step 1 below

 

Integration Method Overview

EDI integrations are often times lengthier than portal integrations as suppliers will need to map to Olivela's EDI specifications.

  • Order Processing: Orders are sent out to suppliers as 850 documents, suppliers return 855-POAck (acceptance/cancellation acknowledgments) and 856s (shipment notices).
  • Inventory: Suppliers send 846 files to Logicbroker
    • once with all fields (Supplier SKU, Quantity, Cost, Supplier Description, Size, Color, Style (if applicable))
    • daily with only required fields (Supplier SKU, Quantity, Cost)
    • inventory is sent and Olivela updates their site accordingly.
  • Packing Slips: Suppliers can either download packing slips directly from Logicbroker – this can also be done in bulk or they can map their own packing slip using Olivela specifications and have Olivela review before going live. 

 

EDI Information

Olivela's Test/Production EDI Qualifier/ID: ZZ/LB125173

EDI Specifications: Specs

AS2: Information and Certificate

FTP: Connection

FTP: Directories

 

________________________________________________________________________________________________________________

Onboarding

This section will walk you through all the steps you need to complete for a successful go-live.

Step 1: Provide EDI Connection Information

Your first step is to share your EDI connection information with Logicbroker so we can set up your account.

Action: 

  1. Submit your EDI connectivity information to Logicbroker by completing the following survey: Olivela EDI Survey 
  2. Once you complete this survey, sit tight and Logicbroker will reach back out within 1 business day with next steps.

* Please have your EDI connectivity information ready, we will ask for your EDI Qualifier/ID and AS2/FTP connection information

 

Step 2: Establish Connectivity

Within 1 business day of submitting your EDI survey (Step 1), Logicbroker will reach back out and let you know if a successful EDI connection was established. Logicbroker will also send out portal invitations to your team in this step.

Action: 

  1. If there were any issues creating the EDI relationship, Logicbroker will provide details and will work with your team to establish a successful connection.
  2. If no errors occur, no further action is needed.

 

Step 3: Create Logicbroker Account

You should have already received an invitation from Logicbroker via email. Subject Line: "Welcome to Logicbroker!". This invitation will allow you to create a login and password to the Logicbroker platform. Don’t see the email? Check your junk mail folder & add do-not-reply@logicbroker.com to your contacts list.

Action: 

  1. Accept the invitation within 7 days and create your Logicbroker account. The link expires after 7 days so if you miss the window, let us know and we can send out a new invitation. 
  2. Once you have created an account, you send out invitations to anyone else on your team. To see how, see User Management

 

Step 4: Review the LMS (Learning Management System)

Learn Logicbroker is our Learning Management System which offers learning materials to help you become more comfortable with your dropship experience. Here, we offer an extensive library of videos, photos, and written information to help acclimate you to Logicbroker and help you succeed with your integration with Olivela. Only registered users can access Learn Logicbroker so make sure you complete Step 1 before attempting to log in. 

Action: Logicbroker will assign you the Portal Supplier Onboarding Path which includes the following modules:

  • Welcome to Learn Logicbroker
  • Getting Started with Logicbroker: The Portal
  • Supplier Overview

If you lose the email or want to have another member of your team walk through the path, you can access and share the link here: Portal Supplier Onboarding Path

To access Learn Logicbroker, go here: Learn Logicbroker

 * Note that this content is general information for all PORTAL suppliers - some information is not Olivela specific such as information on returns and invoices and some information is not relevant to EDI suppliers such as manually creating documents and uploading Excel/CSV inventory. Once you walk through the path, you will continue on to Olivela/EDI specific tasks noted below

 

Step 5: Map to Olivela EDI Specifications

Review and map to the listed Olivela EDI specifications.

Actions:

  1. See Olivela EDI Specifications here.
  2. Map to the following:
    • Order (850)
    • Acknowledgment (855)
    • Shipment (856)
    • Inventory (846)

* Note that Olivela prefers you use Logicbroker-generated packing slips.  If you will be mapping your own packing slip, please refer to Step 7b.

 

Step 6: Send 846 to Stage

Once you mapped to all EDI specifications, send Logicbroker your inventory through an 846 feed.

Action: 

  1. Make sure you have mapped to the 846 specifications
    • All fields below are required for your FIRST 846 transmission, and any Live transmission where you are adding to your assortment:
      • Supplier SKU: LIN:LIN03 (VN)
      • Quantity: LIN:QTY02 (33)
      • Cost: LIN:CTP03 (DIS)
      • Supplier Description: LIN:PID05 (08)
      • Size: LIN:LIN11 (SZ) *if applicable
      • Color: LIN:LIN13 (VE) *if applicable
      • Style: LIN:LIN09 (ST) *if applicable
  2. Send the 846 file from your system to Logicbroker's stage portal (using the stage AS2 ID: STAGELOGICBROKERAS2)

  3. Verify your 846 was successfully transmitted to and accepted by Logicbroker. To do this:
    • confirm you received back a 997
    • go to stage portal > Products > Inventory Feeds > select Olivela as your Partner > check the Events tab:
      •  the Events tab should say "Inventory Imported"mceclip0.png

Running into issues with this step? see Onboarding Help

 

Step 7: Complete Test Cases

After you have successfully sent your 846 to Logicbroker, you will move onto testing where you will complete 3 test cases. 

Action: 

  1. Make sure you have mapped to the 850, 855 and 856 specifications

  2. In stage portal, go to Testing > Olivela: View > click on Create a New Test Order for each of the three test cases

  3. Confirm these orders are transmitted to your system as 850 documents through the AS2 connection (this may take a few minutes)

  4. Process the 3 test cases through your system:
    • Test Case 1: Fulfill (Single Line)
      • Send an 855 fully accepting the order
      • Send an 856 fully shipping the order *include a Carrier and a Tracking Number. The tracking number can be any alphanumeric string

    • Test Case 2: Fulfill (Multi Line)
      • Send an 855 fully accepting the order
      • Send an 856 fully shipping the order *include a Carrier and a Tracking Number. The tracking number can be any alphanumeric string

    • Test Case 3: Cancel 

      • Send an 855 to fully cancel the order.  *If you plan on canceling orders manually through the web portal in production, you may process this order directly in the portal instead of sending an 855 (See Creating an Acknowledgement). Be sure to change the Quantity Cancelled for each line item so that it matches the Quantity Ordered, and enter in the Change Reason: Out of Stock for each under Acknowledgement Items.


        Please note the following Olivela-approved Change Reasons, to be used for cancellations once your account has been enabled in production:

        • Out of stock
        • Cannot fulfill in time
        • Discontinued Item
        • Other

Running into issues with this step? see Onboarding Help

 

Step 7b: Request Packing Slip Approval

* Note that Olivela prefers you use Logicbroker-generated packing slips

If you choose to map your own packing slip using Olivela's packing slip specifications, you will need to have a test packing slip approved by the Olivela team

Actions: 

  1. Create 2 test packing slip PDFs per Olivela’s specifications. 
    • 1st PDF: Standard packing slip (no gift message)
    • 2nd PDF: Packing slip with gift message
  2. Send test packing slips via email using the active onboarding thread to request approval from the Olivela team.

 

Step 8: Request Inventory Approval

Once you’ve completed the 3 test cases, you will need an updated inventory (sent via 846) to be approved in the stage portal.

Action: 

  1. Send a current 846 document into the stage portal.  If there has been no change in quantity or product assortment since your initial 846 was sent, you can skip this step.
  2. Request approval of your new inventory upload in the stage portal.  If you skipped Step 1, please request re-approval of your initial inventory.
  3. Once Olivela approves your updated stage inventory, Logicbroker will enable your account in production.  You will receive an update via email when your account is ready to access through the production / live portal.

 

Step 9: Send Live Inventory

When your account is enabled in production, you are nearly ready to go live!

Action: 

  1. Send your newly-approved inventory (via 846) into the production / live portal the same way you did in stage ((using the production AS2 ID: LOGICBROKERAS2). 

 

Ready to go live!

Olivela will reach out with next steps to launch via email.

From this point on, you will use the production portal only.*You will not need to log in or send EDI documents to the stage portal, except for special cases.

 

________________________________________________________________________________________________________________

Support

See the Onboarding Help article

If you have any other questions throughout the onboarding or production phase, review:

Both these resources are great for training new members of your team! If you need additional support, reach out to support@logicbroker.com, marthaluz@olivela.com, and dropship@olivela.com.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.