Support

Shopify information

How to read and understand Shopify order, payment and fulfillement statuses?

https://help.shopify.com/en/manual/fulfillment/managing-orders/order-status#order-status-desc

What are the existing statuses for Shopify products?

https://shopify.dev/docs/api/admin-graphql/latest/enums/ProductStatus?utm_source=chatgpt.com

Shipping rate vs Carrier Service

A shipping rate is the final delivery charge that Shopify shows to the customer at checkout.

A shipping rate can be:

created manually in Shopify (fixed price, by zone, by weight),
or provided dynamically by a carrier service.

A Carrier Service is an external API (via a Shopify app) that calculates delivery rates in real time. A Carrier Service therefore produces Shipping Rates, but dynamic ones.

OneStock connector uses carrier services to generate a rate in the Shipping checkout.

https://help.shopify.com/en/manual/fulfillment/setup/shipping-rates/understanding-shipping-rates

How can I see the stock level of an item on Shopify?

On the product page, you can find the stock quantity for each product in the inventory column by location as well as an history of the stock by clicking on the “Adjustement history” hyperlink located on the top right of the Inventory block.

Pro tips

When are my Shopify orders created in OneStock?

OneStock Connector for Shopify

How can I orchestrate my Shopify orders in OneStock?

Shopify flow configuration

Orders are created in OneStock as soon as they are created in Shopify.
The OneStock connector relies on the Order Created trigger: https://help.shopify.com/en/manual/shopify-flow/reference/triggers/order-created. To notify OneStock that the order has been paid, and that orchestration can start, a second trigger is required: https://help.shopify.com/en/manual/shopify-flow/reference/triggers/order-paid. Using Shopify Flow is mandatory to capture this event as OneStock connector does not listen this trigger.
When the Order Paid trigger fires, Shopify Flow must call the OneStock API to patch the order status, which then triggers the orchestration process. Please find below the workflow:

Workflow order orchestration when order paid

{"site_id":"cxxx",
"order": {"from" : "pending", "to" : "paid"}}

We also advise you to patch the order with additional information to block manual line transitions in the OneStock back office via the OneStock workflow.

