Introduction
The dropshipping process is built into the same infrastructure as B2B order processing.
Features and differences:
- Dropshipping orders created by you appear in the list of regular B2B orders. They have a hidden attribute identifying them as dropshipping orders and a
referenceattribute that is used to search, request, and manage dropshipping orders.
Important. There is no visual difference between B2B orders created manually and orders created through the Market API, including dropshipping orders in the list at the moment - To manage dropshipping orders, there is a list of Market API methods. These methods do not apply to regular B2B orders that are created manually or by using the related Market API methods.
- We do not change our item prices in the scope of the dropshipping process. Prices you can get via Market API are the same as in the Reseller Store.
- Dropshipping orders are subject to additional service fees, such as order processing and delivery fees.
Payment model
We offer the ‘Credit terms’ payment model. You can create dropshipping orders until the total sum of unpaid orders is below the limit. It is not possible to place more dropshipping orders if the total sum exceeds the limit.
The limit value is set based on your individual agreement. Ask your account manager about the credit terms limit.
Overall process and interaction description
Step 1
You can receive all products available in the Foxway stock list using existing Market API methods, and share that information with your customers in your webstore.
Step 2
The customer collects products and proceeds to checkout.
Step 3
At that step, you can request a confirmation that the products are still available and your orders in total are still below your credit limit.
We do not pay attention to the order processing details on your side. However, the one thing important to us is that when you are planning to create a dropshipping order, you already have a confirmed end-customer’s intention of purchasing that order.
Step 4
Your request to create a dropshipping order goes to Foxway.
Important. The process allows you to create a dropshipping order without a confirmed payment to reserve the items. You have time to confirm the payment within 1 hour.
After the dropshipping order is created, it has the status ‘Open’.
Important. For one dropshipping order that contains products of different VAT types, the system will create two separate orders referring to the same reference.
Next, confirm the payment status of the dropshipping order.
Payment statuses:
- Pending (Id = 1)
The customer’s payment is in process - Paid (Id = 2)
The customer has paid the order.
Step 5
The order is created and the payment is confirmed. The dropshipping order status is set to ‘Pending’.
You can upload any document to the order that you wish to print and include in the order’s package for the customer.
Step 6
Foxway begins processing the dropshipping order.
The dropshipping order status is set to ‘In Process’. Processing includes the stages of assembly, packaging, and shipping. The internal processing stages do not affect the order’s status.
You can access the order details and a pro forma invoice to complete your order payment.
When the order is shipped to the customer, the order status is set to ‘Shipped’. You will also see the tracking number with the order details received by API.
Step X
You can cancel the order at any time, regardless of the order status. See ‘Order Cancelation’ below for more details.
Order Statuses
Open
Order is created on Foxway side. The payment status is ‘Pending’.
Pending
Order exists. Payment status of dropshipping order is ‘Paid’. Order processing has not started yet.
In Process
Order processing has started.
Shipped
Order was processed and shipped.
Canceled
Dropshipping order is canceled.
Order cancelation
You have the opportunity to cancel your dropshipping order at any time. Depending on the stage of the process when the cancelation occurs, the result will be different:
- Open: The order is removed from the system without consequences.
- Pending: The order is removed from the system without consequences.
- In Process: The order goes into the ‘Canceled’ status. The required quantity for each item is set to 0 (zero). Payment for dropshipping services will be required.
- Shipped: A manual cancelation process. After clicking cancel, your account manager will be in touch with you.
Market & dropshipping API
Authorization
Authorization is provided by using X-ApiKey.
You can use one key to work with all Market API methods.
To gain access to the Market API and use dropshipping methods, contact your manager. Please note that any previously created access to the Market API must be extended to use dropshipping methods.
Endpoints
Endpoints:
- Test:
https://market--uat.qa.rc.foxway.dev/ - Production:
https://foxway.shop/
Dropshipping methods
The technical description is available in Swagger.
Create dropshipping order
HTTP POST /api/v1/dropshipping
Allows you to create a new dropshipping order. Requires order and customer details.
Upload a document to the order
HTTP POST /api/v1/dropshipping/{reference}/document
Allows you to upload a file to the existing dropshipping order. Use this method if you need to add printable documents for the end customer.
Get documents
HTTP GET /api/v1/dropshipping/{reference}/documents
Allows receiving the customer’s related documents for the dropshipping order.
Get invoices
HTTP GET /api/v1/dropshipping/{reference}/invoices
The method allows receiving the payment documents (pro forma invoices) for the dropshipping order.
Please note that the response may contain several pro formas if the dropshipping order includes products that belong to different VAT types.
Get order
HTTP GET /api/v1/dropshipping/{reference}
Allows you to receive existing dropshipping order details. It includes orderlines, customer details, order status, tracking number.
Update payment status
HTTP PUT /api/v1/dropshipping/{reference}/payment
Allows you to update the payment status of an existing dropshipping order.
Cancel order
HTTP POST /api/v1/dropshipping/{reference}/cancel
Allows to create a request to cancel the dropshipping order. There are several cancelation scenarios, depending on the current state of the order. See ‘Order Cancelation’ for details.
Get available carriers
HTTP GET /api/v1/dropshipping/carriers
Allows to get a list of delivery services that are supported by Foxway. You can offer the customer a choice of supported services and transfer the service chosen by the customer when creating the dropshipping order by the method ‘Create dropshipping order’.
Best practices
Available quantity of SKU
We recommend confirming product availability immediately before submitting your order. To do this, you will be able to use a separate method (in development) that allows you to get the price and quantity for a specific SKU.
