Every order that you fulfill needs to be updated with shipping information. On every Order you can find an array that holds information about the ordered items. Each item has its own entry in this array, which we call order_items. Every order_item has its own STATE that you can update. You have to upload identifiers (e.g. IMEI or serial numbers), invoices, and tracking information. We offer two ways to handle shipments, either through your own shipping agreement or by using refurbed’s shipping agreement. If you work with your own shipping agreement(s), parcel tracking links must be set on every order_item individually which also allows the use of different carriers to fulfill an order. If you joined our shipping agreement, you can generate the shipping label for each order. Countries outside of the EU might require extra information for customs clearance.
All services and operations concerning shipping must be called with OrderItemService, OrderService, MerchantService, and ShippingProfileService in the URL followed by the command/operation.
E.g.:
https://api.refurbed.com/refb.merchant.v1.OrderItemService/UpdateOrderItem
or
https://api.refurbed.com/refb.merchant.v1.OrderService/CreateShippingLabel
or
https://api.refurbed.com/refb.merchant.v1.MerchantService/ListMerchantAddresses
or
https://api.refurbed.com/refb.merchant.v1.ShippingProfileService/CreateShippingProfile
All calls must be done using POST method.
BatchUpdateOrderItems / BatchUpdateOrderItemsState / UpdateOrderItem / UpdateOrderItemsState)We offer two endpoints (and their batch versions) that basically do the same with only one difference:
BatchUpdateOrderItems and UpdateOrderItem can be used to update identifiers and/or parcel tracking links.
BatchUpdateOrderItems**State** and UpdateOrderItems**State** can be used as above but additionally also set the order item state in one update call.
Order states are a concept to organize your orders and keep track of them until they are shipped. Order states can’t be changed directly. You can only change the state of order_items (same state values as the order object). The order state is automatically calculated from the order_item states.
Order states are not shown to the customers and are only for your internal use. Order states are a good way to filter for new orders if you use order polling. refurbed does not change order states automatically, triggered by any event or action e.g. you refund an order → state does not go to REJECTED. Also setting a state will not trigger any action or event e.g. setting the state to REJECTED → does not trigger a refund. refurbed only enforces state transitions as described below.
All orders are by default in state NEW. If you start fresh on refurbed we advise to start early using this feature. If you’re an existing seller, all your older orders are also in state NEW. It’s good to set all old orders to e.g. ACCEPTED or SHIPPED (if you can also provide a parcel tracking link), to be able to filter for all real new incoming orders.
Can be changed. Change the order item state via BatchUpdateOrderItemsState / UpdateOrderItemState e.g. to ACCEPTED once you retrieved an order and checked your stock. Refer to the order_item_id. State value names are fix and cannot be changed.