Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.mathership.com/llms.txt

Use this file to discover all available pages before exploring further.

Vendor Contacts

Vendor contacts let restaurants save supplier contact details and send orders directly by email. Use vendor contacts when you order from a supplier that is not connected through the Mathership vendor catalog or vendor relationship system.

What are vendor contacts?

A vendor contact is a saved supplier contact for one of your customer companies. A vendor contact usually includes:
  • Supplier name
  • Supplier email address
  • Active or inactive status
  • The customer company it belongs to
Vendor contacts are used when creating direct contact orders.

When to use vendor contacts

Use vendor contacts when:
  • The supplier is not available in the vendor catalog
  • You only need to send an order by email
  • You want to save frequently used supplier email addresses
  • You want to reuse supplier contacts instead of typing them again
  • You order from smaller or external suppliers
Examples:
SupplierEmailUse case
Local butcherorder@butcher-example.comMeat orders
Wine suppliersales@wine-example.comWine orders
Bakerybakery@example.comBread orders
Vegetable supplierorders@vegetables-example.comFresh produce orders

Vendor contacts and connected vendors

Vendor contacts are different from connected vendors.
TypeMeaning
Connected vendorA vendor company connected through Mathership
Vendor contactA manually saved supplier contact with name and email
Connected vendors can have product catalogs, customer relationships, customer numbers, routes, and vendor-side order management. Vendor contacts are simpler. They are mainly used to send an order email to a saved supplier address.

Viewing vendor contacts

To view vendor contacts:
  1. Go to Restaurants
  2. Open your company
  3. Go to Vendor Contacts or the supplier/contact selection in the order flow
  4. Review the saved contacts
The list can show:
  • Contact ID
  • Supplier name
  • Supplier email
  • Active status
Only active contacts are shown in the normal contact list.

Creating a vendor contact

To create a new vendor contact:
  1. Open the vendor contact list
  2. Click Add Contact
  3. Enter the supplier name
  4. Enter the supplier email address
  5. Save the contact
Required fields:
FieldRequiredExample
Supplier nameYesFresh Food Supplier
Supplier emailYesorders@supplier.com
A vendor contact needs both a name and an email address. Without both fields, the contact cannot be created.

Reusing existing contacts

When you place an order using a supplier name and email, Mathership can reuse an existing vendor contact with the same email address. If the contact already exists:
  • The existing contact is reused
  • The name can be updated
  • The contact can be reactivated if it was inactive
This avoids duplicate contacts for the same supplier email address.

Editing a vendor contact

You can update a saved vendor contact. You can usually edit:
  • Supplier name
  • Supplier email address
  • Active status
To edit a contact:
  1. Open the vendor contact list
  2. Select the contact
  3. Update the name or email
  4. Save your changes
Example:
FieldOld valueNew value
Supplier nameWine SupplierPremium Wine Supplier
Supplier emailold@supplier.comorders@supplier.com
Updating a vendor contact changes the saved contact for future use. It does not necessarily change old orders that were already sent.

Deleting a vendor contact

Deleting a vendor contact does not permanently remove it. Instead, the contact is set to inactive. This means:
  • The contact no longer appears in the active contact list
  • Existing order history can still reference the contact
  • The contact can be reactivated later if needed
To delete a contact:
  1. Open the vendor contact list
  2. Select the contact
  3. Click Delete
  4. Confirm the action

Active and inactive contacts

Vendor contacts have an active status.
StatusMeaning
ActiveThe contact is available for new orders
InactiveThe contact is hidden from normal selection
Use inactive status when:
  • You no longer order from the supplier
  • The email address is outdated
  • The supplier is temporarily not used
  • You want to keep history but clean up the active list

Using a vendor contact in an order

Vendor contacts are used for direct contact orders. When creating an order, you can either:
  • Select an existing vendor contact
  • Enter a new supplier name and email
If you select an existing contact, Mathership uses the saved name and email address. If you enter a new supplier name and email, Mathership can create or reuse a vendor contact automatically.

Required order information

A direct contact order needs:
  • Delivery location
  • Vendor contact or supplier name and email
  • At least one product
  • Quantities
Optional fields can include:
  • Message
  • Estimated delivery date
  • Sending mode
  • Scheduled sending time
Example order fields:
FieldExample
Delivery locationMain Restaurant
Vendor contactLocal Butcher
MessagePlease deliver before 10:00
Estimated delivery date2026-05-12
ModeSend
ItemsRibeye, minced beef

Order modes

Direct contact orders can be handled in three modes.
ModeMeaning
SendSend the order email immediately
DraftSave the order without sending it
ScheduleSave the order and send it later

Sending an order immediately

Use Send when the order should be emailed to the supplier right away. When the order is sent:
  • The order is created
  • The vendor contact is linked
  • The order email is queued or sent
  • The email status is set to pending first

Saving an order as draft

Use Draft when the order should be prepared but not sent yet. Draft orders are useful when:
  • You want to review the order later
  • A colleague should check it first
  • The order is incomplete
  • You are not ready to send it
Draft orders can be edited before sending.

Scheduling an order

Use Schedule when the order should be sent at a future date and time. Scheduled orders are useful when:
  • Orders should go out early in the morning
  • You prepare orders in advance
  • You want to align ordering with supplier deadlines
  • You want to avoid sending an order immediately
The scheduled time must be in the future.
Scheduled sending times must use a valid date and time format and must be in the future.

