Files
medusa-store/docs-util/oas-output/operations/admin/post_admin_fulfillments.ts
github-actions[bot] bfda7a626d chore(docs): Generated OAS (#7189)
This PR holds all generated OAS for the upcoming release.

Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>
2024-05-01 10:07:31 +00:00

227 lines
7.3 KiB
TypeScript

/**
* @oas [post] /admin/fulfillments
* operationId: PostFulfillments
* summary: Create Fulfillment
* description: Create a fulfillment.
* x-authenticated: true
* parameters: []
* security:
* - api_token: []
* - cookie_auth: []
* - jwt_token: []
* requestBody:
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - location_id
* - provider_id
* - delivery_address
* - items
* - labels
* - order
* - metadata
* properties:
* location_id:
* type: string
* title: location_id
* description: The fulfillment's location id.
* provider_id:
* type: string
* title: provider_id
* description: The fulfillment's provider id.
* delivery_address:
* type: object
* description: The fulfillment's delivery address.
* required:
* - first_name
* - last_name
* - phone
* - company
* - address_1
* - address_2
* - city
* - country_code
* - province
* - postal_code
* - metadata
* properties:
* first_name:
* type: string
* title: first_name
* description: The delivery address's first name.
* last_name:
* type: string
* title: last_name
* description: The delivery address's last name.
* phone:
* type: string
* title: phone
* description: The delivery address's phone.
* company:
* type: string
* title: company
* description: The delivery address's company.
* address_1:
* type: string
* title: address_1
* description: The delivery address's address 1.
* address_2:
* type: string
* title: address_2
* description: The delivery address's address 2.
* city:
* type: string
* title: city
* description: The delivery address's city.
* country_code:
* type: string
* title: country_code
* description: The delivery address's country code.
* province:
* type: string
* title: province
* description: The delivery address's province.
* postal_code:
* type: string
* title: postal_code
* description: The delivery address's postal code.
* metadata:
* type: object
* description: The delivery address's metadata.
* properties: {}
* items:
* type: array
* description: The fulfillment's items.
* items:
* type: object
* description: The item's items.
* required:
* - title
* - sku
* - quantity
* - barcode
* - line_item_id
* - inventory_item_id
* properties:
* title:
* type: string
* title: title
* description: The item's title.
* sku:
* type: string
* title: sku
* description: The item's sku.
* quantity:
* type: number
* title: quantity
* description: The item's quantity.
* barcode:
* type: string
* title: barcode
* description: The item's barcode.
* line_item_id:
* type: string
* title: line_item_id
* description: The item's line item id.
* inventory_item_id:
* type: string
* title: inventory_item_id
* description: The item's inventory item id.
* labels:
* type: array
* description: The fulfillment's labels.
* items:
* type: object
* description: The label's labels.
* required:
* - tracking_number
* - tracking_url
* - label_url
* properties:
* tracking_number:
* type: string
* title: tracking_number
* description: The label's tracking number.
* tracking_url:
* type: string
* title: tracking_url
* description: The label's tracking url.
* label_url:
* type: string
* title: label_url
* description: The label's label url.
* order:
* type: object
* description: The fulfillment's order.
* properties: {}
* metadata:
* type: object
* description: The fulfillment's metadata.
* properties: {}
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl -X POST '{backend_url}/admin/fulfillments' \
* -H 'x-medusa-access-token: {api_token}' \
* -H 'Content-Type: application/json' \
* --data-raw '{
* "location_id": "{value}",
* "provider_id": "{value}",
* "delivery_address": {
* "first_name": "{value}",
* "last_name": "{value}",
* "phone": "{value}",
* "company": "{value}",
* "address_1": "{value}",
* "address_2": "{value}",
* "city": "{value}",
* "country_code": "{value}",
* "province": "{value}",
* "postal_code": "{value}",
* "metadata": {}
* },
* "items": [
* {
* "title": "{value}",
* "sku": "{value}",
* "quantity": 6350536800468992,
* "barcode": "{value}",
* "line_item_id": "{value}",
* "inventory_item_id": "{value}"
* }
* ],
* "labels": [
* {
* "tracking_number": "{value}",
* "tracking_url": "{value}",
* "label_url": "{value}"
* }
* ],
* "order": {},
* "metadata": {}
* }'
* tags:
* - Fulfillments
* responses:
* "200":
* description: OK
* "400":
* $ref: "#/components/responses/400_error"
* "401":
* $ref: "#/components/responses/unauthorized"
* "404":
* $ref: "#/components/responses/not_found_error"
* "409":
* $ref: "#/components/responses/invalid_state_error"
* "422":
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
*
*/