When you group an order's line items into one or more packages, each package requires a corresponding plan for handling, addressing, and shipping; this is a shipping fulfillment. For each package, execute this call once to generate a shipping fulfillment associated with that package.
Note: A single line item in an order can consist of multiple units of a purchased item, and one unit can consist of multiple parts or components. Although these components might be provided by the manufacturer in separate packaging, the seller must include all components of a given line item in the same package.
Before using this call for a given package, you must determine which line items are in the package. If the package has been shipped, you should provide the date of shipment in the request. If not provided, it will default to the current date and time.
The globally unique eBay-generated identifier of the line item.
Note: A single line item can consist of multiple units of a purchased item, and one unit can consist of multiple parts or components. Although these components might be provided by the manufacturer in separate packaging, the seller cannot distribute them among multiple shipping packages. Thus, each line item ID will appear in exactly one fulfillment.
The tracking number provided by the shipping carrier for this fulfillment.
This field and the shippingCarrierCode field are mutually dependent. If you include one, you must also include the other.
Note: If you include trackingNumber (and shippingCarrierCode) in the request, the resulting fulfillment's ID (returned in the HTTP location code) is the tracking number. If you do not include the tracking number, the resulting fulfillment ID will default to an arbitrary number such as 999.
The ENV string is the HTTP path to the same eBay supported environment in which this call was issued. The ORDERID parameter is the unique identifier of the order addressed by this call; for example, 170009092860-9849164007!140000000544476. The FULFILLMENTID parameter identifies the newly created fulfillment; for example, 9405509699937003457459. Use this Get Fulfillment URI to retrieve the contents of the new fulfillment.
Internal Server Error.
Note: In some cases, this call may succeed if you issue it once more after receiving this error.
Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.
Sample: Create a Shipping Fulfillment
Generate a new shipping fulfillment for a set of line items in a specified order.
This sample creates a new shipping fulfillment with an eBay-generated fulfillment ID, containing the specified line items.
Use the orderid parameter to specify the order for which you are creating a shipping fulfillment. Identify the lineItems included in the package, as well as the shipping information if the package has been shipped.
URL format.See also the non-wrapped version of this URL.
A successful call returns an HTTP status code of 201 (Created). It also returns a location code for the newly created shipping fulfillment resource, including its fulfillment ID: