Skip to content

Automated order ingestion

If you sell off Shopify, or you run several channels, you can feed orders into SamVertex automatically. Four automated paths exist today: a REST API, a signed custom webhook, a connected Google Sheet, and a CSV upload. They all map to the same order shape and join the same pick, pack, dispatch, and COD flow as a Shopify order. Pick the one that matches how your system already works.

How an automated order reaches us

Section titled “How an automated order reaches us”

Every automated order runs through one pipeline. Your system sends the order, we acknowledge it with a receipt, and a background worker turns it into a SamVertex order. Nothing is lost if a single order is malformed; the rest still flow.

  1. You send the order by API, webhook, Google Sheet row, or CSV row.
  2. We acknowledge with a receipt id you can check later.
  3. We normalise and write the order into your account.

The Needs review step

Section titled “The Needs review step”

Orders that arrive through the REST API, a custom webhook, Google Sheets, or a CSV import land in a Needs review state first. They do not dispatch until they are confirmed, either by you in the merchant portal or by the SamVertex team. This is a safety gate: a misconfigured feed or a test row never turns into a real delivery on its own.

Shopify orders and manual orders are not held for review. The Shopify app is trusted through its install, and manual orders are entered by a person.

Choose a path

Section titled “Choose a path”
REST API POST each order as JSON with a Bearer key. Best when your system can call an HTTP endpoint.
Custom webhook Same JSON, signed with an HMAC over the raw body. Best when your platform already fires outbound webhooks.
Google Sheets Connect a sheet and map the columns. New rows ingest on a regular poll. No code.
CSV import Upload a CSV in the portal, map the columns, and import a batch at once.
Shopify app Our official Shopify app. One-click install, real-time sync. The simplest path if you are on Shopify.
Manual orders Type an order into the portal when you only have one or two to send.

After you send

Section titled “After you send”

Once orders are flowing, the receipts, status, and errors page explains how to confirm an order was accepted, read the ingestion log in your portal, and understand the error responses.