Estimated delivery date

The estimated delivery date is optional. Use it when you want to record when the supplier is expected to deliver. The date should use the format: YYYY-MM-DD Example: 2026-05-12
The estimated delivery date is not the same as the scheduled sending time. The estimated delivery date describes when the goods are expected to arrive.

Editing draft or scheduled orders

Draft and scheduled contact orders can be edited before they are sent. You can usually update:
  • Delivery location
  • Message
  • Estimated delivery date
  • Scheduled sending time
  • Order items
When updating items, the item list is replaced with the new list.
Only draft or scheduled orders can be edited. Orders that were already sent cannot be edited in the same way.

Sending a draft or scheduled order now

You can send a draft or scheduled order immediately. When you send it now:
  • Email status changes to pending
  • Scheduled sending time is cleared
  • The order email is sent to the vendor contact
Use this when:
  • A draft is ready
  • A scheduled order should be sent earlier
  • You no longer want to wait for the scheduled sending time

Updating the delivery date

You can update the delivery date of an order after creation. Use this when:
  • The supplier confirms a delivery date
  • The expected delivery date changes
  • You want your order history to reflect the actual planning
The delivery date should use the format: YYYY-MM-DD Example: 2026-05-12

Archiving contact orders

Orders can be archived when they are no longer relevant in the active list. Archiving does not delete the order. Use archiving when:
  • The order is completed
  • The order no longer needs attention
  • You want to clean up the order list
  • You want to keep the order for history
Archived orders are removed from normal active order views but remain available for history.

Downloading an order PDF

Orders can be downloaded as a PDF file. Use this when:
  • You want to save a copy outside Mathership
  • You need to forward the order manually
  • You want to print the order
  • You want to keep a document for internal records
The PDF can include:
  • Supplier name
  • Customer company
  • Delivery location
  • Order items
  • Quantities
  • Prices if available
  • Message
  • Order details

Retrying a failed order email

If an order email fails, it can be retried. Retry is usually available when the email status is:
  • Failed
  • Pending
When retrying:
  • The email status is reset to pending
  • The previous email error is cleared
  • The email sending task is started again
Use this when:
  • The supplier email was temporarily unavailable
  • There was a technical sending issue
  • You fixed an email address problem and want to resend

Common workflow

A typical vendor contact workflow looks like this:
  1. Create or select a customer company
  2. Add products to your own company product list
  3. Create a vendor contact with supplier name and email
  4. Create an order using that contact
  5. Add products and quantities
  6. Send, draft, or schedule the order
  7. Review the order history
  8. Archive completed orders

Example: Create a vendor contact

You want to save your local butcher as a contact.
FieldExample
Supplier nameLocal Butcher
Supplier emailorders@local-butcher.com
StatusActive
You can now select this contact when sending meat orders.

Example: Send a direct contact order

You want to send a direct email order to your bakery.
FieldExample
Vendor contactCity Bakery
Delivery locationMain Restaurant
Estimated delivery date2026-05-12
MessagePlease deliver before 8:00
ModeSend
Mathership creates the order and sends the email to the saved bakery contact.

Example: Schedule an order

You want to prepare an order today but send it tomorrow morning.
FieldExample
Vendor contactVegetable Supplier
Delivery locationMain Restaurant
ModeSchedule
Scheduled timeTomorrow morning
Estimated delivery date2026-05-12
The order is saved and sent later at the scheduled time.

Best practices

Keep supplier emails clean

Use the email address where orders should actually be sent. Avoid using general addresses if the supplier has a dedicated ordering address. Good examples:

Use clear supplier names

Use names your team can recognize quickly. Examples:
Less clearBetter
Supplier 1Local Butcher
WinePremium Wine Supplier
BreadCity Bakery

Remove old contacts from active use

If you no longer order from a supplier, set the contact inactive instead of keeping it in the active list. This keeps the order flow clean.

Check before sending

Before sending an order, check:
  • Correct supplier contact
  • Correct delivery location
  • Correct products
  • Correct quantities
  • Correct message
  • Correct delivery date

Use drafts for review

Use drafts when another person should check the order before it is sent. This helps avoid wrong quantities or wrong supplier emails.

Common problems

Vendor contact does not appear

Check that:
  • The contact belongs to the selected customer company
  • The contact is active
  • The correct company is selected
  • The contact was not deleted or deactivated

Contact cannot be created

Check that:
  • Supplier name is entered
  • Supplier email is entered
  • The email address is valid
  • You are working in the correct customer company

Order cannot be sent

Check that:
  • A delivery location is selected
  • At least one item is included
  • A vendor contact is selected
  • Or supplier name and supplier email are entered
  • The sending mode is valid

Scheduled order fails

Check that:
  • The scheduled time is in the future
  • The scheduled time is a valid date and time
  • The order still has items
  • The vendor contact email is correct

Wrong supplier received the order

Check that:
  • The correct vendor contact was selected
  • The supplier email is up to date
  • Old contacts were deactivated
  • The order was not created with a manually typed wrong email

Placing Orders

Learn how to create and send orders.

Order Drafts and Scheduling

Save orders as drafts or schedule them for later sending.

Order History

Review sent, draft, scheduled, and archived orders.

Order Attachments

Understand PDFs, CSV files, and order email attachments.

Manage Vendors

Manage connected vendors and supplier relationships.

Vendor Catalog

Discover public vendors and follow them.
Last modified on May 5, 2026