Skip to content

Onboarding a New Brand - Software Tools

Onboarding Video

Step-by-step Onboarding

  1. After Otter inserts the new brand in their panel, the brand will have an otterId. You can find it in the Otter Developer portal: developer.tryotter.com.
  2. Getting the otterId:
    • Click the Prod application (the second one).
    • Go to StoresOnboarded.
    • Find the newly created brand and copy the External Store Id.
  3. If Otter sends the webhook before you create the brand on our side, the store is created automatically. Check the External Store Id in Mongo before adding a new one. If it already exists, you can change the name.
  4. Obtain Uber login credentials and the account PIN from the OK team.
  5. Collect the Uber merchantUuid and parentChainUuid:
    • Open the Uber Eats Manager Delivery Settings: merchants.ubereats.com/manager/settings/delivery.
    • Inspect the site and select the newly created brand from the top dropdown.
    • In the Network panel, find the GraphQL request with OperationName getVdfDeliverySettings. The response contains merchantUuid and parentChainUuid.
  6. Collect the Grubhub Id from the Grubhub dashboard:
    • Navigate to Delivery Settings in the Grubhub panel, select the relevant store, change the EDT, and inspect the API payload. You will see the Grubhub Id there.
    • Note: Access may require VPN if you are outside the US.
  7. Open the OK Manager Brands page and create or edit the brand: manager.orbitalkitchens.com/brands.
    • Pay attention to the kitchen selector (the created brand goes under the selected kitchen).
  8. In the brand form dialog, confirm the Live Orders Mapping and Kitchen Station. Ask Casey if you need those mappings.
  9. Fill in all information about the new brand.
  10. Create a document in the delivery_service_parameter collection using the following structure:

    {
      "BrandId": "<brandId>",
      "BrandName": "<brand name>",
      "BrandLogo": "https://example.com/logo.png",
      "UberEatsDeliveryType": 1,
      "UberEatsFees": [],
      "GrubHubFeeEtd": {
        "DeliveryEstimateMinutes": 0,
        "PickupEstimateMinutes": 0,
        "Zones": []
      },
      "KitchenId": "<kitchenId>"
    }
    
  11. In OK Manager, navigate to Delivery Services, find the new brand, select the checkbox, and click Synchronize Selected at the top. If everything is correct, you will see the ETD and fee values populated.