{"site_id":"cxxx",
"order": {"information" : { "paid" : "true"}}

Workflow OneStock configuration

Add a paid status to the order entity.
Create a transition between pending to paid in the order entity (not automatic one) without any condition.
Add to the transition between pending to placed (not automatic one) in the line_item_group entity a information_in condition to avoid manual transition in the backoffice. Please refer to the additional data from the PATCH/orders in Shopify Flow.
Delete the conditions between pending to paid in the line_item_group entity

Atlas configuration to allow relay pickup point usage in the checkout with OneStock delivery promise

Install Introduction - Atlas Pickup Points Docs in your Shopify store.
Click on the Add pickup point selection app block in checkout.

Click on the Add your first pickup point configuration and configure your carrier.
- In this section, add your Shipping rates manually by writing down Default Service name. This information is available in the section Carrier Services from the OneStock Connector.

OneStock connector put data from Atlas in the POST/orders to OneStock in the field order.information.shopify_metafields.atlas_pickup_point.

{
  "provider": "CHRONOPOST",
  "code": "608AS",
  "details": {
    "name": "LA POSTE DE ST DENIS PLEYEL",
    "description1": "170 BOULEVARD ANATOLE FRANCE, ST DENIS",
    "description2": null
  },
  "address": {
    "longitude": 2.343608,
    "latitude": 48.919984,
    "address1": "170 BOULEVARD ANATOLE FRANCE",
    "address2": null,
    "city": "ST DENIS",
    "zip": "93200",
    "province": null,
    "provinceCode": null,
    "countryCode": "FR"
  },
  "attributes": [
    {
      "key": "typeDePoint",
      "value": "P"
    }
  ],
  "rate": {
    "id": "a6b71de7-8d79-4c44-ba52-88992de0fa24"
  }
}

How can I find out which products have been sent to OneStock for delivery promise API call?

I would like to know which product was sent to OneStock in order to receive the delivery promise response. To do this, please ask the product team in charge of the OneStock connector to activate the DeliveryGroup option.

Troubleshooting

Order synchronization issue

If there is an issue when an order is created by the OneStock connector, a tag in the order is created → os_error. You can create a view in your order list to get all orders that haven’t been synchronised correcly.

Inventory not updated for a product even if stock import is finished

Our connector requires that the product MUST be tracked in the location you have defined to update stocks for an item.

My product’s features are not updated even though the product import is finished

Our connector requires that the product is in an ACTIVE state and requires that the SKU field is updated to take into account the product.

I want to install GraphiQL app on my Shopify store https://shopify-graphiql-app.shopifycloud.com/login

Go to the page https://shopify-graphiql-app.shopifycloud.com/login
Put your Shopify store URL
Add all the following scopes - read only

all_orders
assigned_fulfillment_orders
customers
discounts
draft_orders
fulfillments
gift_cards
inventory
locales
locations
marketplace_fulfillment_orders
marketplace_orders
merchant_managed_fulfillment_orders
orders
products
returns
shipping
taxes
third_party_fulfillment_orders

Glossary

Term	Description

Term	Description
Location	In Shopify, a location can be a warehouse, a store or even a third-party logistics provider. Each product’s inventory is tracked across locations so Shopify knows the quantity available - https://help.shopify.com/en/manual/fulfillment/setup/locations-management
Fulfillment Order or FO	The FulfillmentOrder resource represents either an item or a group of items in an order that are to be fulfilled from the same location - https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentorder?utm_source=chatgpt.com It is what we need to dispatch. Available state open → orchestrating in_progress → processing fulfilled → dispatched canceled → removed
Fulfillment	What we have really dispatch OneStock connector create fulfillment by API and Shopify update the Fulfillment Order
Shopify native checkout	Default checkout experience built into Shopify, fully hosted and managed by Shopify
Shopify native workflow	Standard order and fulfillment process built into Shopify
Custom OneStock DP (delivery promise) checkout	Customized checkout flow built by OneStock using the delivery promise module
Delivery	Delivery method chosen by the customer at checkout. Can be Ship to adress, Pickup in store, Ship to pickuppoint or Local delivery
Shipping rate	A shipping rate is a shipping option offered to the customer at checkout, accompanied by: a name (e.g. Standard, Express, Chronopost) a price (e.g. £5, free, calculated dynamically) an estimated delivery time (if provided) a type (standard, express, local delivery, etc.) This is what the customer sees when they choose how they want to receive their order. https://help.shopify.com/en/manual/fulfillment/setup/shipping-rates
Shipping to pickup points	A delivery method where customers choose a third-party location (such as a parcel-locker, post-office branch, retail partner or carrier drop-off) where their online order will be delivered, instead of shipping directly to their personal address. Customers select the specific pickup location during checkout, and once the package is delivered there, they receive a notification to collect it - https://help.shopify.com/en/manual/fulfillment/setup/delivery-methods/pickup-points
Pickup in store (Local Pick up)	Delivery method chosen by the customer at checkout. Corresponds to C&C in OneStock - https://help.shopify.com/en/manual/fulfillment/setup/delivery-methods/pickup-in-store
Local delivery	Local Delivery in Shopify allows merchants to deliver orders directly to nearby customers within a defined area (based on distance or postal codes), instead of using shipping carriers - https://help.shopify.com/en/manual/fulfillment/setup/delivery-methods/local-delivery
Express checkout	A fast payment option in Shopify that lets customers skip the regular checkout steps by using saved information from services like Shop Pay, Apple Pay, Google Pay, or PayPal for quicker purchases
Inventory Item	Contains information about the physical product, such as its SKU. Think of this as the backend information used for managing inventory, shipping, and fulfillments. Inventory items are associated with one or many inventory levels. An inventory item has an inventory level for each location where the item is stocked.https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships

Appendices - Support, pro-tips, troubleshoot and glossary