Kroger FAQs | Comparably
Comparably
Comparably Awards
Kroger Claimed Company
The Kroger Co. is one of the world's largest grocery retailers. The Kroger Co. spans many states with store formats that include grocery read more
EMPLOYEE
PARTICIPANTS
4028
TOTAL
RATINGS
40628

Kroger FAQs

Kroger's Frequently Asked Questions page is a central hub where its customers can always go to with their most common questions. These are the 51 most popular questions Kroger receives.

Frequently Asked Questions About Kroger

  • Attached are the specifications for the Order (850), Acknowledgement (855), Shipment (856), Invoice (810) and Inventory (846).

    NOTE: Currently, for Kroger only, returns (180) are only allowed forperishableitems that are returned because the shipment wasundeliverable or refused. All other returns must be coordinated directly (outside of Logicbroker) with Kroger.

    NOTE: You can do a hybrid of EDI documents and using the Portal. For example, if you want to do cancels and invoices in the Portal, you would only need to support the 850 and 856.

    IMPORTANT: If you are going to be generating the packing slip (vs. using the one that Logicbroker provides in the Portal), please see the specifications here: https://kroger.logicbroker.com/hc/en-us/articles/360020958231-Packing-Slip-Specification

    Kroger EDI Qualifier/Identifier:ZZ/LB126678

    Sample Files: https://kroger.logicbroker.com/hc/en-us/sections/360002572331-Sample-Files

    Update History:

    11/18/18

    850 - PER segment, removed ship-to email since that does not come in on the order.

    10/2/19

    850 - updated TD505 shipping methods

    855 - removed mention of nonexistent N9 segment

    856 - updated TD505 shipping methods

    8/6/2019

    180 - added 180 spec for returns, to only be used by perishable item vendors when processing undeliverable or refused shipments.

    7/12/2019

    850 - updated specification to indicate Cost/Price will be provided in PO104

    3/12/19

    856 - updated set note for DTM 067 to confirm the data is required

    3/6/19

    855 - Removed all mentions of backorders and removed N9 segment

    2/26/19

    810 - Removed ITD, N1, N3 and N4 segments entirely. Added in code for SAC02 for taxes.

    2/15/19

    856 - TD5 segment updated with permitted shipping codes.

    810 - BIG07 removed credit memo as an option

    2/6/19

    Adding in our standard 846 spec until we determine if a custom one is required.

    12/13/18

    First draft specs attached.

    1/2/19

    Added sample file link.

    View Article

  • IMPORTANT: Notifications & Monitoring are specific to your Stage and Production accounts, so you will need to set up in both locations when the time comes.

    Set Up Notifications

    1. Navigate toSettings-->Notifications.

    2. From the Notifications page you can select all the reports and notifications you want emailed to you (toggle to red).

    By default, when a user is set up, they will be configured with a default set of notifications.

    You can unsubscribe from a notification simply be turning the switch off (toggle to grey).

    3. Before leaving the page, you must click Save to update your notification settings.

    Move on to Step 5

    View Article

  • These are the specifications to create the packing slip with your systems.

    Logicbroker can also provide the packing slips in bulk (PDF file either from the Portal or via FTP), or they can be printed individually from the Portal. See the Packing Slip article for more details.

    See attached sample and logo.

    Field Mapping

    Packing Slip Field

    API Field

    EDI 850 Segment

    Ship To Name

    ShipToAddress.FirstName & ShipToAddress.LastName

    N201 (ST) and N202 (ST)

    Ship To Address

    ShipToAddress.Address1

    N301 (ST)

    Ship To City

    ShipToAddress.City

    N401 (ST)

    Ship To State

    ShipToAddress.State

    N402 (ST)

    Ship To Zip

    ShipToAddress.Zip

    N403 (ST)

    Bill To Name

    BillToAddress.FirstName & BillToAddress.LastName

    N201 (BT) and N202 (BT)

    Bill To Address

    BillToAddress.Address1

    N301 (BT)

    Bill To City

    BillToAddress.City

    N401 (BT)

    Bill To State

    BillToAddress.State

    N402 (BT)

    Bill To Zip

    BillToAddress.Zip

    N403 (BT)

    Order Number

    OrderNumber

    REF02 (CO)

    Shipping Date

    ShipmentDate

    BSN03 (from 856, not 850)

    Shipment ID

    ShipmentNumber

    BSN02(from 856, not 850)

    Item Description

    OrderLines.Description

    PID05 (08)

    Item #

    OrderLines.ItemIdentifier.SupplierSKU

    PO107 (VN)

    Qty

    OrderLines.Quantity

    PO103

    View Article

  • Yes, you are able to utilize ourShipStationconnector to receive orders and process shipments.You must have aShipStationaccount and this option may require a Logicbroker subscription. If you are interested in knowing more, please contact us at [email protected].

    View Article

  • Once you submit your tracking information, there is very little time to make changes due to how quickly that information is transmitted to Kroger. There is typically a few minutes after you submit a shipment, where the status of the shipment isProcessing, where you can modify the data.

    Find the shipment in the Portal, view it and selectChange Statusunder theMore Actionsdrop down. Change the status toDraft, so you can modify and then submit it with corrections.

    Keep in mind our system will only let you edit before the status of the shipment goes toComplete. After the shipment has gone to Complete, the only option is to contact Kroger with the updated information.

    View Article

  • From the left menu, navigate toSettings> selectNotifications.

    On this page you can select all the reports and notifications you want emailed. By default when a user is setup they will be configured with a default set of notifications. Any user can stop receiving an alertby unchecking the corresponding checkbox and selectingSave.

    View Article

  • Yes, you are able to connect to Logicbroker using our Shopify connector for orders, shipments and inventory.You must have a Shopify account and this option may require a Logicbroker subscription.If you are interested in knowing more, please contact us at [email protected].

    View Article

  • You can add, modify and remove users from the Portal. To learn how to add users, read the Managing Usersarticle here: https://kroger.logicbroker.com/hc/en-us/articles/360021192612-Managing-Users

    View Article

  • In the knowledge base, we've erred on the side of giving you as much information as possible. However, at a high-level, we can show you a simple view of what everyone needs to do to get through onboarding:

    Set up your username/password and add users if you have more than one.

    Managing Users Link: https://kroger.logicbroker.com/hc/en-us/articles/360021192612-Managing-Users

    If doing EDI, confirm the connection works.

    AS2/FTP Info Link: https://kroger.logicbroker.com/hc/en-us/sections/360002566772-Connection-Information

    Load inventory (a full inventory file) into Staging.

    Inventory Link: https://kroger.logicbroker.com/hc/en-us/articles/360021192172-Creating-Your-Test-Orders

    Generate your test orders in the Testing module in Stage Portal, regardless if your connection is Portal, EDI, API, etc. Follow the test case requirements.

    Test Cases Link: https://kroger.logicbroker.com/hc/en-us/sections/360002572291-Testing-Test-Cases

    Testing Stage Portal Link: https://stageportal.logicbroker.com/testing/

    Once test orders are complete, Kroger reviews the account and pushes into Production. Logicbroker sends a final "go live" email, which is when the Production Portal is enabled to be used and Production inventory can be loaded.

    We have a few tours that walk through inventory setup and the 4 test cases below (from a Portal user perspective).

    Inventory: http://www.screencast.com/t/qlpq6g9wg1i Test Case 1 (TC1): http://www.screencast.com/t/UaoJkghs Test Case 2 (TC2): http://www.screencast.com/t/ZeLKeq4aG Test Case 3 (TC3): http://www.screencast.com/t/15a8vrTe7hi9 Test Case 4 (TC4): https://www.screencast.com/t/h658X3dZyst Test Case 4A (TC4A): https://www.screencast.com/t/eiaL7NZQiCwK

    View Article

  • You can reset your password here:

    https://account.logicbroker.com/manage/Account/ForgotPassword

    View Article

  • NOTE:We also offer an additional connection option utilizing ourShipStationconnector (orders and shipments). You must have aShipStationaccount and this option may require a Logicbroker subscription, please contact us at LINK for additional information.

    Creating a shipment is the required step to close out or complete an order (unless the order has been cancelled). By providing a carrier and tracking number, this information is transmitted to the retailer so the customer is notified that the order has shipped. Follow these steps to create a shipment in the Portal.

    1. There are two ways to pull up an order that you would like to ship.

    Option 1: Using the Search bar at the top of any page in the Portal, enter in the order number. This will pull up all related documents to the order (the order as well as any existing shipments, returns and/or cancellations).

    Option 2: Click on Orders in the left-hand menu, and from the Order Management page, find the order.

    Option 1:

    Option 2:

    2. On the Order Management page, click on Actions and select Ship.

    3. You will be taken to the Create Shipment page. This is where you will create a shipment for an order.There are two key pieces of information required to create the shipment: Carrier and Tracking.

    From the Carrier drop-down menu, select the carrier used to ship the item(s).

    If the shipping method isn't visible in the drop down, you can type any approved SCAC code. You can see the standard list for Logicbroker under Settings --> Shipment Options.

    Hint: The shipping method used should typically match up to the shipping method requested on the order. For example, if UPS Next Day service was requested on the order, the expectation is the order would ship with next day service.

    In the Tracking field, enter in the tracking number for the shipment.

    For Items, make sure the items and quantity match to what was in the box shipped.

    All other information on the page is optional unless otherwise requested by the retailer.

    When finished, click on Submit (top right corner of the page).

    Shipping Multiple Boxes

    There are times when you will need to split the items of an order into more than one box.

    1. From theCreate Shipmentpage, you can click onAdd Box.

    Using the example above, a few things to note:

    TheAdd Boxlink is clicked anytime you need to add a box. If you need 3 boxes, you click it two times to create two additional boxes beyond the original box we automatically generated for you.

    When a new box is created, you need to select the appropriate item(s) from theAdd Item drop down Since we auto-populate the first box with all items (since a vast majority of items go into a single box), you will need to click Remove next to the item(s) thatwon't be in the first box.

    IMPORTANT: Essentially, make sure each box has the items that are included with that particular tracking number.

    NOTE: Because shipment data is usually sent frequently to the retailer throughout the day, make sure your shipment data is 100% accurate before clicking on Submit. The ability fix a mistake is very limited and could have a negative impact on a customer.

    See the following article for options to bulk upload tracking information: https://kroger.logicbroker.com/hc/en-us/articles/360021192752-Tracking-Information-Bulk-Upload

    View Article

  • The survey that Logicbroker sent and that you completed, is the kick-off for integration. You should now be ready to proceed with the transition to the Logicbroker platform!

    The first step is setting up your connection, testing it and setting up users:

    Set Up Your Integration & Connection

    There are a variety of options to connect to Logicbroker:

    Portal - all documents can be supported manually through our browser-based Portal.

    Orders can be manually downloaded, printed or viewed

    Acknowledgements (acceptance and/or cancels), Shipments, Invoices, and Inventory can be uploaded/downloaded using CSV or Excel via the Portal.

    EDI - we support AS2 (SHA2) and FTP/SFTP EDI connections

    850 (Orders) documents will be sent to you via your preferred connection.

    855 (Acknowledgements), 856 (Shipments), (810) Invoices, and (846) Inventorydocuments will be returned through the same connection. We will also be sending/receiving 997 (Functional Acknowledgements).

    XML (API) - using our hosted API connection, you can interact directly with our systems using standard Logicbroker templates.

    XML/JSON (FTP/SFTP) - use our virtual hosted FTP site to trade XML or JSON formatted files.

    CSV (FTP/SFTP) - use our virtual hosted FTP site to trade CSV formatted files.

    Based on the survey, we have already received your preferred connection method and set that method up in our system. You will want to test your connection before proceeding.

    NOTE: You can change your connection at a later date if your situation changes. For example, if you choose a Portal integration to start, you can swing back to an EDI integration later (or any other method).

    Additional Connection Options

    We also offer additional connection options utilizing ourShopify EDIconnector (orders, shipments and inventory) andShipStationconnector (orders and shipments). These options may require a Logicbroker subscription, please contact us at LINK for additional information.

    Test Your Connection

    Portal - using your Logicbroker username and password, make sure you can log into Stage:

    Stage: https://stageportal.logicbroker.com

    EDI - make sure test connection files can be traded in both directions (Inbound/Outbound)

    EDI AS2 Connection Info: https://kroger.logicbroker.com/hc/en-us/articles/360021439491-AS2-Info-and-Certificate

    EDI FTP Connection Info: https://kroger.logicbroker.com/hc/en-us/articles/360021192792-FTP-Connection

    XML (API) - using our hosted API, set up your API keys in Stage and make sure test connection files can be traded in both directions (Inbound/Outbound)

    API Connection Info: https://kroger.logicbroker.com/hc/en-us/articles/360021249992-API-Documentation

    XML/JSON (FTP/SFTP) - use our virtual hosted FTP site,make sure test connection files can be traded in both directions (Inbound/Outbound)

    FTP Connection Info: https://kroger.logicbroker.com/hc/en-us/articles/360021192792-FTP-Connection

    CSV (FTP/SFTP) - use our virtual hosted FTP site,make sure test connection files can be traded in both directions (Inbound/Outbound)

    FTP Connection Info: https://kroger.logicbroker.com/hc/en-us/articles/360021192792-FTP-Connection

    Set Up Users

    You are able to control access to your users by adding, modifying or deleting users as you see fit. See the following article to set up new users: https://kroger.logicbroker.com/hc/en-us/articles/360021192612-Managing-Users

    Move on to Step 2

    View Article

  • NOTE: Currently, for Kroger only, returns are only allowed for perishable items that are returned because the shipment was undeliverable or refused. All other returns must be coordinated directly (outside of Logicbroker) with Kroger.

    *API field name refers to field names for XML, JSON, and CSV field names.

    EDI Field

    Logicbroker/API Field

    Description

    Requirement

    N/A

    Identifier.SourceKey

    Identifier that will come from the source system; typically this will match the PartnerPO.

    Read Only

    N/A

    Identifier.LogicbrokerKey

    ID to identify the document in the Logicbroker system.

    Read Only

    N/A

    Identifier.LinkKey

    Used to link the document to the original source document. For example, It is best to supply the Order's LinkKey when posting a shipment. This will make sure the order shipped quantities are updated on the original order and all statuses are updated appropriately.

    Optional

    N/A

    SenderCompanyId

    Logicbroker Internal Company ID to specify what company is sending the document.

    Required

    N/A

    ReceiverCompanyId

    Logicbroker Internal Company ID to specify what company is to receive the document.

    Required

    PRF01

    PartnerPO

    This will be the purchase order number, this will be the main Key to link all your documents.

    Required

    BGN02

    ReturnNumber

    Unique Identifier used to identify the Return

    Required

    N/A

    DocumentDate

    Date of the Return. This field will automatically default with the date the document is created.

    Required

    BGN03

    ReturnDate

    Date of the Return. This field will automatically default with the date the document is created.

    Required

    N102 (ST)

    ShipToAddress.CompanyName

    Optional

    N201 (ST)

    ShipToAddress.FirstName

    Optional

    N202 (ST)

    ShipToAddress.LastName

    Optional

    N301 (ST)

    ShipToAddress.Address1

    Optional

    N302 (ST)

    ShipToAddress.Address2

    Optional

    N401 (ST)

    ShipToAddress.City

    Optional

    N402 (ST)

    ShipToAddress.State

    Optional

    N404 (ST)

    ShipToAddress.Country

    Optional

    N403 (ST)

    ShipToAddress.Zip

    Optional

    N104 (ST*92)

    ShipToAddress.AddressCode

    Optional

    N1:PER06 (TE)

    ShipToAddress.Phone

    Optional

    N1:PER04 (EM)

    ShipToAddress.Email

    Optional

    N102 (SF)

    ShipFromAddress.CompanyName

    Optional

    N201 (SF)

    ShipFromAddress.FirstName

    Optional

    N202 (SF)

    ShipFromAddress.LastName

    Optional

    N301 (SF)

    ShipFromAddress.Address1

    Optional

    N302 (SF)

    ShipFromAddress.Address2

    Optional

    N401 (SF)

    ShipFromAddress.City

    Optional

    N402 (SF)

    ShipFromAddress.State

    Optional

    N404 (SF)

    ShipFromAddress.Country

    Optional

    N403 (SF)

    ShipFromAddress.Zip

    Optional

    N104 (SF*92)

    ShipFromAddress.AddressCode

    Optional

    N1:PER06 (TE)

    ShipFromAddress.Phone

    Optional

    N1:PER04 (EM)

    ShipFromAddress.Email

    Optional

    N/A

    ExtendedAttribute.EXAMPLE

    Optional

    BLI09 (IN)

    ReturnLines.ItemIdentifier.PartnerSKU

    The Item identifier that is internal to the purchaser/merchant.

    Conditional - if received on an order this value should be returned

    BLI02 (VN)

    ReturnLines.ItemIdentifier.SupplierSKU

    The Item Identifier that is used by the supplier or the person fulfilling the product.

    Required

    BLI11 (UP)

    ReturnLines.ItemIdentifier.UPC

    Typically the U.P.C Consumer Package code will be provided; however additional standardized codes can be provided here as well. See specific partner instructions for details.

    Conditional - if received on an order this value should be returned

    N/A

    ReturnLines.Price

    Unit cost that the merchant expects to be billed for each unit fulfilled.

    Optional

    BLI03

    ReturnLines.Quantity

    Used to indicate the quantity being returned

    Required

    BLI04

    ReturnLines.QuantityUOM

    Unit of Measure for the Quantity being identified for this line.

    Required

    BLI:RDR04 (DR)

    ReturnLines.ReturnReason

    Free Form Reason for return of the line item.

    Required

    BLI:RDR04 (DR)

    ReturnLines.ReturnReasonCode

    Code specified by your partner to identify the return reason.

    Required

    View Article

  • In order for your products to be featured on the Kroger and/or Fred Meyer Direct website, inventory needs to be loaded into Production either manually through the Logicbroker Portal or through an automated option (EDI, FTP, etc.)

    There are a few steps to complete depending on how you will be loading your inventory:

    There are 4 ways to load inventory:

    For Portal vendors, you will load your inventory through the Production Portal here: https://portal.logicbroker.com/advanced-product-management

    For EDI vendors, you can use an 846 (Inventory) document. You may also set up a FTP CSV file if you are not able to support an 846 file. See here for more details.

    For CSV vendors, you can set up a FTP CSV file.See here for more details.

    For API vendors, you can use our API connection. See the documentation located here.

    Once inventory has been loaded (and test orders are completed), communicate with Logicbroker that you have finished testing and have loaded inventory.

    Logicbroker will coordinate with you and Kroger to go live as quickly as possible after testing is completed.

    If any questions come up for any reason, please send an emailto: [email protected]

    View Article

  • These are the codes to expect on an order and can be returned on a shipment. If you are unable to support any one of these, please coordinate with Kroger.

    KROGER

    SCAC Code

    Service

    FDEG-SP

    FedEx SmartPost

    FedEx-OneDay

    FedEx Standard Overnight

    FDEG-HD

    FedEx Home Delivery

    FedEx-Express

    FedEx Express Saver (2 Day)

    FDEG-CG

    FedEx Ground

    USPS-PB

    USPS Priority Mail

    View Article

  • A sample file is attached for quick use loading into the Portal, required fields in yellow. Inventory can also be loaded via EDI 846 or CSV/Excel file via FTP.

    Field Descriptions

    EDI Field

    Logicbroker Field

    Description

    Requirement

    LIN:LIN03 (VN)

    SupplierSKU

    SKU for the party that is receiving the purchase order.

    Mandatory

    N/A

    MerchantSKU

    SKU for the party sending the purchase order.

    Optional

    LIN:LIN05 (UP)

    UPC

    UPC Code.

    Mandatory

    LIN: LIN07 (MG)

    ManufacturerSKU

    SKU provided by the manufacturer of the product.

    Optional

    LIN:QTY02 (33)

    Quantity

    Total Quantity available for sale, this would be the total quantity across all warehouses.

    Mandatory

    LIN:CTP03 (DIS)

    Cost

    Cost sold from the supplier to the merchant. This is the value that will be on the purchase order.

    Mandatory

    N/A

    MSRP

    Manufacturer's Suggested Retail Price

    Optional

    N/A

    RetailPrice

    Price in which the item will be sold to the end customer

    Optional

    LIN:PID05 (08)

    SupplierDescription

    Description provided by the supplier.

    Mandatory

    N/A

    MerchantDescription

    Description provided by the merchant. This is typically done during product setup using the matching file.

    Optional

    LIN:LIN11 (SZ)

    Size

    Size attribute associated with product

    Optional

    LIN:LIN13 (VE)

    Color

    Color attribute associated with product

    Optional

    LIN:LIN09 (ST)

    Style

    Unique attribute to identify specific characteristic of the product

    Optional

    N/A

    Weight

    Total Weight per each Quantity

    Optional

    REF02 (IO)

    Warehouse

    Code/Identifier indicating location of the Quantity. Used only if only providing one warehouse for all quantity. If quantities for mulitple warehouses are required, then start with Warehouse2.

    Optional

    LIN:SCH01 (018)

    NextAvailableQuantity

    Quantity available given date in "NextAvailableDate"

    Optional

    LIN:SCH06 (018)

    NextAvailableDate

    Date when next record of inventory will be available

    Optional

    LIN:QTY03

    UOM

    Unit of measure for the item getting updated.

    Optional

    N/A

    WarehouseQuantity

    Total quantity available associated with the Warehouse field. Should match total quantity.

    Optional

    LIN:QTY:LS:REF02 (WS)

    Warehouse2

    Second Warehouse code/identifer where inventory is located.

    Optional

    LIN:QTY:LS:QTY02 (33)

    Warehouse2Quantity

    Quantity available at the second warehouse.

    Optional

    LIN:QTY:LS:REF02 (WS)

    Warehouse3

    Third Warehouse code/Identifier where inventory is located.

    Optional

    LIN:QTY:LS:QTY02 (33)

    Warehouse3Quantity

    Quantity available at the third warehouse.

    Optional

    LIN:QTY:LS:REF02 (WS)

    Warehouse4

    Fourth Warehouse code/Identifier where inventory is located.

    Optional

    LIN:QTY:LS:QTY02 (33)

    Warehouse4Quantity

    Quantity available at the fourth warehouse.

    Optional

    LIN:QTY:LS:REF02 (WS)

    Warehouse5

    Fifth Warehouse code/Identifier where inventory is located.

    Optional

    LIN:QTY:LS:QTY02 (33)

    Warehouse5Quantity

    Quantity available at the fifth warehouse.

    Optional

    LIN:REF02 (ACC)

    Status

    Status code of the product. Typically to indicate if a product is discontinued or not available. See retailer specifications for what codes are required.

    Optional

    N/A

    LastUpdate

    Date in which the latest inventory update was provided.

    Read Only - Used only for Export

    History

    3/15/19 - Original specification loaded

    View Article

  • Need help from Kroger?

    Email: [email protected]

    View Article

  • Logicbroker is best equipped to answer questions related to how you interact with our systems. Topics such as the Logicbroker Portal, your integration method (EDI, Portal, etc.), order testing, and account setup, all fall into our area of expertise.

    Email is the fastest way to get a response as we have a team of people who are reviewing requests throughout the day.

    [email protected]

    (203) 929-7633

    View Article

  • Sample Files: https://kroger.logicbroker.com/hc/en-us/sections/360002572331-Sample-Files

    *API field name refers to field names for XML, JSON, and CSV field names.

    EDI Field

    API Field*

    Description

    Requirement

    BIG04

    PartnerPO

    The Purchase order number provided on the original order.

    Mandatory

    BIG03

    InvoiceDate

    The Date of the invoice being transmitted to Kroger

    Mandatory

    N/A

    OrderDate

    The Date of the order being placed (found on the order file)

    Mandatory

    BIG02

    InvoiceNumber

    Number to identify the unique invoice document

    Mandatory

    CUR02

    Currency

    Currency code to identify all values on the invoice. If no value is provided "USD" will be assumed.

    Mandatory

    SAC05 (G821)

    HandlingAmount

    Shipping and handling total to be charged on the invoice, this is part of the invoice total

    Mandatory

    TDS01

    InvoiceTotal

    Invoice total includes, full amount to be paid including line totals, shipping, taxes and discounts. Will be automatically calculated if no value is provided.

    Optional

    SAC05 (C310)

    Discounts.DiscountAmount

    Will include the total discount, and will be used to calculate the invoice total

    Optional

    SAC05 (H850)

    Taxes.TaxAmount

    This will be the tax amount used to calculate the invoice total amount.

    Mandatory

    CUR02

    Currency

    Currency code to identify all values on the invoice. If no value is provided "USD" will be assumed.

    Mandatory

    IT101

    InvoiceLIne.LineNumber

    Line Number from the Order. If not provided this will be taken from the order automatically.

    Mandatory

    IT106 (VN)

    InvoiceLIne.ItemIdentifier.SupplierSKU

    This is the SupplierSKU provided on the original order. It must be returned on the invoice.

    Mandatory

    IT108 (UP)

    InvoiceLine. ItemIdentifier.UPC

    The UPC code of the product sold, provided on the order. If not provided, it will be populated with the UPC code from the order

    Conditional

    IT1:IT102

    InvoiceLine.Quantity

    The number of units being invoiced for the line item

    Mandatory

    IT1:IT104

    InvoiceLine.Price

    Unit cost that the merchant is being billed for that line.

    Mandatory

    IT1:IT105

    InvoiceLine.QuantityUOM

    Unit of measure to identify the quantity on the invoice.

    Will always default to "EA" Each.

    Optional

    View Article

  • Sample Files: https://kroger.logicbroker.com/hc/en-us/sections/360002572331-Sample-Files

    *API field name refers to field names for XML, JSON, and CSV field names.

    EDI Field

    API Field*

    Description

    Requirement

    BSN02

    ShipmentNumber

    Unique ID to identify the shipment.

    Mandatory

    O:PRF01

    PartnerPO

    This will be the purchase order number, this will be the main Key to link all your documents.

    Mandatory

    S:DTM02 (067)

    ExpectedDeliveryDate

    The date the package is expected to arrive at the customers door for delivery.

    Mandatory

    I:LIN01

    ShipmentLine.LineNumber

    This element should match the purchase order line number.

    Mandatory

    I:LIN03 (VN)

    ShipmentLine.ItemIdentifier.SupplierSKU

    The Item Identifier that is used by the supplier or the person fulfilling the product. This needs to match the SupplierSKU on the purchase order.

    Mandatory

    I:LIN05 (UP)

    ShipmentLine.ItemIdentifier.UPC

    The UPC of the product; field is optional if SupplierSKU is provided.

    Optional

    I:SN102

    ShipmentLine.ShipmentInfo.Qty

    Total Qty of the product within the package or container.

    Mandatory

    P:TD107

    (G)

    ShipmentLine.ShipmentInfo.Weight

    The weight of the package/box/carton. Unit will always be in pounds (lb).

    Mandatory

    S:TD505

    ShipmentLine.ShipmentInfo.ClassCode

    The shipping method that will be used to send the merchandise.

    If you are using custom shipment mappings, configured under "Shipment Settings", you can provide a custom code which will translate to the appropriate Kroger shipment code.

    Mandatory

    S:DTM02 (011)

    ShipmentLine.ShipmentInfo.DateShipped

    Date the packaged was shipped.

    Mandatory

    P:MAN02 (CP)

    ShipmentLine.ShipmentInfo.TrackingNumber

    Tracking number for the specific package.

    Mandatory

    I:SN103

    ShipmentLine.QuantityUOM

    Unit of measure to identify the quantity in the container or package.

    Will always default to "EA" Each.

    Optional

    View Article

  • Sample Files: https://kroger.logicbroker.com/hc/en-us/sections/360002572331-Sample-Files

    *API field name refers to field names for XML, JSON, and CSV field names.

    EDI Field

    API Field*

    Description

    Requirement

    BAK03

    PartnerPO

    This will be the purchase order number this will be the main Key to link all your documents.

    Mandatory

    BAK04

    OrderDate

    Date on the Purchase Order

    Mandatory

    BAK08

    AcknowledgementNumber

    Unique Identifier used to identify the acknowledgment

    Mandatory

    BAK09

    AcknowledgementDate

    Date of the Acknowledgement. This field will automatically default with the date the document is created.

    Mandatory

    DTM02 (068)

    ScheduledShipDate

    The date an Item is expected to be shipped

    Mandatory

    PO1:PO101

    AckLines.LineNumber

    Needs to match the purchase order line number.

    Mandatory

    PO1:PO107 (VN)

    AckLines.ItemIdentifier.SupplierSKU

    VN (Vendor's (Seller's) Item Number) -The Item Identifier that is used by the supplier or the person fulfilling the product. This needs to match the SupplierSKU on the purchase order.

    Mandatory

    PO1:PO109 (UP)

    AckLines.ItemIdentifier.UPC

    UP (UPC) The UPC provided on the order; field is optional if SupplierSKU is provided.

    Optional

    PO1:ACK02

    AckLines.Quantity

    The Quantity to be accepted. Cannot exceed original quantity ordered.

    Mandatory

    PO1:ACK02

    AckLines.QuantityCancelled

    If this value is provided Quantity will be automatically updated and the change reason will get updated appropriately.

    Conditional

    PO1:ACK03

    AckLines.QuantityUOM

    EA will always default.

    Optional

    View Article

  • Sample Files: https://kroger.logicbroker.com/hc/en-us/sections/360002572331-Sample-Files

    *API field name refers to field names for XML, JSON, and CSV field names.

    EDI Field

    API Field*

    Description

    Requirement

    REF02 (IO)

    ReceiverCompanyId

    Logicbroker's Company Id to identify the receiver in the logicbroker system. This is an internal identifier.

    Optional

    N/A

    SenderCompanyId

    Logicbroker Internal Company ID to specify what company is sending the document.

    Optional

    REF02 (IL)

    Identifier.LogicbrokerKey

    Internal Identifier for the document in the Logicbroker system.

    Optional

    BEG03

    PartnerPO

    This will be the purchase order number, this will be the main Key to link all your documents.

    Required on the Packing Slip.

    Mandatory

    REF02 (CO)

    OrderNumber

    Contains the end customer's order number, this will be used on the packing slip.

    Mandatory

    BEG05

    OrderDate

    Date on the Purchase Order.

    Will be required on the Packing Slip

    Mandatory

    BEG02

    TypeCode

    Purchase Order Type Code will indicate what type of PO is being sent.

    SA = Stand Alone

    Mandatory

    REF02 (IA)

    VendorNumber

    Internal vendor number

    Mandatory

    TD505

    ShipmentInfo.ClassCode

    The shipping method that will be used to send the merchandise. This will contain the code provided from the retailer. Will be used on the packing slip.

    If you are using custom shipment mappings, configured under "Shipment Settings" in the Portal, the information will come from "ShipmentInfos.ReceiverClassCode"

    Default Codes:

    FDEG-CG = FedEx Ground

    FDEG-HD = FedEx Home Delivery

    FDE-SE = FedEx 2Day

    FDEG-ND = FedEx Next Day

    Mandatory

    N/A

    ShipmentInfo.ReceiverClassCode

    If you are using custom shipment mappings, configured under "Shipment Settings" the information will come from "ShipmentInfos.ReceiverClassCode"

    Optional

    REF02 (ST)

    ExtendedAttributes.SalesOrigin

    This field indicates which division of Kroger the order originated

    Mandatory

    N102

    BillToAddress.CompanyName

    End customer's company or full name.

    Mandatory

    N104

    BillToAddress.AddressCode

    Will be the customer number, to be used on the packing slip.

    Mandatory

    N201

    BillToAddress.FirstName

    First name to be used as part of the address. Used on the packing slip.

    Mandatory

    N202

    BillToAddress.LastName

    Last Name on address. Used on the packing slip.

    Mandatory

    N301

    BillToAddress.Address1

    First line of the Address; required on the packing slip.

    Mandatory

    N302

    BillToAddress.Address2

    Second line of the address, typically would see apartment number, suite, building number etc.

    If provided required on the packing slip.

    Optional

    N401

    BillToAddress.City

    City as part of the address; required on the packing slip.

    Mandatory

    N402

    BillToAddress.State

    State or Province as part of the address; required on the packing slip.

    Mandatory

    N403

    BillToAddress.Zip

    Zip or postal code to be used as part of the address; required on the packing slip.

    Mandatory

    N404

    BillToAddress.Country

    Country as part of the address.

    Mandatory

    N1:PER04 (TE)

    BillToAddress.Phone

    Phone number to be used as part of the main contact on the address.

    Optional

    N102

    ShipToAddress.CompanyName

    Company Name of the organization where the order will be shipped to; required on the packing slip.

    Mandatory

    N201

    ShipToAddress.FirstName

    First name to be used as part of the address; required on packing slip.

    Mandatory

    N202

    ShipToAddress.LastName

    Last Name on address; required on packing slip.

    Mandatory

    N301

    ShipToAddress.Address1

    First line of the Address; required on packing slip.

    Mandatory

    N302

    ShipToAddress.Address2

    Second line of the address, typically would see apartment number, suite, building number etc.

    Required on packing slip.

    Optional

    N401

    ShipToAddress.City

    City as part of the address; required on packing slip.

    Mandatory

    N402

    ShipToAddress.State

    State or Province as part of the address; required on packing slip.

    Mandatory

    N403

    ShipToAddress.Zip

    Zip or postal code to be used as part of the address; required on packing slip.

    Mandatory

    N404

    ShipToAddress.Country

    Country as part of the address

    Mandatory

    N1: PER 02 (IC)

    ShipToAddress.ExtendedAttributes. PER - ShipToName

    Full Name for Telephone contact

    Mandatory

    N1:PER04 (TE)

    ShipToAddress.Phone

    Phone number to be used as part of the main contact on the address.

    Mandatory

    PO1:PO101

    OrderLines.LineNumber

    Purchase order line number. Will need to be returned back on the Shipment.

    Mandatory

    PO1:PO107 (VN)

    OrderLines.ItemIdentifier.SupplierSKU

    The Item identifier that is internal to the purchaser/merchant; required on the packing slip.This should be provided on all return documents.

    Mandatory

    PO1:PO109 (IN)

    OrderLines.ItemIdentifier.PartnerSKU

    The Item Identifier that is used by the supplier or the person fulfilling the product. This should be provided on all return documents.

    Mandatory

    PO1:PO111 (UP)

    OrderLines.ItemIdentifier.UPC

    Will contain UPC or shopping cart SKU, which will be required on the Packing slip.

    Mandatory

    PO1:PO102

    OrderLines.Quantity

    Contains the quantity of items to be fulfilled; required on the packing slip.

    Mandatory

    PO1:PO103

    OrderLines.QuantityUOM

    Unit of Measure for the quantity ordered.

    "EA" - Each will always be used.

    Mandatory

    PO1:PO104

    OrderLines.Price

    Unit price. The unit price/cost of an Item.

    Mandatory

    PO1:PID05

    OrderLines.Description

    Standard short description or name of the product; required on packing slip.

    Optional

    View Article

  • Regardless of communication method (EDI, API, Portal, etc.), to start working through the test cases, you must first load some sample inventory and create your test orders.

    Loading Test Inventory

    Test orders cannot be generated until test inventory has been loaded. Ideally, you would load an inventory file that has real inventory data to ensure all data can be handled properly.

    EDI - load the 846 file through the established EDI AS2 connection or via FTP/SFTP.

    Excel or CSV - load the file through Stage Portal.

    See steps below for the template and steps.

    We recommend using an Excel file if you are not familiar with CSV-formatted files.

    A sample inventory file is attached if you want to use that as a template.

    We also have a video that walks you through how to set up your inventory in the Portal: http://www.screencast.com/t/qlpq6g9wg1i

    1. Navigate to Products --> Inventory Feeds.

    2. From the Download Files section, select Download XLSX (or CSV) to download the appropriate inventory headers in an Excel file.

    3. Update the Excel file with the appropriate information.

    For testing, the only required fields are SupplierSKU, MerchantSKU, UPC and Quantity. Additional fields may be required depending on the Retailer specifications.

    Be sure to load at least 5 unique SupplierSKUs (anything less may cause issues with test order generation.

    NOTE: UPCs are typically 12 digits long, and we advise you format the field at Text to ensure the number is not converted into a scientific number.

    NOTE: A sample inventory file is attached to this article as well.

    API Test Cases

    4. Drag and drop the Excel file in the Upload Files section OR click inside the dotted box to select a file to upload.

    5. A dialogue box will appear advising you of the status of the upload. Click Close.

    6. From the Events section, you can see that your file successfully loaded and you can review the file that was uploaded by clicking on View.

    A dialogue box appears where you can download the file that was originally uploaded.

    You are now ready to generate your test orders.

    Generate Test Orders

    Regardless of communication method (EDI, API, Portal, etc.), you will use the Testing module in Stage Portal to generate your test orders and review the results of your testing.

    EDI - all sent/received documents will be done through the connection you've established (AS2 or FTP/SFTP). You still need to generate the test orders in the Portal. Instructions below.

    API/JSON/XML- all sent/received documents will be done through the connection you've established (API, FTP, SFTP). You still need to generate the test orders in the Portal. Instructions below.

    Portal - all activities will be completed through the Portal.

    NOTE: You are able to combine actions. For example, you can do some actions via EDI and some via Portal (aka "mix and match").

    1. Navigate to Testing.

    2. If you have multiple Retailers (aka Partners), you may have the option to select which Retailer you would like to test. Select the appropriate Retailer by clicking View.

    3. The listing of required testing cases to complete are provided. Click on Generate A New Test Order for the first test.

    NOTE: When you generate the order, it creates a test order that will be visible in the Portal but will also send via EDI, API, etc. depending on your communication method.

    4. Now that you have generated the order, you review the order. Click on the order number.

    NOTE: Below the order number, you can see expected steps/documents you should be taking. The description on the left also includes more details on the actions expected.

    NOTE: Once you click on the order, you can see at the top of the order a link that takes you back to the Test Case page. It may take a moment (less than 30 seconds) for the test order to be "ready" to start taking action on.

    5. Once you complete a test, the status moves to Complete (green).

    6. At any time, you can generate a new test order if you would like to start over, try again, etc. Just click on Generate A New Test Order.

    You are now ready to proceed with testing. If you want more detail beyond the instructions in the Testing module, you can review written instructions here (based on communication method):

    Portal Test Cases

    EDI Test Cases

    CSV Test Cases

    XML/JSON Flat File Test Cases

    View Article

  • Below are the written steps to take to complete the test cases in the Portal (not via EDI, XML, JSON, CSV, etc.)

    Test Case Summary (see further below for the steps to take for each test):

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    We also have a few videos that walk through inventory setup and the 4 test cases below (from a Portal user perspective).

    Inventory: http://www.screencast.com/t/qlpq6g9wg1i Test Case 1 (TC1): http://www.screencast.com/t/UaoJkghs Test Case 2 (TC2): http://www.screencast.com/t/ZeLKeq4aG Test Case 3 (TC3): http://www.screencast.com/t/15a8vrTe7hi9 Test Case 4 (TC4): https://www.screencast.com/t/h658X3dZyst Test Case 4A (TC4A): https://www.screencast.com/t/eiaL7NZQiCwK

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    Step

    Process

    Description

    Action to Take

    1

    Order

    Vendor/Supplier will create the order and it will contain two lines of items. The orderwill be available in the Portal in a status of Ready to Ship.

    None, other than to confirm you can see the orderand it is in the right status. It may take a moment (less than 30 seconds) after you've generated the order for the order to be Ready to Ship.

    2

    Acknowledgement

    The acknowledgement should contain all items with all quantities being accepted.The estimated ship date should be included.

    Submit the acknowledgement through the Portal by navigating to the order detail, selecting Accept/Reject from the top header menu. By default, the acknowledgement will be drafted with all items accepted, you can then selectSubmit on the Create Acknowledgement page.

    3

    Shipment

    You will need to make sure to ship the order in 2 different boxes/containers (2 different tracking numbers). In the first box, quantity 1 (of 1) and quantity 2 (of 4). In the second box, quantity 2 (of 4).

    Be sure to use the same shipping method as requested on the order.

    Submit the shipment through the Portal by navigating to the order and selecting Shipfrom the top header menu.Once the shipment details such as carrier, tracking number and items shipped per box are entered, selectSubmit.

    NOTE: To create a shipment, the only required fields to enter are estimated delivery date, weight, carrier and tracking number.

    4

    Invoice

    The invoice will be for all items that shipped on the order.

    Submit the invoice from the shipment inthe Portal by navigating to the shipment createdand selecting Invoice. Once the invoice details are entered (price, quantity, and additional charges) selectSubmit.

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests. It may take a moment (less than 30 seconds) for the Testing status to update.

    TC2 - Cancel All Items

    Step

    Process

    Description

    Action to Take

    1

    Order

    Vendor/Supplier will create the order and it will contain two lines of items. The orderwill be available in the Portal in a status of Ready to Ship.

    None, other than to confirm you can see the orderand it is in the right status. It may take a moment (less than 30 seconds) after you've generated the order for the order to be Ready to Ship.

    2

    Acknowledgement

    The acknowledgement should cancel all lines on the order.

    Submit the acknowledgement through the Portal by navigating to the order detail, selecting Accept/Reject from the top header menu.

    On the Create Acknowledgement page, select Cancel All Items to call all items on the order.

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests. It may take a moment (less than 30 seconds) for the Testing status to update.

    TC3 - Partial Cancel First and Ship the Rest in Full

    Step

    Process

    Description

    Action to Take

    1

    Order

    Vendor/Supplier will create the order and it will contain three lines of items. The orderwill be available in the Portal in a status of Ready to Ship.

    None, other than to confirm you can see the orderand it is in the right status. It may take a moment (less than 30 seconds) after you've generated the order for the order to be Ready to Ship.

    2

    Acknowledgement

    The acknowledgement should cancel quantity 2 (of 4 ordered) from the first line and accept all remaining quantities and lines. The estimated ship date should be included.

    Submit the acknowledgement through the Portal by navigating to the order detail, selecting Accept/Reject from the top header menu.

    On the Create Acknowledgement page, update the Quantity Cancelled field for the first line to 2.The system will automatically change the Quantity Accepted from quantity 4 to quantity 2. Then select Submit to complete.

    3

    Shipment

    You will need to make sure to ship the order in 3 different boxes/containers (3 different tracking numbers). Ship each line in a different box. In the first box, ship the remaining first line quantity 2 (of 4 ordered). In the second box, ship quantity 2 (of 2). In the third box, ship quantity 1 (of 1).

    Be sure to use the same shipping method as requested on the order.

    Submit the shipment through the Portal by navigating to the order and selectingShipfrom the top header menu. You will need to select Add Box to create a second and third box and you will need to add/remove the SKUs required for each box.

    Once the shipment details such as carrier, tracking number and items shipped per box are entered, selectSubmit.

    NOTE: To create a shipment, the only required fields to enter are estimated delivery date, weight, carrier and tracking number.

    4

    Invoice

    The invoice will be for all items that shipped on the order.

    Submit the invoice from the shipment inthe Portal by navigating to the shipment createdand selectingInvoice. Once the invoice details are entered (price, quantity, and additional charges) selectSubmit.

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests. It may take a moment (less than 30 seconds) for the Testing status to update.

    TC4 - Multi-Line Ship

    Step

    Process

    Description

    Action to Take

    1

    Order

    Vendor/Supplier will create the order and it will contain one line. The orderwill be available in the Portal in a status of Ready to Ship.

    None, other than to confirm you can see the orderand it is in the right status. It may take a moment (less than 30 seconds) after you've generated the order for the order to be Ready to Ship.

    2

    Acknowledgement

    The acknowledgement should contain all items with all quantities being accepted.The estimated ship date should be included.

    Submit the acknowledgement through the Portal by navigating to the order detail, selecting Accept/Reject from the top header menu. By default, the acknowledgement will be drafted with all items accepted, you can then selectSubmit on the Create Acknowledgement page.

    3

    Shipment

    You will need to make sure to ship all quantities in one box.

    Be sure to use the same shipping method as requested on the order.

    Submit the shipment through the Portal by navigating to the order and selectingShipfrom the top header menu.

    Once the shipment details such as carrier, tracking number and items shipped are entered, selectSubmit.

    NOTE: To create a shipment, the only required fields to enter are estimated delivery date, weight, carrier and tracking number.

    4

    Invoice

    The invoice will be for all items on the order.

    Submit the invoice from the shipment inthe Portal by navigating to the shipment createdand selectingInvoice. Once the invoice details are entered (price, quantity, and additional charges) selectSubmit.

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests. It may take a moment (less than 30 seconds) for the Testing status to update.

    TC4A - Multi-Line +Perishable Undeliverable Return (Conditional)

    Step

    Process

    Description

    Action to Take

    1

    Order

    Vendor/Supplier will create the order and it will contain one line. The orderwill be available in the Portal in a status of Ready to Ship.

    None, other than to confirm you can see the orderand it is in the right status. It may take a moment (less than 30 seconds) after you've generated the order for the order to be Ready to Ship.

    2

    Acknowledgement

    The acknowledgement should contain all items with all quantities being accepted.The estimated ship date should be included.

    Submit the acknowledgement through the Portal by navigating to the order detail, selecting Accept/Reject from the top header menu. By default, the acknowledgement will be drafted with all items accepted, you can then selectSubmit on the Create Acknowledgement page.

    3

    Shipment

    You will need to make sure to ship all quantities in one box.

    Be sure to use the same shipping method as requested on the order.

    Submit the shipment through the Portal by navigating to the order and selectingShipfrom the top header menu.

    Once the shipment details such as carrier, tracking number and items shipped are entered, selectSubmit.

    NOTE: To create a shipment, the only required fields to enter are estimated delivery date, weight, carrier and tracking number.

    4

    Invoice

    The invoice will be for all items on the order.

    Submit the invoice from the shipment inthe Portal by navigating to the shipment createdand selectingInvoice. Once the invoice details are entered (price, quantity, and additional charges including handling, tax and discount) selectSubmit.

    5

    Return

    The return will be for all items on the order.

    Pull the order up in the Portal, selectMore Actionsfrom the Order Details page, then selectReturn Items.

    Enter a return reason of "Undeliverable/Refused" and update the return quantity to 2. This reason requires you to type it out in full. Then select Submit.

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests. It may take a moment (less than 30 seconds) for the Testing status to update.

    View Article

  • Download the ZIP file to see sample files that correspond to the Kroger test cases.

    Update History:

    9/9/19

    Added in a 2nd order line to Test Case 4 (all docs) and removed taxes and discount from invoice sample.

    3/7/19

    Adding in sample files for JSON format

    View Article

  • Download the ZIP file to see sample files that correspond to the Kroger test cases.

    Update History:

    9/9/19

    Added in a 2nd order line to Test Case 4 (all docs) and removed taxes and discount from invoice sample.

    5/7/19

    Loaded new files.

    View Article

  • Download the ZIP file to see sample files that correspond to the Kroger test cases.

    Update History:

    9/9/19

    Added in a 2nd order line to Test Case 4 (all docs) and removed taxes and discount from invoice sample.

    3/7/19

    Adding in sample files for XML format

    View Article

  • Download the ZIP file to see sample files that correspond to the Kroger test cases.

    Update History:

    9/9/19

    Added in a 2nd order line to Test Case 4 (all docs) and removed SAC segment (810)

    3/7/19

    Adding in sample files for Test Case 4

    1/2/19

    Initial EDI sample files attached

    View Article

  • Below are the written steps to take to complete the test cases viaAPI.

    NOTE: You would use the Stage Portal Testing module to create your test orders as well as see the results on the files you send back (Acknowledgement, Shipment, Invoice).

    See also API Documentation: https://kroger.logicbroker.com/hc/en-us/articles/360021249992-API-Documentation

    Test Case Summary (see further below for the steps to take for each test):

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    Follow the documentation and instructions at Supplier Order Lifecycle for getting an order.

    2

    Ack

    The acknowledgementfileshould accept all quantities of the order. The estimated ship date should be included.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an acknowledgement.

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 2 different boxes/containers (2 different tracking numbers).In the first box, quantity 1 (of 1 ordered) and quantity 2 (of 4). In the second box, the remaining quantity 2 (of 4).Make note of the shipping method requested on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting a shipment.

    4

    Invoice

    The invoice will be for all shipped items on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an invoice.

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    NOTE: When you pick up an order from FTP/SFTP, you should either pick it up and delete it from the FTP folder location OR move it to a folder under /APIXML/Archive or /JSON/Archive.

    TC2 - Cancel All Items

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    Follow the documentation and instructions at Supplier Order Lifecycle for getting an order.

    2

    Ack

    The acknowledgement file should cancel all lines and quantities of the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an acknowledgement.

    3

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC3 - Partial Cancel First and Ship the Rest in Full

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain three lines of items.

    Follow the documentation and instructions at Supplier Order Lifecycle for getting an order.

    2

    Ack

    The acknowledgement fileshould cancel line 1, quantity 2 (of 4 ordered) and accept the second and third line of the drop ship order.Any cancel/change reason is acceptable. The estimated ship date should be included.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an acknowledgement.

    3

    Shipment

    The shipment file willneed tomake sure to ship the order in 3 different boxes/containers (3 different tracking numbers).In the first box, line 1, quantity 2 (of 4 ordered). In the second box, line 2, quantity 2 (of 2). In the third box, line 3, quantity 1 (of 1). Make note of the shipping method requested on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting a shipment.

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an invoice.

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4 - Multi-Line Ship

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    Follow the documentation and instructions at Supplier Order Lifecycle for getting an order.

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an acknowledgement.

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting a shipment.

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an invoice.

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4A - Invoicing +Perishable Undeliverable Return (Conditional)

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    Follow the documentation and instructions at Supplier Order Lifecycle for getting an order.

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an acknowledgement.

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting a shipment.

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an invoice.

    5

    Return

    The return file will be for all shipped items on the order.Make sure the Return Reason is Undeliverable/Refused.

    Follow the documentation and instructions at Supplier Order Lifecycle for posting an invoice.

    6

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    View Article

  • Below are the written steps to take to complete the test cases via CSV.

    NOTE: You would use the Stage Portal Testing module to create your test orders as well as see the results on the files you send back (Acknowledgement, Shipment, Invoice).

    Test Case Summary (see further below for the steps to take for each test):

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /CSV/Inbound/Order

    2

    Ack

    The acknowledgementfileshould accept all quantities of the order The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /CSV/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 2 different boxes/containers (2 different tracking numbers).In the first box, quantity 1 (of 1 ordered) and quantity 2 (of 4). In the second box, the remaining quantity 2 (of 4).Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /CSV/Outbound/ExtendedShipment

    4

    Invoice

    The invoice will be for all shipped items on the order.

    The invoicefile is posted to:

    /CSV/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    NOTE: When you pick up an order from FTP/SFTP, you should either pick it up and delete it from the FTP folder location OR move it to a folder under /CSV/Archive.

    TC2 - Cancel All Items

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /CSV/Inbound/Order

    2

    Ack

    The acknowledgement file should cancel all lines and quantities of the order.

    The acknowledgementfile is posted to:

    /CSV/Outbound/Acknowledgement

    3

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC3 - Partial Cancel First and Ship the Rest in Full

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain three lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /CSV/Inbound/Order

    2

    Ack

    The acknowledgement fileshould cancel line 1, quantity 2 (of 4 ordered) and accept the second and third line of the drop ship order.Any cancel/change reason is acceptable. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /CSV/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed tomake sure to ship the order in 3 different boxes/containers (3 different tracking numbers).In the first box, line 1, quantity 2 (of 4 ordered). In the second box, line 2, quantity 2 (of 2). In the third box, line 3, quantity 1 (of 1). Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /CSV/Outbound/ExtendedShipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /CSV/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4 - Multi-Line Ship

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /CSV/Inbound/Order

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /CSV/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /CSV/Outbound/ExtendedShipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /CSV/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4A - Multi-Line +Perishable Undeliverable Return (Conditional)

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /CSV/Inbound/Order

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /CSV/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /CSV/Outbound/ExtendedShipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /CSV/Outbound/Invoice

    5

    Return

    The return file will be for all shipped items on the order.Make sure the Return Reason is Undeliverable/Refused.

    The returnfile is posted to:

    /CSV/Outbound/Return

    6

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    View Article

  • Below are the written steps to take to complete the test cases viaXML or JSON.

    NOTE: You would use the Stage Portal Testing module to create your test orders as well as see the results on the files you send back (Acknowledgement, Shipment, Invoice).

    Test Case Summary (see further below for the steps to take for each test):

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /APIXML/Inbound/Order or

    /JSON/Inbound/Order

    2

    Ack

    The acknowledgementfileshould accept all quantities of the order. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /APIXML/Outbound/Acknowledgement

    or/JSON/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 2 different boxes/containers (2 different tracking numbers).In the first box, quantity 1 (of 1 ordered) and quantity 2 (of 4). In the second box, the remaining quantity 2 (of 4).Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /APIXML/Outbound/Shipment

    or/JSON/Outbound/Shipment

    4

    Invoice

    The invoice will be for all shipped items on the order.

    The invoicefile is posted to:

    /APIXML/Outbound/Invoice

    or/JSON/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    NOTE: When you pick up an order from FTP/SFTP, you should either pick it up and delete it from the FTP folder location OR move it to a folder under /APIXML/Archive or /JSON/Archive.

    TC2 - Cancel All Items

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain two lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /APIXML/Inbound/Order or

    /JSON/Inbound/Order

    2

    Ack

    The acknowledgement file should cancel all lines and quantities of the order.

    The acknowledgementfile is posted to:

    /APIXML/Outbound/Acknowledgement

    or/JSON/Outbound/Acknowledgement

    3

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC3 - Partial Cancel First and Ship the Rest in Full

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain three lines of items.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /APIXML/Inbound/Order or

    /JSON/Inbound/Order

    2

    Ack

    The acknowledgement fileshould cancel line 1, quantity 2 (of 4 ordered) and accept the second and third line of the drop ship order.Any cancel/change reason is acceptable. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /APIXML/Outbound/Acknowledgement

    or/JSON/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed tomake sure to ship the order in 3 different boxes/containers (3 different tracking numbers).In the first box, line 1, quantity 2 (of 4 ordered). In the second box, line 2, quantity 2 (of 2). In the third box, line 3, quantity 1 (of 1). Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /APIXML/Outbound/Shipment

    or/JSON/Outbound/Shipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /APIXML/Outbound/Invoice

    or/JSON/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4 - Multi-Line Ship

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /APIXML/Inbound/Order or

    /JSON/Inbound/Order

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /APIXML/Outbound/Acknowledgement

    or/JSON/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /APIXML/Outbound/Shipment

    or/JSON/Outbound/Shipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /APIXML/Outbound/Invoice

    or/JSON/Outbound/Invoice

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4A - Multi-Line +Perishable Undeliverable Return (Conditional)

    Step

    Document

    Description

    FTP/SFTP

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the orderthrough the established connection. The orderwill contain one line.

    The order file is sent to Logicbroker's Stage FTP/SFTP site:

    /APIXML/Inbound/Order or

    /JSON/Inbound/Order

    2

    Ack

    The acknowledgement fileshould accept all lines of the order. The estimated ship date should be included.

    The acknowledgementfile is posted to:

    /APIXML/Outbound/Acknowledgement

    or/JSON/Outbound/Acknowledgement

    3

    Shipment

    The shipment file willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the order.

    The shipmentfile is posted to:

    /APIXML/Outbound/Shipment

    or/JSON/Outbound/Shipment

    4

    Invoice

    The invoice file will be for all shipped items on the order.

    The invoicefile is posted to:

    /APIXML/Outbound/Invoice

    or/JSON/Outbound/Invoice

    5

    Return

    The return file will be for all shipped items on the order.Make sure to use the Return Reason of Undeliverable/Refused.

    The returnfile is posted to:

    /APIXML/Outbound/Return

    or/JSON/Outbound/Return

    6

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    View Article

  • Below are the written steps to take to complete the test cases viaEDI.

    NOTE: You would use the Stage Portal Testing module to create your test orders as well as see the results on the files you send back (855, 856, 810).

    See also EDI Specifications: https://kroger.logicbroker.com/hc/en-us/articles/360020700352-EDI-Specifications

    See also EDI Sample Files: https://kroger.logicbroker.com/hc/en-us/articles/360021192832-EDI-Sample-Files

    Test Case Summary (see further below for the steps to take for each test):

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    Step

    Document

    Description

    FTP/SFTP

    AS2

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the 850 through the established connection. The 850 will contain two lines of items.

    850 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    850will post to Stage AS2 endpoint provided.

    2

    FuncAck

    Supplier will send 997; the test is successful when it is Accepted.

    997file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    997will post to Stage AS2 endpoint provided.

    3

    Ack

    The 855 should accept all remaining quantities of the order. The estimated ship date should be included.

    855file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    855will post

    to Stage AS2 endpoint provided.

    4

    FuncAck

    997should be received whether the 855passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will post

    to Stage AS2 endpoint provided.

    5

    Shipment

    The 856willneed tomake sure to ship the order in 2 different boxes/containers (2 different tracking numbers).In the first box, quantity 1 (of 1 ordered) and quantity 2 (of 4). In the second box, the remaining quantity 2 (of 4).Make note of the shipping method requested on the order.

    856file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    856 will post

    to Stage AS2 endpoint provided.

    6

    FuncAck

    997should be received whether the 856passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will post to Stage AS2 endpoint provided.

    7

    Invoice

    The 810will be for all shipped items on the order.

    810file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    810 will post

    to Stage AS2 endpoint provided.

    8

    FuncAck

    997should be received whether the 810passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will post

    to Stage AS2 endpoint provided.

    9

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    NOTE: As you go through testing, if you need to send a new "fixed" 855, 856 or 810 file, make sure you change the document identifier. For example, in the 855, BAK08 should be unique every time a file is submitted. For the 856, it's BSN02. For the 810, it's BIG02. If you reuse the same information here, it will be blocked by our system.

    TC2 - Cancel All Items

    Step

    Document

    Description

    FTP/SFTP

    AS2

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the 850 through the established connection. The 850 will contain two lines of items.

    850 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    850 will postto Stage AS2 endpoint provided.

    2

    FuncAck

    Supplier will send 997; the test is successful when it is Accepted.

    997file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    997 will postto Stage AS2 endpoint provided.

    3

    Ack

    The 855 acknowledgement should cancel all lines and quantities of the order.

    855file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    855 will postto Stage AS2 endpoint provided.

    4

    FuncAck

    997should be received whether the 855passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    5

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC3 - Partial Cancel First and Ship the Rest in Full

    Step

    Document

    Description

    FTP/SFTP

    AS2

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the 850 through the established connection. The 850 will contain three lines of items.

    850 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    850 will postto Stage AS2 endpoint provided.

    2

    FuncAck

    Supplier will send 997; the test is successful when it is Accepted.

    997file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    997 will postto Stage AS2 endpoint provided.

    3

    Ack

    855acknowledgement

    should cancel line 1, quantity 2 (of 4 ordered) and accept the second and third line of the drop ship order. Any cancel/change reason is acceptable. The estimated ship date should be included.

    855file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    855will postto Stage AS2 endpoint provided.

    4

    FuncAck

    997should be received whether the 855passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    5

    Shipment

    856willneed to make sure to ship the order in 3 different boxes/containers (3 different tracking numbers).In the first box, line 1, quantity 2 (of 4 ordered). In the second box, line 2, quantity 2 (of 2). In the third box, line 3, quantity 1 (of 1). Make note of the shipping method requested on the 850.

    856file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    856will post to Stage AS2 endpoint provided.

    6

    FuncAck

    997should be received whether the 856passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    7

    Invoice

    810will be for all shipped items on the order.

    810file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    810 will postto Stage AS2 endpoint provided.

    8

    FuncAck

    997should be received whether the 810passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will postto Stage AS2 endpoint provided.

    9

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4 - Multi-Line Ship

    Step

    Document

    Description

    FTP/SFTP

    AS2

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the 850 through the established connection. The 850 will contain one line.

    850 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    850 will postto Stage AS2 endpoint provided.

    2

    FuncAck

    Supplier will send 997; the test is successful when it is Accepted.

    997file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    997 will postto Stage AS2 endpoint provided.

    3

    Ack

    855acknowledgement

    should accept all lines of the order. The estimated ship date should be included.

    855file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    855will postto Stage AS2 endpoint provided.

    4

    FuncAck

    997should be received whether the 855passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    5

    Shipment

    856willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the 850.

    856file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    856will post to Stage AS2 endpoint provided.

    6

    FuncAck

    997should be received whether the 856passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    7

    Invoice

    810will be for all shipped items on the order.

    810file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    810 will postto Stage AS2 endpoint provided.

    8

    FuncAck

    997should be received whether the 810passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will postto Stage AS2 endpoint provided.

    9

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    TC4A - Multi-Line +Perishable Undeliverable Return (Conditional)

    Step

    Document

    Description

    FTP/SFTP

    AS2

    1

    Order

    Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the 850 through the established connection. The 850 will contain one line.

    850 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    850 will postto Stage AS2 endpoint provided.

    2

    FuncAck

    Supplier will send 997; the test is successful when it is Accepted.

    997file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    997 will postto Stage AS2 endpoint provided.

    3

    Ack

    855acknowledgement

    should accept all lines of the order. The estimated ship date should be included.

    855file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    855will postto Stage AS2 endpoint provided.

    4

    FuncAck

    997should be received whether the 855passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    5

    Shipment

    856willneed to make sure to ship the order in 1 box.Make note of the shipping method requested on the 850.

    856file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    856will post to Stage AS2 endpoint provided.

    6

    FuncAck

    997should be received whether the 856passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997 will postto Stage AS2 endpoint provided.

    7

    Invoice

    810will be for all shipped items on the order.

    810file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    810 will postto Stage AS2 endpoint provided.

    8

    FuncAck

    997should be received whether the 810passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will postto Stage AS2 endpoint provided.

    9

    Return

    180will be for all shipped items on the order. Make sure the return reason is Undeliverable/Refused.

    180file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Outbound

    180 will postto Stage AS2 endpoint provided.

    10

    FuncAck

    997should be received whether the 180passes validation or not.

    997 file is sent to Logicbroker's Stage FTP/SFTP site:

    /EDI/Inbound

    997will postto Stage AS2 endpoint provided.

    11

    Review Test Results

    NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

    View Article

  • All testing will be managed through the Testing module in Stage Portal, regardless of the communication type (EDI, API, Portal, etc.)

    The Testing module is where you will view the test orders you have generated, the results of your test documents (shipments, invoices, etc.), and the completion of the test case scenarios.

    There are 4 distinct test scenarios you will go through:

    TC1 - Multi-Line Ship in Multiple Boxes/Containers

    The purpose of this test is to send multiple boxes in a single Shipment file while specifying which items and quantities go in each box, then Invoice all shipped items.

    TC2 - Cancel All Items

    The purpose of this test is to cancel all lines on the order via the Acknowledgement file.

    TC3 - Partial Cancel First and Ship the Rest in Full

    The purpose of this test is to do a partial cancel of a single line and to accept/ship the remaining items in multiple boxes/containers, then Invoice all shipped items.

    TC4 - Multi-Line Ship (Conditional)

    TC4 - Multi-Line Ship - The purpose of this test is to send multiple items in a single box and Shipment (856) file).

    TC4A - Multi-Line + Perishable Undeliverable Return- The purpose of this test is to send multiple items in a single box and Shipment (856) file, and return the perishable order as undeliverable/refused.

    Note: If you are not shipping perishable items, you complete TC4 and skip TC4A.If you are shipping perishable items, you skip TC4 and move on to TC4A.

    Go to the Testing & Test Cases section of the Kroger Knowledge Base to get started.

    Move on to Step 3

    View Article

  • Creating a return is how to notify the retailer that you have received item(s) back from the customer (or the delivery could not be made and was returned. Follow these steps to create an invoice in the Portal.

    1. There are two ways to pull up an order that you would like to return.

    Option 1: Using the Search bar at the top of any page in the Portal, enter in the order number. This will pull up all related documents to the order (the order as well as any existing shipments, returns and/or cancellations).

    Option 2: Click on Orders in the left-hand menu, and from the Order Management page, find the order.

    Option 1:

    Option 2:

    2. On the Order Management page, click on Actions and select Return Items.

    3.You will be taken to the Create Returnpage. This is where you will create a return from an order.

    There are a few areas of the page to note using the screenshot example above:

    The Billing and Shipping Address information is pre-populated with the information originally submitted on the order.

    In the General Information section,Return Numberis a unique identifier for each individual return file that will be submitted. Logicbroker auto-populates the field but it can be modified as needed.

    NOTE: If you create more than one return for an order (example: one item returned today, another item returned tomorrow), you will need to modify this number on the 2nd return to ensure it is different than the one created on the 1st return. In summary, every return should have a unique return number.

    No other fields are required in this section.

    In the Return Items section:

    Update the Quantity Returned based on what was returned to you.

    Update the Return Reason either with a brief word or two on the return reason.

    NOTE: Kroger currently only accepts returns via Logicbroker when the shipment is an undeliverable or refused perishable item.

    Once ready, click Submit (top right corner of the page).

    View Article

  • Kroger EDI Qualifier/Identifier: ZZ/LB126678

    Logicbroker AS2 Information (SHA2):

    Stage/Test AS2 Identifier

    STAGELOGICBROKERAS2

    Stage/Test AS2 URL

    http://stage.commerceapi.io/as2

    Stage/Test IP Address Port

    23.101.133.17 80

    Production AS2 Identifier

    LOGICBROKERAS2

    Production AS2 URL

    http://commerceapi.io/as2

    Production IP Address Port

    23.101.133.17 80

    Encryption

    Triple DES (3DES)

    MDN Required

    Synchronous MDN

    Message Type/Format

    SMIME/Signed and encrypted

    NOTE: IP Address is only used to white list inbound files from our connection. This is not the IP for the AS2 address.

    Certificate Information:

    Certificate Type

    Certificate Name (File Name)

    SHA2

    logicbroker.com.cer

    NOTE: Certificate is attached as a .cer and .zip file. The certificate is the same for both Staging and Production.

    View Article

  • Creating an invoice is how to request payment from the retailer for the item(s) shipped. Follow these steps to create an invoice in the Portal.

    1. There are two ways to pull up an order that you would like to invoice.

    Option 1: Using the Search bar at the top of any page in the Portal, enter in the order number. This will pull up all related documents to the order (the order as well as any existing shipments, returns and/or cancellations).

    Option 2: Click on Orders in the left-hand menu, and from the Order Management page, find the order.

    Option 1:

    Option 2:

    2. On the Order Management page, click on Actions and select Invoice.

    NOTE: This is how to invoice an entire order. See further below on how to invoice just the items that have shipped.

    3.You will be taken to the Create Invoicepage. This is where you will create an invoice for an order.

    There are a few areas of the page to note using the screenshot example above:

    The Billing and Shipping Address information is pre-populated with the information originally submitted on the order. This is not the remit-to address.

    In the General Information section, you must enter in an Invoice Number.

    Invoice Date will pre-populate with today's date but can be modified.

    Invoice Number and Invoice Date are the only two fields that can be modified in this section.

    In the Invoice Items section, the only field that can be modified is the Unit Price field.

    In the Invoice Totals section, you can modify Discount, Freight and Tax and the Invoice Total will auto-update based on those changes.

    Discount will subtract from the Invoice Total, while Freight and Tax will be added to the Invoice Total.

    Once ready, click Submit (top right corner of the page).

    Create an Invoice for Shipped Items

    Our default invoice is for an entire order, however some vendors will invoice based on shipment. To create an invoice just for items shipped, follow these steps:

    1. Search for the PO in the search box.

    2. Find the shipment document you want to invoice, click View.

    Key point: You must view the shipment you want to invoice if you want to limit the invoice to what was shipped.

    3. ClickNew Invoice (top right corner of the screen)

    4. Follow the normal steps to create an invoice and click Submit.

    View Article

  • For every user login created in the Logicbroker portal, that user will have access

    to a Logicbroker-hosted FTP/SFTP site for that company. Your Logicbroker username

    and password will be used to log on to both the Stage and Production FTP/SFTP

    sites.

    Stage Host:vftp-stage.logicbroker.com

    Production Host: vftp.logicbroker.com

    **RECOMMENDATION: If you are setting up an automated integration

    to post your FTP/SFTP files, it is best to create a new FTP/SFTP user. This is

    to ensure that no single user's FTP credentials are being used for an automated

    FTP/SFTP process. To add a new user you can follow the instructions below.

    NOTE: If you need to white list the Logicbroker IP address,

    it is23.101.133.17 for both Stage and Production.We support

    both FTP/SFTP setups (no certificates), however if you use FTP it will require

    a plain, non-encrypted setup.

    1. From the Dashboard, go to Settings ->

    Manage Users

    2. Click Create New User and enter the required information

    Assuming you have created the FTP user or alias at your company, enter in

    the email address (that you will have access to) that will serve as the FTP

    login email.

    Select Send Inviteto send the email.

    3. Open the email, click on the link and create the FTP username/password that

    you will be using for your FTP automation.

    4. Test your FTP credentials by logging in using a standard FTP client like FileZilla

    or WinSCP.

    Once logged in, you should see a folder structure similar to below:

    View Article

  • Depending on your integration method, you may have unique shipping codes that you need to come through in your data for the SCAC (Standard Carrier Alpha Code). To set up your custom SCAC mappings:

    1. Navigate to Settings--> Shipment Options

    2. Once you are viewing the Ship Method Mapping section, sort by the Used By Partnerheader in Descending to show all the marked check boxes.

    3. To configure your custom SCAC, click on Edit. A new window will appear where you can enter in the code that you want to come inbound (orders) and you will use outbound (shipments). Click Save.

    For EDI, this will make sure that any codes sent in the shipment in the ClassCode field or the TD505 field in EDI will properly send to the Retailerwith the appropriate Carrier Code and Service Level Code.

    Move on to Step 4

    View Article

  • Adding Users

    To add additional users to access the Logicbroker Portal, please follow these steps:

    1. From the Dashboard, go to Settings --> Manage Users

    2. In the Invite New User section, enter the new user's email address.

    You can adjust the user's access under Permissions prior to sending the invite. They are defaulted to full access.

    Select Send Inviteto send the email.

    3. The newly created user will receive an email from Logicbroker, with the subject line of "Welcome to Logicbroker!". Users should also check their spam folders in case the email is routed there.

    4. Once the user has activated their account by setting up a username and password, they will appear in the Users section.

    Modifying/Deactivating Users

    To modify or delete a user, please follow these steps:

    1. From the Dashboard, go to Settings --> Manage Users

    2. From the Users section, select Edit or Delete.

    3. If modifying, you can modify First Name, Last Name and Permissions.

    You cannot modify username or email address. Delete the user and have them register again with their new information.

    4. If deleting, you will be prompted to confirm the action.

    View Article

  • Before creating a Logicbroker account, you will need to receive an email invitation to register.

    1. If you are the first user at your company, Logicbroker can send you an invitation.

    2. If there are already users at your company, an admin at your company can send an invite. They can follow the instructions to add users in the Manage Users article here: https://kroger.logicbroker.com/hc/en-us/articles/360021192612-Managing-Users

    3. The subject line of the email invitation is "Welcome to Logicbroker!". You should also check you spam folders in case the email was routed there. The email will contain a link to set up your account.

    4. Once you click on the link, you will be brought to the following page.

    Create a username, provide your first name and last name, and enter in your desired password two times.

    Click Activate. Please note that your password must be at least 10 characters/digits in length.

    View Article

  • Order Status

    Definition

    New (0)

    Order has been received into Logicbroker's system. Order will quickly move into another status and will not stay New.

    Submitted (100)

    Order is waiting to be received by the supplier. The order should not stay in this status long. If EDI, the order will move to Ready to Ship once successfully sent. For XML, JSON, CSV, and API; the status will update once the file is picked up via FTP. For Portal vendors, the order will never remain at this status and will automatically process to Ready to Ship.

    Ready to Ship (500)

    Order hasbeen sent to the vendor. The vendor has not completely shipped the order yet. The order will remain in this status until all items on the order have shipped or have been cancelled.

    Complete (1000)

    Order has been shipped completely.

    Cancelled (1100)

    Orderhas been entirely cancelled (does not apply to partial cancel/partial ship scenarios).

    Failed (1200)

    Order failed due to a connection issue or a validation issue with the vendor. Retailer is notified when an order is in a Failed status.

    Ignored (1400)

    Order has been marked as Ignored by at the request of Retailer or Logicbroker.

    NOTE: For the statuses above, the code associated with the status is helpful when creating custom reporting in the Logicbroker Portal.

    View Article

  • When you log in to the FTP site, you will see the applicable directories listed in the table below (there are more than what is listed). This is where you can send/receive documents with each directory indicating the format to be sent/received.

    NOTE: Your files will be located in the folder that corresponds with the communication type you use. If you use EDI, the EDI folder will contain all the relevant documents.

    Directory

    Sub-directory

    Description

    APIXML

    /Inbound

    /InboundByPartner

    /Outbound

    /Archive

    Inbound will be where XML files will be picked up, such as orders. Retailer --> Vendor

    InboundByPartner will be where XML files will be picked up, such as orders. Retailer --> Vendor

    Outbound will be where XML files will get posted, such as shipments. Vendor --> Retailer

    Archive will be where XML files can be moved after action has been taken, such as picking up orders. It is optional, and it is up to each vendor to determine whether to delete or archive.

    NOTE: This directory will only be used for the Logicbroker standard XML format. This is the format to use if you are connecting to Logicbroker via the Logicbroker API.

    CSV

    /Inbound

    /InboundByPartner

    /Outbound

    /Archive

    Inbound will be where CSV files will be picked up, such as orders. Retailer --> Vendor

    InboundByPartner will be where CSV files will be picked up, such as orders. Retailer --> Vendor

    Outbound will be where CSV files will get posted, such as shipments. Vendor --> Retailer

    Archive will be where CSV files can be moved after action has been taken, such as picking up orders. It is optional, and it is up to each vendor to determine whether to delete or archive.

    NOTE: You must either delete or move order files out of the Inbound location for any new orders to be received.

    CustomXML

    /Inbound

    /InboundByPartner

    /Outbound

    /Archive

    Inbound will be where Custom XML files will be picked up, such as orders. Retailer --> Vendor

    InboundByPartner will be where Custom XML files will be picked up, such as orders. Retailer --> Vendor

    Outbound will be where Custom XML files will get posted, such as shipments. Vendor --> Retailer

    Archive will be where Custom XML files can be moved after action has been taken, such as picking up orders. It is optional, and it is up to each vendor to determine whether to delete or archive.

    NOTE: This directory will be used to process a customized XML format, either mandated by the Retailer and/or Vendor. This is the XML format to use if you are not using the Logicbroker API to post documents.

    NOTE: You must either delete or move order files out of the Inbound location for any new orders to be received.

    EDI

    /Inbound

    /Outbound

    /Archive

    Inbound will be where all EDI files will be picked up, such as orders. Retailer --> Vendor

    Outbound will be where all EDI files will get posted, such as shipments. Vendor --> Retailer

    NOTE: You must either delete or move order files out of the Inbound location for any new orders to be received.

    JSON

    /Inbound

    /InboundByPartner

    /Outbound

    /Archive

    Inbound will be where JSON files will be picked up, such as orders. Retailer --> Vendor

    InboundByPartner will be where JSON files will be picked up, such as orders. Retailer --> Vendor

    Outbound will be where JSON files will get posted, such as shipments. Vendor --> Retailer

    Archive will be where JSON files can be moved after action has been taken, such as picking up orders. It is optional, and it is up to each vendor to determine whether to delete or archive.

    NOTE: You must either delete or move order files out of the Inbound location for any new orders to be received.

    ManagedInventory

    126678/Outbound

    This is where you would drop an Excel or CSV inventory file to be picked up by the Retailer. Use the Standard Feed template unless otherwise directed.

    NOTE: EDI 846 files do not go in this location, they go in the EDI location.

    Packing Slip

    /Inbound

    /Archive

    Inbound will be where you can pick up Packing Slips in bulk (this has to be set up with Logicbroker prior to using).

    Archive will be where Packing Slip files can be moved after action has been taken, such as picking up packing slips. It is optional, and it is up to each vendor to determine whether to delete or archive.

    NOTE: You must either delete or move packing slip files out of the Inbound location for any new orders to be received.

    Product

    /Outbound

    Outbound is where you would drop a product setup CSV file. Only use if directed by Logicbroker.

    View Article

  • Prior to testing, make sure to set up your API subscription key in Stage.

    1. Go to: https://stageportal.logicbroker.com/profile/api-authentication/

    2. Click on Regenerate to generate a key if there isn't one there.

    IMPORTANT: If there is an API key already there, confirm with your team before regenerating, as that could break an existing connection.

    3. Review the documentation and reference files below to set up your API connection.

    Stage API Reference: https://stage.commerceapi.io/swagger/ui/index

    Production API Reference: https://commerceapi.io/swagger/ui/index

    API Testing Documentation: https://dev.logicbroker.com/

    View Article

  • Creating an acknowledgement (acceptance and/or cancellation) is how a vendor/supplier communicates that the order has been received and the items have been accepted (or not). This information is transmitted to the retailer so they know what to expect when the order is ready to ship.

    There are several ways to bulk acceptance and/or cancellations from the Portal. The following is the easiest way to bulk accept and/or cancel orders.

    1. Navigate to Orders --> Order Management

    2. Select the orders you wish to bulk accept and/or cancel by clicking the appropriate checkboxes, or selecting all orders on a page. Then click on Accept/Reject.

    NOTE: You can adjust how many orders are visible on a page and you may also filter by status to only show orders in a "Ready to Ship" or "Ready to Acknowledge" status.

    3. All acknowledgements default to acceptance. If you want to accept an order without any changes, all you have to do is click on Submit. If you want to accept part and cancel part, or cancel entirely, adjust the Quantity Cancelled and Quantity Accepted for each item. For any cancelled items, enter in a Cancellation Reason.

    NOTE: Depending on the retailer, you may be required to enter in a specific cancellation code in the Cancellation Reason field. Additionally, some retailers may not allow partial acceptance or cancellation of an item and/or order. You will receive an error message if you attempt these actions and there is additional information required.

    NOTE: We automatically populate the Acknowledgement Number field. If you need to submit a 2nd acknowledgement on an order (for example, you initially accepted all items but then need to cancel an item later), you will need to manually adjust this field to be a new, unique number since the auto-generated number has already been used.

    4. When submitted successfully, you will receive a confirmation message.

    5. If there is an error, you will receive an error message and be given the opportunity to fix the error (by clicking on Retry).

    NOTE: Some actions, such as backorders, scheduled ship dates, etc. can only be done from doing one acknowledgement at a time and cannot be completed via the bulk acceptance process.

    View Article

  • Creating an invoice is how to request payment from the retailer for the item(s) shipped.

    There are several ways to bulk invoice from the Portal. The following is the easiest way to bulk invoice order(s).

    1. Navigate to Orders --> Order Management

    2. Select the orders you wish to invoice by clicking the appropriate checkboxes, or selecting all orders on a page. Then click on Invoice.

    NOTE: You can adjust how many orders are visible on a page and you may also filter by status to only show orders in a certain status, such as Complete or Ready to Invoice.

    3. All invoices default to all items on the order being invoiced. If you want to do partial invoices, you can adjust the Invoice Quantity to reflect what actually is invoiced and leave any items that shouldn't be invoiced with an InvoiceQuantity of zero.

    IMPORTANT: Make sure you provide Invoice Number, Invoice Date, and confirm that price at the item level, order level, and any freight or taxes is accurate. Once an invoice is submitted, there is not a way to edit the invoice.

    NOTE: Depending on the retailer, you may only be allowed to invoice the entire order or only items that have shipped. You will receive an error message if you attempt these actions.

    4. When submitted successfully, you will receive a confirmation message.

    5. If there is an error, you will receive an error message and be given the opportunity to fix the error (by clicking on Retry).

    View Article

  • Creating a shipment is the required step to close out or complete an order (unless the order has been cancelled). By providing a carrier and tracking number, this information is transmitted to the retailer so the customer is notified that the order has shipped.

    There are several ways to bulk ship and/or cancel from the Portal. The following is the easiest way to bulk ship and/or cancel orders.

    1. Navigate to Orders --> Order Management

    2. Select the orders you wish to bulk ship and/or cancel by clicking the appropriate checkboxes, or selecting all orders on a page. Then click on Ship/Cancel.

    NOTE: You can adjust how many orders are visible on a page and you may also filter by status to only show orders in a "Ready to Ship" or "Ready to Acknowledge" status.

    3. All shipments default to all items on the order shipping. If you want to do partial shipments, you can adjust the Ship Quantity to reflect what actually has shipped and leave any items that haven't shipped with a Ship Quantity of zero.If you want to ship part and cancel part, or cancel entirely, adjust the Cancel Quantityand Ship Quantity for each item. For any cancelled items, enter in a Cancellation Reason.

    NOTE: Depending on the retailer, you may be required to enter in a specific cancellation code in the Cancellation Reason field. Additionally, some retailers may not allow partial shipment or cancellation of an item and/or order. You will receive an error message if you attempt these actions and there is additional information required.

    4. When submitted successfully, you will receive a confirmation message.

    5. If there is an error, you will receive an error message and be given the opportunity to fix the error (by clicking on Retry).

    NOTE: Some actions, such as multiple boxes/tracking numbers, can only be done from doing one shipment at a time and cannot be completed via the bulk shipment process.

    View Article

  • Loading and updating inventory is a key process for retailers so they have up-to-date information on the status of products. Logicbroker provides tools to manage the updating of inventory via our Portal, FTP, or other communications.

    Inventory Feed Page

    Click onProductsin the left-hand menu, then click on Inventory Feeds.

    Section Definitions:

    Partner. Some vendors may have multiple retailer/partners they work with. This drop down allows the vendor to toggle between each partner for inventory updates. Each partner may have different inventory templates.

    Feed Information. Date of the last file received and the number of items in that file.

    Upload Files. Where you upload your inventory file (XLSX or CSV). Selecting Resend Items will resend the last file uploaded.

    Download Files. Standard Feed is the Logicbroker standard inventory template. You can use this download as your inventory template, and the download is the full export of inventory data loaded with the most recent updates for each item.

    Merchant Feed and Unmatched Items are only required if directed by Logicbroker or the retailer/partner.

    Events. Events is a full history of all inventory activities, showing all inventory actions taken. The View button allows the user to see the file(s) associated with that specific event. It's useful when looking for historical inventory files as well as a history of who made the update.

    Inventory Upload via Portal

    If you are uploading your inventory via the Portal, we recommend loading an Excel file (not a CSV file).

    1. To get your template, go to the Inventory Feeds page and click on Download XLSX next to Standard Feed (in the Download Files section)

    2. Use the downloaded file's headers as your template. The minimum required data for any inventory file is SupplierSKU and Quantity, however each retailer/partner may have additional requirements on data provided.

    HINT: It is best practice to provide as much information as possible, since the retailer/partner will often use this data to merchandise the products.

    3.After you have entered your inventory information into the template, save it to your desktop or a folder where you will be able to find it. Then in the Portal, on the Inventory Feeds page, navigate to the Upload Files section. From here, you can either drop your file into the box, or click in the box to browse and upload.

    NOTE: There will a box that appears to let you know the file was uploaded (it does not mean the data was validated, just that the file was received).

    4. After loading the file, wait a minute for the Events section to update to confirm that your file was successfully received and processed. If there was an error, this section is where you would go to view the details of the error.

    NOTE: To see the exact file that was loaded, click on View and download the file.

    Inventory Upload via FTP

    For every user login created in the Portal, that user has access to the Logicbroker-hosted FTP site. Your Logicbroker username and password will be used to log into both the Stage and Production FTP sites. The same Standard Feed template used in the Portal can be used as the template for FTP upload.

    Stage Host:vftp-stage.logicbroker.com

    Production Host:vftp.logicbroker.com

    Inventory Directory:/ManagedInventory/126678/Outbound

    EDI 846 Directory: /EDI/Outbound

    IMPORTANT: See these two articles for more information on setting up the FTP connection and our standard directory structure.

    FTP Connection: https://kroger.logicbroker.com/hc/en-us/articles/360021192792-FTP-Connection

    FTP Directories: https://kroger.logicbroker.com/hc/en-us/articles/360021439511-FTP-Directories

    View Article

  • Creating an acknowledgement is how a vendor/supplier communicates that the order has been received and the items have been accepted (or not). This information is transmitted to the retailer so they know what to expect when the order is ready to ship. Follow these steps to create an acknowledgement.

    NOTE: Kroger will not be accepting backorders. Orders must be accepted, cancelled or a combination of the two.

    1. There are two ways to pull up an order that you would like to ship.

    Option 1: Using the Search bar at the top of any page in the Portal, enter in the order number. This will pull up all related documents to the order (the order as well as any existing shipments, returns and/or cancellations).

    Option 2: Click on Orders in the left-hand menu, and from the Order Management page, find the order.

    Option 1:

    Option 2:

    2. On the Order Management page, click on Actions and select Accept/Reject.

    3. You will be taken to theCreate Acknowledgementpage. This is where you will accept, reject and/or backorder items on an order.

    There are a few areas of the page to note using the screenshot example above:

    The General Information section will include:

    Reference Number (aka Purchase Order Number), which is typically the connecting identifier between all documents.

    Acknowledgement Numberis a unique identifier for each individual acknowledgement file that will be submitted. Logicbroker auto-populates the field but it can be modified as needed.

    NOTE: If you create more than one acknowledgement for an order (example: accept all items initially, then you need to cancel an item), you will need to modify this number on the 2nd acknowledgement to ensure it is different than the one created on the 1st acknowledgement. In summary, every acknowledgement should have a unique acknowledgement number.

    Estimated Ship Date should always be provided when a backorder is being submitted. If there is more than one in stock date due to multiple items being on backorder, select the date furthest out.

    Acceptance

    All items automatically default to acceptance when an acknowledgement is created.

    To submit a full acceptance of all items on an order with no changes only requires you to click on Submit (top corner of the page).

    Cancel (aka Reject)

    To cancel items, go to the Acknowledgement Items section and update the Quantity Cancelled field with the quantity you want to cancel/reject for that line.

    For example, if quantity 2 is ordered and you want to cancel quantity 1, enter quantity 1 in the Quantity Cancelled field.

    Enter in a cancel reason in the Change Reason field next to each item (just to the left of Quantity Accepted).

    Click Submit (top right corner of the page) to complete.

    You may also cancel the entire order without changing any quantities in the Acknowledgement Items section by clicking on Cancel All Items (top right of the screen).

    Backorder (Not Kroger)

    To backorder items, go to the Acknowledgement Items section and update the Quantity Backordered field with the quantity you want to backorder for that line.

    For example, if quantity 2 is ordered and you want to backorder quantity 1, enter quantity 1 in the Quantity Backorderedfield.

    Enter in an Estimated Ship Date in the General Information section for the backorder.

    Click Submit (top right corner of the page) to complete.

    See example below of an acknowledgement with acceptance, cancels and backorders in one file.

    IMPORTANT: Because cancel data is sent regularly, make sure your cancellation is 100% accurate before clicking on Submit. The ability fix a mistake is very limited and could have a negative impact on the customer.

    View Article

  • You may download packing slips in four distinct ways from the Portal:

    Order Level - Bulk

    Order Level - Individually

    Shipment Level - Bulk

    Shipment Level - Individually

    Order Level Packing Slips include all items on the order. Shipment Level Packing Slips include just the items on a specific shipment.

    Downloading Order Level Packing Slips - Bulk

    This is how to download packing slips at the order level from the Portal (all items on the order regardless of shipping status).

    1. Log into the Portal and navigate toOrdersin the left-hand menu which opens theOrder Managementpage.

    2. Click on the checkboxes in the left hand column to select the orders that you would like to print packing slips.

    3. Click on the Exportbutton and select the optionPacking Slips. ClickDownload.

    4. A PDF file will generate with all the packing slips from the orders selected in the previous screen.

    Downloading Order Level Packing Slips - Individually

    This is how to download packing slips at the order level (all items on the order regardless of shipping status).

    1. Log into the Portal and navigate toOrdersin the left-hand menu which opens theOrder Managementpage.

    2. Click View on the right-hand side of the order for which you want to print a packing slip.

    3. Go to the More Actions drop-down menu in the header of the Order Details page and choose View Packing Slip

    4. From there you may download the single packing slip in the following formats: PDF, PNG, JPEG, PostScript, Zebra.

    Downloading Shipment Level Packing Slips - Bulk

    This is how to download packing slips at the shipment level (all items on the shipment).

    1. Log into the Portal and navigate toOrdersin the left-hand menu which opens theOrder Managementpage.

    2. Click theAll Documentsbutton at the top of the page.

    3. Filter by Type for "Shipment".

    4. Click on the checkboxes in the left hand column to select the orders that you would like to print packing slips.

    5. Click on Download Packing Slips. A PDF file will generate with all the packing slips associated to those shipments.

    Downloading Shipment Level Packing Slips - Individually

    This is how to download packing slips individually at the shipment level.

    1. Log into the Portal and navigate toOrdersin the left-hand menu which opens theOrder Managementpage.

    2. Click theAll Documentsbutton at the top of the page.

    3. Filter by Type for "Shipment".

    4.Click View to select the Shipment.

    5. From the header, click on View Packing Slip.

    6. From there you may download the single packing slip in the following formats: PDF, PNG, JPEG, PostScript, Zebra.

    NOTE: If you would like to set up a FTP process to receive packing slips, please contact Logicbroker to review the options available.

    View Article

  • The Order Details page shows you all the details associated to a specific order.

    Navigate to the Order Management page. Locate the order you would like to work on and choose View.

    Clicking View opens the Order Details page for that particular order.

    The information on the Order Details page is pulled directly from the order data submitted.

    At the top of the page, you'll notice you can Accept/Reject the Order as well as create a Shipment and an Invoice from this page.

    Some of the key actions in theMore Actionsdrop down menu allow you to:

    Download XML or JSON files of the order

    Return Items

    Download the packing slip for the order

    In the Order Items section, you will locate all of the product detail related to the ordered item(s), such as SKU, UPC and quantity orders.

    In the Shipping and Payment Information section, you can locate your shipping method requested.

    The Notes section will show any optional gift messages to be included with the order.

    The General Information section will show the PO number as well as the customer order number. The Reference # is the Purchase Order #, which is almost always used as the connecting ID (unique identifier) between retailer and supplier.

    The Events section will display key actions taken on the order and the Attachments section will display documents, such as the XML files related to the order.

    The Related Documents section shows all related documents to the purchase order. A cancelation, shipment, return, invoice, etc. are all documents of actions taken on an order.

    Each of those actions creates a document that is unique to the purchase order, and all of them are grouped under the Related Documents

    IMPORTANT: The search bar at the top of every page is often the fastest way to pull up an order or document. If you search by an order number, all related documents will come up under the search. You can also search by anything that would be in the order (name, address, SKU, product name, etc.).

    View Article
12345678910

Curious about Kroger?

Anonymously Ask Kroger Any Question

Ask Anonymous Question

Kroger's Competitors

Recently Asked Questions

Recent Kroger Employee Reviews

×
Rate your company