{ "opencollection": "1.0.0", "info": { "name": "Admin Account / Address Shipments API", "version": "v3" }, "items": [ { "info": { "name": "Shipments", "type": "folder" }, "items": [ { "info": { "name": "Return a list of Shipments", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v2/platform/shipments", "params": [ { "name": "page", "value": "1", "type": "query" }, { "name": "per_page", "value": "50", "type": "query" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" }, { "name": "filter[state_eq]", "value": "complete", "type": "query" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Returns a list of Shipments" }, { "info": { "name": "Create a Shipment", "type": "http" }, "http": { "method": "POST", "url": "http://{defaultHost}/api/v2/platform/shipments", "params": [ { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Creates a Shipment" }, { "info": { "name": "Return a Shipment", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v2/platform/shipments/:id", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Returns a Shipment" }, { "info": { "name": "Update a Shipment", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Updates a Shipment" }, { "info": { "name": "Delete a Shipment", "type": "http" }, "http": { "method": "DELETE", "url": "http://{defaultHost}/api/v2/platform/shipments/:id", "params": [ { "name": "id", "value": "", "type": "path" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Deletes a Shipment" }, { "info": { "name": "Adds item (Variant) to an existing Shipment", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/add_item", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "If selected Variant was already added to Order it will increase the quantity of existing Line Item, if not it will create a new Line Item" }, { "info": { "name": "Removes item (Variant) from Shipment", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/remove_item", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "If selected Variant is removed completely and Shipment doesn't include any other Line Items, Shipment itself will be deleted" }, { "info": { "name": "Mark Shipment as ready to be shipped", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/ready", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Marks Shipment as ready to be shipped" }, { "info": { "name": "Mark Shipment as shipped", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/ship", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Marks Shipment as shipped" }, { "info": { "name": "Cancels the Shipment", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/cancel", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Cancels the Shipment" }, { "info": { "name": "Resumes the Shipment", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/resume", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Resumes previously canceled Shipment" }, { "info": { "name": "Moves Shipment back to pending state", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v2/platform/shipments/:id/pend", "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "include", "value": "line_items,variants,product", "type": "query", "description": "Select which associated resources you would like to fetch, see: https://jsonapi.org/format/#fetching-includes" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Moves Shipment back to pending state" } ] } ], "bundled": true }