chore(docs): Updated API Reference (automated) (#11030)
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com> Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
This commit is contained in:
co-authored by
Oli Juhl
Shahed Nasser
parent
bff8c0bc93
commit
24441e48df
@@ -61,7 +61,7 @@
|
||||
* $ref: "#/components/responses/invalid_request_error"
|
||||
* "500":
|
||||
* $ref: "#/components/responses/500_error"
|
||||
* x-workflow: deleteReturnReasonsWorkflow
|
||||
* x-workflow: deleteRefundReasonsWorkflow
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
+2
-60
@@ -20,52 +20,7 @@
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* description: The inventory levels to create or delete.
|
||||
* properties:
|
||||
* create:
|
||||
* type: array
|
||||
* description: The inventory levels to create.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The inventory level's details.
|
||||
* required:
|
||||
* - location_id
|
||||
* properties:
|
||||
* location_id:
|
||||
* type: string
|
||||
* title: location_id
|
||||
* description: The ID of the associated location.
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The inventory level's stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The inventory level's incoming quantity.
|
||||
* update:
|
||||
* type: array
|
||||
* description: The inventory levels to update.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The inventory level's details.
|
||||
* properties:
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The inventory level's stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The inventory level's incoming quantity.
|
||||
* delete:
|
||||
* type: array
|
||||
* description: The inventory levels to delete.
|
||||
* items:
|
||||
* type: string
|
||||
* title: delete
|
||||
* description: The ID of the inventory level to delete.
|
||||
* $ref: "#/components/schemas/AdminBatchInventoryItemLocationsLevel"
|
||||
* x-codeSamples:
|
||||
* - lang: Shell
|
||||
* label: cURL
|
||||
@@ -75,19 +30,6 @@
|
||||
* tags:
|
||||
* - Inventory Items
|
||||
* responses:
|
||||
* "200":
|
||||
* description: OK
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* description: The inventory item's details.
|
||||
* required:
|
||||
* - inventory_item
|
||||
* properties:
|
||||
* inventory_item:
|
||||
* type: object
|
||||
* description: The inventory item's details.
|
||||
* "400":
|
||||
* $ref: "#/components/responses/400_error"
|
||||
* "401":
|
||||
@@ -100,7 +42,7 @@
|
||||
* $ref: "#/components/responses/invalid_request_error"
|
||||
* "500":
|
||||
* $ref: "#/components/responses/500_error"
|
||||
* x-workflow: bulkCreateDeleteLevelsWorkflow
|
||||
* x-workflow: batchInventoryItemLevelsWorkflow
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
+130
@@ -0,0 +1,130 @@
|
||||
/**
|
||||
* @oas [post] /admin/inventory-items/location-levels/batch
|
||||
* operationId: PostInventoryItemsLocationLevelsBatch
|
||||
* summary: Manage Inventory Levels
|
||||
* description: Manage inventory levels to create, update, or delete them.
|
||||
* x-authenticated: true
|
||||
* parameters: []
|
||||
* security:
|
||||
* - api_token: []
|
||||
* - cookie_auth: []
|
||||
* - jwt_token: []
|
||||
* requestBody:
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* description: The inventory levels to manage.
|
||||
* properties:
|
||||
* create:
|
||||
* type: array
|
||||
* description: The inventory levels to create.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The details of an inventory level to create.
|
||||
* required:
|
||||
* - location_id
|
||||
* - inventory_item_id
|
||||
* properties:
|
||||
* location_id:
|
||||
* type: string
|
||||
* title: location_id
|
||||
* description: The ID of the associated stock location.
|
||||
* inventory_item_id:
|
||||
* type: string
|
||||
* title: inventory_item_id
|
||||
* description: The ID of the associated inventory item.
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The incoming quantity to be added to stock.
|
||||
* update:
|
||||
* type: array
|
||||
* description: The inventory levels to update.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The details of an inventory level to update.
|
||||
* required:
|
||||
* - location_id
|
||||
* - inventory_item_id
|
||||
* properties:
|
||||
* location_id:
|
||||
* type: string
|
||||
* title: location_id
|
||||
* description: The ID of the associated stock location.
|
||||
* inventory_item_id:
|
||||
* type: string
|
||||
* title: inventory_item_id
|
||||
* description: The ID of the associated inventory item.
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The incoming quantity to be added to stock.
|
||||
* delete:
|
||||
* type: array
|
||||
* description: The IDs of the inventory levels to delete.
|
||||
* items:
|
||||
* type: string
|
||||
* title: delete
|
||||
* description: The ID of the inventory level to delete.
|
||||
* force:
|
||||
* type: boolean
|
||||
* title: force
|
||||
* description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity.
|
||||
* x-codeSamples:
|
||||
* - lang: Shell
|
||||
* label: cURL
|
||||
* source: |-
|
||||
* curl -X POST '{backend_url}/admin/inventory-items/location-levels/batch' \
|
||||
* -H 'Authorization: Bearer {access_token}' \
|
||||
* -H 'Content-Type: application/json' \
|
||||
* --data-raw '{
|
||||
* "create": [
|
||||
* {
|
||||
* "location_id": "sloc_123",
|
||||
* "inventory_item_id": "iitem_123",
|
||||
* "stocked_quantity": 100,
|
||||
* "incoming_quantity": 50
|
||||
* }
|
||||
* ],
|
||||
* "update": [
|
||||
* {
|
||||
* "location_id": "sloc_456",
|
||||
* "inventory_item_id": "iitem_456",
|
||||
* "stocked_quantity": 200,
|
||||
* "incoming_quantity": 75
|
||||
* }
|
||||
* ],
|
||||
* "delete": [
|
||||
* "iilev_123"
|
||||
* ]
|
||||
* }'
|
||||
* tags:
|
||||
* - Inventory Items
|
||||
* 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"
|
||||
* x-workflow: batchInventoryItemLevelsWorkflow
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,66 @@
|
||||
/**
|
||||
* @schema AdminBatchInventoryItemLocationsLevel
|
||||
* type: object
|
||||
* description: The inventory levels to create, update, or delete.
|
||||
* properties:
|
||||
* create:
|
||||
* type: array
|
||||
* description: The inventory levels to create.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The inventory level's details.
|
||||
* required:
|
||||
* - location_id
|
||||
* properties:
|
||||
* location_id:
|
||||
* type: string
|
||||
* title: location_id
|
||||
* description: The ID of the associated location.
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The inventory level's stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The inventory level's incoming quantity.
|
||||
* update:
|
||||
* type: array
|
||||
* description: The inventory levels to update.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The inventory level's details.
|
||||
* properties:
|
||||
* stocked_quantity:
|
||||
* type: number
|
||||
* title: stocked_quantity
|
||||
* description: The inventory level's stocked quantity.
|
||||
* incoming_quantity:
|
||||
* type: number
|
||||
* title: incoming_quantity
|
||||
* description: The inventory level's incoming quantity.
|
||||
* location_id:
|
||||
* type: string
|
||||
* title: location_id
|
||||
* description: The associated stock location's ID.
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The ID of the location level.
|
||||
* required:
|
||||
* - location_id
|
||||
* delete:
|
||||
* type: array
|
||||
* description: The inventory levels to delete.
|
||||
* items:
|
||||
* type: string
|
||||
* title: delete
|
||||
* description: The ID of the inventory level to delete.
|
||||
* force:
|
||||
* type: boolean
|
||||
* title: force
|
||||
* description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity.
|
||||
* x-schemaName: AdminBatchInventoryItemLocationsLevel
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* @schema AdminInventoryItem
|
||||
* type: object
|
||||
* description: The reservation's inventory item.
|
||||
* description: The inventory item's details.
|
||||
* x-schemaName: AdminInventoryItem
|
||||
* required:
|
||||
* - id
|
||||
@@ -22,15 +22,15 @@
|
||||
* hs_code:
|
||||
* type: string
|
||||
* title: hs_code
|
||||
* description: The inventory item's hs code.
|
||||
* description: The inventory item's HS code.
|
||||
* requires_shipping:
|
||||
* type: boolean
|
||||
* title: requires_shipping
|
||||
* description: The inventory item's requires shipping.
|
||||
* description: Whether the inventory item requires shipping.
|
||||
* mid_code:
|
||||
* type: string
|
||||
* title: mid_code
|
||||
* description: The inventory item's mid code.
|
||||
* description: The inventory item's MID code.
|
||||
* material:
|
||||
* type: string
|
||||
* title: material
|
||||
@@ -62,10 +62,10 @@
|
||||
* thumbnail:
|
||||
* type: string
|
||||
* title: thumbnail
|
||||
* description: The inventory item's thumbnail.
|
||||
* description: The thumbnail URL of the inventory item.
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The inventory item's metadata.
|
||||
* description: Custom key-value pairs, used to store additional information about the inventory item.
|
||||
* location_levels:
|
||||
* type: array
|
||||
* description: The inventory item's location levels.
|
||||
|
||||
@@ -29,22 +29,6 @@
|
||||
* type: string
|
||||
* title: provider_id
|
||||
* description: The ID of the payment provider used to process this payment.
|
||||
* cart_id:
|
||||
* type: string
|
||||
* title: cart_id
|
||||
* description: The ID of the associated cart.
|
||||
* order_id:
|
||||
* type: string
|
||||
* title: order_id
|
||||
* description: The ID of the associated order.
|
||||
* order_edit_id:
|
||||
* type: string
|
||||
* title: order_edit_id
|
||||
* description: The ID of the associated order edit.
|
||||
* customer_id:
|
||||
* type: string
|
||||
* title: customer_id
|
||||
* description: ID of the associated customer.
|
||||
* data:
|
||||
* type: object
|
||||
* description: The payment's data, useful for processing by the payment provider.
|
||||
|
||||
@@ -7,7 +7,6 @@
|
||||
* - payment_providers
|
||||
* - id
|
||||
* - currency_code
|
||||
* - region_id
|
||||
* - amount
|
||||
* - status
|
||||
* properties:
|
||||
@@ -19,10 +18,6 @@
|
||||
* type: string
|
||||
* title: currency_code
|
||||
* description: The payment collection's currency code.
|
||||
* region_id:
|
||||
* type: string
|
||||
* title: region_id
|
||||
* description: The ID of the region this payment collection is associated with.
|
||||
* amount:
|
||||
* type: number
|
||||
* title: amount
|
||||
|
||||
@@ -134,6 +134,11 @@
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The variant's metadata, can hold custom key-value pairs.
|
||||
* inventory_items:
|
||||
* type: array
|
||||
* description: The variant's inventory items.
|
||||
* items:
|
||||
* $ref: "#/components/schemas/AdminProductVariantInventoryItemLink"
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
/**
|
||||
* @schema AdminProductVariantInventoryItemLink
|
||||
* type: object
|
||||
* description: An association between a product variant and an inventory item.
|
||||
* x-schemaName: AdminProductVariantInventoryItemLink
|
||||
* required:
|
||||
* - id
|
||||
* - variant_id
|
||||
* - inventory_item_id
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The ID of the association.
|
||||
* variant_id:
|
||||
* type: string
|
||||
* title: variant_id
|
||||
* description: The associated product variant's ID.
|
||||
* variant:
|
||||
* $ref: "#/components/schemas/AdminProductVariant"
|
||||
* inventory_item_id:
|
||||
* type: string
|
||||
* title: inventory_item_id
|
||||
* description: The associated inventory item's ID.
|
||||
* inventory:
|
||||
* $ref: "#/components/schemas/AdminInventoryItem"
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -56,6 +56,13 @@
|
||||
* format: date-time
|
||||
* title: deleted_at
|
||||
* description: The date the promotion was deleted.
|
||||
* status:
|
||||
* type: string
|
||||
* description: The promotion's status.
|
||||
* enum:
|
||||
* - draft
|
||||
* - active
|
||||
* - inactive
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
@@ -29,22 +29,6 @@
|
||||
* type: string
|
||||
* title: provider_id
|
||||
* description: The ID of the payment provider used to process this payment.
|
||||
* cart_id:
|
||||
* type: string
|
||||
* title: cart_id
|
||||
* description: The ID of the associated cart.
|
||||
* order_id:
|
||||
* type: string
|
||||
* title: order_id
|
||||
* description: The ID of the associated order.
|
||||
* order_edit_id:
|
||||
* type: string
|
||||
* title: order_edit_id
|
||||
* description: The ID of the associated order edit.
|
||||
* customer_id:
|
||||
* type: string
|
||||
* title: customer_id
|
||||
* description: ID of the associated customer.
|
||||
* data:
|
||||
* type: object
|
||||
* description: The payment's data, useful for processing by the payment provider.
|
||||
|
||||
@@ -6,7 +6,6 @@
|
||||
* required:
|
||||
* - id
|
||||
* - currency_code
|
||||
* - region_id
|
||||
* - amount
|
||||
* - status
|
||||
* - payment_providers
|
||||
@@ -19,10 +18,6 @@
|
||||
* type: string
|
||||
* title: currency_code
|
||||
* description: The payment collection's currency code.
|
||||
* region_id:
|
||||
* type: string
|
||||
* title: region_id
|
||||
* description: The ID of the region this payment collection is associated with.
|
||||
* amount:
|
||||
* type: number
|
||||
* title: amount
|
||||
|
||||
@@ -7,7 +7,6 @@
|
||||
* - payment_providers
|
||||
* - id
|
||||
* - currency_code
|
||||
* - region_id
|
||||
* - amount
|
||||
* - status
|
||||
* properties:
|
||||
@@ -19,10 +18,6 @@
|
||||
* type: string
|
||||
* title: currency_code
|
||||
* description: The payment collection's currency code.
|
||||
* region_id:
|
||||
* type: string
|
||||
* title: region_id
|
||||
* description: The ID of the region this payment collection is associated with.
|
||||
* amount:
|
||||
* type: number
|
||||
* title: amount
|
||||
|
||||
Reference in New Issue
Block a user