Skip to content
Build 8b0b16e

Superior B2B — the 850, the 940, and what we send Cirro

Proof exercise — real prod order, nothing wired

PO PO264566 · OMS ORD221273 · Superior Communications (Distributors / VMI) · pulled 2026-06-02. POs and SKUs are real — this is an internal page. Part of CI-240 (XB → Cirro B2B migration). Raw 850/940 archived in the camel repo at reference/cirro/edi-samples/. Superior's Camel 940→Cirro path isn't lit yet, so this 940 is from the legacy Mule prod MySQL. See the Overview for the cross-vendor structure, the three data gaps, and the open questions for Cirro.


The 850 — Purchase Order

Header verbatim; 4 line items, identical shape, line 1 shown full (each repeats the same ST address); lines 2–4 elided (full file in edi-samples/).

<?xml version='1.0' encoding='UTF-8'?>
<PurchaseOrders ...><PurchaseOrder>
  <Header>
    <OrderHeader>
      <TradingPartnerId>005ALLPOPSOCKET</TradingPartnerId>
      <PurchaseOrderNumber>PO264566</PurchaseOrderNumber>
      <TsetPurposeCode>00</TsetPurposeCode>
      <PurchaseOrderTypeCode>SA</PurchaseOrderTypeCode>
      <PurchaseOrderDate>2026-01-08</PurchaseOrderDate>
      <Department>001</Department>
      <Vendor>POP2</Vendor>
    </OrderHeader>
    <Address>
      <AddressTypeCode>ST</AddressTypeCode>
      <LocationCodeQualifier>92</LocationCodeQualifier>
      <AddressLocationNumber>DC2_VMI</AddressLocationNumber>      <!-- Superior DC -->
      <AddressName>Superior Communications</AddressName>
      <Address1>5301 Centre Pointe Drive</Address1>
      <City>La Vergne</City><State>TN</State><PostalCode>37086</PostalCode><Country>US</Country>
    </Address>
  </Header>
  <LineItems>
    <LineItem>
      <OrderLine>
        <LineSequenceNumber>10000</LineSequenceNumber>
        <BuyerPartNumber>18990VRP</BuyerPartNumber>             <!-- Superior item # (retailer SKU) -->
        <VendorPartNumber>800857</VendorPartNumber>            <!-- our SKU (Mfr Part No) -->
        <PartDescription1>Black Aluminum PopGrip</PartDescription1>
        <OrderQty>120</OrderQty><OrderQtyUOM>EA</OrderQtyUOM>
        <UnitPrice>5.8</UnitPrice>
      </OrderLine>
      <Address><AddressTypeCode>ST</AddressTypeCode>...DC2_VMI / Superior Communications, La Vergne TN...</Address>
    </LineItem>

    <!-- ... 3 more line items, identical shape (each with the same ST address block):
         2: BuyerPartNumber 53709VRP / VendorPartNumber 804928 / "Smiley PopGrip TD"        / qty 160
         3: BuyerPartNumber 53714VRP / VendorPartNumber 802457 / "KnurledTexture PopGrip Blk"/ qty 400
         4: BuyerPartNumber 58399VRP / VendorPartNumber 807047 / "PopGrip Boho Butterfly Wht"/ qty 360 ... -->

  </LineItems>
  <Summary><TotalLineItemNumber>4</TotalLineItemNumber><TotalQuantity>1040</TotalQuantity></Summary>
</PurchaseOrder>
</PurchaseOrders>

The 940 — Warehouse Shipping Order

Header verbatim; all 4 line items shown (no UPC / GTIN tag on any line).

