Miravia Open Platform
1. Order process for DBS fullfiment
Note:DBS (Delivery By Seller) is a method by which the seller is in control of its entire handling, shipping process, and settlement with 3PLs(Third party logistics providers）. Instead of using Miravia official logistics service, the seller uses its own logistics partners and delivers the order to buyers directly.
This tutorial will show you how to identify DBS type orders and use the Miravia fulfillment API to ship them.
1.1. The flow of API calls
1.2 Get OrderID and OrderItemID of new order
You can use GetOrders to retrieve a list of new orders and the order details. With Order ID of new order, you can useGetOrderItems to retrieve the product information of the order.
Response example (GetOrderItems)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | { "data": [ { ...... "order_item_id": 33247176004, ...... "order_id": 33247076004, "status": "pending", "warehouse_code": "dropshipping", "shipping_type": "Dropshipping", "created_at": "2022-08-01 14:47:30 +0800", "delivery_option_sof": 1, "updated_at": "2022-08-01 14:48:46 +0800", "currency": "EUR", "shipping_provider_type": "seller_own_fleet". ...... } ], "code": "0", "request_id": "21038f5516593373640451144"} |
Tips :
- Check the "delivery_option_sof" field in the response of GetOrderItems to confirm whether the item can be shipped using the DBS method, if the value of 1 means that the order item can be shipped in the DBS method, if the value is 0, the process cannot be used.
- Use the “CreatedAfter” parameter to filter newly created orders.
- Use the “Limit” and “Offset” parameters to set the number of orders returned.
- Save the order IDs.
1.3 Packaged orders
Use the order item ids and order ids obtained in the first step to call the Pack API to pack the order item ids into a package.
Request example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | { "result": { "data": { "pack_order_list": [ { "order_item_list": [ { "order_item_id": 33247176004, "item_err_code": "0", "tracking_number": "SOF_33247076004", "shipment_provider": "Delivered by Seller", "package_id": "FP0900221001", "retry": false }, { "order_item_id": 33247176005, "item_err_code": "0", "tracking_number": "SOF_33247076004", "shipment_provider": "Delivered by Seller", "package_id": "FP0900221001", "retry": false } ], "order_id": 33247076004 } |
Tips :
- Please fill in the shipping_allocate_type field with TFS.
- The delivery_type field can only be filled with dropship.
- DBS type orders do not require the "shipping_provider_code" field in this step, so please do not use this field.
1.4 Get shipping provider and Tracking number
You would need to call GetDBSShipmentProviders API to get the DBS shipping provider list to update the actual shipping provider of each parcel. Because you use the DBS method of shipping, the Miravia system will not automatically sense your package information.
Request example
{"sellerId":4000000176001}
Tips :
- You can call the GetSeller API to get the seller id
Response example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | { "result": { "data": { "shipment_providers": [ { "name": "Correos EXPRESS", "provider_code": "DBSSP100000016" }, { "name": "SF3", "provider_code": "DBSSP100000009" } ] }, "success": true }, "code": "0", "request_id": "211b500616593381296471086"} |
Tips :
- This response is only an example, the actual result is based on the actual response from the API. The shipment provider of response may increase or decrease over time.
DBSShipmentProviders List
- Note: This list is for reference only, please refer to the GetDBSShipmentProviders API response for the specific DBSShipmentProviders available.
Name |
Trace Website |
Tracking Number Regex |
Correos EXPRESS |
https://s.correosexpress.com/SeguimientoSinCP/search;jsessionid=UB6X2jZ4t2Aequ9T1DZ5OSkjNSItC2NOoJAq8Dz2.seguimientosincp-cex-677dc6d959-k778q |
^([0-9]{16}|[0-9]{23})$ |
SEUR |
https://www.seur.com/miseur/mis-envios/detalle?tracking= |
^([0-9a-zA-Z]{5,36})$ |
GLS(Inc.ASM) |
https://mygls.gls-spain.es/parcel-tracking |
^([0-9a-zA-Z]{5,36})$ |
MRW |
https://www.mrw.es/seguimiento_envios/MRW_seguimiento_envios.asp |
^([0-9a-zA-Z]{5,36})$ |
Correos Spain |
http://www.correos.es/ |
^([0-9a-zA-Z]{5,36})$ |
UPS |
https://www.ups.com/track?loc=es_ES&requester=ST/ |
^([0-9a-zA-Z]{18}|[0-9]{12}|[0-9a-zA-Z]{11}|[0-9]{9})$ |
TIPSA |
https://www.tip-sa.com/es/localizacion-envios |
^([0-9a-zA-Z]{5,36})$ |
ENVIALIA |
https://www.envialia.com/seguimiento/ |
^([0-9a-zA-Z\/]{1,36})$ |
NACEX |
https://www.nacex.es/recargarPagina.do?pagina=0 |
^([0-9a-zA-Z\/]{1,36})$ |
ZELERIS |
https://www.zeleris.com/busqueda-envio.aspx |
^([0-9a-zA-Z]{18})$ |
ICP |
https://www.onlinecargotracking.com/icp-logistica-tracking/ |
^([a-zA-Z]{2}[0-9]{8})$ |
CTT EXPRESS |
https://www.cttexpress.com/home/index |
^[0-9]{22}|[0-9a-zA-Z]{13}$ |
T.W.S. Express Courier |
https://www.mytws.it/ |
^([0-9a-zA-Z]{5,36})$ |
La Poste |
http://www.laposte.fr/ |
^([0-9a-zA-Z]{5,36})$ |
Chronopost France |
http://www.chronopost.fr/ |
^([0-9a-zA-Z]{5,36})$ |
Asendia |
http://www.asendia.com/ |
^([0-9a-zA-Z]{5,36})$ |
DPD (FR) |
http://www.dpd.fr/ |
^([0-9a-zA-Z]{5,36})$ |
Bpost |
https://track.bpost.cloud/ |
^([0-9a-zA-Z]{5,36})$ |
PostNL |
https://www.postnl.nl/ |
^([0-9a-zA-Z]{5,36})$ |
Poste Italiane |
http://www.poste.it/ |
^([0-9a-zA-Z]{5,36})$ |
Hermes |
https://www.hermesworld.com/ |
^([0-9a-zA-Z]{5,36})$ |
4PX |
https://www.4px.com/ |
^([0-9a-zA-Z]{5,36})$ |
DHL Express |
http://www.dhl.com/ |
^([0-9a-zA-Z]{5,36})$ |
TNT |
http://www.tnt.com/ |
^([0-9a-zA-Z]{5,36})$ |
SF Express |
https://www.sf-express.com/ |
^([0-9a-zA-Z]{9,15})$ |
SF Express |
http://intl.sf-express.com/ |
^([0-9a-zA-Z]{1,36})$ |
Flyt Express |
http://www.flytexpress.com/ |
^([0-9a-zA-Z]{1,36})$ |
Singapore Post |
http://www.singpost.com/ |
^([0-9a-zA-Z]{1,36})$ |
TOPYOU |
https://www.szty56.com/ |
^([0-9a-zA-Z]{1,36})$ |
SunYou |
http://www.sypost.com/ |
^([0-9a-zA-Z]{1,36})$ |
China Post Air Parcel |
http://yjcx.ems.com.cn/ |
^([0-9a-zA-Z]{1,36})$ |
YANWEN |
http://www.yw56.com.cn/ |
^([0-9a-zA-Z]{1,36})$ |
Sending |
https://www.sending.es/localiza-tu-envio/ |
^([0-9a-zA-Z]{5,36})$ |
Amazon Logistics |
https://track.amazon.in/ |
^([0-9a-zA-Z]{5,36})$ |
ZTT |
http://zhiteng.biz/ |
^([0-9a-zA-Z]{1,36})$ |
Closer Logistics |
https://tracking.closerlogistics.com/ |
^([0-9a-zA-Z]{5,36})$ |
Others |
https://www.miravia.es/ |
^([0-9a-zA-Z]{5,36})$ |
Paack |
https://mydeliveries.paack.app/tracking |
^([0-9a-zA-Z\-]{1,36})$ |
On Time |
https://ontime.es/ |
^([0-9a-zA-Z]{5,36})$ |
Celeritas |
https://celeritastransporte.com/en/ |
^([0-9a-zA-Z]{5,36})$ |
DHL Parcel |
https://www.dhl.com/es-en/home/our-divisions/parcel/home/private-shipments/tracking-shipments.html |
^([0-9a-zA-Z]{5,36})$ |
BRT Bartolini |
http://www.brt.it/ |
^([0-9a-zA-Z]{5,36})$ |
Cubyn |
https://track.cubyn.com/ |
^([0-9a-zA-Z]{5,36})$ |
Redur |
https://redur.es/track-trace/ |
^([0-9a-zA-Z]{5,36})$ |
DPD(PL) |
https://www.dpd.com.pl/ |
^([0-9a-zA-Z]{5,36})$ |
Fedex |
https://www.fedex.com/es-es/tracking.html |
^([0-9a-zA-Z]{5,36})$ |
DPD (NL) |
https://www.dpd.com/nl/nl/ |
^([0-9a-zA-Z]{5,36})$ |
Transaher |
https://transaher.es/en/ |
^([0-9a-zA-Z]{5,36})$ |
Transaher |
https://transaher.es/en/ |
^([0-9a-zA-Z\/_]{1,36})$ |
DPD(BE,NL) |
https://www.dpd.com/be/nl/ |
^([0-9a-zA-Z]{5,36})$ |
Cainiao |
https://www.cainiao.com/ |
^([0-9a-zA-Z]{5,36})$ |
DPD_DE |
http://www.dpd.com/ |
^([0-9a-zA-Z]{5,36})$ |
DPD_FR |
http://www.dpd.fr/ |
^([0-9a-zA-Z]{5,36})$ |
1.5 Update shipping provider and Tracking number
Call the UpdateTrackingInfo API to upload your actual tracking number and shipping provider.
Request example
1 2 3 4 5 6 7 8 9 | { "update_packages": [ { "tracking_number": "9356463170722110", "package_id": "FP0900221001", "shipment_provider_code": "DBSSP100000016" } ]} |
Tips :
- The package id can be obtained by checking the response of the second step or by calling GetOrderItems API
Response example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | { "result": { "data": { "packages": [ { "item_err_code": "0", "package_id": "FP0900221001", "retry": false } ] }, "success": true }, "code": "0", "request_id": "211b500616593388491761088"} |
1.6 Set the order to RTS(Ready to ship) status
Call ReadyToShip API to update the order to RTS status.
Request example
{"packages":[{"package_id":"FP0900221001"}]}
Tips :
- The package id can be obtained by checking the response of the second step or by calling GetOrderItems.
- Once the order status is updated to RTS, the order will not be cancelled.
- This API can be called only after the third step is completed.
Response example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | { "result": { "data": { "packages": [ { "item_err_code": "0", "package_id": "FP0900221001", "retry": false } ] }, "success": true }, "code": "0", "request_id": "211b500616593408382921092"} |
1.7 Set the order to delivery or failed delivery status.
After your shipping provider have delivered the DBS parcels and buyers have accepted them , then you need to trigger parcels as delivered status through ConfirmDeliveryForDBS API .
If your shipping provider fail delivery the DBS parcels , then you need to trigger the parcels as failed delivered stauts through FailedDeliveryForDBS API.
Request example
{"packages":[{"package_id":"FP0900221001"}]}
Response example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | { "result": { "data": { "packages": [ { "item_err_code": "0", "package_id": "FP0900221001", "retry": false } ] }, "success": true }, "code": "0", "request_id": "211b500616593408382921092"} |
Tips :
- After calling the ConfirmDeliveryForDBS API, the order will be updated to shipped status and will be automatically updated to delivered status after 7 days.
- This operation is not reversible, so please be careful calling these two APIs.
- When using ConfirmDeliveryForDBS or FailedDeliveryForDBS calls, if the following error is returned "Package logistics information is tracked by ARISE and cannot be updated manually!" ,the reason is that: If our platform can identify the tracking number and can track it,in order to make the logistics status more accurate, then the platform will not allow you to delivered and the platform will update the order status based on the tracking number. Which can be understood as follows:
DBS parcels,
-if the platform can not track logistics information, it can be delivered or failed deliveried by seller themselves.
-if the platform can track logistics information, it can not be delivered or failed deliveried by seller themselves.