<?xml version='1.0' encoding='UTF-8'?>
<WarehouseShippingOrders ...><WarehouseShippingOrder>
  <Header>
    <OrderHeader>
      <TradingPartnerId>29ADISTPOPSOCKET</TradingPartnerId>
      <DepositorOrderNumber>ORD221273</DepositorOrderNumber>
      <RecordType>HO</RecordType>
      <DepositorPurchaseOrderNumber>PO264566</DepositorPurchaseOrderNumber>
      <OrderStatusCode>N</OrderStatusCode>
      <PurchaseOrderTypeCode>SA</PurchaseOrderTypeCode>
      <ShipmentMethodOfPayment>H</ShipmentMethodOfPayment>
      <CarrierTransMethodCode>L</CarrierTransMethodCode>
      <CarrierRouting>ROUTEGUIDE</CarrierRouting>
      <CarrierAlphaCode>SRGD</CarrierAlphaCode>
    </OrderHeader>
    <Reference><ReferenceQual>L1</ReferenceQual><ReferenceID>DIST</ReferenceID></Reference>
    <Reference><ReferenceQual>PD</ReferenceQual></Reference>
    <Reference><ReferenceQual>SE</ReferenceQual></Reference>
    <Reference><ReferenceQual>IA</ReferenceQual><ReferenceID>POP2</ReferenceID></Reference>
    <Reference><ReferenceQual>PH</ReferenceQual><ReferenceID>C02655</ReferenceID></Reference>
    <Reference><ReferenceQual>CO</ReferenceQual><ReferenceID>PO264566</ReferenceID></Reference>      <!-- PO -->
    <Reference><ReferenceQual>SI</ReferenceQual><ReferenceID>ORD221273</ReferenceID></Reference>      <!-- order # -->
    <Reference><ReferenceQual>LU</ReferenceQual><ReferenceID>005ALLPOPSOCKET</ReferenceID></Reference>
    <Reference><ReferenceQual>ST</ReferenceQual><ReferenceID>DC2_VMI</ReferenceID></Reference>        <!-- DC -->
    <Reference><ReferenceQual>DP</ReferenceQual><ReferenceID>001</ReferenceID></Reference>            <!-- Dept # -->
    <Date><DateTimeQualifier1>04</DateTimeQualifier1><Date1>20260108</Date1></Date>
    <Date><DateTimeQualifier1>10</DateTimeQualifier1><Date1>20260218</Date1></Date>
    <Contact><ContactTypeCode>IC</ContactTypeCode><ContactName>Evelyn Dominguez</ContactName></Contact>
    <Address>
      <AddressTypeCode>ST</AddressTypeCode>
      <LocationCodeQualifier>92</LocationCodeQualifier>
      <AddressLocationNumber>DC2_VMI</AddressLocationNumber>
      <AddressName>Superior Communications</AddressName>
      <Address1>5301 Centre Pointe Drive</Address1>
      <City>La Vergne</City><State>TN</State><PostalCode>37086</PostalCode><Country>US</Country>
    </Address>
    <Address>
      <AddressTypeCode>SF</AddressTypeCode>
      <AddressName>Distributors Virtual Fulfilment</AddressName>
      <Address1>8115 Saint Andrews Ave</Address1>
      <City>SAN DIEGO</City><State>CA</State><PostalCode>92154</PostalCode><Country>US</Country>
    </Address>
    <Address>
      <AddressTypeCode>VN</AddressTypeCode>
      <AddressName>PopSockets LLC</AddressName>
      <Address1>1426 Pearl St.</Address1><Address2>Ste 400</Address2>
      <City>BOULDER</City><State>CO</State><PostalCode>80302</PostalCode><Country>US</Country>
    </Address>
    <Address>
      <AddressTypeCode>BY</AddressTypeCode>
      <AddressName>Superior Communications</AddressName>
      <Address1>Attn: Accounts Payable</Address1><Address2>5027 Irwindale Ave. Suite 900</Address2>
      <City>Irwindale</City><State>CA</State><PostalCode>91706</PostalCode><Country>US</Country>
    </Address>
  </Header>
  <LineItems>
    <LineItem><OrderLine>
      <LineSequenceNumber>10000</LineSequenceNumber>
      <BuyerPartNumber>18990VRP</BuyerPartNumber>              <!-- Superior item # (retailer SKU) -->
      <VendorPartNumber>800857</VendorPartNumber>             <!-- our SKU (Mfr Part No) -->
      <PartDescription1>PG-Alum-Black-BK BK</PartDescription1>
      <OrderQty>120.00</OrderQty><OrderQtyUOM>EA</OrderQtyUOM><UnitWeight>0.00</UnitWeight><Amount1>5.80</Amount1>
    </OrderLine></LineItem>
    <LineItem><OrderLine>
      <LineSequenceNumber>20000</LineSequenceNumber>
      <BuyerPartNumber>53709VRP</BuyerPartNumber>
      <VendorPartNumber>804928</VendorPartNumber>
      <PartDescription1>PG-Tie Dye Smiley-BK BK</PartDescription1>
      <OrderQty>160.00</OrderQty><OrderQtyUOM>EA</OrderQtyUOM><UnitWeight>0.00</UnitWeight><Amount1>3.60</Amount1>
    </OrderLine></LineItem>
    <LineItem><OrderLine>
      <LineSequenceNumber>30000</LineSequenceNumber>
      <BuyerPartNumber>53714VRP</BuyerPartNumber>
      <VendorPartNumber>802457</VendorPartNumber>
      <PartDescription1>PG-Knurled Texture Black-BK BK</PartDescription1>
      <OrderQty>400.00</OrderQty><OrderQtyUOM>EA</OrderQtyUOM><UnitWeight>0.00</UnitWeight><Amount1>3.60</Amount1>
    </OrderLine></LineItem>
    <LineItem><OrderLine>
      <LineSequenceNumber>40000</LineSequenceNumber>
      <BuyerPartNumber>58399VRP</BuyerPartNumber>
      <VendorPartNumber>807047</VendorPartNumber>
      <PartDescription1>PG-Boho Butterfly-BK BK</PartDescription1>
      <OrderQty>360.00</OrderQty><OrderQtyUOM>EA</OrderQtyUOM><UnitWeight>0.00</UnitWeight><Amount1>3.60</Amount1>
    </OrderLine></LineItem>
  </LineItems>
  <Summary><TotalOrders>1040.00</TotalOrders></Summary>
</WarehouseShippingOrder></WarehouseShippingOrders>

What we send Cirro

Fields we send (Order Push), populated from the 940. Superior uses three labels (no Case Marking / GTIN label, no UPC field anywhere). po_number (on all three labels) is carried once at the request level.

{
  "po_number": "PO264566",
  "label_template": {
    "ucc_label": {
      "items": [
        { "product_sku": "800857" },                          // Mfr Part No (our SKU) — Item# (retailer SKU) not sent on UCC, see discussion
        { "product_sku": "804928" },
        { "product_sku": "802457" },
        { "product_sku": "807047" }
      ]
    },
    "packing_slip_label": {
      "items": [
        { "platform_sku": "18990VRP" },                       // Superior item # (retailer SKU)
        { "platform_sku": "53709VRP" },
        { "platform_sku": "53714VRP" },
        { "platform_sku": "58399VRP" }
      ]
    },
    "pallet_label": {
      "items": [
        { "platform_sku": "18990VRP", "product_sku": "800857" },
        { "platform_sku": "53709VRP", "product_sku": "804928" },
        { "platform_sku": "53714VRP", "product_sku": "802457" },
        { "platform_sku": "58399VRP", "product_sku": "807047" }
      ]
    }
  }
}

No hard data gap — every field we send has a value on the 940.


Discussion points with Cirro

  1. UCC Item# (Superior's retailer SKU) — does it belong on the carton label? The spec marks the UCC Item# as 订单推送 Order Push (we send), same as its sibling Manufacturer Part Number (our SKU). The payload above currently sends only our SKU on the UCC items[]. Confirm: does the UCC carton label want Superior's item number too, or just our SKU? (It's already sent on the Packing Slip and Pallet, so the data is on the 940 either way.)

Built from real prod EDI pulled 2026-06-02. Raw 850/940 archived in the camel repo at reference/cirro/edi-samples/.