{"components":{"examples":{},"headers":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"LogisticsAccount":{"description":"A logistics account. Creation of a logistics account is a prerequisite for most requests to the API.","properties":{"id":{"type":"string","description":"A globally-unique account identifier."}},"required":["id"],"type":"object","additionalProperties":false},"LogisticsAccountCreateInput":{"description":"The input fields used to create a logistics account.","properties":{"experimentCode":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Indicates that the merchant is part of an SFN experiment.\nhttps://docs.google.com/document/d/1nFC66GtDuY2JuAu3EqAoZi8DuVAXmQdHRo0TQFBxCvU/edit","example":"SFNFeb2023"},"isSandboxAccount":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Boolean_","description":"Flag indicating whether or not this is a sandbox account. Defaults to false if not specified."},"isTestAccount":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Boolean_","description":"Flag indicating whether or not this is a test account. Defaults to false if not specified."},"shopifyBillingAccountId":{"type":"string","description":"The Shopify Billing account ID.","example":"1001001","minLength":1,"maxLength":255}},"required":["shopifyBillingAccountId"],"type":"object","additionalProperties":false},"InputMaybe_Scalars-at-String_":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"Maybe_Scalars-at-String_":{"type":"string","nullable":true},"InputMaybe_Scalars-at-Boolean_":{"$ref":"#/components/schemas/Maybe_Scalars-at-Boolean_"},"Maybe_Scalars-at-Boolean_":{"type":"boolean","nullable":true},"UnauthorizedError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.UNAUTHORIZED","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"},"code":{"$ref":"#/components/schemas/StatusCodes.UNAUTHORIZED"},"message":{"type":"string"}},"required":["status","type","title","code","message"],"type":"object","additionalProperties":false},"StatusCodes.UNAUTHORIZED":{"enum":[401],"type":"number"},"SignedUrlDetails":{"properties":{"signedUrl":{"type":"string"},"yearMonth":{"type":"string"},"expirationTime":{"type":"string"}},"required":["signedUrl","yearMonth","expirationTime"],"type":"object","additionalProperties":false},"ChargeSummary":{"properties":{"total":{"type":"number","format":"double"},"grossTotal":{"type":"number","format":"double"},"currency":{"type":"string"},"charges":{"$ref":"#/components/schemas/Record_string.ChargeSummaryItem-or-null_"}},"required":["total","grossTotal","currency","charges"],"type":"object","additionalProperties":false},"Record_string.ChargeSummaryItem-or-null_":{"properties":{},"type":"object","description":"Construct a type with a set of properties K of type T"},"UnprocessableEntityError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.UNPROCESSABLE_ENTITY","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"StatusCodes.UNPROCESSABLE_ENTITY":{"enum":[422],"type":"number"},"ChargeTotal":{"properties":{"total":{"type":"number","format":"double"},"grossTotal":{"type":"number","format":"double"},"currency":{"type":"string"}},"required":["total","grossTotal","currency"],"type":"object","additionalProperties":false},"ChargeType":{"enum":["storage","fulfillment","inbound","return"],"type":"string"},"ChargeDetails":{"properties":{"networkRefId":{"type":"string"},"networkRefType":{"type":"string"},"charges":{"items":{"$ref":"#/components/schemas/Charge"},"type":"array"}},"required":["networkRefId","networkRefType","charges"],"type":"object","additionalProperties":false},"Charge":{"properties":{"type":{"$ref":"#/components/schemas/ChargeType"},"chargeDate":{"type":"string","format":"date-time"},"amount":{"type":"number","format":"double"},"grossAmount":{"type":"number","format":"double"},"description":{"type":"string"},"currency":{"type":"string"},"subType":{"type":"string"}},"required":["type","amount","grossAmount","description","currency"],"type":"object","additionalProperties":false},"ChargeItemOrderBy":{"enum":["date"],"type":"string"},"OrderDirection":{"enum":["asc","desc"],"type":"string"},"Health":{"properties":{"status":{"$ref":"#/components/schemas/HealthStatus"}},"required":["status"],"type":"object","additionalProperties":false},"HealthStatus":{"enum":["OK","UNHEALTHY"],"type":"string"},"ApiBundleResponse":{"properties":{"externalBundleId":{"$ref":"#/components/schemas/ExternalBundleIdType"},"title":{"type":"string","description":"The bundle title or short description. Should represent a single line of text suitable to\nidentify the bundle or for search purposes.","minLength":3,"maxLength":255},"sku":{"$ref":"#/components/schemas/SkuType"},"bundleContents":{"items":{"$ref":"#/components/schemas/BundleContent"},"type":"array","minItems":1,"maxItems":20},"bundleId":{"$ref":"#/components/schemas/BundleIdType"},"createdAt":{"$ref":"#/components/schemas/CreationDate"}},"required":["externalBundleId","title","sku","bundleContents","bundleId","createdAt"],"type":"object","additionalProperties":false},"ExternalBundleIdType":{"type":"string","description":"A permanent unique reference for this bundle generated by and meaningful to the API user.\nThis value will be used when sending orders to identify the bundle to ship.\nThis value must be unique among all bundles created via API.","minLength":1,"maxLength":255},"SkuType":{"type":"string","description":"The human-readable Stock Keeping Unit (SKU) for reporting. This value may change over time.","minLength":1,"maxLength":255},"BundleContent":{"properties":{"productId":{"$ref":"#/components/schemas/ProductIdType"},"quantity":{"type":"number","format":"double","description":"Provide the quantity of that product that will be part of the bundle being created."}},"required":["productId","quantity"],"type":"object","additionalProperties":false},"ProductIdType":{"type":"string","description":"The globally unique product identifier created by Flexport and assigned on product creation.\nMay be referred to in other documentation as the Flexport SKU or DSKU.","pattern":"^D[0-9a-zA-Z]+$","minLength":11,"maxLength":11},"BundleIdType":{"type":"string","description":"The globally unique bundle identifier created by Flexport and assigned on bundle creation.\nMay be referred to in other documentation as the Flexport SKU or BSKU.","pattern":"^B[0-9a-zA-Z]+$","minLength":11,"maxLength":11},"CreationDate":{"type":"string","format":"date-time","description":"The timestamp of creation in RFC 3339 format.\ne.g. 2017-07-21T17:32:28Z"},"NotFoundError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.NOT_FOUND","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"StatusCodes.NOT_FOUND":{"enum":[404],"type":"number"},"ForbiddenError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.FORBIDDEN","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"StatusCodes.FORBIDDEN":{"enum":[403],"type":"number"},"ApiBundleResponseWithCursor":{"properties":{"bundles":{"items":{"$ref":"#/components/schemas/ApiBundleResponse"},"type":"array"},"nextCursor":{"type":"string"}},"required":["bundles"],"type":"object","additionalProperties":false},"ApiBundleInventoryResponse":{"properties":{"bundleId":{"$ref":"#/components/schemas/BundleIdType"},"availableUnits":{"type":"number","format":"double","description":"The number of units available for sale - not reserved for open orders,\nbelonging to bundles that are in a pickable and shippable\nstate at connected warehouses."}},"required":["bundleId","availableUnits"],"type":"object","additionalProperties":false},"ApiBundle":{"properties":{"externalBundleId":{"$ref":"#/components/schemas/ExternalBundleIdType"},"title":{"type":"string","description":"The bundle title or short description. Should represent a single line of text suitable to\nidentify the bundle or for search purposes.","minLength":3,"maxLength":255},"sku":{"$ref":"#/components/schemas/SkuType"},"bundleContents":{"items":{"$ref":"#/components/schemas/BundleContent"},"type":"array","minItems":1,"maxItems":20}},"required":["externalBundleId","title","sku","bundleContents"],"type":"object","additionalProperties":false},"DeliverySchedule":{"properties":{"version":{"type":"number","format":"double"},"lastUpdate":{"type":"string","format":"date-time"}},"required":["version","lastUpdate"],"type":"object","additionalProperties":false},"PaginatedResponse_DeliveryScheduleEntry_":{"properties":{"prev":{"type":"string"},"next":{"type":"string"},"items":{"items":{"$ref":"#/components/schemas/DeliveryScheduleEntry"},"type":"array"}},"required":["items"],"type":"object","additionalProperties":false},"DeliveryScheduleEntry":{"properties":{"countryCode":{"type":"string"},"subdivisionCode":{"type":"string"},"postalCode":{"type":"string"},"minDeliveryDate":{"type":"string","format":"date-time"},"maxDeliveryDate":{"type":"string","format":"date-time"},"expirationDate":{"type":"string","format":"date-time"}},"required":["countryCode","subdivisionCode","postalCode","minDeliveryDate","maxDeliveryDate","expirationDate"],"type":"object","additionalProperties":false},"PaginatedResponse_ProductDeliverySchedule_":{"properties":{"prev":{"type":"string"},"next":{"type":"string"},"items":{"items":{"$ref":"#/components/schemas/ProductDeliverySchedule"},"type":"array"}},"required":["items"],"type":"object","additionalProperties":false},"ProductDeliverySchedule":{"properties":{"logisticsSKU":{"type":"string"},"scheduleId":{"type":"string"}},"required":["logisticsSKU","scheduleId"],"type":"object","additionalProperties":false},"DeliverySettings":{"properties":{"active":{"type":"boolean"}},"required":["active"],"type":"object","additionalProperties":false},"EventsResponseItem":{"properties":{"id":{"type":"string"},"type":{"type":"string"},"time":{"type":"string"},"payload":{"$ref":"#/components/schemas/EventPayloadType"}},"required":["id","type","time","payload"],"type":"object","additionalProperties":false},"EventPayloadType":{"properties":{},"additionalProperties":{"type":"string"},"type":"object","description":"Event payload"},"EventId":{"type":"string","pattern":"^([\\w]{0,50})$"},"WarehouseAddress":{"properties":{"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/CountryCode","description":"The two-letter code for the country of the address."},"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30},"storageWarehouseId":{"type":"string","description":"The unique id of a storage-warehouse.","maxLength":50}},"required":["address1","city","countryCode","provinceCode","zip","storageWarehouseId"],"type":"object","additionalProperties":false},"CountryCode":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MK","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW"],"nullable":false},"InboundShipmentResponseV6":{"properties":{"id":{"type":"string"},"receivingId":{"type":"string"},"status":{"$ref":"#/components/schemas/LogisticsInboundShipmentStatus"},"items":{"items":{"$ref":"#/components/schemas/ItemOutputUnstable"},"type":"array"},"packages":{"items":{"$ref":"#/components/schemas/PackageOutputUnstable"},"type":"array"},"arrivedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"shippingPlanId":{"type":"string"},"shippingPlanExternalId":{"type":"string","description":"The external shipment ID provided in the request."},"shippingPlanName":{"type":"string"},"bookingId":{"type":"string"},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"externalAsnId":{"type":"string","description":"The external ASN identifier provided in the request.\nOnly present for NETWORK shipments where externalAsnId was specified."},"customAttributes":{"$ref":"#/components/schemas/CustomAttributes","description":"The custom key-value attributes associated with this shipment.\nOnly present where customAttributes were specified in the request."},"addresses":{"$ref":"#/components/schemas/AddressesOutputUnstable"},"freight":{"$ref":"#/components/schemas/ShopifyFreightResponseV2"},"prep":{"$ref":"#/components/schemas/PrepRequestData"},"shipmentDestination":{"$ref":"#/components/schemas/LogisticsInboundShipmentDestination"},"cargoType":{"$ref":"#/components/schemas/LogisticsInboundCargoType"},"container":{"$ref":"#/components/schemas/ContainerOutput"}},"required":["id","status","shippingPlanId","addresses","shipmentDestination"],"type":"object","additionalProperties":false},"LogisticsInboundShipmentStatus":{"enum":["PENDING","READY_TO_SHIP","IN_TRANSIT","ARRIVED","PREPARING_FOR_DISTRIBUTION","IN_PREP","FORWARDING","RECEIVING","COMPLETED"],"type":"string"},"ItemOutputUnstable":{"properties":{"logisticsSku":{"type":"string"},"shipmentItemId":{"type":"string"},"counts":{"$ref":"#/components/schemas/CountsOutput"},"lineItemId":{"type":"string"},"merchantSku":{"type":"string"}},"required":["logisticsSku","shipmentItemId","counts"],"type":"object","additionalProperties":false},"CountsOutput":{"properties":{"sellable":{"type":"number","format":"double"},"damaged":{"type":"number","format":"double"},"expected":{"type":"number","format":"double"}},"required":["sellable","damaged","expected"],"type":"object","additionalProperties":false},"PackageOutputUnstable":{"description":"Package configuration for inbound shipment response.","properties":{"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"dimensionUnit":{"$ref":"#/components/schemas/LengthUnit","description":"Which length measurement standards are being used for the package.","example":"in"},"weightUnit":{"$ref":"#/components/schemas/WeightUnit","description":"Which weight measurement standards are being used for the package.","example":"lb"},"id":{"type":"string"},"identicalPackageConfigIdentifer":{"type":"string"},"items":{"items":{"$ref":"#/components/schemas/ItemDataV2"},"type":"array"},"sellerLPN":{"type":"string","nullable":true,"description":"The seller's unique identifier for the package."}},"required":["id","items"],"type":"object","additionalProperties":false},"LengthUnit":{"type":"string","enum":["in","cm","mm","m"]},"WeightUnit":{"type":"string","enum":["oz","kg","lb","g"]},"ItemDataV2":{"description":"A basic item that pairs a Logistics SKU and quantity.","properties":{"logisticsSku":{"type":"string"},"quantity":{"type":"integer","format":"int32"},"lotNumber":{"type":"string"},"expirationDate":{"type":"string","format":"date"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the inbound"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"InboundShippingOption":{"enum":["SPD_EXTERNAL","FREIGHT_EXTERNAL","LTL_EXTERNAL","LTL_INTERNAL","FTL_INTERNAL","SPD_INTERNAL"],"type":"string"},"CustomAttributes":{"properties":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"}]}},"AddressesOutputUnstable":{"properties":{"to":{"$ref":"#/components/schemas/InboundAddress"},"from":{"anyOf":[{"$ref":"#/components/schemas/InboundAddress"},{"$ref":"#/components/schemas/WarehouseAddress"}]}},"required":["to","from"],"type":"object","additionalProperties":false},"InboundAddress":{"properties":{"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/CountryCode","description":"The two-letter code for the country of the address."},"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30}},"required":["address1","city","countryCode","provinceCode","zip"],"type":"object","additionalProperties":false},"ShopifyFreightResponseV2":{"properties":{"pickup":{"$ref":"#/components/schemas/FreightPickupResponse"},"pallets":{"items":{"$ref":"#/components/schemas/FreightPalletResponse"},"type":"array"},"bolId":{"type":"string"},"shippingProvider":{"type":"string"},"proId":{"type":"string"},"estimatedShipDate":{"type":"string","format":"date-time"},"carrierEmailAddress":{"type":"string"}},"type":"object","additionalProperties":false},"FreightPickupResponse":{"properties":{"id":{"type":"number","format":"double"},"contactName":{"type":"string"},"contactPhone":{"type":"string"},"contactEmail":{"type":"string"},"liftGate":{"type":"boolean"},"pickupDate":{"type":"string","format":"date-time"},"customerReferenceNumber":{"type":"string"},"facilityOperatingHours":{"$ref":"#/components/schemas/TimeWindow"}},"required":["id","contactName","contactPhone","contactEmail","pickupDate"],"type":"object","additionalProperties":false},"TimeWindow":{"properties":{"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["startTime","endTime"],"type":"object","additionalProperties":false},"FreightPalletResponse":{"properties":{"id":{"type":"number","format":"double"},"palletConfigId":{"type":"string"},"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"dimensionUnit":{"type":"string"},"weight":{"type":"number","format":"double"},"weightUnit":{"type":"string"}},"required":["id","length","width","height","dimensionUnit","weight","weightUnit"],"type":"object","additionalProperties":false},"PrepRequestData":{"properties":{"boxContentLabels":{"type":"boolean"}},"required":["boxContentLabels"],"type":"object","additionalProperties":false},"LogisticsInboundShipmentDestination":{"enum":["NETWORK","STORAGE"],"type":"string"},"LogisticsInboundCargoType":{"enum":["PALLETIZED","FLOOR_LOADED_CONTAINER"],"type":"string"},"ContainerOutput":{"properties":{"size":{"$ref":"#/components/schemas/LogisticsInboundContainerSize"},"id":{"type":"string"}},"required":["size"],"type":"object","additionalProperties":false},"LogisticsInboundContainerSize":{"enum":["GENERAL_20FT","GENERAL_40FT"],"type":"string"},"CreateInboundShipmentRequestV6":{"properties":{"palletCount":{"type":"number","format":"double","description":"only used by STORAGE shipments; required when cargoType is PALLETIZED"},"prep":{"$ref":"#/components/schemas/PrepRequestData","description":"only used by NETWORK shipments & required for NETWORK shipments"},"shippingPlanExternalId":{"type":"string","description":"Unique identifier for the shipment.\n\n**Recommended:** Use an internal shipment ID or a UUID/GUID\ne.g., `\"SHIP-2024-001-abc123\"` or `\"550e8400-e29b-41d4-a716-446655440000\"`\n\n**On duplicates:** Returns `400 Bad Request` with the message:\n\n> A shipping plan with this external ID already exists. Please use a unique external ID and try again."},"shippingPlanName":{"type":"string"},"bookingId":{"type":"string","description":"Booking ID is the FLEX-ID of a Flexport freight shipment in Core.\n\ne.g., \"FLEX-1234567890\"","pattern":"^[Ff][Ll][Ee][Xx]-"},"shipmentDestination":{"$ref":"#/components/schemas/LogisticsInboundShipmentDestination","description":"defaults to NETWORK; Classify the destination of the shipment."},"storageWarehouseId":{"type":"string","description":"Mandatory for STORAGE shipments (shipmentDestination: \"STORAGE\"). Not applicable for NETWORK shipments.\n\nThe unique identifier of the storage-warehouse facility where the shipment will be stored.\n\nValid storageWarehouseIds can be retrieved using the\n[GetStorageWarehouses](#operation/GetInboundsWarehouses) operation."},"cargoType":{"$ref":"#/components/schemas/LogisticsInboundCargoType","description":"Required for STORAGE shipments (shipmentDestination: \"STORAGE\").\nOptional for NETWORK shipments - if omitted, the default is PALLETIZED.\n\nIndicates whether the shipment is loaded on pallets or floor-loaded\n(boxes placed directly into the container)."},"container":{"$ref":"#/components/schemas/ContainerInput","description":"Mandatory when cargoType is set to FLOOR_LOADED_CONTAINER. Not applicable for other cargo types."},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"from":{"$ref":"#/components/schemas/InboundAddressV2"},"destinationWarehouseId":{"type":"string","description":"Required only for NETWORK shipments (shipmentDestination: \"NETWORK\"),\nand only when creating an inbound directly to a DTC fulfillment facility\ninstead of using cross-docking for distribution.\n\nThis field is available only for merchants on Multi-Node Zone-Based Pricing.\n\nValid destinationWarehouseId values can be retrieved using the\n[GetInboundsWarehouses](#operation/GetInboundsWarehouses) operation."},"items":{"items":{"$ref":"#/components/schemas/ItemDataV4"},"type":"array","description":"required for STORAGE shipments & optional for NETWORK shipments if packages are provided; The items on the shipment. Specify items if creating a blind inbound."},"packages":{"items":{"$ref":"#/components/schemas/PackageInputV3"},"type":"array","description":"only used by NETWORK shipments & optional if items are provided; The packages on the shipment. Packages do not need to be specified if creating an blind inbound where items are provided instead."},"externalAsnId":{"type":"string","description":"An optional external identifier for the ASN associated with this shipment.\nUse this to correlate the Flexport shipment with your own system's ASN or purchase order identifier.\nOnly supported for NETWORK shipments."},"customAttributes":{"$ref":"#/components/schemas/CustomAttributes","description":"An optional set of custom key-value attributes to associate with this shipment.\nOnly supported for NETWORK shipments. Up to 10 key/value pairs; keys max 50 chars; string values max 255 chars; numeric values must be finite."}},"required":["from"],"type":"object","additionalProperties":false},"ContainerInput":{"properties":{"size":{"$ref":"#/components/schemas/LogisticsInboundContainerSize"},"id":{"type":"string"}},"required":["size"],"type":"object","additionalProperties":false},"InboundAddressV2":{"properties":{"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30},"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/CountryCode","description":"The two-letter code for the country of the address."},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30}},"required":["name","city","zip","address1","countryCode","provinceCode"],"type":"object","additionalProperties":false},"ItemDataV4":{"properties":{"logisticsSku":{"type":"string","description":"Required for STORAGE shipments. For NETWORK shipments, either logisticsSku or merchantSku must be provided."},"merchantSku":{"type":"string","description":"Not applicable for STORAGE shipments. For NETWORK shipments, either logisticsSku or merchantSku must be provided."},"quantity":{"type":"integer","format":"int32","description":"the total number of units for a given SKU; for STORAGE shipments the quantity must be a multiple of the unitsPerCase defined within the caseDetails"},"lotNumber":{"type":"string"},"expirationDate":{"type":"string","format":"date"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the inbound"},"caseDetails":{"$ref":"#/components/schemas/CasePackTemplateV2"}},"required":["quantity"],"type":"object","additionalProperties":false},"CasePackTemplateV2":{"description":"only used by STORAGE shipments & required for STORAGE shipments","properties":{"weightUnit":{"$ref":"#/components/schemas/WeightUnitV2"},"dimensionUnit":{"$ref":"#/components/schemas/LengthUnitV2"},"unitsPerCase":{"type":"number","format":"double","description":"must be a factor of the quantity"},"weight":{"type":"number","format":"double"},"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"}},"required":["unitsPerCase","weight","length","width","height"],"type":"object","additionalProperties":false},"WeightUnitV2":{"type":"string","enum":["lb","kg"]},"LengthUnitV2":{"type":"string","enum":["in","cm"]},"PackageInputV3":{"description":"Package configuration for V6 inbound shipment requests with optional SKU identifiers\nExtends PackageInputV2 but uses WeightUnitV2 instead of WeightUnit","properties":{"items":{"items":{"$ref":"#/components/schemas/ItemDataV3"},"type":"array"},"dimensionUnit":{"$ref":"#/components/schemas/LengthUnitV2","description":"Which dimension measurement standards are being used for the package.","example":"in"},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"numberOfIdenticalPkgs":{"type":"number","format":"double"},"sellerLPNs":{"items":{"type":"string"},"type":"array","description":"The seller's unique identifier for the package. The length of sellerLPNs array must match the value specified in numberOfIdenticalPkgs."},"quantityUOM":{"type":"string","description":"Unit of measure for the pack type (`\"CASE\"` or `\"UNIT\"`)\n\nCASE: Packages are intended to be inbounded as cases.\n\n**Note**: Dimensions are required when quantityUOM is CASE.\n\nUNIT: Packages are intended to be inbounded as individual units.\n\n **Note**: When nothing is provided, the default is UNIT."},"numberOfReservedPkgs":{"type":"integer","format":"int32","description":"Number of packages (as cases) reserved for orders.\n\nOnly applicable for `CASE` inbounds.\n\nMust be less than or equal to `numberOfIdenticalPkgs`."},"weightUnit":{"$ref":"#/components/schemas/WeightUnitV2","description":"Which weight measurement standards are being used for the package.","example":"lb"}},"required":["items","numberOfIdenticalPkgs"],"type":"object","additionalProperties":false},"ItemDataV3":{"description":"Item type for V5/V6 packages with optional SKU identifiers","properties":{"logisticsSku":{"type":"string","description":"Required for STORAGE shipments. For NETWORK shipments, either logisticsSku or merchantSku must be provided."},"merchantSku":{"type":"string","description":"Not applicable for STORAGE shipments. For NETWORK shipments, either logisticsSku or merchantSku must be provided."},"quantity":{"type":"integer","format":"int32","description":"The total number of units for a given SKU."},"lotNumber":{"type":"string"},"expirationDate":{"type":"string","format":"date"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the inbound"}},"required":["quantity"],"type":"object","additionalProperties":false},"BadRequestError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.BAD_REQUEST","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"StatusCodes.BAD_REQUEST":{"enum":[400],"type":"number"},"CreateInboundShipmentAsyncRequestV1":{"properties":{"packages":{"items":{"$ref":"#/components/schemas/PackageInputV3"},"type":"array","description":"only used by NETWORK shipments & optional if items are provided; The packages on the shipment. Packages do not need to be specified if creating an blind inbound where items are provided instead."},"palletCount":{"type":"number","format":"double","description":"only used by STORAGE shipments; required when cargoType is PALLETIZED"},"prep":{"$ref":"#/components/schemas/PrepRequestData","description":"only used by NETWORK shipments & required for NETWORK shipments"},"shippingPlanName":{"type":"string"},"customAttributes":{"$ref":"#/components/schemas/CustomAttributes","description":"An optional set of custom key-value attributes to associate with this shipment.\nOnly supported for NETWORK shipments. Up to 10 key/value pairs; keys max 50 chars; string values max 255 chars; numeric values must be finite."},"bookingId":{"type":"string","description":"Booking ID is the FLEX-ID of a Flexport freight shipment in Core.\n\ne.g., \"FLEX-1234567890\"","pattern":"^[Ff][Ll][Ee][Xx]-"},"items":{"items":{"$ref":"#/components/schemas/ItemDataV4"},"type":"array","description":"required for STORAGE shipments & optional for NETWORK shipments if packages are provided; The items on the shipment. Specify items if creating a blind inbound."},"from":{"$ref":"#/components/schemas/InboundAddressV2"},"shipmentDestination":{"$ref":"#/components/schemas/LogisticsInboundShipmentDestination","description":"defaults to NETWORK; Classify the destination of the shipment."},"storageWarehouseId":{"type":"string","description":"Mandatory for STORAGE shipments (shipmentDestination: \"STORAGE\"). Not applicable for NETWORK shipments.\n\nThe unique identifier of the storage-warehouse facility where the shipment will be stored.\n\nValid storageWarehouseIds can be retrieved using the\n[GetStorageWarehouses](#operation/GetInboundsWarehouses) operation."},"cargoType":{"$ref":"#/components/schemas/LogisticsInboundCargoType","description":"Required for STORAGE shipments (shipmentDestination: \"STORAGE\").\nOptional for NETWORK shipments - if omitted, the default is PALLETIZED.\n\nIndicates whether the shipment is loaded on pallets or floor-loaded\n(boxes placed directly into the container)."},"container":{"$ref":"#/components/schemas/ContainerInput","description":"Mandatory when cargoType is set to FLOOR_LOADED_CONTAINER. Not applicable for other cargo types."},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"destinationWarehouseId":{"type":"string","description":"Required only for NETWORK shipments (shipmentDestination: \"NETWORK\"),\nand only when creating an inbound directly to a DTC fulfillment facility\ninstead of using cross-docking for distribution.\n\nThis field is available only for merchants on Multi-Node Zone-Based Pricing.\n\nValid destinationWarehouseId values can be retrieved using the\n[GetInboundsWarehouses](#operation/GetInboundsWarehouses) operation."},"externalAsnId":{"type":"string","description":"An optional external identifier for the ASN associated with this shipment.\nUse this to correlate the Flexport shipment with your own system's ASN or purchase order identifier.\nOnly supported for NETWORK shipments."},"shippingPlanExternalId":{"type":"string","description":"A unique identifier for the shipment. This field is required when creating an asynchronous shipment and is used to retrieve the shipment.\n\n**Recommended:** Use an internal shipment ID or a UUID/GUID\ne.g., `\"SHIP-2024-001-abc123\"` or `\"550e8400-e29b-41d4-a716-446655440000\"`\n\n**On duplicates:** Returns `400 Bad Request` with the message:\n\n> A shipping plan with this external ID already exists. Please use a unique external ID and try again."}},"required":["from","shippingPlanExternalId"],"type":"object","additionalProperties":false},"InboundShipmentResponseV7":{"properties":{"status":{"$ref":"#/components/schemas/LogisticsInboundShipmentStatus"},"packages":{"items":{"$ref":"#/components/schemas/PackageOutputUnstable"},"type":"array"},"id":{"type":"string"},"prep":{"$ref":"#/components/schemas/PrepRequestData"},"shippingPlanExternalId":{"type":"string","description":"The external shipment ID provided in the request."},"shippingPlanName":{"type":"string"},"customAttributes":{"$ref":"#/components/schemas/CustomAttributes","description":"The custom key-value attributes associated with this shipment.\nOnly present where customAttributes were specified in the request."},"bookingId":{"type":"string"},"shippingPlanId":{"type":"string"},"freight":{"$ref":"#/components/schemas/ShopifyFreightResponseV2"},"arrivedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"shipmentDestination":{"$ref":"#/components/schemas/LogisticsInboundShipmentDestination"},"cargoType":{"$ref":"#/components/schemas/LogisticsInboundCargoType"},"container":{"$ref":"#/components/schemas/ContainerOutput"},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"externalAsnId":{"type":"string","description":"The external ASN identifier provided in the request.\nOnly present for NETWORK shipments where externalAsnId was specified."},"receivingId":{"type":"string"},"addresses":{"$ref":"#/components/schemas/AddressesOutputUnstable"},"items":{"items":{"$ref":"#/components/schemas/ItemOutputUnstableV2"},"type":"array"}},"required":["status","id","shippingPlanId","shipmentDestination","addresses"],"type":"object","additionalProperties":false},"ItemOutputUnstableV2":{"properties":{"logisticsSku":{"type":"string"},"shipmentItemId":{"type":"string"},"counts":{"$ref":"#/components/schemas/CountsOutput"},"lineItemId":{"type":"string"},"merchantSku":{"type":"string"},"packOfDsku":{"type":"string"},"caseQty":{"type":"number","format":"double"}},"required":["logisticsSku","shipmentItemId","counts"],"type":"object","additionalProperties":false},"DocumentResponse":{"properties":{"ready":{"type":"boolean"},"url":{"type":"string"}},"required":["ready","url"],"type":"object","additionalProperties":false},"DocumentOption":{"enum":["BOX_CONTENT_LABEL","SHIPPING_LABEL","BILL_OF_LADING","PALLET_LABEL"],"type":"string"},"BoxLabelsFormat":{"enum":["US_LETTER","THERMAL_4_X_6","A4_PAPER"],"type":"string"},"InboundShipmentResponseV3":{"properties":{"id":{"type":"string"},"receivingId":{"type":"string"},"status":{"$ref":"#/components/schemas/LogisticsInboundShipmentStatus"},"addresses":{"$ref":"#/components/schemas/AddressesOutput"},"items":{"items":{"$ref":"#/components/schemas/ItemOutputUnstable"},"type":"array"},"packages":{"items":{"$ref":"#/components/schemas/PackageOutputUnstable"},"type":"array"},"arrivedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"freight":{"$ref":"#/components/schemas/ShopifyFreightResponse"},"prep":{"$ref":"#/components/schemas/PrepRequestData"},"shippingPlanId":{"type":"string"}},"required":["id","receivingId","status","addresses","prep","shippingPlanId"],"type":"object","additionalProperties":false},"AddressesOutput":{"properties":{"to":{"$ref":"#/components/schemas/InboundAddress"},"from":{"$ref":"#/components/schemas/InboundAddress"}},"required":["to","from"],"type":"object","additionalProperties":false},"ShopifyFreightResponse":{"properties":{"pickup":{"$ref":"#/components/schemas/FreightPickupResponse"},"pallets":{"items":{"$ref":"#/components/schemas/FreightPalletResponse"},"type":"array"}},"type":"object","additionalProperties":false},"UpdateInboundShipmentRequestV4":{"properties":{"from":{"$ref":"#/components/schemas/InboundAddress"},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"packages":{"items":{"$ref":"#/components/schemas/UpdatePackageInputV2"},"type":"array"},"freightDetails":{"$ref":"#/components/schemas/UpdateFreightInputV3"},"packageTrackingNumber":{"type":"string"},"prep":{"$ref":"#/components/schemas/PrepRequestData"},"createPackages":{"items":{"$ref":"#/components/schemas/PackageInputV1"},"type":"array"}},"type":"object","additionalProperties":false},"UpdatePackageInputV2":{"description":"Package configuration for V3 update shipment requests with LengthUnitV2 and WeightUnitV2","properties":{"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"ids":{"items":{"type":"string"},"type":"array"},"shippingProvider":{"type":"string"},"trackingNumber":{"type":"string"},"weightUnit":{"$ref":"#/components/schemas/WeightUnitV2","description":"Which weight measurement standards are being used for the package.","example":"lb"},"dimensionUnit":{"$ref":"#/components/schemas/LengthUnitV2","description":"Which dimension measurement standards are being used for the package.","example":"in"}},"required":["ids"],"type":"object","additionalProperties":false},"UpdateFreightInputV3":{"properties":{"pallets":{"items":{"$ref":"#/components/schemas/PalletInput"},"type":"array"},"pickup":{"$ref":"#/components/schemas/PickupInputV3"},"bolId":{"type":"string"},"shippingProvider":{"type":"string"},"proId":{"type":"string"},"estimatedShipDate":{"type":"string","format":"date-time"}},"type":"object","additionalProperties":false},"PalletInput":{"description":"Pallet configuration used for internal freight inbound shipments.","properties":{"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"dimensionUnit":{"type":"string"},"weight":{"type":"number","format":"double"},"weightUnit":{"type":"string"},"numberOfIdenticalPallets":{"type":"integer","format":"int32"}},"required":["length","width","height","dimensionUnit","weight","weightUnit","numberOfIdenticalPallets"],"type":"object","additionalProperties":false},"PickupInputV3":{"properties":{"readyDate":{"type":"string","format":"date-time"},"facilityHoursStart":{"type":"string"},"facilityHoursEnd":{"type":"string"},"contactName":{"type":"string"},"contactPhone":{"type":"string"},"contactEmail":{"type":"string"},"liftGate":{"type":"boolean"},"customerReferenceNumber":{"type":"string"}},"required":["readyDate","contactName","contactPhone","contactEmail","liftGate"],"type":"object","additionalProperties":false},"PackageInputV1":{"description":"Package configuration for inbound shipment requests.","properties":{"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"dimensionUnit":{"$ref":"#/components/schemas/LengthUnit","description":"Which length measurement standards are being used for the package.","example":"in"},"weightUnit":{"$ref":"#/components/schemas/WeightUnit","description":"Which weight measurement standards are being used for the package.","example":"lb"},"items":{"items":{"$ref":"#/components/schemas/ItemDataV2"},"type":"array"},"numberOfIdenticalPkgs":{"type":"number","format":"double"},"sellerLPNs":{"items":{"type":"string"},"type":"array","description":"The seller's unique identifier for the package. The length of sellerLPNs array must match the value specified in numberOfIdenticalPkgs."}},"required":["items","numberOfIdenticalPkgs"],"type":"object","additionalProperties":false},"QuoteResultResponse":{"properties":{"error":{"$ref":"#/components/schemas/InboundExternalRateError"},"quotes":{"items":{"$ref":"#/components/schemas/RateQuoteWithPurchased"},"type":"array"}},"required":["quotes"],"type":"object","additionalProperties":false},"InboundExternalRateError":{"properties":{"code":{"type":"string"},"subcode":{"type":"string"}},"type":"object","additionalProperties":false},"RateQuoteWithPurchased":{"properties":{"id":{"type":"number","format":"double"},"shippingProvider":{"type":"string"},"rateShoppingMethod":{"$ref":"#/components/schemas/InboundRateShoppingMethod"},"amount":{"type":"number","format":"double"},"fullAmount":{"type":"number","format":"double"},"currency":{"type":"string"},"providerMethod":{"type":"string"},"purchased":{"type":"boolean"},"estimatedTimeOfArrival":{"type":"string","format":"date-time"},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"}},"required":["id","shippingProvider","rateShoppingMethod","amount","currency","providerMethod","purchased","estimatedTimeOfArrival","shippingOption"],"type":"object","additionalProperties":false},"InboundRateShoppingMethod":{"enum":["CHEAPEST","FASTEST","ERROR","RACE"],"type":"string"},"InboundRateQuoteResult":{"properties":{"quotes":{"items":{"$ref":"#/components/schemas/InboundRateQuoteFE"},"type":"array"},"error":{"$ref":"#/components/schemas/InboundExternalRateError"}},"required":["quotes"],"type":"object","additionalProperties":false},"InboundRateQuoteFE":{"properties":{"shippingOption":{"$ref":"#/components/schemas/NetworkInboundShippingOption"},"rateShoppingMethod":{"$ref":"#/components/schemas/InboundRateShoppingMethod"},"amount":{"type":"number","format":"double"},"fullAmount":{"type":"number","format":"double"},"currency":{"type":"string"},"shippingProvider":{"type":"string"},"providerMethod":{"type":"string"},"externalEstimateDays":{"type":"number","format":"double"},"externalEta":{"type":"string","format":"date-time"},"id":{"type":"number","format":"double"}},"required":["shippingOption","rateShoppingMethod","amount","currency","shippingProvider","providerMethod","externalEstimateDays","externalEta","id"],"type":"object","additionalProperties":false},"NetworkInboundShippingOption":{"enum":["SPD","SPD_EXTERNAL","LTL","LTL_DELIVERR","FTL_DELIVERR","LTL_EXTERNAL","FTL_EXTERNAL"],"type":"string"},"InboundRateBuyResultV2":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/InboundRateTransactionNetwork"},"type":"array"},"error":{"$ref":"#/components/schemas/InboundExternalRateError"}},"required":["transactions"],"type":"object","additionalProperties":false},"InboundRateTransactionNetwork":{"properties":{"quoteId":{"type":"number","format":"double"},"shippingOption":{"$ref":"#/components/schemas/NetworkInboundShippingOption"},"rateShoppingMethod":{"$ref":"#/components/schemas/InboundRateShoppingMethod"},"amount":{"type":"number","format":"double"},"currency":{"type":"string"},"shippingProvider":{"type":"string"},"providerMethod":{"type":"string"},"externalEstimateDays":{"type":"number","format":"double"},"externalEta":{"type":"string","format":"date-time"}},"required":["quoteId","shippingOption","rateShoppingMethod","amount","currency","shippingProvider","providerMethod","externalEstimateDays","externalEta"],"type":"object","additionalProperties":false},"PurchaseQuotesRequest":{"properties":{"quoteIds":{"items":{"type":"integer","format":"int32"},"type":"array"}},"required":["quoteIds"],"type":"object","additionalProperties":false},"NonComplianceIssueResponse":{"properties":{"id":{"type":"integer","format":"int32","description":"Id of issue"},"type":{"$ref":"#/components/schemas/NonComplianceIssueType","description":"The issue type"},"logisticsSku":{"type":"string","description":"Merchant's logistics product ID"},"barcode":{"type":"string","description":"The shipment's barcode"},"shipmentId":{"type":"integer","format":"int32","description":"The shipment id"},"shippingPlanId":{"type":"integer","format":"int32","description":"The shipping plan id"},"reportedUnits":{"type":"integer","format":"int32","description":"The total number of reported units"},"receivedUnits":{"type":"integer","format":"int32","description":"The total number of received units"},"status":{"$ref":"#/components/schemas/NonComplianceIssueStatus","description":"The issue's current status."},"createdAt":{"type":"string","format":"date-time","description":"When the issue was created"},"updatedAt":{"type":"string","format":"date-time","description":"When the issue was updated"},"dispute":{"$ref":"#/components/schemas/Dispute","description":"Dispute related fields"},"extended":{"$ref":"#/components/schemas/ExtendedNonComplianceIssue","description":"Wrapper for issue specific data"}},"required":["id","type","status","createdAt","updatedAt","dispute","extended"],"type":"object","additionalProperties":false},"NonComplianceIssueType":{"enum":["MISSING_BARCODE","UNKNOWN_BARCODE","UNEXPECTED_SKU","DAMAGED_PRODUCT","RELABELED_BOXES","SHORT_SHIPPED_BOXES"],"type":"string"},"NonComplianceIssueStatus":{"enum":["ACTION_REQUIRED","IN_REVIEW","RESOLVED"],"type":"string"},"Dispute":{"properties":{"hasActiveDispute":{"type":"boolean","description":"The issue has an open dispute"},"disputeUrl":{"type":"string","description":"URL for the dispute ticket"},"disputeClosedAt":{"type":"string","format":"date-time","description":"When the dispute was closed"}},"type":"object","additionalProperties":false},"ExtendedNonComplianceIssue":{"description":"This type contains any issue type specific data. Only one property in this object will be set per issue","properties":{"missingBarcode":{"$ref":"#/components/schemas/MissingBarcodeIssue"},"unknownBarcode":{"$ref":"#/components/schemas/UnknownBarcodeIssue"},"unexpectedSku":{"$ref":"#/components/schemas/UnexpectedSkuIssue"},"damagedProduct":{"$ref":"#/components/schemas/DamagedProductIssue"},"relabeledBox":{"$ref":"#/components/schemas/RelabeledBoxIssue"},"shortShippedBox":{"$ref":"#/components/schemas/ShortShippedBoxIssue"}},"type":"object","additionalProperties":false},"MissingBarcodeIssue":{"properties":{"frontPicture":{"type":"string","description":"URL for image"},"backPicture":{"type":"string","description":"URL for image"},"boxContentPicture":{"type":"string","description":"URL for image"},"barcodePicture":{"type":"string","description":"URL for image"},"receivedSubmissionAt":{"type":"string","description":"When we received a resolution from the merchant"},"completedAt":{"type":"string","description":"When the issue was resolved after receiving a resolution"}},"required":["frontPicture","backPicture","boxContentPicture"],"type":"object","additionalProperties":false},"UnknownBarcodeIssue":{"properties":{"frontPicture":{"type":"string","description":"URL for image"},"backPicture":{"type":"string","description":"URL for image"},"boxContentPicture":{"type":"string","description":"URL for image"},"barcodePicture":{"type":"string","description":"URL for image"},"receivedSubmissionAt":{"type":"string","description":"When we received a resolution from the merchant"},"completedAt":{"type":"string","description":"When the issue was resolved after receiving a resolution"}},"required":["frontPicture","backPicture","boxContentPicture","barcodePicture"],"type":"object","additionalProperties":false},"UnexpectedSkuIssue":{"properties":{},"type":"object","additionalProperties":false},"DamagedProductIssue":{"properties":{"damageType":{"$ref":"#/components/schemas/DamageType","description":"Describes the type of damage to the products"},"damageFault":{"$ref":"#/components/schemas/DamageFault","description":"Who is responsible for the damage"},"damagedExteriorPhoto":{"type":"string","description":"URL for image"},"damagedProductPhoto":{"type":"string","description":"URL for image"},"additionalPhoto1":{"type":"string","description":"URL for image"},"additionalPhoto2":{"type":"string","description":"URL for image"},"disposalStatus":{"type":"boolean","description":"Whether the product has been disposed"}},"required":["damageType","damageFault","disposalStatus"],"type":"object","additionalProperties":false},"DamageType":{"enum":["DAMAGED","EXPIRED"],"type":"string"},"DamageFault":{"enum":["SHOPIFY_AT_FAULT","MERCHANT_AT_FAULT"],"type":"string"},"RelabeledBoxIssue":{"properties":{"reportedBoxes":{"type":"integer","format":"int32","description":"How many boxes are affected by the issue"}},"type":"object","additionalProperties":false},"ShortShippedBoxIssue":{"properties":{"status":{"$ref":"#/components/schemas/ShortShippedBoxStatus","description":"The current status of the short ship"},"resolvedBy":{"$ref":"#/components/schemas/ShortShippedResolvedBy","description":"Who resolved the issue"},"reportedBoxes":{"type":"integer","format":"int32","description":"How many boxes are affected by the issue"}},"required":["status"],"type":"object","additionalProperties":false},"ShortShippedBoxStatus":{"enum":["CREATED","WITH_SUPPORT","SHOPIFY_AT_FAULT","MERCHANT_AT_FAULT","ARRIVED_LATE"],"type":"string"},"ShortShippedResolvedBy":{"enum":["SHOPIFY","MERCHANT"],"type":"string"},"InboundWarehouseResponseLogisticsApi":{"properties":{"fulfillmentCentres":{"items":{"$ref":"#/components/schemas/InboundWarehouseDetailsLogisticsApi"},"type":"array"},"storageWarehouses":{"items":{"$ref":"#/components/schemas/InboundWarehouseDetailsLogisticsApi"},"type":"array"}},"type":"object","additionalProperties":false},"InboundWarehouseDetailsLogisticsApi":{"properties":{"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"company":{"type":"string"},"countryCode":{"$ref":"#/components/schemas/CountryCode"},"name":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"phone":{"type":"string"},"provinceCode":{"type":"string"},"zip":{"type":"string"},"warehouseId":{"type":"string"},"warehouseName":{"type":"string"},"isPrep":{"type":"boolean"}},"required":["address1","city","countryCode","provinceCode","zip","warehouseId","warehouseName"],"type":"object","additionalProperties":false},"JsonRpcResponse":{"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"nullable":false},"result":{},"error":{"properties":{"data":{},"message":{"type":"string"},"code":{"type":"number","format":"double"}},"required":["message","code"],"type":"object"},"id":{"anyOf":[{"type":"string"},{"type":"number","format":"double"}],"nullable":true}},"required":["jsonrpc","id"],"type":"object","additionalProperties":false},"AuthFlow":{"description":"Does the flow use the Cognito hosted UI or our custom UI","enum":["hosted_ui","custom_ui"],"type":"string"},"TokenResponse":{"properties":{"access_token":{"type":"string"},"logisticsAccountId":{"type":"string"}},"required":["access_token","logisticsAccountId"],"type":"object","additionalProperties":false},"TokenRequest":{"properties":{"grant_type":{"$ref":"#/components/schemas/GrantTypes","description":"Value MUST be set to \"authorization_code\"."},"code":{"type":"string","description":"The authorization code received from the authorization server."},"redirect_uri":{"type":"string","description":"Required, if the \"redirect_uri\" parameter was included in the authorization\nrequest as described, and must be identical to the value included in the\nauthorization request."}},"required":["grant_type","code"],"type":"object","additionalProperties":false},"GrantTypes":{"enum":["authorization_code"],"type":"string"},"OrderModel202407":{"properties":{"address":{"$ref":"#/components/schemas/Address"},"cost":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_","description":"A fulfillment order's cost"},"id":{"type":"string","description":"A globally-unique identifier."},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was created."},"updatedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was last modified."},"error":{"$ref":"#/components/schemas/Maybe_OrderError_"},"deliveredAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the entire fulfillment order\n    (all packages) were reported as completing delivery to the buyer."},"externalOrderId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"A unique order reference meaningful to the external system submitting the order."},"lineItems":{"items":{"$ref":"#/components/schemas/OrderLineItem"},"type":"array","description":"A list of the fulfillment order's line items."},"promisedDeliveryByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should arrive at\nthe buyer's address, based on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and after promisedShipByTime."},"promisedShipByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should ship by,\nbased on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and before promisedDeliveryByTime."},"shippedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the fulfillment order was reported as shipped to the buyer."},"source":{"$ref":"#/components/schemas/Maybe_SourceId_","description":"The name of the system originating the order such as SHOPIFY, AMAZON, WEBSITE, WALMART or similar. This is a vital field if the source marketplace restricts which carriers are allowed to be used."},"state":{"$ref":"#/components/schemas/OrderState"},"shipments":{"items":{"$ref":"#/components/schemas/FulfillmentShipmentModel"},"type":"array"},"dropshipDetails":{"$ref":"#/components/schemas/OrderDropshipDetails"},"giftMessage":{"type":"string"}},"required":["address","id","lineItems","state","shipments"],"type":"object","additionalProperties":false},"Address":{"properties":{"address1":{"type":"string","description":"First address line of the address."},"address2":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"Second address line of the address."},"city":{"type":"string","description":"City of the address."},"company":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"Company name for the entity."},"countryCode":{"type":"string","description":"Country code for the address."},"email":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"Email of the entity."},"name":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"Name of entity."},"phone":{"type":"string","description":"Phone number of the entity."},"provinceCode":{"type":"string","description":"State or region of the address."},"zip":{"type":"string","description":"Postal code of the address."}},"required":["address1","city","countryCode","phone","provinceCode","zip"],"type":"object","additionalProperties":false},"Maybe_Scalars-at-Float_":{"type":"number","format":"double","nullable":true},"Maybe_Scalars-at-Date_":{"type":"string","format":"date-time","nullable":true},"Maybe_OrderError_":{"allOf":[{"$ref":"#/components/schemas/OrderError"}],"nullable":true},"OrderError":{"properties":{"code":{"type":"number","format":"double"},"lineItemErrors":{"$ref":"#/components/schemas/Maybe_Array_LineItemError__"},"message":{"type":"string"},"retriable":{"type":"boolean","description":"Signals when an order error can be considered transient and can be retried manually by the caller.\nAttempting to create the order again will return a DUPLICATE_ORDER error, to retry please use the retry API."},"type":{"$ref":"#/components/schemas/OrderErrorType"}},"required":["code","message","retriable","type"],"type":"object","additionalProperties":false},"Maybe_Array_LineItemError__":{"items":{"$ref":"#/components/schemas/LineItemError"},"type":"array","nullable":true},"LineItemError":{"properties":{"logisticsSku":{"type":"string"}},"required":["logisticsSku"],"type":"object","additionalProperties":false},"OrderErrorType":{"type":"string","enum":["PARTIALLY_SHIPPED","BAD_ADDRESS","BAD_ADDRESS_DDP","BAD_PRODUCT_INFO","CANNOT_SHIP_HAZMAT","CARRIER_NETWORK_ERR","CUSTOMS_VALUE_LIMIT_EXCEEDED","DDU_NOT_ALLOWED","DSKU_NEVER_INBOUNDED","INTERNATIONAL_ADDRESS","INVALID_CUSTOMS_ITEMS_CURRENCY_CODE","INVENTORY_ERR","INVENTORY_TIMEOUT","LABEL_PURCHASE_FAILURE","MISSING_CUSTOMS_INFO","MISSING_DDP_TAG","MISSING_REMOVAL_FEE_SPECS","MISSING_SHIPPING_SPECIFICATIONS_FOR_HAZMAT","NON_PLT_ORDER_NOT_SUPPORTED","NO_FEDEX_RATES","NO_RATES","NO_REMOVAL_PROPOSAL","OVERSIZED_DIMS","PARTIAL_FULFILL_FAILED","PARTIAL_SHIP_UPDATE_FAILED","PROMISE_TIME_EXPIRED","REMOVALS_MINIMUM_NOT_MET","REMOVAL_ON_HOLD","SHIPPING_METHOD_NOT_SUPPORTED_DDP","STOCKOUT","STOCKOUT_AT_INGESTION","UNKNOWN","UNKNOWN_SFP_STATUS","UNREGISTERED_PRIME_PRODUCTS","UNSUPPORTED_DESTINATION","WAREHOUSE_ERR"]},"OrderLineItem":{"properties":{"customsUnitValue":{"$ref":"#/components/schemas/Maybe_Money_"},"lineItemId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"logisticsSku":{"type":"string"},"quantity":{"type":"number","format":"double"},"quantityBreakdown":{"$ref":"#/components/schemas/Maybe_OrderLineItemQuantityBreakdown_","description":"The quantity breakdown for the order line item. Only available for backordered orders."}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"Maybe_Money_":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"Money":{"properties":{"amount":{"type":"number","format":"double"},"currencyCode":{"type":"string"}},"required":["amount","currencyCode"],"type":"object","additionalProperties":false},"Maybe_OrderLineItemQuantityBreakdown_":{"allOf":[{"$ref":"#/components/schemas/OrderLineItemQuantityBreakdown"}],"nullable":true},"OrderLineItemQuantityBreakdown":{"properties":{"backorderedQuantity":{"$ref":"#/components/schemas/Maybe_Scalars-at-Int_","description":"Quantity on backorder, awaiting stock"},"cancelledQuantity":{"$ref":"#/components/schemas/Maybe_Scalars-at-Int_","description":"Quantity cancelled"},"fulfillableQuantity":{"$ref":"#/components/schemas/Maybe_Scalars-at-Int_","description":"Quantity available to ship"},"shippedQuantity":{"$ref":"#/components/schemas/Maybe_Scalars-at-Int_","description":"Quantity shipped"}},"type":"object","additionalProperties":false},"Maybe_Scalars-at-Int_":{"type":"number","format":"double","nullable":true},"Maybe_SourceId_":{"allOf":[{"$ref":"#/components/schemas/SourceId"}],"nullable":true},"SourceId":{"type":"string","enum":["AMAZON","AUTO_ZONE","BABYLIST","BED_BATH_BEYOND","BELK","BEST_BUY","BLOOMINGDALES","CHEWY","CHORD","CHORD_ADMIN","CHORD_FERMAT","CHORD_GIFTING","CHORD_SUBSCRIPTIONS","CHORD_WHOLESALE_PORT","CMS_SHOPIFY","COSTCO","DELIVERR_API","EBAY","ETSY","GO_TIME_GEAR","JEST_TEST","KENSIUM","KOHLS","KOHLSUS_PROD","KROGER","LEASHBOSS","LUSSOGEAR","MACYS","MAGENTO","MATTRESS_FIRM","NETSUITE","NORDSTROM","ORCHARD_MILES","REFLECTIVE","SAKS","SAMS_CLUB","SHEIN","SHOPIFY","SKUPREME","SLEEPONITKIDS","TARGET","TARGET_PLUS","THREDUP","TIKTOK","WALMART","WEBSITE","WOOCOMMERCE","XTREMEBANDS"]},"OrderState":{"properties":{"fulfillmentDelayed":{"type":"boolean"},"fulfillmentInProgress":{"type":"boolean"},"fulfillmentStatus":{"$ref":"#/components/schemas/ExternalOrderStatus"},"internalStatus":{"$ref":"#/components/schemas/InternalOrderStatus"}},"required":["fulfillmentDelayed","fulfillmentInProgress","fulfillmentStatus","internalStatus"],"type":"object","additionalProperties":false},"ExternalOrderStatus":{"type":"string","enum":["DELIVERED","SHIPPED","ROUTING_IN_PROGRESS","STOPPED"]},"InternalOrderStatus":{"type":"string","enum":["CANCELLED","ERROR","CREATED","DELIVERED","SHIPPED","ON_HOLD"]},"FulfillmentShipmentModel":{"$ref":"#/components/schemas/Omit_FulfillmentShipment.warehouse_"},"Omit_FulfillmentShipment.warehouse_":{"$ref":"#/components/schemas/Pick_FulfillmentShipment.Exclude_keyofFulfillmentShipment.warehouse__","description":"Construct a type with the properties of T except for those in type K."},"Pick_FulfillmentShipment.Exclude_keyofFulfillmentShipment.warehouse__":{"properties":{"status":{"$ref":"#/components/schemas/ShipmentStatus","description":"Status of shipment"},"packages":{"items":{"$ref":"#/components/schemas/FulfillmentPackage"},"type":"array"},"id":{"type":"string","description":"A globally-unique identifier."},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the shipment object was created."},"estimatedDeliveryTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the shipment is estimated to be delivered."},"lineItems":{"items":{"$ref":"#/components/schemas/FulfillmentShipmentItem"},"type":"array"},"shippedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the entire shipment (all packages) was shipped to the buyer."},"estimatedShipTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the shipment is estimated to be shipped."},"labelPrintTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the label was printed."},"warehouseId":{"type":"string","description":"The id of the location (warehouse) that the shipment was processed at."},"warehouseOrderId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"The id of the order at the location (warehouse) that the shipment was processed at."}},"required":["status","packages","id","lineItems","warehouseId"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"ShipmentStatus":{"type":"string","enum":["CANCELLED","ERROR","CREATED","NOT_SYNCED","OVER_SHIPPED","PARTIALLY_SHIPPED","SHIPPED","WAREHOUSE"]},"FulfillmentPackage":{"description":"Represents a fulfillment package.","properties":{"attemptedDeliveryTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"carrierDeliveryTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"carrierPickUpTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"carrierShipTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"id":{"type":"string"},"label":{"$ref":"#/components/schemas/Maybe_PackageLabel_"},"labelCreateTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"lineItems":{"items":{"$ref":"#/components/schemas/FulfillmentPackageItem"},"type":"array"},"serialNumbers":{"$ref":"#/components/schemas/Maybe_Array_Scalars-at-String__"}},"required":["id","lineItems"],"type":"object","additionalProperties":false},"Maybe_PackageLabel_":{"allOf":[{"$ref":"#/components/schemas/PackageLabel"}],"nullable":true},"PackageLabel":{"properties":{"carrier":{"type":"string","description":"Delivery Service provider for the package."},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the label object was created."},"id":{"type":"string"},"labelFormat":{"$ref":"#/components/schemas/Maybe_LabelFormat_"},"labelUrl":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"packageDimensions":{"$ref":"#/components/schemas/Dimensions"},"shippingMethod":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"Delivery Service provider's service level for the package."},"trackingCode":{"type":"string"},"trackingUrl":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"}},"required":["carrier","id","packageDimensions","trackingCode"],"type":"object","additionalProperties":false},"Maybe_LabelFormat_":{"allOf":[{"$ref":"#/components/schemas/LabelFormat"}],"nullable":true},"LabelFormat":{"type":"string","enum":["PDF","PNG","ZPL203"]},"Dimensions":{"properties":{"height":{"type":"number","format":"double"},"length":{"type":"number","format":"double"},"lengthUnit":{"$ref":"#/components/schemas/LengthUnit"},"weight":{"type":"number","format":"double"},"weightUnit":{"$ref":"#/components/schemas/WeightUnit"},"width":{"type":"number","format":"double"}},"required":["height","length","lengthUnit","weight","weightUnit","width"],"type":"object","additionalProperties":false},"FulfillmentPackageItem":{"properties":{"expirationDate":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"logisticsSku":{"type":"string"},"lotNumber":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"quantity":{"type":"number","format":"double"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"Maybe_Array_Scalars-at-String__":{"items":{"type":"string"},"type":"array","nullable":true},"FulfillmentShipmentItem":{"properties":{"logisticsSku":{"type":"string"},"quantity":{"type":"number","format":"double"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"OrderDropshipDetails":{"properties":{"barCode":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"billingAddress":{"$ref":"#/components/schemas/Maybe_Address_"},"customMessage":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"customerOrderDate":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"customerOrderNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"lineItemData":{"$ref":"#/components/schemas/DropshipLineItemRecord"},"orderId":{"type":"number","format":"double"},"paymentMethod":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"reserved1":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"reserved2":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"retailerPurchaseOrderNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"returnAddress":{"$ref":"#/components/schemas/Maybe_Address_"},"returnMessage":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"shipMethod":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"warehouseId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"}},"required":["lineItemData","orderId"],"type":"object","additionalProperties":false},"Maybe_Address_":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"DropshipLineItemRecord":{"properties":{"key":{"type":"string"},"value":{"$ref":"#/components/schemas/DropshipLineItem"}},"required":["key","value"],"type":"object","additionalProperties":false},"DropshipLineItem":{"properties":{"itemColor":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"itemCredit":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_"},"itemShippingCharge":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_"},"itemSize":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"itemSubTotalPrice":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_"},"itemTax":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_"},"itemUnitPrice":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_"},"retailerDescription":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"retailerRefNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"vendorRefNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"}},"type":"object","additionalProperties":false},"CreateOrderInput202503":{"$ref":"#/components/schemas/Omit_CreateOrderInput202407.packingSlipUrl_"},"Omit_CreateOrderInput202407.packingSlipUrl_":{"$ref":"#/components/schemas/Pick_CreateOrderInput202407.Exclude_keyofCreateOrderInput202407.packingSlipUrl__","description":"Construct a type with the properties of T except for those in type K."},"Pick_CreateOrderInput202407.Exclude_keyofCreateOrderInput202407.packingSlipUrl__":{"properties":{"address":{"$ref":"#/components/schemas/AddressInput"},"externalOrderId":{"type":"string","description":"A unique order reference meaningful to the external system submitting the order."},"lineItems":{"items":{"$ref":"#/components/schemas/OrderLineItemInput202407"},"type":"array","description":"A list of the fulfillment order's line items."},"promisedDeliveryByTime":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should arrive at\nthe buyer's address, based on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and after promisedShipByTime."},"promisedShipByTime":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should ship by,\nbased on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and before promisedDeliveryByTime."},"source":{"$ref":"#/components/schemas/InputMaybe_SourceId_","description":"The name of the system originating the order such as SHOPIFY, AMAZON, WEBSITE, WALMART or similar. This is a vital field if the source marketplace restricts which carriers are allowed to be used. If left blank, this will default to SHOPIFY"},"deliveryDays":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Int_","description":"Define the number of days in which this order must be delivered, counting from the date of shipment. Accepted values are limited to: 1,2,3,7."},"duties":{"$ref":"#/components/schemas/InputMaybe_DutiesInput_","description":"Duties information for an order"},"isSubscriptionOrder":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Boolean_","description":"Is this order part of a recurring subscription for the customer"},"shipMethod":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Text of ship method like 'Standard', 'UPS GROUND', etc."},"giftMessage":{"type":"string","description":"Optional field to include a gift message with the order."},"dropShipData":{"$ref":"#/components/schemas/DropshipData","description":"The drop ship data for the order."},"fulfillmentOptions":{"$ref":"#/components/schemas/FulfillmentOptions","description":"Configuration options for order fulfillment."}},"required":["address","externalOrderId","lineItems"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"AddressInput":{"properties":{"address1":{"type":"string","description":"First address line of the address."},"address2":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Second address line of the address."},"city":{"type":"string","description":"City of the address."},"company":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Company name for the entity."},"countryCode":{"type":"string","description":"Country code for the address. Ex: 'US', 'CA', 'MX'"},"email":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Email of the entity - only required for international orders."},"name":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Name of entity."},"phone":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Phone number of the entity."},"provinceCode":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"State or region of the address - if a US countryCode, must be the 2-letter state postal abbreviation."},"zip":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Postal code of the address."}},"required":["address1","city","countryCode"],"type":"object","additionalProperties":false},"OrderLineItemInput202407":{"allOf":[{"$ref":"#/components/schemas/OrderLineItemInput202401"},{"properties":{"lineItemDropShipData":{"$ref":"#/components/schemas/LineItemDropShipData","description":"The drop ship data for the line item."}},"type":"object"}]},"OrderLineItemInput202401":{"properties":{"lineItemId":{"type":"string","description":"A lineItem reference meaningful to the external system submitting the order."},"quantity":{"type":"integer","format":"int32","description":"The quantity of the product to ship for this order.","minimum":1},"logisticsSku":{"type":"string","description":"Unique line item identifier.\nThis can also be a bundle identifier."},"customsUnitValue":{"allOf":[{"$ref":"#/components/schemas/CustomsUnitValueInput"}],"nullable":true,"description":"The value of the product for customs purposes. Required for PASSPORT."}},"required":["quantity","logisticsSku"],"type":"object"},"CustomsUnitValueInput":{"properties":{"amount":{"type":"number","format":"double","description":"The value of one unit of the line item. Must be greater than zero."},"currencyCode":{"type":"string","description":"The three-letter code for the currency associated with the line item."}},"required":["amount","currencyCode"],"type":"object","additionalProperties":false},"LineItemDropShipData":{"properties":{"itemSize":{"type":"string","description":"The size of the item."},"itemColor":{"type":"string","description":"The color of the item."},"itemCredit":{"type":"number","format":"double","description":"The credit of the item."},"taxTypeCode":{"type":"string","description":"The tax type code of the item"},"itemTax":{"type":"number","format":"double","description":"The tax of the item."},"itemDiscount":{"type":"number","format":"double","description":"The discount associated with the item."},"itemSubTotalPrice":{"type":"number","format":"double","description":"The subtotal price of the item."},"itemShippingCharge":{"type":"number","format":"double","description":"The shipping charge of the item."},"itemUnitPrice":{"type":"number","format":"double","description":"The unit price of the item."},"retailerDescription":{"type":"string","description":"The retailer description."},"retailerRefNo":{"type":"string","description":"The retailer reference number."},"vendorRefNo":{"type":"string","description":"The vendor reference number."}},"type":"object"},"InputMaybe_Scalars-at-Date_":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"InputMaybe_SourceId_":{"$ref":"#/components/schemas/Maybe_SourceId_"},"InputMaybe_Scalars-at-Int_":{"$ref":"#/components/schemas/Maybe_Scalars-at-Int_"},"InputMaybe_DutiesInput_":{"$ref":"#/components/schemas/Maybe_DutiesInput_"},"Maybe_DutiesInput_":{"allOf":[{"$ref":"#/components/schemas/DutiesInput"}],"nullable":true},"DutiesInput":{"properties":{"incoterm":{"$ref":"#/components/schemas/InputMaybe_Incoterm_","description":"Incoterm value for an order  Ex: 'DDP', 'DAP'. Used for GLOBALE, MARKETS_PRO, and PASSPORT."},"merchantOfRecordAccountId":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"The merchant GUID associated with GLOBALE. Required for GLOBALE and MARKETS_PRO."},"merchantOfRecordCarrierCode":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"The carrier code used by the carrier. Used for GLOBALE, MARKETS_PRO, and PASSPORT."},"merchantOfRecordOrderId":{"type":"string","description":"The merchant order ID associated with the merchantOfRecordProvider."},"merchantOfRecordProvider":{"$ref":"#/components/schemas/MerchantOfRecordProvider","description":"The merchant of record provider for the order."},"merchantOfRecordSkuMap":{"$ref":"#/components/schemas/InputMaybe_Array_InputMaybe_MerchantOfRecordSkuMapInput___","description":"A list of DSKU to MSKU mappings. Required for PASSPORT."}},"required":["merchantOfRecordOrderId","merchantOfRecordProvider"],"type":"object","additionalProperties":false},"InputMaybe_Incoterm_":{"$ref":"#/components/schemas/Maybe_Incoterm_"},"Maybe_Incoterm_":{"allOf":[{"$ref":"#/components/schemas/Incoterm"}],"nullable":true},"Incoterm":{"type":"string","enum":["DAP","DDP","DDU"]},"MerchantOfRecordProvider":{"type":"string","enum":["GLOBALE","MARKETS_PRO","PASSPORT","SELLER"]},"InputMaybe_Array_InputMaybe_MerchantOfRecordSkuMapInput___":{"$ref":"#/components/schemas/Maybe_Array_InputMaybe_MerchantOfRecordSkuMapInput___"},"Maybe_Array_InputMaybe_MerchantOfRecordSkuMapInput___":{"items":{"$ref":"#/components/schemas/InputMaybe_MerchantOfRecordSkuMapInput_"},"type":"array","nullable":true},"InputMaybe_MerchantOfRecordSkuMapInput_":{"$ref":"#/components/schemas/Maybe_MerchantOfRecordSkuMapInput_"},"Maybe_MerchantOfRecordSkuMapInput_":{"allOf":[{"$ref":"#/components/schemas/MerchantOfRecordSkuMapInput"}],"nullable":true},"MerchantOfRecordSkuMapInput":{"properties":{"dsku":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"The logisticsSku that represents the product. It may appear across multiple MSKU mappings."},"msku":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"The marketplace SKU that links to the DSKU, specifying which marketplace product this refers to."},"quantity":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Int_","description":"The number of units of DSKU associated with the MSKU."}},"type":"object","additionalProperties":false},"DropshipData":{"properties":{"shipMethod":{"type":"string","description":"The shipping method to be used/included on the pack slip."},"billingAddress":{"$ref":"#/components/schemas/Address","description":"The billing address."},"retailerPurchaseOrderNo":{"type":"string","description":"The retailer purchase order number."},"barCode":{"type":"string","description":"The barcode."},"customerOrderDate":{"type":"string","description":"The customer order date in ISO 8601 format."},"customerOrderNo":{"type":"string","description":"The customer order number."},"customMessage":{"type":"string","description":"The custom message to be included on the pack slip."},"messageFrom":{"type":"string","description":"The source of the custom message"},"messageTo":{"type":"string","description":"The target of the custom message"},"reserved1":{"type":"string","description":"Reserved field 1."},"reserved2":{"type":"string","description":"Reserved field 2."},"discountPercent":{"type":"number","format":"double","description":"The discount percentage for the order"},"taxCode1":{"type":"string","description":"Tax code 1 for the order"},"taxPercentage1":{"type":"number","format":"double","description":"Tax percentage 1 for the order"},"taxCode2":{"type":"string","description":"Tax code 2 for the order"},"taxPercentage2":{"type":"number","format":"double","description":"Tax percentage 2 for the order"},"returnAddress":{"$ref":"#/components/schemas/Address","description":"The return address."},"returnMessage":{"type":"string","description":"Instructions for the return of the order."},"warehouseIds":{"items":{"type":"string"},"type":"array","description":"The warehouseIds to use for the order."},"paymentMethod":{"type":"string","description":"The payment method used for the order."}},"type":"object","additionalProperties":false},"FulfillmentOptions":{"properties":{"skipAddressValidation":{"type":"boolean","description":"Bypasses Flexport's address validation process when set to true.\n\nThis feature is restricted to approved merchants who have verified they have advanced address validation systems. Contact your Flexport team to request this capability.\nEven when enabled, basic address validation checks (e.g. street address character length) will still be enforced to ensure the shipping address meets minimum requirements to successfully print a shipping label."}},"type":"object","additionalProperties":false},"OrderModelV2":{"allOf":[{"$ref":"#/components/schemas/Omit_OrderModel202407.dropshipDetails-or-shipments_"},{"properties":{"shipments":{"anyOf":[{"items":{"$ref":"#/components/schemas/FulfillmentShipmentModel"},"type":"array"},{"items":{"$ref":"#/components/schemas/ReplenishmentShipmentV2"},"type":"array"}]},"dropshipDetails":{"$ref":"#/components/schemas/OrderDropshipDetails202510"}},"required":["shipments"],"type":"object"}]},"Omit_OrderModel202407.dropshipDetails-or-shipments_":{"$ref":"#/components/schemas/Pick_OrderModel202407.Exclude_keyofOrderModel202407.dropshipDetails-or-shipments__","description":"Construct a type with the properties of T except for those in type K."},"Pick_OrderModel202407.Exclude_keyofOrderModel202407.dropshipDetails-or-shipments__":{"properties":{"address":{"$ref":"#/components/schemas/Address"},"cost":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_","description":"A fulfillment order's cost"},"id":{"type":"string","description":"A globally-unique identifier."},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was created."},"updatedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was last modified."},"error":{"$ref":"#/components/schemas/Maybe_OrderError_"},"deliveredAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the entire fulfillment order\n    (all packages) were reported as completing delivery to the buyer."},"externalOrderId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"A unique order reference meaningful to the external system submitting the order."},"lineItems":{"items":{"$ref":"#/components/schemas/OrderLineItem"},"type":"array","description":"A list of the fulfillment order's line items."},"promisedDeliveryByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should arrive at\nthe buyer's address, based on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and after promisedShipByTime."},"promisedShipByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should ship by,\nbased on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and before promisedDeliveryByTime."},"shippedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the fulfillment order was reported as shipped to the buyer."},"source":{"$ref":"#/components/schemas/Maybe_SourceId_","description":"The name of the system originating the order such as SHOPIFY, AMAZON, WEBSITE, WALMART or similar. This is a vital field if the source marketplace restricts which carriers are allowed to be used."},"state":{"$ref":"#/components/schemas/OrderState"},"giftMessage":{"type":"string"}},"required":["address","id","lineItems","state"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"ReplenishmentShipmentV2":{"properties":{"status":{"$ref":"#/components/schemas/ShipmentStatus","description":"Shipment status"},"externalChannelShipmentId":{"type":"string","description":"Shipment ID of the external channel where the order is being sent"},"externalChannelReferenceNumber":{"type":"string","description":"Reference number of the external channel where the order is being sent"},"shipmentId":{"type":"string","description":"Shipment Id of the shipment"},"shipmentChargedWeight":{"type":"number","format":"double","description":"Total weight of all items in the shipment (which are billed)."},"shipmentChargedWeightUnit":{"$ref":"#/components/schemas/WeightUnit","description":"Unit of measure for shipment charged weight"},"shipFromAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"Address from where the shipment being sent"},"shipToAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"Address where the shipment is being sent"},"transportationDetails":{"$ref":"#/components/schemas/TransportationDetails","description":"Transportation details of shipment"},"packDetails":{"items":{"$ref":"#/components/schemas/PackDetails"},"type":"array","description":"Tracking details of the shipment when shipping type is PARCEL"},"freightDetails":{"items":{"$ref":"#/components/schemas/FreightDetails"},"type":"array","description":"Tracking details of the shipment for Freight Orders (LTL, FTL)"},"shipmentItems":{"items":{"$ref":"#/components/schemas/ReplenishmentShipmentItemV2"},"type":"array","description":"Items in the shipment"}},"required":["status","shipmentId","shipmentChargedWeight","shipmentChargedWeightUnit","transportationDetails","shipmentItems"],"type":"object","additionalProperties":false},"DeliverrAddress":{"properties":{"name":{"type":"string"},"company":{"type":"string"},"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"zip":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"isResidential":{"type":"boolean"}},"required":["name","street1","city","zip","state","country"],"type":"object","additionalProperties":false},"TransportationDetails":{"description":"Transportation details per order.","properties":{"shippingPartner":{"$ref":"#/components/schemas/PartnerV2","description":"FLEXPORT, THIRD_PARTY, RECEIVER, COLLECT, SELLER is supported"},"shippingType":{"$ref":"#/components/schemas/ShippingType","description":"Type of shipping eg LTL, FTL, PARCEL"},"carrierAccountDetails":{"$ref":"#/components/schemas/CarrierAccountDetails","description":"Carrier account details of the carrier. Required if shipping THIRD_PARTY, RECEIVER or COLLECT"},"duties":{"$ref":"#/components/schemas/Duties","description":"Duties related data tied to the shipment"},"shippingMethod":{"$ref":"#/components/schemas/ShippingMethod","description":"Shipping method for the shipment (e.g. `UPS.GROUND`, `FEDEX.GROUND`). Takes precedence over `shippingSpeed` when both are provided."},"shippingSpeed":{"$ref":"#/components/schemas/ShippingSpeed","description":"Specifies the delivery speed option for orders fulfilled through Flexport's parcel shipping service.\nNotes:\n1. Shipping speed affects final delivery cost.\n2. Not all speeds may be available for all destinations."}},"required":["shippingPartner"],"type":"object","additionalProperties":false},"PartnerV2":{"description":"Partner from which you have booked freight","enum":["FLEXPORT","THIRD_PARTY","RECEIVER","COLLECT","SELLER"],"type":"string"},"ShippingType":{"enum":["LTL","FTL","PARCEL"],"type":"string"},"CarrierAccountDetails":{"properties":{"carrierName":{"type":"string","description":"Carrier name. Only UPS and FEDEX supported for now."},"carrierAccountId":{"type":"string","description":"Carrier account identifier of the carrier"},"country":{"type":"string","description":"Country of the registered carrier account"},"postalCode":{"type":"string","description":"Postal code of the registered carrier account"}},"required":["carrierName"],"type":"object","additionalProperties":false},"Duties":{"properties":{"dutyPaymentAccountDetails":{"$ref":"#/components/schemas/DutyPaymentAccountDetails","description":"Duty payment account details of the carrier. Required if shipping internationally and incoterm is DDP"},"incoterm":{"$ref":"#/components/schemas/Incoterm","description":"Incoterm for international shipments (DAP/DDP)"},"eelPfc":{"type":"string","description":"EEL/PFC Number associated with the shipment if the shipment exceeds $2500USD in value and is bound to countries other than US or Canada"}},"type":"object","additionalProperties":false},"DutyPaymentAccountDetails":{"properties":{"carrierName":{"type":"string","description":"Carrier name. Only UPS and FEDEX supported for now."},"dutyPaymentAccountId":{"type":"string","description":"Duty payment account identifier of the carrier"},"country":{"type":"string","description":"Country of the registered duty payment account"},"postalCode":{"type":"string","description":"Postal code of the registered duty payment account"}},"required":["carrierName"],"type":"object","additionalProperties":false},"ShippingMethod":{"type":"string"},"ShippingSpeed":{"enum":["ONE_DAY","TWO_DAY","THREE_DAY","STANDARD"],"type":"string"},"PackDetails":{"description":"Details of the packages as part of the shipment","properties":{"packItems":{"items":{"$ref":"#/components/schemas/PackItem"},"type":"array"},"carrierName":{"type":"string","description":"Name of the carrier through which the order is being sent"},"carrierSCAC":{"type":"string","description":"Standard Carrier Alpha Code of Carrier"},"trackingNumber":{"type":"string","description":"Tracking number of the carrier"},"packageStatus":{"$ref":"#/components/schemas/PackageStatus","description":"Status of the package"},"sscc":{"type":"string","description":"Serial Shipping Container Code of the shipment container"},"packDims":{"$ref":"#/components/schemas/BoxDimensions","description":"Dimensions of shipment box"},"boxId":{"type":"string","description":"Id of the shipment box"}},"type":"object","additionalProperties":false},"PackItem":{"description":"Represent pack items","properties":{"logisticsSku":{"type":"string","description":"Logistics sku of shipment"},"quantity":{"type":"number","format":"double","description":"Quantity of the item of sku sent"},"quantityUOM":{"$ref":"#/components/schemas/QuantityUom","description":"Unit of measure of the qty included, can be either EACH or CASE"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"QuantityUom":{"enum":["EACH","CASE"],"type":"string"},"PackageStatus":{"enum":["PRE_TRANSIT","IN_TRANSIT","OUT_FOR_DELIVERY","DELIVERED","RETURN_INITIATED","RETURN_COMPLETED","FAILURE","CANCELLED","UNKNOWN"],"type":"string"},"BoxDimensions":{"properties":{"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"lengthUnit":{"$ref":"#/components/schemas/LengthUnit"},"weight":{"type":"number","format":"double"},"weightUnit":{"$ref":"#/components/schemas/WeightUnit"}},"required":["length","width","height","lengthUnit","weight","weightUnit"],"type":"object","additionalProperties":false},"FreightDetails":{"description":"Details of freight as part of the shipment","properties":{"bolId":{"type":"string","description":"Bill of Lading ID - a unique identifier for the shipping document that serves as a receipt of freight services and a contract of carriage"},"proNumber":{"type":"string","description":"PRO Number, a unique identifier assigned by the carrier"},"carrierName":{"type":"string","description":"Name of the carrier through which the order is being sent"},"carrierSCAC":{"type":"string","description":"Standard Carrier Alpha Code of Carrier"}},"type":"object","additionalProperties":false},"ReplenishmentShipmentItemV2":{"properties":{"logisticsSku":{"type":"string","description":"Logistics sku of the product"},"quantity":{"type":"number","format":"double","description":"Total expected units of the product to be sent"},"shippedQuantity":{"type":"number","format":"double","description":"Total units shipped for this item. Present only for PARCEL shipments after status is SHIPPED."},"quantityUOM":{"$ref":"#/components/schemas/QuantityUom","description":"Unit of measure of the qty included, can be either EACH or CASE"},"quantityPerPack":{"type":"number","format":"double","description":"Quantity per pack"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the outbound"},"lotNumber":{"type":"string","description":"Lot number assigned to the product by seller"},"unitPrice":{"type":"number","format":"double","description":"Price associated with each unit of product"},"totalPrice":{"type":"number","format":"double","description":"Total price of all units of product (totalPrice = unitPrice * quantity)"},"discount":{"type":"number","format":"double","description":"Absolute value of discount given by seller on all units of product (not in percentage)"}},"required":["logisticsSku","quantity","quantityPerPack"],"type":"object","additionalProperties":false},"OrderDropshipDetails202510":{"$ref":"#/components/schemas/Omit_OrderDropshipDetails.orderId_"},"Omit_OrderDropshipDetails.orderId_":{"$ref":"#/components/schemas/Pick_OrderDropshipDetails.Exclude_keyofOrderDropshipDetails.orderId__","description":"Construct a type with the properties of T except for those in type K."},"Pick_OrderDropshipDetails.Exclude_keyofOrderDropshipDetails.orderId__":{"properties":{"warehouseId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"shipMethod":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"barCode":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"billingAddress":{"$ref":"#/components/schemas/Maybe_Address_"},"customMessage":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"customerOrderDate":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"customerOrderNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"lineItemData":{"$ref":"#/components/schemas/DropshipLineItemRecord"},"paymentMethod":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"reserved1":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"reserved2":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"retailerPurchaseOrderNo":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"},"returnAddress":{"$ref":"#/components/schemas/Maybe_Address_"},"returnMessage":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_"}},"required":["lineItemData"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"ExternalOrderIdType":{"type":"string","description":"A unique order reference meaningful to the external system submitting the order."},"OrderModel":{"properties":{"address":{"$ref":"#/components/schemas/Address"},"cost":{"$ref":"#/components/schemas/Maybe_Scalars-at-Float_","description":"A fulfillment order's cost"},"id":{"type":"string","description":"A globally-unique identifier."},"createdAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was created."},"updatedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) when the fulfillment was last modified."},"error":{"$ref":"#/components/schemas/Maybe_OrderError_"},"deliveredAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the entire fulfillment order\n    (all packages) were reported as completing delivery to the buyer."},"externalOrderId":{"$ref":"#/components/schemas/Maybe_Scalars-at-String_","description":"A unique order reference meaningful to the external system submitting the order."},"lineItems":{"items":{"$ref":"#/components/schemas/OrderLineItem"},"type":"array","description":"A list of the fulfillment order's line items."},"promisedDeliveryByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should arrive at\nthe buyer's address, based on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and after promisedShipByTime."},"promisedShipByTime":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) the packages in this fulfillment order should ship by,\nbased on expectations given to customers or set by the originating marketplace.\nThis date and time needs to be in the future and before promisedDeliveryByTime."},"shippedAt":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_","description":"The date and time (ISO 8601 format) that the fulfillment order was reported as shipped to the buyer."},"source":{"$ref":"#/components/schemas/Maybe_SourceId_","description":"The name of the system originating the order such as SHOPIFY, AMAZON, WEBSITE, WALMART or similar. This is a vital field if the source marketplace restricts which carriers are allowed to be used."},"state":{"$ref":"#/components/schemas/OrderState"},"shipments":{"items":{"$ref":"#/components/schemas/FulfillmentShipmentModel"},"type":"array"}},"required":["address","id","lineItems","state","shipments"],"type":"object","additionalProperties":false},"OrderIdType":{"type":"string","description":"A unique identifier for this order.","pattern":"^\\d+$"},"RetryOrderBody":{"properties":{"options":{"$ref":"#/components/schemas/RetryOrderOptions"}},"type":"object"},"RetryOrderOptions":{"properties":{"skipAddressValidation":{"type":"boolean"}},"type":"object"},"UpdateOrderInput":{"properties":{"address":{"$ref":"#/components/schemas/InputMaybe_AddressInput_"},"lineItems":{"$ref":"#/components/schemas/InputMaybe_Array_OrderLineItemInput__"}},"type":"object","additionalProperties":false},"InputMaybe_AddressInput_":{"$ref":"#/components/schemas/Maybe_AddressInput_"},"Maybe_AddressInput_":{"allOf":[{"$ref":"#/components/schemas/AddressInput"}],"nullable":true},"InputMaybe_Array_OrderLineItemInput__":{"$ref":"#/components/schemas/Maybe_Array_OrderLineItemInput__"},"Maybe_Array_OrderLineItemInput__":{"items":{"$ref":"#/components/schemas/OrderLineItemInput"},"type":"array","nullable":true},"OrderLineItemInput":{"properties":{"customsUnitValue":{"$ref":"#/components/schemas/InputMaybe_CustomsUnitValueInput_","description":"The value of the product for customs purposes. Required for PASSPORT."},"lineItemId":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"A lineItem reference meaningful to the external system submitting the order."},"logisticsSku":{"type":"string","description":"Unique line item identifier."},"quantity":{"type":"number","format":"double","description":"The quantity of the product to ship for this order."}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"InputMaybe_CustomsUnitValueInput_":{"$ref":"#/components/schemas/Maybe_CustomsUnitValueInput_"},"Maybe_CustomsUnitValueInput_":{"allOf":[{"$ref":"#/components/schemas/CustomsUnitValueInput"}],"nullable":true},"LabelGenerationJobRequest":{"properties":{"integrationChannelId":{"$ref":"#/components/schemas/IntegrationChannelId","description":"Integration channel that the new orders will be ingested from.\nExample: \"shipstation\""},"estimatedOrderCount":{"type":"number","format":"double","description":"Estimated number of new orders to be purchased in this label generation job."}},"required":["integrationChannelId","estimatedOrderCount"],"type":"object","additionalProperties":false},"IntegrationChannelId":{"type":"string","enum":["shipstation"],"nullable":false},"CreateParcelAPIResponse":{"properties":{"status":{"$ref":"#/components/schemas/ParcelApiStatus","description":"The status of the parcel.\n(e.g. OK, ERROR)"},"parcelId":{"type":"string","description":"Unique ID used to track the parcel, returned after acquiring a purchase label."},"price":{"type":"number","format":"double","description":"The price of the parcel."},"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"trackingCode":{"type":"string","description":"The tracking code for the package."},"carrierCode":{"type":"string","description":"The carrier code for the package."},"packageTrackingUrl":{"type":"string","description":"URL that can be used to track the package."},"shippingLabelUrl":{"type":"string","description":"URL used to download the shipping label data."},"customerReferenceId":{"type":"string","description":"An identifier meaningful to the seller."},"customerCustomField":{"type":"string","description":"An optional field that has additional information about the parcel provided by the caller."},"flexportTrackingUrl":{"type":"string","description":"URL that can be used to track a package end-to-end through Flexport and final-mile partner networks."},"carrierBarcode":{"type":"string","description":"Carrier barcode is the exact barcode which is on the physical label that is scanned."}},"required":["status","parcelId","price","serviceLevel","trackingCode","carrierCode","packageTrackingUrl","shippingLabelUrl","customerReferenceId"],"type":"object","additionalProperties":false},"ParcelApiStatus":{"enum":["OK","ERROR"],"type":"string"},"CreateParcelRequestV3":{"$ref":"#/components/schemas/CreateParcelRequest"},"CreateParcelRequest":{"properties":{"customerParcelId":{"type":"string","description":"An identifier meaningful to the seller."},"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"injectionLocation":{"type":"string","description":"The origin Flexport sortation center."},"shipToAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"The delivery address for the parcel."},"returnAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"The return address for the parcel."},"skipAddressValidation":{"type":"boolean","description":"If true, the correctness of the address will not be verified."},"pickupDateTime":{"type":"string","format":"date-time","description":"The date the parcel will be picked up for injection\ninto a Flexport sortation center."},"dimensions":{"$ref":"#/components/schemas/ParcelDimensions","description":"The dimensions and weight of the parcel."},"customerCustomField":{"type":"string","description":"An optional field that has additional information about the parcel provided by the caller."},"labelFormat":{"$ref":"#/components/schemas/ShippingLabelFormatParcel","description":"The format of the shipping label.\n(e.g. PDF, PNG, or ZPL)"},"isReturn":{"type":"boolean","description":"If true, the parcel delivers to the return address."},"marketplace":{"type":"string","description":"The marketplace integration for the parcel.\n(e.g. AMAZON, EBAY, WALMART)"},"customLabelFooterFields":{"$ref":"#/components/schemas/CustomLabelFooterFields","description":"Additional information to be included on\nthe shipping label."},"customsInformation":{"$ref":"#/components/schemas/ParcelCustomsInformation","description":"Customs information is required for each item\nin a parcel with an International delivery address."},"packslipNotes":{"type":"string","description":"The packslip notes to be included with a label.\nPackslip notes will be printed on a separate sheet."}},"required":["shipToAddress","dimensions"],"type":"object","additionalProperties":false},"ParcelDimensions":{"properties":{"height":{"type":"number","format":"double","example":5},"length":{"type":"number","format":"double","example":2},"lengthUnit":{"$ref":"#/components/schemas/LengthUnit","example":"in"},"weight":{"type":"number","format":"double","example":1},"weightUnit":{"$ref":"#/components/schemas/WeightUnit","example":"lb"},"width":{"type":"number","format":"double","example":8}},"required":["height","length","lengthUnit","weight","weightUnit","width"],"type":"object","additionalProperties":false},"ShippingLabelFormatParcel":{"anyOf":[{"$ref":"#/components/schemas/ShippingLabelFormat"},{"type":"string","enum":["PDF"]}]},"ShippingLabelFormat":{"type":"string","enum":["PNG","ZPL203"]},"CustomLabelFooterFields":{"properties":{"customLabelFooter1":{"type":"string","description":"A custom field that can be used to define a string to be placed in the footer of the shipping label.","minLength":1,"maxLength":25},"customLabelFooter2":{"type":"string","description":"A custom field that can be used to define a string to be placed in the footer of the shipping label.","minLength":1,"maxLength":25}},"required":["customLabelFooter1"],"type":"object","additionalProperties":false},"ParcelCustomsInformation":{"properties":{"customsItems":{"items":{"$ref":"#/components/schemas/ParcelCustomsInformationItems"},"type":"array"}},"required":["customsItems"],"type":"object","additionalProperties":false},"ParcelCustomsInformationItems":{"properties":{"code":{"type":"string","description":"The product SKU for the item."},"description":{"type":"string","description":"A description of the item."},"quantity":{"type":"number","format":"double","description":"The quantity of the item."},"weight":{"type":"number","format":"double","description":"The weight of the item."},"weightUnit":{"$ref":"#/components/schemas/WeightUnit","description":"The unit of weight for the item."},"value":{"type":"number","format":"double","description":"The value of the item in USD."},"hsTariffCode":{"type":"string","description":"The HS tariff code for the item."},"originCountry":{"$ref":"#/components/schemas/CountryCode","description":"The origin country of the item."}},"required":["code","description","quantity","weight","weightUnit","value","hsTariffCode","originCountry"],"type":"object","additionalProperties":false},"CancelParcelRequest":{"properties":{"parcelId":{"type":"string","description":"The Flexport parcel ID to cancel."}},"required":["parcelId"],"type":"object","additionalProperties":false},"ParcelTrackingAPIGetResponse":{"properties":{"parcelId":{"type":"string","description":"Unique ID used to track the parcel, returned after acquiring a purchase label."},"customerReferenceId":{"type":"string","description":"An identifier meaningful to the seller."},"customerCustomField":{"type":"string","description":"An optional field that has additional information about the parcel provided by the caller."},"status":{"$ref":"#/components/schemas/ParcelApiStatus","description":"The status of the parcel.\n(e.g. OK, ERROR)"},"errors":{"type":"string","description":"An error code if the status is ERROR."},"errorMessage":{"type":"string","description":"An error message if the status is ERROR."},"packageTrackingUrl":{"type":"string","description":"URL that can be used to track the package."},"shippingLabelUrl":{"type":"string","description":"URL used to download the shipping label data."},"trackingCode":{"type":"string","description":"The tracking code for the package."},"carrierCode":{"type":"string","description":"The carrier code for the package."},"carrierBarcode":{"type":"string","description":"Carrier barcode is the exact barcode which is on the physical label that is scanned. In some cases it's prefix+trackingCode so sending it as a separate field"},"eventTimestamps":{"$ref":"#/components/schemas/TrackingResultTimestamps","description":"The tracking event timestamps."},"expiredTrackingData":{"items":{"$ref":"#/components/schemas/ExpiredTrackingData"},"type":"array","description":"Canceled tracking data for repurchased parcels."},"flexportTrackingUrl":{"$ref":"#/components/schemas/URL","description":"URL that can be used to track a package end-to-end through Flexport and final-mile partner networks."}},"required":["status","eventTimestamps"],"type":"object","additionalProperties":false},"TrackingResultTimestamps":{"properties":{"labelTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when a label was printed for the package."},"arrivalScanTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of the arrival scan."},"sortationArrivalTime":{"type":"string","format":"date-time","nullable":true,"description":"This is the time at which the parcel is scanned at the sortation center."},"facilityTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when the package arrived at the facility."},"attemptedDeliveryTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when delivery was attempted for the package."},"deliveryTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when the package was delivered."},"estimatedDeliveryTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when the package is expected to be delivered."},"promisedDeliveryTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when the package is promised to be delivered."},"lastTrackingEventTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of the last tracking event for the package."},"lastTrackingIngestionTime":{"type":"string","format":"date-time","nullable":true,"description":"UTC timestamp of when the last tracking event for the package was ingested."}},"required":["labelTime","arrivalScanTime","facilityTime","attemptedDeliveryTime","deliveryTime","estimatedDeliveryTime","lastTrackingEventTime","lastTrackingIngestionTime"],"type":"object","additionalProperties":false},"ExpiredTrackingData":{"properties":{"labelId":{"type":"string","description":"Unique ID for the label."},"trackingCode":{"type":"string","description":"The tracking code for the package."},"shippingLabelUrl":{"type":"string","description":"URL used to download the label data."},"packageTrackingUrl":{"type":"string","description":"URL that can be used to track the package through a final-mile partner network."},"shippingMethod":{"$ref":"#/components/schemas/ShippingMethod","description":"The shipping method used to ship the package."}},"type":"object","additionalProperties":false},"URL":{"type":"string","description":"The URL interface represents an object providing static methods used for creating object URLs.\n`URL` class is a global reference for `import { URL } from 'node:url'`\nhttps://nodejs.org/api/url.html#the-whatwg-url-api"},"ParcelQuoteAPIResponse":{"properties":{"price":{"type":"number","format":"double","description":"The price of the parcel delivery."},"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"billedWeightLbs":{"type":"number","format":"double","description":"The billed weight in pounds (based on\nthe dimensions and weight of the parcel)."},"dimensions":{"$ref":"#/components/schemas/ParcelDimensions","description":"The dimensions and weight of the parcel."},"warnings":{"items":{"type":"string"},"type":"array","description":"Warnings (e.g. Unable to verify if address is valid)"}},"required":["price","serviceLevel","billedWeightLbs","dimensions","warnings"],"type":"object","additionalProperties":false},"CreateQuoteRequestV2":{"$ref":"#/components/schemas/CreateQuoteRequest"},"CreateQuoteRequest":{"properties":{"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"injectionLocation":{"type":"string","description":"The origin Flexport sortation center."},"shipToAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"The delivery address for the parcel."},"dimensions":{"$ref":"#/components/schemas/ParcelDimensions","description":"The dimensions and weight of the parcel."}},"required":["serviceLevel","shipToAddress","dimensions"],"type":"object","additionalProperties":false},"BulkParcelJobAPIResponse":{"properties":{"jobId":{"type":"number","format":"double","description":"Id associated with bulk parcel job"},"status":{"type":"string","description":"Status of the bulk parcel job\n(e.g. CREATING, COMPLETED, PARTIALLY_COMPLETED, FAILED)"},"labelsUrl":{"type":"string","description":"The URL incorporating the specified labels generated"},"parcels":{"items":{"$ref":"#/components/schemas/BulkParcelJobParcel"},"type":"array","description":"Compilation of parcels generated via the bulk job"}},"required":["jobId","status"],"type":"object","additionalProperties":false},"BulkParcelJobParcel":{"properties":{"status":{"$ref":"#/components/schemas/ParcelApiStatus","description":"The status of the parcel.\n(e.g. OK, ERROR)"},"parcelId":{"type":"string","description":"Unique ID used to track the parcel, returned after acquiring a purchase label."},"price":{"type":"number","format":"double","description":"The price of the parcel."},"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"trackingCode":{"type":"string","description":"The tracking code for the package."},"carrierCode":{"type":"string","description":"The carrier code for the parcel"},"packageTrackingUrl":{"type":"string","description":"URL that can be used to track the package."},"shippingLabelUrl":{"type":"string","description":"URL used to download the shipping label data."},"customerReferenceId":{"type":"string","description":"An identifier meaningful to the seller."},"customerCustomField":{"type":"string","description":"An optional field that has additional information about the parcel provided by the caller."},"flexportTrackingUrl":{"type":"string","description":"URL that can be used to track a package end-to-end through Flexport and final-mile partner networks."},"carrierBarcode":{"type":"string","description":"Carrier barcode is the exact barcode which is on the physical label that is scanned."},"integrationChannelParcelId":{"type":"string","description":"The parcel ID linked to the integration channel (e.g., ShipStation)"},"trackingNumber":{"type":"string","description":"The tracking number associated with the parcel"},"shipDate":{"type":"string","format":"date-time","description":"The shipping date of the parcel"},"parcelStatus":{"type":"string","description":"The current status of the parcel"},"errorMessages":{"type":"string","description":"An error message if the status is ERROR."}},"required":["status","parcelId","price","serviceLevel","trackingCode","carrierCode","packageTrackingUrl","shippingLabelUrl","customerReferenceId","integrationChannelParcelId","trackingNumber","shipDate","parcelStatus","errorMessages"],"type":"object","additionalProperties":false},"CreateBulkParcelJobRequest":{"$ref":"#/components/schemas/BulkParcelJobRequest"},"BulkParcelJobRequest":{"properties":{"parcels":{"items":{"$ref":"#/components/schemas/BulkParcelRequest"},"type":"array"},"packslipRequired":{"type":"boolean","description":"If true, packslip notes should be included in the parcel request."}},"required":["parcels","packslipRequired"],"type":"object","additionalProperties":false},"BulkParcelRequest":{"properties":{"customerParcelId":{"type":"string","description":"An identifier meaningful to the seller."},"serviceLevel":{"type":"string","description":"The level of service selected for parcel delivery.\n(e.g. Standard, Expedited, International)"},"injectionLocation":{"type":"string","description":"The origin Flexport sortation center."},"shipToAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"The delivery address for the parcel."},"returnAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"The return address for the parcel."},"skipAddressValidation":{"type":"boolean","description":"If true, the correctness of the address will not be verified."},"pickupDateTime":{"type":"string","format":"date-time","description":"The date the parcel will be picked up for injection\ninto a Flexport sortation center."},"dimensions":{"$ref":"#/components/schemas/ParcelDimensions","description":"The dimensions and weight of the parcel."},"customerCustomField":{"type":"string","description":"An optional field that has additional information about the parcel provided by the caller."},"labelFormat":{"$ref":"#/components/schemas/ShippingLabelFormatParcel","description":"The format of the shipping label.\n(e.g. PDF, PNG, or ZPL)"},"isReturn":{"type":"boolean","description":"If true, the parcel delivers to the return address."},"marketplace":{"type":"string","description":"The marketplace integration for the parcel.\n(e.g. AMAZON, EBAY, WALMART)"},"customLabelFooterFields":{"$ref":"#/components/schemas/CustomLabelFooterFields","description":"Additional information to be included on\nthe shipping label."},"customsInformation":{"$ref":"#/components/schemas/ParcelCustomsInformation","description":"Customs information is required for each item\nin a parcel with an International delivery address."},"packslipNotes":{"type":"string","description":"The packslip notes to be included with a label.\nPackslip notes will be printed on a separate sheet."},"integrationChannel":{"type":"string","description":"The integration channel generating the request.\n(e.g. shipstation)"}},"required":["shipToAddress","dimensions","serviceLevel"],"type":"object","additionalProperties":false},"CreateMasterCartonResponse":{"properties":{"injectionLocation":{"type":"string","description":"The location where the master carton was injected."},"barcodes":{"items":{"$ref":"#/components/schemas/MasterCartonResponseData"},"type":"array","description":"The list of master carton label barcodes along with the download url"},"bulkMasterCartonLabelUrl":{"type":"string","description":"The label url for downloading the bulk master carton labels at once"}},"required":["injectionLocation","barcodes","bulkMasterCartonLabelUrl"],"type":"object","additionalProperties":false},"MasterCartonResponseData":{"properties":{"masterCartonBarcode":{"type":"string"},"labelUrl":{"type":"string"}},"required":["masterCartonBarcode","labelUrl"],"type":"object","additionalProperties":false},"CreateMasterCartonRequest":{"properties":{"numBarcodes":{"type":"number","format":"double","description":"The number of master carton labels required"},"injectionLocation":{"type":"string","description":"The origin Flexport sortation center."}},"required":["numBarcodes","injectionLocation"],"type":"object","additionalProperties":false},"MasterCartonLinkParcelResponse":{"properties":{"masterCartonBarcode":{"type":"string","description":"The master carton barcode"},"failedParcels":{"items":{"$ref":"#/components/schemas/FailedParcelsData"},"type":"array","description":"The list of failed parcels along with reasons for which linking failed"},"flexId":{"type":"string","description":"The optional flex id field"}},"required":["masterCartonBarcode","failedParcels"],"type":"object","additionalProperties":false},"FailedParcelsData":{"properties":{"parcelId":{"type":"string"},"trackingCode":{"type":"string"},"error":{"type":"string"}},"required":["parcelId","trackingCode","error"],"type":"object","additionalProperties":false},"MasterCartonLinkParcelRequest":{"properties":{"masterCartonBarcode":{"type":"string","description":"The master carton barcode to which tracking codes need to be linked"},"flexId":{"type":"string","description":"The optional flexId field linked with the parcels"},"parcelTrackingCodes":{"items":{"type":"string"},"type":"array","description":"The list of tracking codes to be linked to the master carton"}},"required":["masterCartonBarcode","parcelTrackingCodes"],"type":"object","additionalProperties":false},"ApiProductResponse":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"logisticsSku":{"$ref":"#/components/schemas/ProductIdType"},"merchantSku":{"$ref":"#/components/schemas/SkuType"},"barcodes":{"items":{"type":"string"},"type":"array","description":"The list of associated barcodes for this product."},"dimensions":{"$ref":"#/components/schemas/Dimension"},"international":{"$ref":"#/components/schemas/CustomsInput","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping."},"dimsLocked":{"type":"boolean","description":"**true** if the dimensions and weight of the item are verified and trusted.\nMust be true for non-zero inventory levels to be reported. If true, item dimensions\nand weight can no longer be updated via the API."},"createdAt":{"$ref":"#/components/schemas/CreationDate"},"updatedAt":{"$ref":"#/components/schemas/UpdatedDate"}},"required":["name","logisticsSku","merchantSku","barcodes","dimsLocked"],"type":"object","additionalProperties":false},"Dimension":{"properties":{"weight":{"type":"number","format":"double","description":"Weight of the product by itself."},"weightUnit":{"$ref":"#/components/schemas/WeightUnit"},"height":{"type":"number","format":"double","description":"Height of the product by itself."},"width":{"type":"number","format":"double","description":"Width of the product by itself."},"length":{"type":"number","format":"double","description":"Length of the product by itself."},"lengthUnit":{"$ref":"#/components/schemas/LengthUnit"}},"required":["weight","weightUnit","height","width","length","lengthUnit"],"type":"object","additionalProperties":false},"CustomsInput":{"properties":{"originCountry":{"$ref":"#/components/schemas/CountryCode","description":"The 2-letter IANA code for the product's country of origin.\nNeeded only for international shipping."},"tariffCode":{"type":"string","description":"Harmonized tariff code. Needed only for international shipping.","pattern":"^[0-9]{10}$"},"customsValue":{"type":"number","format":"double","description":"The value of one unit of this product in USD for the purpose of customs declaration.\nNeeded only for international shipping.","minimum":0.01},"description":{"type":"string","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping.","minLength":1,"maxLength":255}},"required":["originCountry","tariffCode","customsValue","description"],"type":"object","additionalProperties":false},"UpdatedDate":{"type":"string","format":"date-time","description":"The timestamp when last updated in RFC 3339 format.\ne.g. 2017-07-21T17:32:28Z"},"CreateProductModel":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"merchantSku":{"$ref":"#/components/schemas/SkuType"},"customsInformation":{"$ref":"#/components/schemas/CustomsInput","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping."},"dimensions":{"$ref":"#/components/schemas/Dimension"},"barcodes":{"items":{"type":"string"},"type":"array","description":"The barcodes field is an optional array that allows to associate multiple (max 4) barcode identifiers with a product."}},"required":["name","merchantSku"],"type":"object","additionalProperties":false},"ApiProductAliasesResponse":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"aliases":{"items":{"$ref":"#/components/schemas/AliasType"},"type":"array","description":"An array of objects containing 3 aliases for a given product: merchantSku, channelProductId, and channelId."}},"required":["name","aliases"],"type":"object","additionalProperties":false},"AliasType":{"description":"An object containing 3 aliases for a given product: merchantSku, channelProductId, and channelId.","properties":{"merchantSku":{"$ref":"#/components/schemas/SkuType"},"channelProductId":{"$ref":"#/components/schemas/ExternalProductIdType"},"channelId":{"$ref":"#/components/schemas/ChannelIdType"}},"required":["merchantSku","channelProductId","channelId"],"type":"object","additionalProperties":false},"ExternalProductIdType":{"type":"string","description":"A permanent unique reference for this product generated by and meaningful to the API user.\nThis value will be used when sending orders to identify the product to ship, when reporting\nproducts shipped, and when reporting inventory levels or updates. This value should be chosen\nto represent a PHYSICAL product in the external system, not a virtual product, bundle or kit,\nunless the bundle or kit is inbounded as a single barcoded product. This value must be unique\namong all products created via API.","minLength":1,"maxLength":255},"ChannelIdType":{"type":"string","description":"The name of the channel which the specified product is being sold on (e.g. WALMARTDIRECT or AMAZON or SHOPIFY)"},"ApiInventoryResponse":{"properties":{"logisticsSku":{"$ref":"#/components/schemas/ProductIdType"},"onHand":{"type":"integer","format":"int32","description":"The calculation of on-hand quantity, non-Pickable quantity, and in-transfer quantity,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"available":{"type":"integer","format":"int32","description":"The number of units available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"unavailable":{"type":"integer","format":"int32","description":"The number of units not available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"unitsPerPack":{"type":"number","format":"double","description":"The number of units contained in a single pack.\n\nFor bundles: represents the quantity of this component SKU required to fulfill one bundle.\nFor example, if a bundle requires 3 units of SKU-A, unitsPerPack would be 3.\n\nFor case packs: represents the number of individual units contained in one case pack.\nFor example, if a case pack contains 12 units, unitsPerPack would be 12.\n\nDefaults to 1 for regular products."},"lotTrackingDetails":{"items":{"$ref":"#/components/schemas/LotTrackingDetails"},"type":"array"},"breakdown":{"items":{"$ref":"#/components/schemas/PackInventory"},"type":"array"}},"required":["onHand","available","unavailable"],"type":"object","additionalProperties":false},"LotTrackingDetails":{"properties":{"lotNumber":{"type":"string","description":"Identifier for the lot."},"expirationDate":{"type":"string","description":"Timestamp for when this quantity will expire. RFC 3339 format, e.g., 2017-07-21T17:32:28Z.","format":"date-time"},"available":{"type":"integer","format":"int32","description":"The number of units available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0}},"required":["available"],"type":"object","additionalProperties":false},"PackInventory":{"allOf":[{"$ref":"#/components/schemas/Omit_ApiInventoryResponse.breakdown_"},{"properties":{"dimensions":{"$ref":"#/components/schemas/Dimensions","description":"The physical dimensions of the case pack"},"logisticsSku":{"type":"string"}},"required":["logisticsSku"],"type":"object"}]},"Omit_ApiInventoryResponse.breakdown_":{"$ref":"#/components/schemas/Pick_ApiInventoryResponse.Exclude_keyofApiInventoryResponse.breakdown__","description":"Construct a type with the properties of T except for those in type K."},"Pick_ApiInventoryResponse.Exclude_keyofApiInventoryResponse.breakdown__":{"properties":{"logisticsSku":{"$ref":"#/components/schemas/ProductIdType"},"onHand":{"type":"integer","format":"int32","description":"The calculation of on-hand quantity, non-Pickable quantity, and in-transfer quantity,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"available":{"type":"integer","format":"int32","description":"The number of units available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"unavailable":{"type":"integer","format":"int32","description":"The number of units not available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"unitsPerPack":{"type":"number","format":"double","description":"The number of units contained in a single pack.\n\nFor bundles: represents the quantity of this component SKU required to fulfill one bundle.\nFor example, if a bundle requires 3 units of SKU-A, unitsPerPack would be 3.\n\nFor case packs: represents the number of individual units contained in one case pack.\nFor example, if a case pack contains 12 units, unitsPerPack would be 12.\n\nDefaults to 1 for regular products."},"lotTrackingDetails":{"items":{"$ref":"#/components/schemas/LotTrackingDetails"},"type":"array"}},"required":["onHand","available","unavailable"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"InventoryPool":{"enum":["DEFAULT","UNALLOCATED","STORAGE","PREP"],"type":"string"},"ApiCursorPaginatedInventoryResponse":{"description":"Cursor-paginated response for inventory queries","properties":{"inventories":{"items":{"$ref":"#/components/schemas/ApiInventoryResponse"},"type":"array","description":"Array of inventory items sorted by logisticsSku in ascending order"},"nextCursor":{"type":"string","description":"The cursor to use for fetching the next page.\nThis is the logisticsSku of the last item in the current page.\nIf undefined, there are no more pages."}},"required":["inventories"],"type":"object","additionalProperties":false},"WarehouseDetailsResponse":{"properties":{"logisticsSku":{"type":"string"},"warehouseDetails":{"items":{"$ref":"#/components/schemas/WarehouseDetails"},"type":"array"}},"required":["logisticsSku"],"type":"object","additionalProperties":false},"WarehouseDetails":{"properties":{"available":{"type":"integer","format":"int32","description":"The number of units available for sale - not reserved for open orders,\nbelonging to products whose dimsLocked field is true, that are in a pickable and shippable\nstate at connected warehouses.","minLength":0},"warehouseId":{"type":"string","description":"The unique warehouse identifier from which the shipment was sent."},"unitsPerPack":{"type":"integer","format":"int32","description":"The number of individual units contained in this case pack","minimum":1},"dimensions":{"$ref":"#/components/schemas/Dimensions","description":"The physical dimensions of the case pack"}},"required":["available","warehouseId"],"type":"object","additionalProperties":false},"LogisticsSkus":{"properties":{"logisticsSkus":{"items":{"$ref":"#/components/schemas/ProductIdType"},"type":"array","description":"A list of logisticsSkus."}},"required":["logisticsSkus"],"type":"object","additionalProperties":false},"BulkProductCreateResponse":{"properties":{"status":{"type":"string"},"result":{"anyOf":[{"$ref":"#/components/schemas/InductedProduct"},{"$ref":"#/components/schemas/BadRequestError"}]}},"required":["status","result"],"type":"object","additionalProperties":false},"InductedProduct":{"properties":{"logisticsSKU":{"type":"string"},"merchantSKU":{"type":"string"}},"required":["logisticsSKU","merchantSKU"],"type":"object","additionalProperties":false},"CreateProductInput":{"properties":{"name":{"type":"string"},"merchantSKU":{"type":"string"},"price":{"type":"number","format":"double"},"imageUrl":{"type":"string"},"customsInformation":{"$ref":"#/components/schemas/CustomsInput"},"dimensions":{"$ref":"#/components/schemas/Dimension"}},"required":["name","merchantSKU"],"type":"object","additionalProperties":false},"Product":{"properties":{"name":{"type":"string"},"merchantSKU":{"type":"string"},"logisticsSKU":{"type":"string"},"barcodes":{"items":{"type":"string"},"type":"array"},"dimensions":{"$ref":"#/components/schemas/Dimension"},"inventory":{"$ref":"#/components/schemas/Inventory"},"shippingSpecification":{"$ref":"#/components/schemas/ShippingInfo"},"category":{"$ref":"#/components/schemas/ProductCategoryEntry"}},"required":["name","merchantSKU","logisticsSKU","barcodes","dimensions","inventory"],"type":"object","additionalProperties":false},"Inventory":{"properties":{"incoming":{"type":"number","format":"double"},"onHand":{"type":"number","format":"double"},"available":{"type":"number","format":"double"},"unavailable":{"type":"number","format":"double"}},"required":["incoming","onHand","available","unavailable"],"type":"object","additionalProperties":false},"ShippingInfo":{"$ref":"#/components/schemas/Omit_ShippingSpecification.dsku-or-sourceUser_"},"Omit_ShippingSpecification.dsku-or-sourceUser_":{"$ref":"#/components/schemas/Pick_ShippingSpecification.Exclude_keyofShippingSpecification.dsku-or-sourceUser__","description":"Construct a type with the properties of T except for those in type K."},"Pick_ShippingSpecification.Exclude_keyofShippingSpecification.dsku-or-sourceUser__":{"properties":{"source":{"$ref":"#/components/schemas/ShippingSpecificationSourceType"},"minimumPackagingType":{"$ref":"#/components/schemas/PackagingType"}},"required":["minimumPackagingType"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"ShippingSpecificationSourceType":{"enum":["MANUAL","HAZMAT","SELLER"],"type":"string"},"PackagingType":{"enum":["SHIPS_IN_OWN_CONTAINER","POLY_BAG","BUBBLE_MAILER","BOX"],"type":"string"},"ProductCategoryEntry":{"properties":{"id":{"type":"number","format":"double"},"category":{"type":"string"},"ancestorNames":{"items":{"type":"string"},"type":"array"}},"required":["id","category","ancestorNames"],"type":"object","additionalProperties":false},"LogisticsSKUsInput":{"properties":{"logisticsSKUs":{"items":{"type":"string"},"type":"array","description":"Logistics SKUs of products to fetch.","minItems":1,"maxItems":250}},"required":["logisticsSKUs"],"type":"object","additionalProperties":false},"BarcodesResponse":{"properties":{"logisticsSKU":{"type":"string"},"result":{"items":{"properties":{"subcode":{"$ref":"#/components/schemas/BarcodeResponseSubcode"},"barcode":{"type":"string"},"status":{"type":"string","enum":["true","false"]}},"required":["barcode","status"],"type":"object"},"type":"array"}},"required":["logisticsSKU","result"],"type":"object","additionalProperties":false},"BarcodeResponseSubcode":{"enum":["ALREADY_ASSIGNED","DUPLICATE","INVALID_BARCODE","INVALID_TYPE","NO_BARCODE_SLOTS_REMAINING","PRODUCT_ALIAS_NOT_FOUND","RESERVED_BY_ANOTHER_SELLER"],"type":"string"},"CreateBarcodesInput":{"properties":{"logisticsSKU":{"type":"string"},"barcodes":{"items":{"type":"string"},"type":"array"}},"required":["logisticsSKU","barcodes"],"type":"object","additionalProperties":false},"ProductsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Product"},"type":"array"},"pageInfo":{"properties":{"totalPages":{"type":"number","format":"double"},"currentPage":{"type":"number","format":"double"}},"required":["totalPages","currentPage"],"type":"object"}},"required":["items","pageInfo"],"type":"object","additionalProperties":false},"UpdateProductInput":{"properties":{"name":{"type":"string"},"merchantSKU":{"type":"string"},"price":{"type":"number","format":"double"},"imageUrl":{"type":"string"},"customsInformation":{"$ref":"#/components/schemas/CustomsInput"},"taxonomyNodeId":{"type":"number","format":"double"}},"type":"object","additionalProperties":false},"ShippingSpecificationResponsePublic":{"properties":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/ShippingSpecificationPublic"}},"ShippingSpecificationPublic":{"properties":{"logisticsSKU":{"type":"string"},"minimumPackagingType":{"$ref":"#/components/schemas/PackagingType"},"source":{"$ref":"#/components/schemas/ShippingSpecificationSourceType"},"sourceUser":{"type":"string"}},"required":["logisticsSKU","minimumPackagingType"],"type":"object","additionalProperties":false},"ReplenishmentOrderResponseV2":{"properties":{"orderId":{"type":"string","description":"Id generated after successfully creating the order"},"externalId":{"type":"string","description":"External id submitted by the external system when creating the order"},"externalChannelId":{"type":"string","description":"External channel's order id"},"locationId":{"type":"string","description":"Warehouse id from which the order will be sent"},"type":{"$ref":"#/components/schemas/Type","description":"Type of the order, e.g. B2B, EDI, DROP_SHIP. Currently, only B2B is supported"},"orderStatus":{"$ref":"#/components/schemas/OrderStatus","description":"Current status of the order"},"orderItems":{"items":{"$ref":"#/components/schemas/ReplenishmentOrderItemV2"},"type":"array","description":"Items in the order"},"shipments":{"items":{"$ref":"#/components/schemas/ReplenishmentShipmentV2"},"type":"array","description":"Shipments created related to the order"},"shipBy":{"type":"string","format":"date-time","description":"Ship by date provided by the external system in the request"},"notes":{"type":"string","description":"Additional notes to be provided along with the order"},"retailerData":{"$ref":"#/components/schemas/RetailerData","description":"Additional Data required for EDI and DROP_SHIP orders"},"ingestionChannel":{"$ref":"#/components/schemas/IngestionChannel","description":"Ingestion channel of the order"}},"required":["orderId","type","orderStatus","orderItems","shipments"],"type":"object","additionalProperties":false},"Type":{"enum":["B2B"],"type":"string"},"OrderStatus":{"type":"string","enum":["BOOKED","CANCELLED","COMPLETED","ERROR","IN_PROGRESS","LOST_DAMAGED","PLANNED","TENDERED"]},"ReplenishmentOrderItemV2":{"description":"Item transferred in B2B order","properties":{"logisticsSku":{"type":"string","description":"Logistics sku of the product"},"quantity":{"type":"number","format":"double","description":"Total quantity to sent"},"quantityUOM":{"$ref":"#/components/schemas/QuantityUom","description":"Unit of measure of the qty included, can be either EACH or CASE"},"quantityPerPack":{"type":"number","format":"double","description":"Case pack quantity of the product"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the outbound"},"lotNumber":{"type":"string","description":"Lot number assigned to the product by seller"},"unitPrice":{"type":"number","format":"double","description":"Price associated with each unit of product"},"totalPrice":{"type":"number","format":"double","description":"Total price of all units of product (totalPrice = unitPrice * quantity)"},"discount":{"type":"number","format":"double","description":"Absolute value of discount given by seller on all units of product (not in percentage)"},"productData":{"$ref":"#/components/schemas/ProductData","description":"Product data relating to the item. Required if the logisticSku is not provided for the item"}},"required":["quantity","quantityUOM"],"type":"object","additionalProperties":false},"ProductData":{"description":"Product data relating to the item. Required if the logisticsSku is not provided for the item","properties":{"upc":{"type":"string","description":"Universal product code of the product"},"buyerPartNumber":{"type":"string","description":"Unique identifier assigned to a product by buyer"},"sku":{"type":"string","description":"SKU of product"},"gtin":{"type":"number","format":"double","description":"Global Trade Item Number of the product"}},"required":["sku"],"type":"object","additionalProperties":false},"RetailerData":{"description":"Retailer data for the EDI orders","properties":{"retailer":{"type":"string","description":"Name of retailer"},"purchaseOrderNumber":{"type":"string","description":"Purchase order number"},"tradingPartnerId":{"type":"string","description":"Trading partner id"},"customerPoNumber":{"type":"string","description":"Customer purchase order number"},"invoiceNumber":{"type":"string","description":"Invoice number"},"markForStore":{"type":"string","description":"Mark for store"},"department":{"type":"string","description":"Department"},"address":{"$ref":"#/components/schemas/DeliverrAddress","description":"Delivery address"},"discounts":{"items":{"$ref":"#/components/schemas/Discount"},"type":"array","description":"Discount associated with the order"},"charges":{"items":{"$ref":"#/components/schemas/ChargeV2"},"type":"array","description":"Charges associated with the order"},"paymentTerms":{"$ref":"#/components/schemas/PaymentTerms","description":"Payment terms specific to invoice"},"deliveryDate":{"type":"string","format":"date-time","description":"iso string for delivery date"},"shipByDate":{"type":"string","format":"date-time","description":"A custom ship by date in ISO 8601 (YYYY-MM-DD) to schedule future orders should be atleast two days after current date.\nThe ship by date is in UTC timezone and warehouse will only ship during working hours"},"shipAfterDate":{"type":"string","format":"date-time","description":"A custom ship after date in ISO 8601 (YYYY-MM-DD) to schedule future orders.\nThe ship after date is in UTC timezone and warehouse will only ship during working hours"}},"type":"object","additionalProperties":false},"Discount":{"properties":{"type":{"type":"string","description":"Type of discount"},"value":{"type":"number","format":"double","description":"Absoulute value of discount (not in percentage)"}},"required":["type","value"],"type":"object","additionalProperties":false},"ChargeV2":{"properties":{"type":{"type":"string","description":"Type of charge. e.g. \"Shipping cost\""},"value":{"type":"number","format":"double","description":"Absoulute value of charge (not in percentage)"}},"required":["type","value"],"type":"object","additionalProperties":false},"PaymentTerms":{"properties":{"term":{"type":"string","description":"Payment term string. e.g \"2% 10 Net 30\""},"dueDate":{"type":"string","format":"date-time","description":"Due date of payment in ISO 8601 (YYYY-MM-DD)"}},"type":"object","additionalProperties":false},"IngestionChannel":{"enum":["SPS","SPS_TEST","SHOPIFY_V3","SELLERCLOUD","NETSUITE"],"type":"string"},"ReplenishmentOrderRequestV2":{"description":"B2B Create order request object","properties":{"type":{"$ref":"#/components/schemas/Type","description":"Type of the order, e.g. B2B, EDI, DROP_SHIP. Currently, only B2B is supported"},"orderItems":{"items":{"$ref":"#/components/schemas/ReplenishmentOrderItemV2"},"type":"array","description":"List of items to be sent.\n1. logistics sku of the product\n2. quantity\n3. quantity unit of measure\n4. quantity per pack\n5. line item id\n6. lot number\n7. unit price\n8. total price\n9. currency code\n10. product data required only if logistics sku is not present\n\nNotes:\n1. Duplicate skus are not allowed.\n2. Maximum 1000 items are allowed per order."},"shipToAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"Address where this order should be delivered"},"transportationDetails":{"$ref":"#/components/schemas/TransportationDetails","description":"Shipping preferences contain\n1. Shipping Partner - FLEXPORT, THIRD_PARTY, RECEIVER, COLLECT, SELLER is supported.\n2. Shipping Type -  LTL, FTL, PARCEL\n\nNotes:\n1. Carrier account details are not required if shipping partner is FLEXPORT or SELLER\n2. For THIRD_PARTY and RECEIVER all fields of carrier account details are required\n3. For THIRD_PARTY and RECEIVER shipping type should always be PARCEL\n4. For COLLECT only FEDEX is supported and other fields of carrier account details are not required\n5. Shipping method takes precedence over shipping speed."},"currencyCode":{"$ref":"#/components/schemas/CurrencyCode","description":"The three-letter code for the currency associated with the order. e.g. USD"},"externalId":{"type":"string","description":"A unique order reference meaningful to the external system submitting the order."},"shipBy":{"type":"string","format":"date-time","description":"A custom ship by date in ISO 8601 (YYYY-MM-DD) to schedule future orders\nshould be atleast two days after current date.\nThe ship by date is in UTC timezone and warehouse will only ship during working hours"},"notes":{"type":"string","description":"Additional notes to be provided along with the order"},"locationId":{"type":"string","description":"Unique identifier of the origin warehouse."},"retailerData":{"$ref":"#/components/schemas/RetailerData","description":"Additional Data required for EDI and DROP_SHIP orders"},"ingestionChannel":{"$ref":"#/components/schemas/IngestionChannel","description":"Ingestion channel of the order"},"vasData":{"$ref":"#/components/schemas/VasData","description":"Vas data for the order"}},"required":["type","orderItems","shipToAddress","transportationDetails"],"type":"object","additionalProperties":false},"CurrencyCode":{"type":"string","enum":["LTL","AED","AFN","ALL","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BRL","BSD","BTN","BWP","BYR","BZD","CAD","CDF","CHF","CLP","CNY","COP","CRC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EEK","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LVL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRO","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","STD","SVC","SYP","SZL","THB","TJS","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VED","VEF","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","YER","ZAR","ZMK","ZWD"],"nullable":false},"VasData":{"properties":{"code":{"type":"string","description":"Vas code for the order"}},"type":"object","additionalProperties":false},"ShipmentAttachmentUploadResponse":{"properties":{"uploadUrl":{"type":"string","description":"Upload url for uploading shipment attachment document."},"attachmentType":{"$ref":"#/components/schemas/AttachmentType","description":"Type of the attachment, e.g. \"SHIPPING_LABELS\", \"COMMERCIAL_INVOICE\", etc."},"expirationTime":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp string indicating when the upload URL will expire.\nThe URL is valid for one hour after generation.\nExample: \"2025-05-10T10:00:00Z\""}},"required":["uploadUrl","attachmentType","expirationTime"],"type":"object","additionalProperties":false},"AttachmentType":{"enum":["CASE_LABELS","SHIPPING_LABELS","PALLET_LABELS","COMMERCIAL_INVOICE","BILL_OF_LADING"],"type":"string"},"ShipmentAttachmentUploadRequest":{"description":"Request object for getting upload url for uploading shipment attachment document.\n\nNotes:\n1. Only \"application/pdf\" is supported for now.\n2. Maximum file size is 15MB.\n3. Shipment status should be \"SUBMITTED\", \"PROCESSING\", or \"SCHEDULED\" in seller portal.","properties":{"attachmentType":{"$ref":"#/components/schemas/AttachmentType","description":"Type of the attachment, e.g. \"SHIPPING_LABELS\", \"COMMERCIAL_INVOICE\", etc."},"contentType":{"type":"string","description":"Content type of the attachment. Only \"application/pdf\" is supported for now."}},"required":["attachmentType","contentType"],"type":"object","additionalProperties":false},"Report":{"properties":{"status":{"$ref":"#/components/schemas/ReportStatus","description":"<ol>\n  <li>PENDING: The report is still being generated</li>\n  <li>SUCCESS: Report has been generated, use the url field to download the report as a CSV file</li>\n  <li>ERROR: There was an issue while creating this report, see errorMessage field for details</li>\n</ol>"},"urlExpiration":{"type":"string","format":"date-time","description":"date-time of download url expiration in GMT."},"url":{"type":"string","description":"download report as a csv using this URL. Note that this URL will expire at the urlExpiration time."},"errorMessage":{"type":"string","description":"If status is ERROR, a description of the error."}},"required":["status"],"type":"object","additionalProperties":false},"ReportStatus":{"enum":["PENDING","SUCCESS","ERROR"],"type":"string"},"ReportGenerationResponse":{"properties":{"reportReference":{"type":"string","description":"A reference for polling the status of the report."}},"required":["reportReference"],"type":"object","additionalProperties":false},"ReportGenerationRequest":{"properties":{"reportType":{"$ref":"#/components/schemas/SellerReportType"},"startDate":{"type":"string","format":"date-time","description":"The start date for the data in the report."},"endDate":{"type":"string","format":"date-time","description":"The end date for the data in the report."}},"required":["reportType"],"type":"object","additionalProperties":false},"SellerReportType":{"enum":["Orders-Backorder_Items","Billing-Credits_Balance","Billing-Summary_Report","Claims-Claims_Submitted","Pricing-Fulfillment_Fees","Inbounds-Packages","Inbounds-Inventory_Reconciliation","Inbounds-Monthly_Reconciliation","Inbounds-Shipping_Plan_Reconciliation","Inbounds-Shipping_Plan_Reconciliation_V2","Inbounds-Shipment_Custody_Details","Inbounds-Box_Custody_Details","Incident-Impact_Report","Inbounds-Seller_Problems_Report","Inventory-Units_In_Long_Term_Storage","Inventory-Ecommerce_Monthly_Reconciliation","Inventory-Ecommerce_Monthly_Reconciliation_Using_Ledger","Inventory-Ecommerce_Transaction_History","Inventory-Levels_Today","Inventory-Hourly_Visibility_Report","Inventory-Transaction_History_Between_Dates","Inventory-Levels_Today_Using_Ledger","Inventory-Lot_Tracking_FEFO_All_Products","Inventory-Lot_Tracking_FEFO_All_Products_Using_Ledger","Inventory-Lot_Tracking_FEFO_Single_Product","Inventory-Lot_Tracking_FEFO_Single_Product_Using_Ledger","Inventory-Detail_Reserve_Storage_Using_Ledger","Orders-Shipments","Orders-All_Orders","Parcel-All_Parcels","Parcel_All_Parcels_Tracking_Details","Products-All_SKUs_With_Alias_Counts","Products-All_SKUs_With_Dims_And_Alias_Counts","Products-All_CasePacks_With_Dims_And_Inventory","Products-Available_SKUs_With_Alias_Counts","Products-Available_SKUs_With_No_Aliases","Products-SKUs_With_Linked_Aliases","Products-Catalog_Item_Master","Reserve-Storage-Orders_And_Transfers","Replenishment-Order_Item_Report","Replenishment-Order_Tracking_Report","Reserve-Storage-Pallet-Inventory","Reserve-Storage-Pallet_Inventory_V2","Returns-All_SKUs","Returns-All_Returns","EOD_Report","Inventory-Snapshot_Adhoc_Report","Returns-Processed_In_Day_Excluding_IWT","Returns-Processed_In_Day_Including_IWT","Inbounds-Added_Into_Stock_Today","Returns-Put_Away_Report","IWT-Stock_Ledger_Report","Unexpected-Item_Daily_Processing_Report"],"type":"string"},"ReturnsApiOrder":{"properties":{"id":{"type":"number","format":"double","description":"Unique identifier of the return."},"status":{"$ref":"#/components/schemas/LogisticsReturnStatus","description":"The current status of the return."},"sourceAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"Source address where the return was shipped from, if known."},"shippingLabel":{"$ref":"#/components/schemas/ShippingLabel","description":"The label used to ship the return."},"rma":{"type":"string","description":"RMA of the return."},"externalReturnId":{"type":"string","description":"A unique reference to the return order in the external system submitting the request."},"returnItems":{"items":{"$ref":"#/components/schemas/ReturnItem"},"type":"array","description":"Items contained in the return."},"shippedAt":{"type":"string","format":"date-time","description":"Date when the return was shipped."},"receivedAt":{"type":"string","format":"date-time","description":"Date when the return was received at the warehouse."},"inspectedAt":{"type":"string","format":"date-time","description":"Date when the return was inspected at the warehouse."},"fulfillmentOrderId":{"type":"string","description":"The ID of the original outbound order that was shipped to the customer."}},"required":["id","status","shippingLabel","rma","externalReturnId","returnItems"],"type":"object","additionalProperties":false},"LogisticsReturnStatus":{"enum":["CREATED","SHIPPED","RECEIVED_FOR_PROCESSING","PROCESSED","CANCELLED"],"type":"string"},"LogisticsReturnSourceAddress":{"$ref":"#/components/schemas/Pick_DeliverrAddress.name-or-street1-or-street2-or-city-or-zip-or-state-or-country_"},"Pick_DeliverrAddress.name-or-street1-or-street2-or-city-or-zip-or-state-or-country_":{"properties":{"name":{"type":"string"},"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"zip":{"type":"string"},"state":{"type":"string"}},"required":["name","street1","city","country","zip","state"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"LogisticsReturnLabelResponse":{"properties":{"trackingCode":{"type":"string"},"trackingStatus":{"$ref":"#/components/schemas/LogisticsReturnTrackingStatusResponse"},"carrier":{"type":"string"},"trackingUrl":{"type":"string"},"labelUrl":{"type":"string"}},"required":["trackingCode","trackingStatus","carrier"],"type":"object","additionalProperties":false},"LogisticsReturnTrackingStatusResponse":{"enum":["CREATED","SHIPPED","DELIVERED","CANCELLED","FAILED"],"type":"string"},"LogisticsReturnItemResponse":{"properties":{"identifier":{"type":"string"},"expectedQuantity":{"type":"number","format":"double"},"inspectedItems":{"items":{"$ref":"#/components/schemas/LogisticsReturnItemInspection"},"type":"array"}},"required":["identifier","expectedQuantity","inspectedItems"],"type":"object","additionalProperties":false},"LogisticsReturnItemInspection":{"properties":{"receivedCondition":{"type":"string"},"finalCondition":{"type":"string"},"disposition":{"type":"string"}},"required":["receivedCondition","finalCondition","disposition"],"type":"object","additionalProperties":false},"ShippingLabel":{"properties":{"trackingCode":{"type":"string","description":"The tracking code of the label."},"trackingStatus":{"$ref":"#/components/schemas/LogisticsReturnTrackingStatusResponse","description":"The current tracking status of the return."},"carrier":{"type":"string","description":"The name of the carrier providing the label."},"trackingUrl":{"type":"string","description":"The tracking URL, if available."},"labelUrl":{"type":"string","description":"The URL of the label, if available."}},"required":["trackingCode","trackingStatus","carrier"],"type":"object","additionalProperties":false},"ReturnItem":{"properties":{"identifier":{"type":"string","description":"The identifier provided when creating the return item."},"expectedQuantity":{"type":"number","format":"double","description":"The quantity provided when creating the return item."},"inspectedItems":{"items":{"$ref":"#/components/schemas/InspectedItem"},"type":"array","description":"The list of items with the given identifier that have completed inspection at the warehouse."}},"required":["identifier","expectedQuantity","inspectedItems"],"type":"object","additionalProperties":false},"InspectedItem":{"properties":{"receivedCondition":{"type":"string","description":"The condition of the item when it was received at the warehouse."},"finalCondition":{"type":"string","description":"The condition of the item after any rework has been completed."},"disposition":{"type":"string","description":"The disposition applied to the item."}},"required":["receivedCondition","finalCondition","disposition"],"type":"object","additionalProperties":false},"CreateReturnRequest":{"properties":{"sourceAddress":{"$ref":"#/components/schemas/DeliverrAddress","description":"Source address indicating where the return is being shipped from.  Required if no externalLabel is provided."},"returnItems":{"items":{"$ref":"#/components/schemas/RequestedReturnItem"},"type":"array","description":"Items contained in the return.","minItems":1},"externalReturnId":{"type":"string","description":"A unique reference to the return order in the external system submitting the request."},"rma":{"type":"string","description":"RMA of the return, typically generated by the merchant."},"externalLabel":{"$ref":"#/components/schemas/ExternalLabel","description":"Required if the return label was purchased externally.  If omitted a label will be purchased."},"logisticsOrderId":{"type":"string","description":"Logistics ID of the original order, if available"}},"required":["returnItems","externalReturnId","rma"],"type":"object","additionalProperties":false},"LogisticsReturnItemRequest":{"properties":{"identifier":{"type":"string"},"type":{"type":"string","enum":["LOGISTICS_SKU","SKU"]},"quantity":{"type":"number","format":"double"},"name":{"type":"string"}},"required":["identifier","type","quantity"],"type":"object","additionalProperties":false},"LogisticsReturnLabelRequest":{"properties":{"trackingCode":{"type":"string"},"carrier":{"type":"string"},"trackingUrl":{"type":"string"},"labelUrl":{"type":"string"}},"required":["trackingCode","carrier"],"type":"object","additionalProperties":false},"RequestedReturnItem":{"properties":{"identifier":{"type":"string","description":"The unique identifier for the item that must already be known to the system.  Ideally this is the LOGISTICS_SKU\nbut we also support the merchant SKU if it has been associated with the product via the Products API.  Returns\ncontaining items that are not known to the system will be rejected."},"type":{"$ref":"#/components/schemas/ReturnItemType","description":"The type of identifier provided.  Must be one of LOGISTICS_SKU, SKU."},"quantity":{"type":"number","format":"double","description":"The number of items with the given identifier in the return.","minimum":1},"name":{"type":"string"}},"required":["identifier","type","quantity"],"type":"object","additionalProperties":false},"ReturnItemType":{"enum":["LOGISTICS_SKU","SKU"],"type":"string"},"ExternalLabel":{"properties":{"trackingCode":{"type":"string","description":"The tracking code of the label."},"carrier":{"type":"string","description":"The name of the carrier providing the label."},"trackingUrl":{"type":"string","description":"The tracking URL, if available."},"labelUrl":{"type":"string","description":"The URL of the label, if available."}},"required":["trackingCode","carrier"],"type":"object","additionalProperties":false},"WebhookModel":{"allOf":[{"$ref":"#/components/schemas/WebhookCreateModel"},{"properties":{"id":{"$ref":"#/components/schemas/WebhookIdType"}},"required":["id"],"type":"object"}]},"WebhookCreateModel":{"properties":{"type":{"type":"string","description":"Types of webhooks available.\n<div><span> <b>Examples:</b></span>\n<span>Freight.TrackingUpdated - </span>\n<span>Inbound.Received - </span>\n<span>Inbound.ShipmentStatusChanged - </span>\n<span>Inventory.Adjusted - </span>\n<span>Order.Submitted - </span>\n<span>Order.Shipped - </span>\n<span>Order.Cancelled - </span>\n<span>Order.Delivered - </span>\n<span>Order.Held - </span>\n<span>Return.Updated - </span>\n<span>Shipment.Created - </span>\n<span>Shipment.Submitted - </span>\n<span>Shipment.Shipped - </span>\n<span>Shipment.Cancelled - </span>\n<span>Shipment.Delivered</span></div>"},"url":{"type":"string","description":"Webhook URL where events should be sent to. Must begin with 'https://'.","pattern":"^https:\\/\\/.+"},"method":{"$ref":"#/components/schemas/WebhookRequestMethod"},"authMethod":{"$ref":"#/components/schemas/WebhookAuthType","description":"<ul>\n<li>NONE: No authentication needed to send webhook events to the specified webhook URL</li>\n<li>BASIC_AUTH: Basic authentication (username and password) if required by the webhook URL</li>\n<li>TOKEN: A token is sent as the tokenHeader header value</li>\n</ul>"},"username":{"type":"string","description":"Required if auth_method is BASIC_AUTH."},"password":{"type":"string","description":"Required if auth_method is BASIC_AUTH."},"token":{"type":"string","description":"Required if auth_method is TOKEN."},"tokenHeader":{"type":"string","description":"Required if auth_method is TOKEN."}},"required":["type","url","method"],"type":"object","additionalProperties":false},"WebhookRequestMethod":{"enum":["POST","PUT"],"type":"string"},"WebhookAuthType":{"enum":["BASIC_AUTH","TOKEN","NONE"],"type":"string"},"WebhookIdType":{"type":"number","format":"double","description":"A unique identifier for a webhook.","pattern":"^\\d+$"},"ConflictError":{"properties":{"status":{"$ref":"#/components/schemas/StatusCodes.CONFLICT","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"StatusCodes.CONFLICT":{"enum":[409],"type":"number"},"ParcelTrackingUpdatedEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"trackingCode":{"type":"string"},"status":{"type":"string"},"message":{"type":"string"},"eventTime":{"type":"string"},"location":{"$ref":"#/components/schemas/EventLocation"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","trackingCode","status","message","eventTime","location"],"type":"object","additionalProperties":false},"EventLocation":{"properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"zip":{"type":"string"}},"type":"object","additionalProperties":false},"ReturnInspectedEvent":{"allOf":[{"$ref":"#/components/schemas/LegacyReturnsApiOrder"},{"$ref":"#/components/schemas/EventWebhookResponse"}]},"LegacyReturnsApiOrder":{"properties":{"id":{"type":"number","format":"double","description":"Shopify's return order id."},"status":{"$ref":"#/components/schemas/ReturnStatus"},"sourceAddress":{"$ref":"#/components/schemas/LegacyReturnsSourceAddress","description":"Return shipment origin address\ncould be customer's or aggregator facility's address."},"destinationAddress":{"$ref":"#/components/schemas/LegacyReturnsDestinationAddress","description":"Shopify's return processing facility address."},"shippingLabels":{"items":{"$ref":"#/components/schemas/ReturnsPublicApiShippingLabel"},"type":"array","description":"For more than one package send multiple shipping label."},"marketplaceOrder":{"$ref":"#/components/schemas/ReturnsApiMarketplaceOrder"},"rma":{"type":"string","description":"Return merchandise authorization unique id generated for returns\nmake sure it is in the shipping label."},"externalReturnId":{"type":"string","description":"Unique identifier for return in RMT."},"returnItems":{"items":{"$ref":"#/components/schemas/LegacyReturnsApiInspectedReturnItem"},"type":"array","description":"Items being returned."},"shippedAt":{"type":"string","format":"date-time","description":"Buyer shipped at date"},"receivedAt":{"type":"string","format":"date-time","description":"Received for inspection date"},"inspectedAt":{"type":"string","format":"date-time","description":"Inspection performed at date"},"inspectionNotes":{"type":"string","description":"Notes captured by operations to pass any unexpected/unusual item or package details."}},"required":["id","status","shippingLabels","marketplaceOrder","rma","externalReturnId","returnItems"],"type":"object","additionalProperties":false},"ReturnStatus":{"enum":["ARRIVED","AUTO_CANCELLED","CANCELLED","CARRIER_SHIPPED","CARRIER_DELIVERED","CLOSED","CREATED","PROCESSED","RETURNED_TO_CUSTOMER"],"type":"string"},"LegacyReturnsSourceAddress":{"properties":{"name":{"type":"string","description":"Full name of entity."},"firstName":{"type":"string","description":"FirstName of entity.","deprecated":true},"lastName":{"type":"string","description":"LastName of entity.","deprecated":true},"address1":{"type":"string","description":"First address line of the address."},"address2":{"type":"string","description":"Second address line of the address."},"company":{"type":"string","description":"Company name for the entity."},"city":{"type":"string","description":"City of the address."},"provinceCode":{"type":"string","description":"State or region of the address - if a US countryCode, must be the\n2-letter state postal abbreviation."},"zip":{"type":"string","description":"Postal code of the address."},"phone":{"type":"string","description":"Contact number of customer."},"countryCode":{"type":"string","description":"Country of the address."}},"required":["address1","city","provinceCode","countryCode"],"type":"object","additionalProperties":false},"LegacyReturnsDestinationAddress":{"properties":{"name":{"type":"string","description":"Full name of entity."},"firstName":{"type":"string","description":"FirstName of entity.","deprecated":true},"lastName":{"type":"string","description":"LastName of","deprecated":true},"address1":{"type":"string","description":"First address line of the address."},"address2":{"type":"string","description":"Second address line of the address."},"company":{"type":"string","description":"Company name for the entity."},"city":{"type":"string","description":"City of the address."},"provinceCode":{"type":"string","description":"State or region of the address - if a US countryCode, must be the\n2-letter state postal abbreviation."},"zip":{"type":"string","description":"Postal code of the address."},"phone":{"type":"string","description":"Contact number of customer."},"countryCode":{"type":"string","description":"Country of the address."}},"required":["address1","city","provinceCode","zip","countryCode"],"type":"object","additionalProperties":false},"ReturnsPublicApiShippingLabel":{"properties":{"carrier":{"$ref":"#/components/schemas/ReturnsPublicApiCarriers"},"trackingCode":{"type":"string"},"trackingUrl":{"type":"string"},"trackingStatus":{"$ref":"#/components/schemas/TrackingStatus"},"labelFormat":{"type":"string","enum":["PDF","PNG","ZPL203"]},"labelUrl":{"type":"string"},"shippingMethod":{"$ref":"#/components/schemas/ReturnsPublicApiShippingMethod"},"packageDimensions":{"$ref":"#/components/schemas/Dimensions"}},"required":["carrier","trackingCode"],"type":"object","additionalProperties":false},"ReturnsPublicApiCarriers":{"anyOf":[{"$ref":"#/components/schemas/Carrier"},{"type":"string","enum":["OTHER"]}]},"Carrier":{"type":"string"},"TrackingStatus":{"enum":["PRE_TRANSIT","IN_TRANSIT","OUT_FOR_DELIVERY","DELIVERED","RETURN_TO_SENDER","FAILURE","UNKNOWN","CANCELLED","ERROR","INVALID"],"type":"string"},"ReturnsPublicApiShippingMethod":{"anyOf":[{"$ref":"#/components/schemas/ShippingMethod"},{"type":"string","enum":["OTHER"]}]},"ReturnsApiMarketplaceOrder":{"properties":{"marketplaceOrderId":{"type":"string","description":"Order id in the marketplace."},"marketplaceName":{"$ref":"#/components/schemas/ReturnsPublicApiMarketplace","description":"Name of the marketplace."}},"required":["marketplaceOrderId","marketplaceName"],"type":"object","additionalProperties":false},"ReturnsPublicApiMarketplace":{"enum":["AIRSHOP","AMAZON","ARTEZA","BIGCOMMERCE","DELIVERR","EBAY","ETSY","FACEBOOK","GOOGLE","INSTAGRAM","JANE","JCPENNEY","KROGER","MAGENTO","NEWEGG","OVERSTOCK","SHOPIFY","SKUPREME","TARGET","WALMART","WISH","WOOCOMMERCE","OTHER"],"type":"string"},"LegacyReturnsApiInspectedReturnItem":{"properties":{"product":{"$ref":"#/components/schemas/ReturnProductDetails"},"inspectionDetails":{"items":{"$ref":"#/components/schemas/ReturnProductInspectionDetail"},"type":"array","description":"Inspection details once the product is scan\nyou can get more or less than expectedQuantity in this payload."}},"required":["product","inspectionDetails"],"type":"object","additionalProperties":false},"ReturnProductDetails":{"properties":{"logisticsSku":{"type":"string"},"quantity":{"type":"number","format":"double"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"ReturnProductInspectionDetail":{"properties":{"quantity":{"type":"number","format":"double","description":"Quantity of the inspected item."},"initialCondition":{"type":"string","description":"Initial condition of the inspected item."},"finalCondition":{"type":"string","description":"Final condition of the inspected item."},"disposition":{"$ref":"#/components/schemas/Disposition","description":"Final disposition/outcome of the inspected item."},"sopId":{"type":"string","description":"SopId of the inspected item denotes which SOP was executed."},"lotNumber":{"type":"string","description":"Lot number of the inspected item."},"vasApplied":{"items":{"type":"string"},"type":"array","description":"Value-Added services applied on the inspected item."},"itemTag":{"type":"string","description":"Return tag of the inspected item i.e license-plate or item-tag."},"images":{"items":{"type":"string"},"type":"array","description":"Image urls of the inspected item."}},"required":["quantity"],"type":"object","additionalProperties":false},"Disposition":{"enum":["RESTOCK","RTV","DESTROY","DONATE","PRE_IWT","IWT","PROBLEM_SOLVING","SALVAGE","REWORK","PRE_RESTOCK","NOT_APPLICABLE","REBAG_RELABEL","LIQUIDATE"],"type":"string"},"EventWebhookResponse":{"description":"Common fields included with every webhook response","properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime"],"type":"object","additionalProperties":false},"ReturnReceivedEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"type":{"type":"string"},"amount":{"type":"integer","format":"int32"},"logisticsSku":{"$ref":"#/components/schemas/ProductIdType"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","type","amount","logisticsSku"],"type":"object","additionalProperties":false},"ReturnShipmentReceivedEvent":{"allOf":[{"$ref":"#/components/schemas/LegacyReturnsApiOrder"},{"$ref":"#/components/schemas/EventWebhookResponse"}]},"ReturnShippedEvent":{"allOf":[{"$ref":"#/components/schemas/LegacyReturnsApiOrder"},{"$ref":"#/components/schemas/EventWebhookResponse"}]},"ReturnUpdatedEvent":{"allOf":[{"$ref":"#/components/schemas/ReturnsApiOrder"},{"$ref":"#/components/schemas/EventWebhookResponse"}]},"InventoryAdjustedEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"adjustmentId":{"type":"string"},"warehouseId":{"type":"string"},"reason":{"type":"string","description":"| Reason      | Description |\n|-------------|-------------|\n| ADJUSTMENT  | These are reflecting adjustments done in warehouse by associates. For example, when they relocate items from place to place etc |\n| ASN_RECEIVE | Any receive in the destination warehouse, either direct or via crossdock |\n| DAMAGE      | Damage related negative adjustments |\n| RETURN      | Positive adjustments for returns |\n| TRANSFER    | Currently only includes FC to FC and direct RS to FC, not via Hubs or CD |\n| QUARANTINE  | Product or lot quarantine |\n| RELOCATE    | Relocated within a warehouse |\n| COUNT       | This is when associates count inventory in a bin; can reflect inventory lost, found or relocated |\n| SHIPPED     | Negative adjustment based on order shipment |"},"adjustments":{"items":{"$ref":"#/components/schemas/Adjustment"},"type":"array"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","adjustmentId","warehouseId","reason","adjustments"],"type":"object","additionalProperties":false},"Adjustment":{"description":"Represents an adjustment of inventory for a specific SKU.","properties":{"logisticsSKU":{"$ref":"#/components/schemas/ProductIdType"},"merchantSKU":{"type":"string"},"changes":{"items":{"$ref":"#/components/schemas/Change"},"type":"array"},"dimensions":{"$ref":"#/components/schemas/Dimensions","description":"The physical dimensions of the case pack"},"unitsPerPack":{"type":"integer","format":"int32","description":"The number of individual units contained in this case pack","minimum":1}},"required":["logisticsSKU","merchantSKU","changes"],"type":"object","additionalProperties":false},"Change":{"properties":{"state":{"type":"string","enum":["AVAILABLE","UNAVAILABLE"]},"delta":{"type":"integer","format":"int32"}},"required":["state","delta"],"type":"object","additionalProperties":false},"ShipmentCreatedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"id":{"$ref":"#/components/schemas/ShipmentIdType"},"orderId":{"$ref":"#/components/schemas/OrderIdType"},"externalOrderId":{"$ref":"#/components/schemas/ExternalOrderIdType"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","id","orderId","externalOrderId"],"type":"object","additionalProperties":false},"ShipmentIdType":{"type":"string","description":"A unique identifier for this shipment.","pattern":"^\\d+$"},"ShipmentCancelledEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentShippedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentPartiallyShippedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"InboundReceivedEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"type":{"type":"string","enum":["SELLABLE","DAMAGED"]},"amount":{"type":"integer","format":"int32"},"shipmentItemId":{"type":"integer","format":"int32"},"shippingPlanExternalId":{"type":"string","description":"The external shipping plan ID provided when the shipping plan was created, if any. Absent for shipments that were created without one."},"merchantSKU":{"type":"string","description":"The merchant SKU associated with the received item, if available."}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","type","amount","shipmentItemId"],"type":"object","additionalProperties":false},"InboundShipmentStatusChangeEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"status":{"type":"string"},"shipmentId":{"$ref":"#/components/schemas/ShipmentIdType"},"shippingPlanExternalId":{"type":"string","description":"The external shipping plan ID provided when the shipping plan was created, if any. Absent for shipments that were created without one."}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","status","shipmentId"],"type":"object","additionalProperties":false},"FreightTrackingUpdatedEvent":{"$ref":"#/components/schemas/Omit_FreightBolTracking.sellerId-or-freightShipmentId_"},"Omit_FreightBolTracking.sellerId-or-freightShipmentId_":{"$ref":"#/components/schemas/Pick_FreightBolTracking.Exclude_keyofFreightBolTracking.sellerId-or-freightShipmentId__","description":"Construct a type with the properties of T except for those in type K."},"Pick_FreightBolTracking.Exclude_keyofFreightBolTracking.sellerId-or-freightShipmentId__":{"properties":{"pickupDetails":{"$ref":"#/components/schemas/FreightStopDetails"},"deliveryDetails":{"$ref":"#/components/schemas/FreightStopDetails"},"bolId":{"type":"string"},"mode":{"$ref":"#/components/schemas/FreightShipmentMode"},"bolStatus":{"$ref":"#/components/schemas/FreightBolStatus"},"carrierName":{"type":"string"},"carrierScac":{"type":"string"},"proNumber":{"type":"string"},"estimatedPickupTime":{"type":"string","format":"date-time"},"estimatedDeliveryTime":{"type":"string","format":"date-time"},"estimatedPortDepartureTime":{"type":"string","format":"date-time"},"estimatedPortArrivalTime":{"type":"string","format":"date-time"},"totalPallets":{"type":"number","format":"double"},"events":{"items":{"$ref":"#/components/schemas/FreightTrackingEvent"},"type":"array"},"updatedAt":{"type":"string","format":"date-time"}},"required":["pickupDetails","deliveryDetails","bolId","mode","bolStatus","events","updatedAt"],"type":"object","description":"From T, pick a set of properties whose keys are in the union K"},"FreightStopDetails":{"properties":{"appointmentWindow":{"$ref":"#/components/schemas/AppointmentWindow"},"address":{"$ref":"#/components/schemas/DeliverrAddress"}},"required":["appointmentWindow","address"],"type":"object","additionalProperties":false},"AppointmentWindow":{"properties":{"startTime":{"type":"string"},"endTime":{"type":"string"},"date":{"type":"string"}},"required":["startTime","endTime","date"],"type":"object","additionalProperties":false},"FreightShipmentMode":{"enum":["LTL","FTL","DRAYAGE","INTERMODAL","TRANSLOAD","VLTL","FCL","LCL"],"type":"string"},"FreightBolStatus":{"type":"string","enum":["CANCELLED","TENDERED","CREATED","IN_TRANSIT","DELIVERED"]},"FreightTrackingEvent":{"properties":{"occurredAt":{"type":"string","format":"date-time"},"location":{"$ref":"#/components/schemas/FreightTrackingLocation"},"eventType":{"$ref":"#/components/schemas/FreightTrackingEventType"},"bolStatus":{"$ref":"#/components/schemas/FreightBolStatus"},"address":{"$ref":"#/components/schemas/DeliverrAddress"}},"required":["occurredAt","eventType","bolStatus"],"type":"object","additionalProperties":false},"FreightTrackingLocation":{"properties":{"name":{"type":"string"},"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"zip":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"}},"type":"object","additionalProperties":false},"FreightTrackingEventType":{"type":"string","enum":["CANCELLED","TENDERED","CREATED","DELIVERED","ESTIMATED_PICKUP_DATE_CHANGED","PICKED_UP","LOCATION_UPDATED","ESTIMATED_DELIVERY_DATE_CHANGED","CONTAINER_FULL_INGATED","CONTAINER_DEPARTED","CONTAINER_BERTHED_AT_TRANSSHIPMENT_PORT","CONTAINER_LOADED_AT_TRANSSHIPMENT_PORT","CONTAINER_DEPARTED_FROM_TRANSSHIPMENT_PORT","CONTAINER_BERTHED","CONTAINER_DISCHARGED","CONTAINER_AVAILABLE","CONTAINER_RETURNED"]},"OrderCancelledEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderEvent":{"properties":{"logisticsAccountId":{"type":"string","description":"Logistics account ID"},"logisticsEventId":{"type":"string","description":"Logistics event ID"},"logisticsEventType":{"type":"string","description":"Event type"},"logisticsEventTime":{"type":"string","description":"Time when the event occurred"},"id":{"$ref":"#/components/schemas/OrderIdType"},"orderId":{"$ref":"#/components/schemas/OrderIdType"},"externalOrderId":{"$ref":"#/components/schemas/ExternalOrderIdType"}},"required":["logisticsAccountId","logisticsEventId","logisticsEventType","logisticsEventTime","id","orderId","externalOrderId"],"type":"object","additionalProperties":false},"OrderShippedEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderHeldEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderSubmittedEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderPickingStartedEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderPackedEvent":{"$ref":"#/components/schemas/OrderEvent"},"OrderDeliveredEvent":{"$ref":"#/components/schemas/OrderEvent"},"ShipmentSubmittedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentPickingStartedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentPackedEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"ShipmentDeliveredEvent":{"$ref":"#/components/schemas/ShipmentEvent"},"inbounds_Health":{"properties":{"status":{"$ref":"#/components/schemas/inbounds_HealthStatus"}},"required":["status"],"type":"object","additionalProperties":false},"inbounds_HealthStatus":{"enum":["OK","UNHEALTHY"],"type":"string"},"inbounds_UnauthorizedError":{"properties":{"status":{"$ref":"#/components/schemas/inbounds_StatusCodes.UNAUTHORIZED","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"},"code":{"$ref":"#/components/schemas/inbounds_StatusCodes.UNAUTHORIZED"},"message":{"type":"string"}},"required":["status","type","title","code","message"],"type":"object","additionalProperties":false},"inbounds_StatusCodes.UNAUTHORIZED":{"enum":[401],"type":"number"},"inbounds_WarehouseAddress":{"properties":{"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/inbounds_CountryCode","description":"The two-letter code for the country of the address."},"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30},"storageWarehouseId":{"type":"string","description":"The unique id of a storage-warehouse.","maxLength":50}},"required":["address1","city","countryCode","provinceCode","zip","storageWarehouseId"],"type":"object","additionalProperties":false},"inbounds_CountryCode":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MK","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW"],"nullable":false},"inbounds_InboundWarehouseResponseLogisticsApi":{"properties":{"fulfillmentCentres":{"items":{"$ref":"#/components/schemas/inbounds_InboundWarehouseDetailsLogisticsApi"},"type":"array"},"storageWarehouses":{"items":{"$ref":"#/components/schemas/inbounds_InboundWarehouseDetailsLogisticsApi"},"type":"array"}},"type":"object","additionalProperties":false},"inbounds_InboundWarehouseDetailsLogisticsApi":{"properties":{"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/inbounds_CountryCode","description":"The two-letter code for the country of the address."},"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30},"warehouseId":{"type":"string"},"warehouseName":{"type":"string"},"isPrep":{"type":"boolean"}},"required":["address1","city","countryCode","provinceCode","zip","warehouseId","warehouseName"],"type":"object","additionalProperties":false},"inbounds_DocumentResult":{"properties":{"ready":{"type":"boolean"},"url":{"type":"string"}},"required":["ready","url"],"type":"object","additionalProperties":false},"inbounds_DocumentOption":{"enum":["BOX_CONTENT_LABEL","SHIPPING_LABEL","BILL_OF_LADING","PALLET_LABEL"],"type":"string"},"inbounds_BoxLabelsFormat":{"enum":["US_LETTER","THERMAL_4_X_6","A4_PAPER"],"type":"string"},"inbounds_NotFoundError":{"properties":{"status":{"$ref":"#/components/schemas/inbounds_StatusCodes.NOT_FOUND","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"inbounds_StatusCodes.NOT_FOUND":{"enum":[404],"type":"number"},"inbounds_QuoteResultResponse":{"properties":{"error":{"$ref":"#/components/schemas/inbounds_RateError"},"quotes":{"items":{"$ref":"#/components/schemas/inbounds_RateQuoteWithPurchased"},"type":"array"}},"required":["quotes"],"type":"object","additionalProperties":false},"inbounds_RateError":{"properties":{"code":{"type":"string"},"subcode":{"type":"string"}},"type":"object","additionalProperties":false},"inbounds_RateQuoteWithPurchased":{"properties":{"id":{"type":"number","format":"double"},"rateShoppingMethod":{"$ref":"#/components/schemas/inbounds_RateShoppingMethod"},"amount":{"type":"number","format":"double"},"fullAmount":{"type":"number","format":"double"},"currency":{"type":"string"},"shippingProvider":{"type":"string"},"providerMethod":{"type":"string"},"purchased":{"type":"boolean"},"estimatedTimeOfArrival":{"type":"string","format":"date-time"},"shippingOption":{"$ref":"#/components/schemas/inbounds_InboundShippingOption"}},"required":["id","rateShoppingMethod","amount","currency","shippingProvider","providerMethod","purchased","estimatedTimeOfArrival","shippingOption"],"type":"object","additionalProperties":false},"inbounds_RateShoppingMethod":{"enum":["CHEAPEST","FASTEST","INBOUNDS_PREFERENCE","ERROR","RACE"],"type":"string"},"inbounds_InboundShippingOption":{"enum":["SPD_EXTERNAL","FREIGHT_EXTERNAL","LTL_EXTERNAL","LTL_INTERNAL","FTL_INTERNAL","SPD_INTERNAL"],"type":"string"},"inbounds_InboundShipmentResponse":{"properties":{"id":{"type":"string"},"receivingId":{"type":"string"},"status":{"$ref":"#/components/schemas/inbounds_LogisticsInboundShipmentStatus"},"items":{"items":{"$ref":"#/components/schemas/inbounds_ItemOutput"},"type":"array"},"packages":{"items":{"$ref":"#/components/schemas/inbounds_PackageOutputUnstable"},"type":"array"},"arrivedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"shippingPlanId":{"type":"string"},"shippingPlanExternalId":{"type":"string","description":"The external shipment ID provided in the request."},"shippingPlanName":{"type":"string"},"bookingId":{"type":"string"},"shippingOption":{"$ref":"#/components/schemas/inbounds_InboundShippingOption"},"addresses":{"$ref":"#/components/schemas/inbounds_AddressesOutputUnstable"},"freight":{"$ref":"#/components/schemas/inbounds_FreightResponse"},"prep":{"$ref":"#/components/schemas/inbounds_PrepRequestData"},"shipmentDestination":{"$ref":"#/components/schemas/inbounds_LogisticsInboundShipmentDestination"},"cargoType":{"$ref":"#/components/schemas/inbounds_LogisticsInboundCargoType"},"container":{"$ref":"#/components/schemas/inbounds_ContainerInput"},"externalAsnId":{"type":"string"},"customAttributes":{"$ref":"#/components/schemas/inbounds_CustomAttributes"}},"required":["id","status","shippingPlanId","addresses","shipmentDestination"],"type":"object","additionalProperties":false},"inbounds_LogisticsInboundShipmentStatus":{"enum":["PENDING","READY_TO_SHIP","IN_TRANSIT","ARRIVED","PREPARING_FOR_DISTRIBUTION","IN_PREP","FORWARDING","RECEIVING","COMPLETED"],"type":"string"},"inbounds_ItemOutput":{"properties":{"logisticsSku":{"type":"string"},"shipmentItemId":{"type":"string"},"counts":{"$ref":"#/components/schemas/inbounds_CountsOutput"},"lineItemId":{"type":"string"},"merchantSku":{"type":"string"},"packOfDsku":{"type":"string"},"caseQty":{"type":"number","format":"double"}},"required":["logisticsSku","shipmentItemId","counts"],"type":"object","additionalProperties":false},"inbounds_CountsOutput":{"properties":{"sellable":{"type":"number","format":"double"},"damaged":{"type":"number","format":"double"},"expected":{"type":"number","format":"double"}},"required":["sellable","damaged","expected"],"type":"object","additionalProperties":false},"inbounds_PackageOutputUnstable":{"properties":{"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"dimensionUnit":{"$ref":"#/components/schemas/inbounds_LengthUnit","description":"Which length measurement standards are being used for the package.","example":"in"},"weightUnit":{"$ref":"#/components/schemas/inbounds_WeightUnit","description":"Which weight measurement standards are being used for the package.","example":"lb"},"id":{"type":"string"},"identicalPackageConfigIdentifer":{"type":"string"},"items":{"items":{"$ref":"#/components/schemas/inbounds_PackageItemData"},"type":"array"},"sellerLPN":{"type":"string","nullable":true,"description":"The seller's unique identifier for the package."}},"required":["id","items"],"type":"object","additionalProperties":false},"inbounds_LengthUnit":{"type":"string","enum":["in","cm","mm","m"]},"inbounds_WeightUnit":{"type":"string","enum":["oz","kg","lb","g"]},"inbounds_PackageItemData":{"properties":{"logisticsSku":{"type":"string"},"quantity":{"type":"integer","format":"int32"},"lotNumber":{"type":"string"},"expirationDate":{"type":"string","format":"date"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the inbound"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"inbounds_AddressesOutputUnstable":{"properties":{"to":{"$ref":"#/components/schemas/inbounds_InboundAddress"},"from":{"anyOf":[{"$ref":"#/components/schemas/inbounds_InboundAddress"},{"$ref":"#/components/schemas/inbounds_WarehouseAddress"}]}},"required":["to","from"],"type":"object","additionalProperties":false},"inbounds_InboundAddress":{"properties":{"address1":{"type":"string","description":"The first line of the address. Typically the street address or PO Box number.","maxLength":255},"address2":{"type":"string","description":"The second line of the address. Typically the number of the apartment, suite, or unit.","maxLength":255},"city":{"type":"string","description":"The name of the city, district, village, or town.","maxLength":255},"company":{"type":"string","description":"The name of the customer's company or organization.","maxLength":255},"countryCode":{"$ref":"#/components/schemas/inbounds_CountryCode","description":"The two-letter code for the country of the address."},"name":{"type":"string","description":"The full name of the customer.","maxLength":255},"firstName":{"type":"string","description":"The first name of the customer.","maxLength":255,"deprecated":true},"lastName":{"type":"string","description":"The last name of the customer.","maxLength":255,"deprecated":true},"phone":{"type":"string","description":"A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111."},"provinceCode":{"type":"string","description":"The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.","maxLength":30},"zip":{"type":"string","description":"The zip or postal code of the address.","maxLength":30}},"required":["address1","city","countryCode","provinceCode","zip"],"type":"object","additionalProperties":false},"inbounds_FreightResponse":{"properties":{"pickup":{"$ref":"#/components/schemas/inbounds_FreightPickupResponse"},"pallets":{"items":{"$ref":"#/components/schemas/inbounds_FreightPalletResponse"},"type":"array"},"bolId":{"type":"string"},"shippingProvider":{"type":"string"},"proId":{"type":"string"},"estimatedShipDate":{"type":"string","format":"date-time"},"carrierEmailAddress":{"type":"string"}},"type":"object","additionalProperties":false},"inbounds_FreightPickupResponse":{"properties":{"id":{"type":"number","format":"double"},"contactName":{"type":"string"},"contactPhone":{"type":"string"},"contactEmail":{"type":"string"},"liftGate":{"type":"boolean"},"pickupDate":{"type":"string","format":"date-time"},"customerReferenceNumber":{"type":"string"},"facilityOperatingHours":{"$ref":"#/components/schemas/inbounds_TimeWindow"}},"required":["id","contactName","contactPhone","contactEmail","pickupDate"],"type":"object","additionalProperties":false},"inbounds_TimeWindow":{"properties":{"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["startTime","endTime"],"type":"object","additionalProperties":false},"inbounds_FreightPalletResponse":{"properties":{"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"dimensionUnit":{"type":"string"},"weight":{"type":"number","format":"double"},"weightUnit":{"type":"string"},"id":{"type":"number","format":"double"},"palletConfigId":{"type":"string"}},"required":["length","width","height","dimensionUnit","weight","weightUnit","id"],"type":"object","additionalProperties":false},"inbounds_PrepRequestData":{"properties":{"boxContentLabels":{"type":"boolean"}},"required":["boxContentLabels"],"type":"object","additionalProperties":false},"inbounds_LogisticsInboundShipmentDestination":{"enum":["NETWORK","STORAGE"],"type":"string"},"inbounds_LogisticsInboundCargoType":{"enum":["PALLETIZED","FLOOR_LOADED_CONTAINER"],"type":"string"},"inbounds_ContainerInput":{"properties":{"size":{"$ref":"#/components/schemas/inbounds_LogisticsInboundContainerSize"},"id":{"type":"string"}},"required":["size"],"type":"object","additionalProperties":false},"inbounds_LogisticsInboundContainerSize":{"enum":["GENERAL_20FT","GENERAL_40FT"],"type":"string"},"inbounds_CustomAttributes":{"properties":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"}]}},"inbounds_PurchaseQuotesRequest":{"properties":{"quoteIds":{"items":{"type":"number","format":"double"},"type":"array"}},"required":["quoteIds"],"type":"object","additionalProperties":false},"inbounds_BadRequestError":{"properties":{"status":{"$ref":"#/components/schemas/inbounds_StatusCodes.BAD_REQUEST","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"inbounds_StatusCodes.BAD_REQUEST":{"enum":[400],"type":"number"},"inbounds_UpdateInboundShipmentRequest":{"properties":{"from":{"$ref":"#/components/schemas/inbounds_InboundAddress","description":"The origin address (sender address) for the shipment."},"shippingOption":{"$ref":"#/components/schemas/inbounds_InboundShippingOption","description":"The type of shipping method to use for the shipment."},"packages":{"items":{"$ref":"#/components/schemas/inbounds_UpdatePackageInput"},"type":"array","description":"Package configurations for updating existing packages on the shipment."},"freightDetails":{"$ref":"#/components/schemas/inbounds_UpdateFreightInput","description":"Freight input details for updating internal or external freight shipments."},"packageTrackingNumber":{"type":"string","description":"The tracking number for the package."},"prep":{"$ref":"#/components/schemas/inbounds_PrepRequestData","description":"Prep request data including box content labels configuration.\nOnly used by NETWORK shipments."},"createPackages":{"items":{"$ref":"#/components/schemas/inbounds_CreatePackageInput"},"type":"array","description":"New packages to create on the shipment."},"bookingId":{"type":"string","description":"Booking ID is the FLEX-ID of a Flexport freight shipment in Core.\n\ne.g., \"FLEX-1234567890\"","pattern":"^[Ff][Ll][Ee][Xx]-"},"shippingPlanName":{"type":"string","description":"The name of the shipping plan associated with the shipment."}},"type":"object","additionalProperties":false},"inbounds_UpdatePackageInput":{"properties":{"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"dimensionUnit":{"$ref":"#/components/schemas/inbounds_LengthUnit","description":"Which dimension measurement standards are being used for the package.","example":"in"},"weightUnit":{"$ref":"#/components/schemas/inbounds_WeightUnit","description":"Which weight measurement standards are being used for the package.","example":"lb"},"ids":{"items":{"type":"string"},"type":"array"},"shippingProvider":{"type":"string"},"trackingNumber":{"type":"string"}},"required":["ids"],"type":"object","additionalProperties":false},"inbounds_UpdateFreightInput":{"properties":{"pallets":{"items":{"$ref":"#/components/schemas/inbounds_PalletInput"},"type":"array"},"pickup":{"$ref":"#/components/schemas/inbounds_PickupInput"},"bolId":{"type":"string"},"shippingProvider":{"type":"string"},"proId":{"type":"string"},"estimatedShipDate":{"type":"string","format":"date-time"}},"type":"object","additionalProperties":false},"inbounds_PalletInput":{"properties":{"length":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"dimensionUnit":{"type":"string"},"weight":{"type":"number","format":"double"},"weightUnit":{"type":"string"},"numberOfIdenticalPallets":{"type":"integer","format":"int32"}},"required":["length","width","height","dimensionUnit","weight","weightUnit","numberOfIdenticalPallets"],"type":"object","additionalProperties":false},"inbounds_PickupInput":{"properties":{"readyDate":{"type":"string","format":"date-time"},"facilityHoursStart":{"type":"string"},"facilityHoursEnd":{"type":"string"},"contactName":{"type":"string"},"contactPhone":{"type":"string"},"contactEmail":{"type":"string"},"liftGate":{"type":"boolean"},"customerReferenceNumber":{"type":"string"}},"required":["readyDate","contactName","contactPhone","contactEmail","liftGate"],"type":"object","additionalProperties":false},"inbounds_CreatePackageInput":{"properties":{"length":{"type":"number","format":"float","description":"Length of the package.","example":12,"minimum":0.01},"width":{"type":"number","format":"float","description":"Width of the package.","example":3,"minimum":0.01},"height":{"type":"number","format":"float","description":"Height of the package.","example":5,"minimum":0.01},"weight":{"type":"number","format":"float","description":"Weight of the package.","example":3,"minimum":0.01},"dimensionUnit":{"$ref":"#/components/schemas/inbounds_LengthUnit","description":"Which length measurement standards are being used for the package.","example":"in"},"weightUnit":{"$ref":"#/components/schemas/inbounds_WeightUnit","description":"Which weight measurement standards are being used for the package.","example":"lb"},"items":{"items":{"$ref":"#/components/schemas/inbounds_ItemData"},"type":"array"},"numberOfIdenticalPkgs":{"type":"number","format":"double"},"sellerLPNs":{"items":{"type":"string"},"type":"array","description":"The seller's unique identifier for the package. The length of sellerLPNs array must match the value specified in numberOfIdenticalPkgs."}},"required":["items","numberOfIdenticalPkgs"],"type":"object","additionalProperties":false},"inbounds_ItemData":{"properties":{"logisticsSku":{"type":"string"},"quantity":{"type":"integer","format":"int32"},"lotNumber":{"type":"string"},"expirationDate":{"type":"string","format":"date"},"lineItemId":{"type":"string","description":"A line item identifier meaningful to the external system creating the inbound"}},"required":["logisticsSku","quantity"],"type":"object","additionalProperties":false},"inbounds_ArchiveShipmentRequest":{"properties":{"shipmentId":{"type":"integer","format":"int32","description":"Shipment ID to archive. Takes precedence over shippingPlanExternalId if both are provided."},"shippingPlanExternalId":{"type":"string","description":"External shipping plan ID to archive. Used when shipmentId is not available.\nExample: \"EXT-PLAN-123\""},"reason":{"$ref":"#/components/schemas/inbounds_ArchivalReason","description":"Reason for archiving the shipment."},"comment":{"type":"string","description":"Optional comment. Trimmed to 250 characters if longer."}},"type":"object","additionalProperties":false},"inbounds_ArchivalReason":{"enum":["ORDER_CREATED_BY_MISTAKE","INCORRECT_PRODUCTS_ORDERED","INCORRECT_SHIPPING_ADDRESS","INCORRECT_SHIPPING_METHOD","ISSUE_WITH_LABELS","DUPLICATE_ORDER","INVENTORY_ALREADY_OUT_OF_STOCK","CUSTOMER_CHANGED_OR_CANCELLED_ORDER","DUPLICATE_SHIPMENT","SHIPMENT_NEEDS_UPDATE","SHIPMENT_CANCELLED","OTHER"],"type":"string"},"network-events_EventsResponseItem":{"properties":{"id":{"type":"string"},"type":{"type":"string"},"time":{"type":"string"},"payload":{"$ref":"#/components/schemas/network-events_EventPayloadType"}},"required":["id","type","time","payload"],"type":"object","additionalProperties":false},"network-events_EventPayloadType":{"properties":{},"additionalProperties":{"type":"string"},"type":"object","description":"Event payload"},"network-events_EventId":{"type":"string","pattern":"^([\\w]{0,50})$"},"products_ApiBundleResponse202310":{"properties":{"externalBundleId":{"$ref":"#/components/schemas/products_ExternalBundleIdType"},"title":{"type":"string","description":"The bundle title or short description. Should represent a single line of text suitable to\nidentify the bundle or for search purposes.","minLength":3,"maxLength":255},"sku":{"$ref":"#/components/schemas/products_SkuType"},"bundleContents":{"items":{"$ref":"#/components/schemas/products_BundleContent202310"},"type":"array","minItems":1,"maxItems":250},"bundleId":{"$ref":"#/components/schemas/products_BundleIdType"},"createdAt":{"$ref":"#/components/schemas/products_CreationDate"}},"required":["externalBundleId","title","sku","bundleContents","bundleId","createdAt"],"type":"object","additionalProperties":false},"products_ExternalBundleIdType":{"type":"string","description":"A permanent unique reference for this bundle generated by and meaningful to the API user.\nThis value will be used when sending orders to identify the bundle to ship.\nThis value must be unique among all bundles created via API.","minLength":1,"maxLength":255},"products_SkuType":{"type":"string","description":"The human-readable Stock Keeping Unit (SKU) for reporting. This value may change over time.","minLength":1,"maxLength":255},"products_BundleContent202310":{"properties":{"productId":{"$ref":"#/components/schemas/products_ProductIdType"},"quantity":{"type":"number","format":"double","description":"Provide the quantity of that product that will be part of the bundle being created."}},"required":["productId","quantity"],"type":"object","additionalProperties":false},"products_ProductIdType":{"type":"string","description":"The globally unique product identifier created by Flexport and assigned on product creation.\nMay be referred to in other documentation as the Flexport SKU or DSKU.","pattern":"^D[0-9a-zA-Z]+$","minLength":11,"maxLength":11},"products_BundleIdType":{"type":"string","description":"The globally unique bundle identifier created by Flexport and assigned on bundle creation.\nMay be referred to in other documentation as the Flexport SKU or BSKU.","pattern":"^B[0-9a-zA-Z]+$","minLength":11,"maxLength":11},"products_CreationDate":{"type":"string","format":"date-time","description":"The timestamp of creation in RFC 3339 format.\ne.g. 2017-07-21T17:32:28Z"},"products_UnauthorizedError":{"properties":{"status":{"$ref":"#/components/schemas/products_StatusCodes.UNAUTHORIZED","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"},"code":{"$ref":"#/components/schemas/products_StatusCodes.UNAUTHORIZED"},"message":{"type":"string"}},"required":["status","type","title","code","message"],"type":"object","additionalProperties":false},"products_StatusCodes.UNAUTHORIZED":{"enum":[401],"type":"number"},"products_NotFoundError":{"properties":{"status":{"$ref":"#/components/schemas/products_StatusCodes.NOT_FOUND","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"products_StatusCodes.NOT_FOUND":{"enum":[404],"type":"number"},"products_ForbiddenError":{"properties":{"status":{"$ref":"#/components/schemas/products_StatusCodes.FORBIDDEN","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"products_StatusCodes.FORBIDDEN":{"enum":[403],"type":"number"},"products_ApiBundle202310":{"properties":{"externalBundleId":{"$ref":"#/components/schemas/products_ExternalBundleIdType"},"title":{"type":"string","description":"The bundle title or short description. Should represent a single line of text suitable to\nidentify the bundle or for search purposes.","minLength":3,"maxLength":255},"sku":{"$ref":"#/components/schemas/products_SkuType"},"bundleContents":{"items":{"$ref":"#/components/schemas/products_BundleContent202310"},"type":"array","minItems":1,"maxItems":250}},"required":["externalBundleId","title","sku","bundleContents"],"type":"object","additionalProperties":false},"products_UnprocessableEntityError":{"properties":{"status":{"$ref":"#/components/schemas/products_StatusCodes.UNPROCESSABLE_ENTITY","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"products_StatusCodes.UNPROCESSABLE_ENTITY":{"enum":[422],"type":"number"},"products_ApiProductResponse":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"logisticsSku":{"$ref":"#/components/schemas/products_ProductIdType"},"merchantSku":{"$ref":"#/components/schemas/products_SkuType"},"barcodes":{"items":{"type":"string"},"type":"array","description":"The list of associated barcodes for this product."},"dimensions":{"$ref":"#/components/schemas/products_Dimension"},"international":{"$ref":"#/components/schemas/products_CustomsInput","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping."},"dimsLocked":{"type":"boolean","description":"**true** if the dimensions and weight of the item are verified and trusted.\nMust be true for non-zero inventory levels to be reported. If true, item dimensions\nand weight can no longer be updated via the API."},"createdAt":{"$ref":"#/components/schemas/products_CreationDate"},"updatedAt":{"$ref":"#/components/schemas/products_UpdatedDate"},"category":{"type":"string"}},"required":["name","logisticsSku","merchantSku","barcodes","dimsLocked"],"type":"object","additionalProperties":false},"products_Dimension":{"properties":{"weight":{"type":"number","format":"double","description":"Weight of the product by itself."},"weightUnit":{"$ref":"#/components/schemas/products_WeightUnit"},"height":{"type":"number","format":"double","description":"Height of the product by itself."},"width":{"type":"number","format":"double","description":"Width of the product by itself."},"length":{"type":"number","format":"double","description":"Length of the product by itself."},"lengthUnit":{"$ref":"#/components/schemas/products_LengthUnit"}},"required":["weight","weightUnit","height","width","length","lengthUnit"],"type":"object","additionalProperties":false},"products_WeightUnit":{"type":"string","enum":["oz","kg","lb","g"]},"products_LengthUnit":{"type":"string","enum":["in","cm","mm","m"]},"products_CustomsInput":{"properties":{"originCountry":{"$ref":"#/components/schemas/products_CountryCode","description":"The 2-letter IANA code for the product's country of origin.\nNeeded only for international shipping."},"tariffCode":{"type":"string","description":"Harmonized tariff code.\nAccepted forms: `620640`/`6206.40`, `62064030`/`6206.40.30`, `6206403050`/`6206.40.3050`.\nNeeded only for international shipping.","pattern":"^\\d{4}(\\.?)\\d{2}(?:\\1(?:\\d{4}|\\d{2}))?$"},"customsValue":{"type":"number","format":"double","description":"The value of one unit of this product in USD for the purpose of customs declaration.\nNeeded only for international shipping.","minimum":0.01},"description":{"type":"string","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping.","minLength":1,"maxLength":255}},"required":["originCountry","tariffCode","customsValue","description"],"type":"object","additionalProperties":false},"products_CountryCode":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MK","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW"],"nullable":false},"products_UpdatedDate":{"type":"string","format":"date-time","description":"The timestamp when last updated in RFC 3339 format.\ne.g. 2017-07-21T17:32:28Z"},"products_CreateProductModel":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"merchantSku":{"$ref":"#/components/schemas/products_SkuType"},"customsInformation":{"$ref":"#/components/schemas/products_CustomsInput","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping."},"dimensions":{"$ref":"#/components/schemas/products_Dimension"},"category":{"type":"string"}},"required":["name","merchantSku"],"type":"object","additionalProperties":false},"products_BadRequestError":{"properties":{"status":{"$ref":"#/components/schemas/products_StatusCodes.BAD_REQUEST","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"products_StatusCodes.BAD_REQUEST":{"enum":[400],"type":"number"},"products_BarcodeOption":{"properties":{"barcodeValue":{"type":"string","description":"The value of an barcode.","minLength":6,"maxLength":255}},"required":["barcodeValue"],"type":"object","additionalProperties":false},"products_UpdateProductModel":{"properties":{"name":{"type":"string","description":"The product name or short description. Should represent a single line of text suitable to\nidentify the product or for search purposes.","minLength":1,"maxLength":255},"merchantSku":{"$ref":"#/components/schemas/products_SkuType"},"customsInformation":{"$ref":"#/components/schemas/products_CustomsInput","description":"Customs description - should reflect usage and materials.\nNeeded only for international shipping."},"dimensions":{"$ref":"#/components/schemas/products_Dimension"},"category":{"type":"string"}},"type":"object","additionalProperties":false},"reports_Report":{"properties":{"status":{"$ref":"#/components/schemas/reports_ReportStatus","description":"<ol>\n  <li>PENDING: The report is still being generated</li>\n  <li>SUCCESS: Report has been generated, use the url field to download the report as a CSV file</li>\n  <li>ERROR: There was an issue while creating this report, see errorMessage field for details</li>\n  <li>EMPTY_REPORT_GENERATED: Report was generated successfully but contains no data</li>\n</ol>"},"urlExpiration":{"type":"string","format":"date-time","description":"date-time of download url expiration in GMT."},"url":{"type":"string","description":"download report as a csv using this URL. Note that this URL will expire at the urlExpiration time."},"errorMessage":{"type":"string","description":"If status is ERROR, a description of the error."}},"required":["status"],"type":"object","additionalProperties":false},"reports_ReportStatus":{"enum":["PENDING","SUCCESS","ERROR","EMPTY_REPORT_GENERATED"],"type":"string"},"reports_UnauthorizedError":{"properties":{"status":{"$ref":"#/components/schemas/reports_StatusCodes.UNAUTHORIZED","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"},"code":{"$ref":"#/components/schemas/reports_StatusCodes.UNAUTHORIZED"},"message":{"type":"string"}},"required":["status","type","title","code","message"],"type":"object","additionalProperties":false},"reports_StatusCodes.UNAUTHORIZED":{"enum":[401],"type":"number"},"reports_NotFoundError":{"properties":{"status":{"$ref":"#/components/schemas/reports_StatusCodes.NOT_FOUND","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"reports_StatusCodes.NOT_FOUND":{"enum":[404],"type":"number"},"reports_ReportGenerationResponse":{"properties":{"reportReference":{"type":"string","description":"A reference for polling the status of the report."}},"required":["reportReference"],"type":"object","additionalProperties":false},"reports_ReportGenerationRequest":{"properties":{"reportType":{"$ref":"#/components/schemas/reports_SellerReportType"},"startDate":{"type":"string","format":"date-time","description":"The start date for the data in the report."},"endDate":{"type":"string","format":"date-time","description":"The end date for the data in the report."},"isScheduled":{"type":"boolean"},"jobId":{"type":"number","format":"double"},"timezone":{"$ref":"#/components/schemas/reports_Timezone"},"countryCode":{"type":"string"}},"required":["reportType"],"type":"object","additionalProperties":false},"reports_SellerReportType":{"enum":["Orders-Backorder_Items","Billing-Credits_Balance","Billing-Summary_Report","Claims-Claims_Submitted","Pricing-Fulfillment_Fees","Inbounds-Packages","Inbounds-Inventory_Reconciliation","Inbounds-Monthly_Reconciliation","Inbounds-Shipping_Plan_Reconciliation","Inbounds-Shipping_Plan_Reconciliation_V2","Inbounds-Shipment_Custody_Details","Inbounds-Box_Custody_Details","Incident-Impact_Report","Inbounds-Seller_Problems_Report","Inventory-Units_In_Long_Term_Storage","Inventory-Ecommerce_Monthly_Reconciliation","Inventory-Ecommerce_Monthly_Reconciliation_Using_Ledger","Inventory-Ecommerce_Transaction_History","Inventory-Levels_Today","Inventory-Hourly_Visibility_Report","Inventory-Transaction_History_Between_Dates","Inventory-Levels_Today_Using_Ledger","Inventory-Lot_Tracking_FEFO_All_Products","Inventory-Lot_Tracking_FEFO_All_Products_Using_Ledger","Inventory-Lot_Tracking_FEFO_Single_Product","Inventory-Lot_Tracking_FEFO_Single_Product_Using_Ledger","Inventory-Detail_Reserve_Storage_Using_Ledger","Orders-Shipments","Orders-All_Orders","Parcel-All_Parcels","Parcel_All_Parcels_Tracking_Details","Products-All_SKUs_With_Alias_Counts","Products-All_SKUs_With_Dims_And_Alias_Counts","Products-All_CasePacks_With_Dims_And_Inventory","Products-Available_SKUs_With_Alias_Counts","Products-Available_SKUs_With_No_Aliases","Products-SKUs_With_Linked_Aliases","Products-Catalog_Item_Master","Reserve-Storage-Orders_And_Transfers","Replenishment-Order_Item_Report","Replenishment-Order_Tracking_Report","Reserve-Storage-Pallet-Inventory","Reserve-Storage-Pallet_Inventory_V2","Returns-All_SKUs","Returns-All_Returns","EOD_Report","EDO_Report_Unwaived","Inventory-Snapshot_Adhoc_Report","Returns-Processed_In_Day_Excluding_IWT","Returns-Processed_In_Day_Including_IWT","Inbounds-Added_Into_Stock_Today","Returns-Put_Away_Report","IWT-Stock_Ledger_Report","Unexpected-Item_Daily_Processing_Report","OTS_Topline","Stockout_Orders_And_Units_Topline","Stock_Loss_Weekly_Topline","Returns_Processing_To_Putaway_Topline","Returns_Back_To_Stock_Topline","Returns_IWT_SLA_Topline","OTS_Drilldown","Stockout_Units_Per_Order_Id_Drilldown","Stock_Loss_Weekly_Transactions_By_SKU_Drilldown","Stock_Loss_Weekly_Transactions_Drilldown","Returns_Processing_To_Putaway_Drilldown","Returns_Back_To_Stock_Drilldown","Returns_IWT_SLA_Details_Drilldown","Billing-Unbundled_Orders_Billing_Report","Conduit-Appointment_details"],"type":"string"},"reports_Timezone":{"enum":["America/Los_Angeles","UTC"],"type":"string"},"reports_UnprocessableEntityError":{"properties":{"status":{"$ref":"#/components/schemas/reports_StatusCodes.UNPROCESSABLE_ENTITY","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"reports_StatusCodes.UNPROCESSABLE_ENTITY":{"enum":[422],"type":"number"},"reports_BadRequestError":{"properties":{"status":{"$ref":"#/components/schemas/reports_StatusCodes.BAD_REQUEST","description":"The HTTP [status code](https://tools.ietf.org/html/rfc7231#section-6)\nthat identifies the category of this problem."},"type":{"type":"string","description":"A URI reference that identifies the problem type.\nWhen dereferenced, it provides human-readable documentation for one of\nthe problem types documented [here](#section/Errors)."},"title":{"type":"string","description":"A short, human-readable summary of the problem type."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."},"instance":{"type":"string","description":"An internal ID that uniquely identifies this specific occurrence of the problem in our backend system"}},"required":["status","type","title"],"type":"object","additionalProperties":false},"reports_StatusCodes.BAD_REQUEST":{"enum":[400],"type":"number"}},"securitySchemes":{"NONE":{"type":"http","scheme":"basic"},"CLIENT_CREDENTIALS":{"type":"http","scheme":"basic"},"TOKEN":{"type":"apiKey","name":"X-Shopify-Access-Token","in":"header"},"BEARER":{"type":"http","scheme":"bearer"}}},"info":{"title":"Logistics API","version":"2026-02","contact":{"name":"Flexport Support","url":"https://support.portal.flexport.com/hc/en-us/articles/1500009448562-Contacting-Support"},"license":{"name":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0.html"},"x-logo":{"url":"https://logistics-api.flexport.com/images/flexportLogo.png"},"description":"# Getting Started\n\nFlexport Logistics API provides access to the Flexport logistics network that powers all of our e-commerce operations, such as order fulfillment, order returns, freight, and parcel.  With the Logistics API, you can create custom applications and integrations to access your Flexport account, or authorize Flexport-approved partner applications for that purpose.\n\n<div class=\"doc-callout\">\n  <strong>OpenAPI specification.</strong> Download or view the raw OpenAPI 3.x spec at <a href=\"https://logistics-api.flexport.com/logistics/api/2026-02/documentation/raw\"><code>/logistics/api/2026-02/documentation/raw</code></a>. Use it to generate clients with <a href=\"https://openapi-generator.tech\">openapi-generator</a>, import into Postman, or build custom tooling.\n</div>\n\nTo start using the Logistics API, you must have an active [Flexport Portal](https://portal.flexport.com) account.  To inbound physical inventory, ship orders, process returns or buy parcel labels, you'll also need to set up a billing account.\n\nThe API has two audiences: **merchants**, who build integrations for their own business or shop, and **partners**, who build applications that serve Flexport merchants or their own customers.\n\n<div class=\"doc-cta-row\">\n  <a class=\"doc-cta doc-cta--primary\" href=\"#section/Getting-Started/Account-Creation\">\n    <strong>I'm a Merchant →</strong>\n    <span>Integrate the API with your own store or business.</span>\n  </a>\n  <a class=\"doc-cta doc-cta--secondary\" href=\"#section/Partner-Program\">\n    <strong>I'm a Partner →</strong>\n    <span>Build an application that serves Flexport merchants.</span>\n  </a>\n</div>\n\n## Account Creation\n\nCreate a free [Flexport Portal](https://portal.flexport.com) account. Complete the questions to create your account, and don't forget to add your **business name**. When asked to create a catalog, you can select _\"I'm not selling online yet\"_.\n\n- You can access the [Products](#tag/Products), [Webhooks](#tag/Webhooks) and [Reports](#tag/Reports) API immediately regardless of billing status.\n- To use the [Parcels](#tag/Parcels) or [Returns](#tag/Returns) API, your account must meet certain criteria. To inquire, submit a [support ticket](https://support.portal.flexport.com/hc/en-us/requests/new).\n- All other APIs require setting up [billing](https://support.portal.flexport.com/hc/en-us/articles/115003185313-View-Billing-in-the-Seller-Portal) in the Flexport Seller Portal.\n\n### Account Types\n\n| Account type             | Purpose\n|--------------------------|-------------------------------------------------------------------------------|\n| Production    | Used for fulfilling real orders with physical inventory.   |\n| Sandbox     | Used for testing fulfillment with simulated inventory and orders. Returns and Parcels do not support Sandbox at this time. |\n\nProduction and Sandbox are completely isolated and separate Seller Portal accounts.  Production account holds physical inventory and incurs costs when orders ship to customers.\n\nSandbox is an API test environment where you can test your application prior to running it against your production account.  Inventory inbounded to the Sandbox account is simulated and auto-received, and orders may be placed against it that are also automatically shipped.\nRefer to [Testing in Sandbox](#section/Getting-Started/Testing-in-Sandbox) for more information.\n\n## Authentication and Authorization\n\nTo use the API, you will need an access token. Each access token is issued with one or more permission scopes that define which resources and operations it can access. You can issue separate tokens scoped to different resources — for example, one token scoped only to products and another scoped only to orders — to follow the principle of least privilege.\n\n### Creating Access Tokens\n\nThere are two ways to request an access token:\n1. Using the UI in [Seller Portal -> Settings -> API Tokens](https://portal.flexport.com/settings/api-tokens).  \n1. Using the API as described [here](#tag/OAuth/operation/AuthorizationRedirect)\n\nWhen creating a token, select the [permission scopes](#section/Common-Resources/Permission-Scopes) it should carry — each scope grants access to a specific resource family in either read-only or read-write mode. The required scope for each operation is listed on its reference page under **Authorizations**.\n\nYou must be an Administrator of your organization to manage access tokens.\n\n<div class=\"doc-callout doc-callout--warning\">\n  <strong>Token expiry.</strong> Merchant tokens expire after one year by default and return <code>401</code> when expired. Partner (3PL) tokens do not expire. Administrators can revoke tokens at any time. Rotate tokens in <a href=\"https://portal.flexport.com/settings/api-tokens\">Settings → API Tokens</a>.\n</div>\n\n## Quickstart\n\nThis quickstart walks you through verifying your access token and making your first API request. You'll confirm your token is wired up correctly before moving on to creating products, inbound shipments, and orders.\n\n### 1. Get an access token\n\nThe Logistics API authenticates requests with a bearer token. In Seller Portal, go to [Settings → API Tokens](https://portal.flexport.com/settings/api-tokens) and click **Create Token**. Copy the token — you'll use it in the next step.\n\nIf you don't have a Flexport account yet, follow [Account Creation](#section/Getting-Started/Account-Creation) first. For the full token flow, including partner (OAuth) tokens, see [Creating Access Tokens](#section/Getting-Started/Creating-Access-Tokens).\n\n### 2. Set your token\n\n<div class=\"doc-codeblock\">\n  <div class=\"doc-codeblock__panel\">\n    <pre><code class=\"language-bash\">export FLEXPORT_TOKEN=\"YOUR_API_TOKEN\"</code></pre>\n  </div>\n</div>\n\n### 3. Call the API\n\n**GET** `/logistics/api/2026-02/warehouses/active`\n\nExamples below use API version `2026-02`. Substitute the version you target in production — see [Versioning](#section/Common-Resources/Versioning).\n\n<div class=\"doc-codeblock\">\n  <div class=\"doc-codeblock__panel doc-codeblock__panel--request\">\n    <div class=\"doc-codeblock__header\">\n      <span class=\"doc-codeblock__title\">cURL Request</span>\n    </div>\n    <pre><code class=\"language-bash\">curl \"https://logistics-api.flexport.com/logistics/api/2026-02/warehouses/active\" \\\n  -H \"Authorization: Bearer $FLEXPORT_TOKEN\"</code></pre>\n  </div>\n\n  <div class=\"doc-codeblock__panel doc-codeblock__panel--response\" data-status-class=\"success\">\n    <div class=\"doc-codeblock__header\">\n      <span class=\"doc-codeblock__dot\"></span>\n      <select class=\"doc-codeblock__select\" aria-label=\"Response status\">\n        <option value=\"200\" data-status-class=\"success\">200 - Response</option>\n        <option value=\"401\" data-status-class=\"error\">401 - Unauthorized</option>\n        <option value=\"403\" data-status-class=\"error\">403 - Forbidden</option>\n      </select>\n    </div>\n    <pre data-status=\"200\"><code class=\"language-json\">[\n  \"ATL1\",\n  \"LAX2\",\n  \"RNO1\"\n]</code></pre>\n    <pre data-status=\"401\" hidden><code class=\"language-json\">{\n  \"status\": 401,\n  \"type\": \"https://docs.logistics-api.flexport.com/2026-02/#section/Errors/401-Unauthorized\",\n  \"title\": \"Unauthorized\",\n  \"instance\": \"92e04577-c56b-47b9-b075-62096165a0ce\",\n  \"code\": 401,\n  \"message\": \"Unauthorized\"\n}</code></pre>\n    <pre data-status=\"403\" hidden><code class=\"language-json\">{\n  \"status\": 403,\n  \"type\": \"https://docs.logistics-api.flexport.com/2026-02/#section/Errors/403-Forbidden\",\n  \"title\": \"Forbidden\",\n  \"instance\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n  \"code\": 403,\n  \"message\": \"Forbidden\"\n}</code></pre>\n  </div>\n</div>\n\nThe request invokes [`GetActiveWarehouses`](#tag/Warehouses/operation/GetActiveWarehouses) and requires the `read_logistics_warehouses` scope. It returns the warehouse codes (for example, `ATL1`) available to your account — the same identifiers that appear on shipment and order responses to indicate the fulfillment facility. You can filter by country using the `countryCode` query parameter (`US`, `NL`).\n\nA `200 OK` with this array confirms the token is valid and correctly scoped. A `401 Unauthorized` indicates an invalid, malformed, or expired token; a `403 Forbidden` indicates the token is valid but missing the `read_logistics_warehouses` scope. See [Errors](#section/Errors) for resolution.\n\n### 4. Build your integration\n\nWith the token verified, the typical integration order is:\n\n<table class=\"doc-next-steps\">\n  <thead>\n    <tr><th>Step</th><th>API</th><th>What it does</th></tr>\n  </thead>\n  <tbody>\n    <tr><td>Sync your catalog</td><td><a href=\"#tag/Products\">Products</a></td><td>Create products and barcodes that identify your SKUs.</td></tr>\n    <tr><td>Send inventory in</td><td><a href=\"#tag/Inbounds\">Inbounds</a></td><td>Create an inbound shipment that moves units into a warehouse.</td></tr>\n    <tr><td>Fulfill D2C orders</td><td><a href=\"#tag/Orders\">Orders</a></td><td>Submit orders that Flexport will pick, pack, and ship.</td></tr>\n    <tr><td>Buy parcel labels</td><td><a href=\"#tag/Parcels\">Parcels</a></td><td>Get rates and purchase labels for parcels you ship yourself.</td></tr>\n    <tr><td>Process returns</td><td><a href=\"#tag/Returns\">Returns</a></td><td>Create return shipments and track returned inventory.</td></tr>\n    <tr><td>Receive event notifications</td><td><a href=\"#tag/Webhooks\">Webhooks</a></td><td>Get pushed notifications for order, shipment, and inventory events instead of polling.</td></tr>\n  </tbody>\n</table>\n\n## Testing in Sandbox\nSandbox allows Flexport customers and partners using the Logistics API to test their applications without moving physical goods around. \n\n### Requesting Sandbox Account\nTo request a Sandbox account:\n- Register for a new separate account on Seller Portal\n- Reach out to [Support](https://support.portal.flexport.com/hc/en-us/requests/new) and provide your account information to convert your account into a Sandbox account.  (This may be self-served in the future).\n\n### Testing your application in Sandbox\n\nAfter you have created the Sandbox account using the steps above, you can test your application against it.\n\nSandbox uses the same API endpoint as production.  The API token serves as a pointer that allows the backend system to find the account you are accessing.  Use the API token from the Sandbox account to work with Sandbox data.  Sandbox and Production accounts are completely isolated from one another, as if they were accounts from separate customers.\n\n### Sample API Workflow\nAs an example, you can use this workflow to go from production creation to inbounding inventory and order placement in Sandbox:\n1) [Create a product](#tag/Products) via the API\n  - Be sure to include dimensions\n2) Ensure the product has dimensions and weight.  \n  - You can validate this in [Seller Portal](https://portal.flexport.com/inventory), if any are missing you can enter them manually.\n  - In our production environment, all new products are measured on inbound and you are not required to provide dimensions - although you can.\n3) [Create an inbound shipment](#tag/Inbounds) using the API.\n  - The inbound will automatically received within an hour.\n  - Only inbounds created via the API will be auto-received (using Seller Portal UI for creating an inbound is not supported).\n4) Wait for the inbound to be auto-received\n  - This can take up to an hour (this time may be lowered in the future)\n  - [Inventory counts for your product](https://portal.flexport.com/inventory) will be updated in Seller Portal after inbound is received\n5) [Place an order](#tag/Orders) via API\n  - Order will automatically be picked, packed and shipped within an hour.\n\nAt this time, our sandbox environment only supports the happy-path use cases. We currently cannot test:\n- Lot & Expiration dates\n- Split shipments\n- Overage, shortage & damaged inbounds\n- Returns\n\n# Partner Program\nLogistics API may be used by Merchants and by Partners.  Either a Merchant or a Partner may develop a software application that uses the Logistics API.\n\nKey difference between a Merchant and a Partner is that:\n- Merchant writes a software application that uses the Logistics API against their own account only.\n- Partner writes a more general software application that uses the Logistics API on behalf of multiple merchants that gave their consent.\n\n## Partner Registration\nCurrently partner registration is manual but may be self-served in the future.\n\nIf you wish to develop an application for use by one or more merchants, reach out to us to request a unique application ID and secret.  Your software application must include a public API server that receives callbacks with the authorization code whenever a merchant authorizes it using the [OAuth authorization_code flow](#tag/OAuth/operation/AuthorizationRedirect).  In response to callback, your application would exchange the one-time OAuth code for an API token.\n\nProvide the following:\n- Detailed description of your business and what your software application will do.\n- Callback URI (registered in DNS) where your application will be receiving authorization codes.\n\nYou will receive your application ID and secret.  You must use the application ID and secret as client credentials when exchanging OAuth authorization code for an API token during [OAuth token exchange](#tag/OAuth#operation/TokenExchange).\n\n## Merchant Consent \nIn order for your application to receive Merchant consent and the API token, you would direct the merchant to the [OAuth authorization_code flow](#tag/OAuth/operation/AuthorizationRedirect) that has your application ID, as well as the scopes that your application requires.  You do not need to include the callback URI, because it is known to us since your application is registered.  \n\nFor example, if your application requires read access to products and orders and the application ID is 01HKBBNEVYKM0D84E63MMYN022 the URI is: \nhttps://logistics-api.flexport.com/logistics/api/2026-02/oauth/authorize?response_type=code&scope=read_logistics_products+read_logistics_orders&client_id=01HKBBNEVYKM0D84E63MMYN022\n\nWhen Merchant visits this URL they'll be shown a Consent page displaying your application name and required access (scopes).  If they click through to agree to use your application, your application server will receive the OAuth code on the callback URI that you registered with your application.\n\nYour application would then exchange the OAuth authorization code for an API token during [OAuth token exchange](#tag/OAuth#operation/TokenExchange).  For client credentials, you would submit your application ID 01HKBBNEVYKM0D84E63MMYN022 and the secret you received.  In addition to the API token, the response will include the logisticsAccountId of the merchant.\n\nYour application must treat each API token with utmost care and store in a secure encrypted location and encrypt and protect it while in transit.\n\n# Migration Guides\n\nThis section will guide you through migration from the [Deliverr API V1](https://api.deliverr.com/documentation/v1/spec).\n\nHere are the key differences between the two APIs at a high level:\n\n| Difference                   | Logistics API version 2023-04        |       Deliverr API version 1.0.0     |\n|------------------------------|--------------------------------------|--------------------------------------|\n| OAuth 2.0, [RFC6749](https://www.rfc-editor.org/rfc/rfc6749) compliant | Yes | No |\n| Release schedule             | Every 3 months | Ad-hoc |\n\nA handful of identifiers have been renamed or added in the Logistics API. Refer to the tables, like the one below, in each of the following guides.\n\n| Changes in    | Deliverr API      | Logistics API      |\n|---------------|-------------------|--------------------|\n| All resources | productId (DSKU)  | logisticsSku       |\n\n## Access tokens\n\nYou must request new access tokens as described [here](#section/Getting-Started/Authentication-and-Authorization) when migrating from Deliverr API.\n\n## Inbounds\n\n| Changes in    | Deliverr API           | Logistics API      |\n|---------------|------------------------|--------------------|\n| All resources | productId              | logisticsSku       |\n| Inbounds      | shippingPlan           | shipment           |\n| Inbounds      | externalShippingPlanId | N/A                |\n| Inbounds      | destination            | N/A                |\n| Inbounds      | caseQuantity           | N/A                |\n\nIn the Logistics API, inventory inbounding has been simplified and a number of new endpoints have been added. Refer to the [Inbounds](#tag/Inbounds) reference for additional details.\n\nKey differences between the API are highlighted below:\n1. Shipments can be read individually by the `id` of the shipment or as a list by specifying a list of ids via the `shipmentIds` query parameter\n2. `logisticsSku` replaces `productId` as the identifier for the product being inbounded\n3. When creating a shipment, the fields `externalShippingPlanId`, `destination` and `caseQuantity` are no longer supported\n4. You cannot retrieve a shipment by an \"external\" `shippingId`.\n5. Prep services such as box content labels can be required when creating a shipment\n6. The GET labels endpoint in the Deliverr API has been replaced by an endpoint to request an expanded set of documents for the shipment [here](#tag/Inbounds/operation/GetTransferDocumentV2), which includes box content labels, shipping labels and bill of landing.\n\n## Products\n\n| Changes in    | Deliverr API      | Logistics API      |\n|---------------|-------------------|--------------------|\n| All resources | productId         | logisticsSku       |\n| Product       | msku              | merchantSku        |\n| Product       | externalProductId | N/A                |\n| Inventory     | availableUnits    | available          |\n| Inventory     | N/A               | onHand             |\n| Inventory     | N/A               | unavailable        |\n\nA few fundamental changes:\n\n- It is no longer necessary to link an alias to a product before use, as linking functionality is optional\n- For placing fulfillment orders, use `logisticsSku` instead of `externalProductId` in the list of **lineItems**\n- In the seller portal, your existing `externalProductId` mapping under the aliases section of a Product Detail page as \"Deliverr API\" will not be used in the Logistics API and will remain unchanged\n- You cannot update a product's dimensions (`height`, `length`, `width`, `weight`), units (lb/kg, in/cm), or category via the API\n\nThe [retrieve inventory](#tag/Products/operation/GetInventory)retrieve inventory endpoint response contains a few new fields.\n\nThe [retrieve warehouse details](#tag/Products/operation/GetWarehouseDetails) endpoint is a POST request instead of a GET. Instead of passing a list of `productId` in the `productIds` query parameter, you will now send a body in the following JSON format:\n\n<!-- TODO: update all endpoints to use logisticsSku instead of logisticsSKU and update all fragments named SKU to sku per the codex. -->\n```json\n{\n  \"logisticsSKUs\": [\n    \"DSKU1\",\n    \"DSKU2\",\n    \"DSKU3\"\n  ]\n}\n```\n\n## Bundles\n\nThe bundle endpoints remain semantically similar between the Deliverr API and the Logistics API. However, the bundle creation flow has changed between the APIs. The order endpoints in the Logistics API do not support fulfilling orders by `bundleId`. Merchants who wish to fulfill bundle orders in the logistics API have two options:\n- You manage the mapping of bundles to their definitions in your systems, which is an array of `{ logisticsSku, quantity }`.\n- You define bundles via the API or the Seller Portal. Use the GetBundle endpoint to retrieve the bundle definition.\n\nIn both cases, you must use the `logisticsSku` and its total quantity when [creating an order](#tag/Orders/operation/CreateOrder).\n\nThe following operations no longer exist in the Logistics API.\n\n| Deprecated Endpoints            |\n|---------------------------------|\n| PATCH [LinkAliasToBundle](https://api.deliverr.com/documentation/v1/spec#tag/Bundles/operation/LinkAliasToBundle) |\n| PATCH [UnlinkAliasFromBundles](https://api.deliverr.com/documentation/v1/spec#tag/Bundles/operation/UnlinkAliasFromBundles) |\n| GET [GetBundleByExternalBundleId](https://api.deliverr.com/documentation/v1/spec#tag/Bundles/operation/GetBundleByExternalBundleId) |\n\n## Orders\n\n| Changes in endpoint           | Deliverr API      | Logistics API          |\n|-------------------------------|-------------------|------------------------|\n| Create order                  | externalProductId | logisticsSku           |\n| Create order                  | orderShipmentTime | promisedShipByTime     |\n| Create order                  | orderDeliverTime  | promisedDeliveryByTime |\n| Create order                  | shipToAddress     | address                |\n| Create order                  | deliverDays       | deliveryDays           |\n| Create order                  | N/A               | packingSlipUrl         |\n| Create order                  | N/A               | duties                 |\n| Create order                  | createdAt         | N/A                    |\n| Create order                  | updatedAt         | N/A                    |\n| Create order                  | orderCreationTime | N/A                    |\n\nThe response payload for getting an order’s information has now changed. See the [retrieve order](#tag/Orders/operation/GetOrder) response.\n\n## Reports\n\nBeyond changes to the URIs, the report endpoints are a one-to-one mapping between the Deliverr API and the Logistics API.\n\n<!-- \n## Parcels & Parcel Integration\nPlaceholder: to be completed by the domain team\n-->\n\n<!-- \n## Returns\nPlaceholder: to be completed by the domain team\n-->\n\n## Webhooks\n\nYour webhook subscriptions must be recreated using the [create webhook](#tag/Webhooks/operation/CreateWebhook) endpoint.\n\n# Common Resources\n\nBesides following the OpenAPI 3.0 specification, below is a list of common resources and standards shared across the APIs.\n\n## Headers\n\nThe Logistics API makes use of the following custom HTTP headers.\n\n| Header field name                | in request | in response | description |\n|----------------------------------|------------|-------------|-------------|\n| `x-correlation-id`               | no         | yes         | UUID v4 tied to a request |\n| `idempotency-key`                | yes        | no          | Can be any string, use for making POST or PATCH requests fault tolerant |\n| `idempotent-replayed`            | no         | yes         | If included in the response, indicates a stored value was used to replay the request |\n\n\n## Permission Scopes\n\nEvery access token is issued with one or more permission scopes. Each scope grants access to a specific resource family in either read-only or read-write mode. Requests that target an operation whose required scope is not present on the token are rejected with `403` — see [403 Forbidden](#section/Errors/403-Forbidden). When requesting an OAuth token, omitted or unknown scopes return [405003 Missing scopes](#section/Errors/405003-Missing-scopes) or [405004 Invalid scopes](#section/Errors/405004-Invalid-scopes).\n\nThe per-operation scope requirement is declared on each endpoint's reference page under **Authorizations**. When requesting a partner (OAuth) token, pass the scopes as a `+`-separated list in the `scope` query parameter of the [AuthorizationRedirect](#tag/OAuth/operation/AuthorizationRedirect) call.\n\n| Scope                            | Grants                                                                                             |\n|----------------------------------|----------------------------------------------------------------------------------------------------|\n| `read_logistics_products`        | Read the product catalog (SKUs, dimensions, barcodes).                                             |\n| `write_logistics_products`       | Create and update products in the catalog.                                                         |\n| `read_logistics_inbounds`        | Read inbound shipments and their contents.                                                         |\n| `write_logistics_inbounds`       | Create, cancel, and modify inbound shipments.                                                      |\n| `read_logistics_orders`          | Read outbound (D2C) orders and shipments.                                                          |\n| `write_logistics_orders`         | Create, cancel, and modify outbound (D2C) orders.                                                  |\n| `read_logistics_orders_b2b`      | Read B2B orders and shipments. (`2024-07` and later.)                                              |\n| `write_logistics_orders_b2b`     | Create, cancel, and modify B2B orders. (`2024-07` and later.)                                      |\n| `read_logistics_bundles`         | Read bundle (kit) definitions.                                                                     |\n| `write_logistics_bundles`        | Create and update bundle definitions.                                                              |\n| `read_logistics_parcels`         | Read parcel labels, rates, and master cartons.                                                     |\n| `write_logistics_parcels`        | Purchase parcel labels and create/link master cartons.                                             |\n| `read_logistics_returns`         | Read return shipments and their contents.                                                          |\n| `write_logistics_returns`        | Create and update return shipments.                                                                |\n| `read_logistics_warehouses`      | Read the list of warehouses available to the account. (`2025-03` and later.)                       |\n| `read_logistics_webhooks`        | Read webhook subscriptions.                                                                        |\n| `write_logistics_webhooks`       | Create, update, and delete webhook subscriptions.                                                  |\n| `read_logistics_events`          | Read the event stream that backs webhook deliveries.                                               |\n| `read_logistics_reports`         | Read generated reports.                                                                            |\n| `write_logistics_reports`        | Request new reports.                                                                               |\n\nThe `unstable` version exposes additional scopes covering experimental endpoints (freight, sales channels, uploads). Refer to the `unstable` reference for the full list; these scopes are not yet available on stable versions.\n\nFollow the principle of least privilege: issue separate tokens with the narrowest scope set each integration needs, rather than a single token with every scope.\n\n## Versioning\n\nThe Logistics API uses date based versioning for releases. Versions are declared explicitly in the Logistics API URI with a format of `/logistics/api/{api_version}/{endpoint}`. Stable releases follow the format of `yyyy-mm`. Experimental releases have an API version of `unstable`. For example:\n\n```\n/logistics/api/2023-04/orders\n/logistics/api/unstable/orders\n```\n\n# Release Notes\n## 2026-02\n\n### Authentication and API Tokens\n- **Token expiration:** Merchant (non-3PL) tokens expire after one year from creation and existing tokens are given a one-year grace period. Partner (3PL) tokens **do not** expire.\n- Expired tokens will automatically be marked `INACTIVE`\n- Rotate tokens in [Settings → API Tokens](https://portal.flexport.com/settings/api-tokens) before they expire.\n\n### Events and Webhooks\n- `Order.Submitted`: This event and webhook is generated when Order is Submitted to system.\n- `Order.PickingStarted`: This event and webhook is generated when Order picking has started at the warehouse.\n- `Order.Packed`: This event and webhook is generated when Order is Packed at the warehouse.\n- `Order.Delivered`: This event and webhook is generated when Order is Delivered to destination.\n- `Shipment.Submitted`: This event and webhook is generated when Shipment is Submitted to system.\n- `Shipment.PickingStarted`: This event and webhook is generated when Shipment picking has started at the warehouse.\n- `Shipment.Packed`: This event and webhook is generated when Shipment is Packed at the warehouse.\n- `Shipment.Delivered`: This event and webhook is generated when Shipment is Delivered to destination.\n\n## 2025-03\n\n### Bundles API\n- `getBundles`: This API retrieves list of bundles with cursor-based pagination.\n\n### Parcels API\n- `createMasterCarton`: This API creates master carton labels in bulk.\n- `linkMasterCarton`: API to link a master carton barcode to list of parcel tracking codes. \n\n### Outbounds API\n- `getOrderByExternalId`: This API gets the order details based on the external ID provided by the seller.\n- `getShipmentAttachmentUrl`: This API generates a pre-signed URL that can be used to upload an attachment for a specific outbound shipment.\n\n### Inbounds API\n- `getStorageWarehouses`: API to get a list of storage warehouses that can store products.\n- Update `createAShipment` API to:\n    1. Allow creating reserve storage shipments\n    2. Pick nearest crossdock location while creating forwarding shipments\n    3. Allow specifying sellerLPNs for each package\n\n- Update `getInboundingShipment` API to allow support storage shipments\n- Update `getInboundingShipments` API to allow support for storage shipments\n- `get_inbounds_warehouses`: API to get a list of storage warehouses and Fulfillment Centres\n## 2024-07\n\n### Orders API\n- `createOrder`: Update API to allow drop ship orders\n- `getOrder`: Update API to get drop ship details for orders\n\n## 2024-04\n\n### Parcels API\n- `getBulkParcelJob`: This API retrieves details about a bulk parcel creation job.\n- `createBulkParcelJob`: Use this API to submit a bulk parcel creation job.\n- Update `getParcel`, `getParcelTracking`, `getParcelTrackingByTrackingCode` and `createParcel` to return an option field `carrierBarcode`.\n- Update `flexportTrackingUrl` datatype from `string` to `URL`\n- Add isReturn field in the createParcel API request (backported into 2024-04 version)\n\n### Orders API\n- Add TIKTOK as a supported `source` marketplace.\n\n## 2024-01\n\n### API Sandbox (New)\n- API Sandbox may be used for testing fulfillment with simulated inventory and orders.\n\n### Partner OAuth (New)\n- Support for partners serving multiple Flexport customers has been added.\n\n### Outbounds Reserve Storage (New)\n- `Outbounds API` allows you to create outbound orders from reserve storage warehouses to fulfilment centres. The APIs also allow you to track the status of the reserve storage outbound orders and cancel them.\n\n### Inbounds\n- Update `Create a shipment` API to accept a `shippingPlanName`.  This is the name that will appear in the Flexport Portal.\n- Update `Get a shipment` and `Get a list of shipments` APIs to support reading direct shipments that were created in Seller Portal.\n- `InboundReceivedEvent` documentation was updated to include `DAMAGED` state.\n\n### Products\n- New `GetProductAliases` API to list all aliases by `logisticsSku`.\n- New `GetProductsByMerchantSku` API to get a paginated list of products by `merchantSku`.\n- New `CreateProductBarcode` API to validate and assign a new barcode to a product by `logisticsSku`.\n\n### Orders\n- Update `CreateOrder` API to accept Flexport bundle SKUs.\n- Update `CreateOrder` API to take packingSlipUrl that overrides the default packing slip.\n- Flexport Fast Tags functionality has been clarified for `CreateOrder` API.\n- Events documentation updated to clarify the difference between `Shipment.Shipped` and `Order.Shipped`.\n\n## 2023-10\n### Parcels API\n- Added `customsInformation` to create a parcel. You can now send parcels to international addresses and specify the relevant customs information.\n- Added `customLabelFooterFields` to create a parcel. This field lets you define a string to be placed on the footer of the shipping label.\n- Return new `flexportTrackingUrl` field when creating a parcel, retrieving a parcel, or retrieving parcel tracking events. This field can be used to track a package end-to-end through Flexport and final mile partner networks.\n\n### Inbounds API\n- Added `shippingPlanName` to create an inbounding shipment. This is the name that will appear in the Flexport Portal.\n- Added `shippingPlanExternalId` to create an inbounding shipment. This field is an external ID that can be used to link to/from other systems.\n- Return `shippingPlanName` and `shippingPlanExternalId` in getting an inbound shipment, or getting a list of inbound shipments.\n\n## 2023-07\n### Products API\n- New API `GetAllInventory`. Get a paginated list of available inventory information for products.\n- New API `GetProducts`. Return a paginated list of products.\n\n### Parcels API\n- New API to get parcel tracking information (including sortation center events) by carrier tracking code\n- New API to cancel a parcel that was previously created.\n\n## 2023-04\n- Initial public beta release of the Logistics API\n\n## unstable\nThe \"unstable\" version contains code experimental changes, developer previews, and new features. However, endpoints can always change and may update with breaking changes without notice.\n### Inbounds API\n- `getInboundsWarehouses`: This API Fetches List of Warehouse Details for Both DTC & RS based on the request parameters.\n# Errors\nWhen an API error occurs, the HTTP response includes a three-digit HTTP status code with additional information returned\nas a [problem+json](https://www.rfc-editor.org/rfc/rfc7807) object, for example:\n```\nHTTP/1.1 404 Not Found\nContent-Type: application/problem+json\nContent-Language: en\n\n{\n \"type\": \"https://docs.logistics-api.flexport.com/2026-02/#section/Errors/404-Not-Found\",\n \"title\": \"Not Found\",\n \"detail\": \"Cannot find order 49201824029\",\n \"instance\": \"92e04577-c56b-47b9-b075-62096165a0ce\"\n}\n```\nIn addition to the three-digit HTTP status code, some errors carry a six-digit error code  \nthat provides additional detail about the specific error condition.  For example `405004` error code \nrefers to `Invalid scopes` and is documented [here](#section/Errors/405004-Invalid-scopes).\n\n## 400 Bad Request\nBad Request.\n\n#### Possible Causes\n- Incorrect HTTP method used.\n- Non-existent URL path used.\n- Malformed syntax in the request.\n- Missing a required parameter.\n- Input on the request did not pass validation.\n- The resource to be modified has moved into a state that is no longer valid.\n\n#### Possible Solutions\n- Retry the request after correcting errors in the request and confirming it's valid. \n- Verify if the resource to be modified exists and is in a valid state.\n\n## 401 Unauthorized\nThe access token is invalid or expired.\n\n#### Possible Causes\n- No valid access token provided.\n- The token has expired (merchant tokens expire after one year by default).\n\n#### Possible Solutions\n- Check to ensure that the access token is valid.\n\n## 403 Forbidden\nAccess token does not have permission to perform the requested operation.\n\n#### Possible Causes\n- Access token provided is not authorized to perform the requested operation.\n\n#### Possible Solutions\n- Check to ensure that the scope of the access token is sufficient to perform the requested operation.\n- Create and use a new access token that has the required scope.\n\n## 404 Not Found\nThe requested object cannot be found.\n\n#### Possible Causes\n- The identifier pointing to the request is incorrect.  \n- The specified resource is no longer available.\n- You do not have access to the specified resource.\n\n#### Possible Solutions\n- Check that the specified resource exists.\n\n## 409 Conflict\nThe object with the same identifier already exists.\n\n#### Possible Causes\n- Resource was already created, but the request is attempting to create it again.\n\n#### Possible Solutions\n- Check that the resource identifier is unique.\n- Use [idempotency-key](#section/Common-Resources/Headers) when creating resources. \n\n## 422 Unprocessable Content\nThe request is malformed.  \n\n#### Possible Causes\n- Request contains invalid data or syntax errors.\n\n#### Possible Solutions\n- Check the payload for inconsistencies or errors.\n\n## 429 Too Many Requests\nToo many requests in a given amount of time (\"rate limiting\").\n\n#### Possible Causes\n- Too many requests were made in a short period of time that exceed the API rate limit allowed.\n\n#### Possible Solutions\n- Try again later.  We recommend an exponential backoff of your requests.\n- Refer to the `Retry-After` header for the number of seconds to wait before retrying the request.\n\n## 423 Locked\nAccess to the Logistics API is locked and denied.\n\n#### Possible Causes\n- Flexport Portal account may be frozen and/or deactivated.\n\n#### Possible Solutions\n- Contact [Flexport Support](https://support.portal.flexport.com/hc/en-us/articles/1500009448562-Contacting-Support)\n\n## 5XX Internal Server Error\nAn internal error has occurred while processing the request (these are uncommon).\n\n#### Possible Causes\n- The request is incorrect and cannot be processed.\n- The server is currently unable to handle the request.\n\n#### Possible Solutions\n- Verify that the request is correct and retry it.\n- Retry the request at a later time.\n\n## 405001 Invalid redirect URI\nThe redirect URI specified as a callback for OAuth authorization is invalid.\n\n#### Possible Causes\n- Redirect URI must be `https://deliverr.com` if `identity` is used as the client ID.\n- Redirect URI must be exactly the same URI as the one registered with the client ID provided.\n\n#### Possible Solutions\n- Verify that the redirect URI is correct.\n\n## 405002 Invalid client_id\nInvalid client_id.\n\n#### Possible Causes\n- The client ID provided is invalid.  The client ID must be `identity` or a valid client ID registered with Flexport.\n\n#### Possible Solutions\n- Submit a valid client ID.\n\n## 405003 Missing scopes\nScopes were not provided.\n\n#### Possible Causes\n- Scope parameter was not provided in the request.\n\n#### Possible Solutions\n- Check to ensure the request includes scopes.  For all available scopes see [OAuth](#tag/OAuth/operation/AuthorizationRedirect).\n\n## 405004 Invalid scopes\nSome of the scopes provided are invalid.  For all available scopes see [OAuth](#tag/OAuth/operation/AuthorizationRedirect).\n\n#### Possible Causes\n- Scope parameter was provided in the request, but the scope values are invalid.\n- Incorrect separator was used to separate scopes. \n\n#### Possible Solutions\n- Check to ensure that scopes requested are known and valid.  For all available scopes see [OAuth](#tag/OAuth/operation/AuthorizationRedirect).\n\n## 405005 Invalid code\nThe one-time authorization code provided is invalid, expired, or has already been used.\n\n#### Possible Causes\n- Authorization code has already been used.\n- Authorization code has expired because it was requested longer than a few minutes ago.\n- Authorization code is invalid.\n\n#### Possible Solutions\n- Restart the [OAuth flow](#tag/OAuth/operation/AuthorizationRedirect) to receive a new authorization code.\n## 407001 Invalid order status\nOperation cannot proceed, because order is in a state that does not allow it.\n\n#### Possible Causes\n- Order retry was requested, however the original order was successful.\n\n#### Possible Solutions\n- Ensure that the order is in the correct state, e.g. if order is being retried the order state should be `Canceled`.\n"},"openapi":"3.1.0","paths":{"/logistics/api/2026-02/bundles/{bundleId}":{"get":{"operationId":"GetBundle202310","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiBundleResponse202310"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"404":{"description":"No bundle found with the bundleId provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_NotFoundError"}}}}},"description":"Get bundle information for a bundle.","summary":"GetBundle","tags":["Bundles"],"security":[{"BEARER":["read_logistics_bundles"]}],"parameters":[{"in":"path","name":"bundleId","required":true,"schema":{"$ref":"#/components/schemas/products_BundleIdType"}}]}},"/logistics/api/2026-02/bundles":{"get":{"operationId":"GetBundles","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiBundleResponseWithCursor"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Get bundle information for a list of bundles.","summary":"Get a list of bundles","tags":["Bundles"],"security":[{"BEARER":["read_logistics_bundles"]}],"parameters":[{"description":"The number of bundles to return. Defaults to 20, capped at 100","in":"query","name":"limit","required":false,"schema":{"default":20,"format":"double","type":"number"}},{"description":"The cursor which can be used to fetch the next set of bundles","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}]},"post":{"operationId":"CreateBundle202310","responses":{"202":{"description":"Bundle has been created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiBundleResponse202310"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"404":{"description":"No bundle found with the bundleId provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_NotFoundError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnprocessableEntityError"}}}}},"description":"Creates a new bundle.","summary":"CreateBundle","tags":["Bundles"],"security":[{"BEARER":["write_logistics_bundles"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiBundle202310"}}}}}},"/logistics/api/2026-02/bundles/{bundleId}/inventory":{"get":{"operationId":"GetBundleInventory","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiBundleInventoryResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"No bundle found with the bundleId provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get available inventory information for the bundle.","tags":["Bundles"],"security":[{"BEARER":["read_logistics_bundles"]}],"parameters":[{"in":"path","name":"bundleId","required":true,"schema":{"$ref":"#/components/schemas/BundleIdType"}}]}},"/logistics/api/2026-02/events":{"get":{"operationId":"GetEvents","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/network-events_EventsResponseItem"},"type":"array"}}}}},"description":"Get all events matching certain criteria.  Additional query fields can be passed as filters,\ne.g. orderId=123&shipmentId=456","tags":["Events"],"security":[{"BEARER":["read_logistics_events"]}],"parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":100,"format":"double","type":"number","minimum":1,"maximum":100}},{"in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/network-events_EventId"}}},{"in":"query","name":"type","required":false,"schema":{"type":"string","pattern":"^([\\w\\.]{0,50})$"}},{"in":"query","name":"orderId","required":false,"schema":{"type":"string"}},{"in":"query","name":"shipmentId","required":false,"schema":{"type":"string"}},{"in":"query","name":"after","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"page_info","required":false,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/inbounds/storage_warehouses":{"get":{"operationId":"GetStorageWarehouses","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/inbounds_WarehouseAddress"},"type":"array"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}}},"description":"Get storage-warehouses that can store products.","summary":"Get a list of storage warehouses","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[]}},"/logistics/api/2026-02/inbounds/shipments":{"post":{"operationId":"CreateInboundingShipmentV5","responses":{"201":{"description":"Inbound Shipment created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundShipmentResponseV6"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Create an inbounding shipment.","summary":"Create a shipment","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInboundShipmentRequestV6"},"examples":{"Direct_Inbound_With_Box_Content_Labels":{"value":{"shipmentDestination":"NETWORK","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","prep":{"boxContentLabels":true},"items":[{"logisticsSku":"D1234567890","quantity":1,"lineItemId":"10"}]}},"Direct_Inbound_With_Package_Details":{"value":{"shipmentDestination":"NETWORK","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","prep":{"boxContentLabels":false},"packages":[{"numberOfIdenticalPkgs":2,"weight":90,"weightUnit":"lb","length":15,"width":12.5,"height":10,"dimensionUnit":"in","items":[{"logisticsSku":"D1234567890","quantity":50,"lineItemId":"12"}]}]}},"Multiple_Node_Direct_Inbound":{"value":{"shipmentDestination":"NETWORK","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","destinationWarehouseId":"WH_12345","prep":{"boxContentLabels":false},"packages":[{"numberOfIdenticalPkgs":2,"weight":90,"weightUnit":"lb","length":15,"width":12.5,"height":10,"dimensionUnit":"in","items":[{"logisticsSku":"D1234567890","quantity":50,"lineItemId":"11"}]}]}},"Reserve_Storage_Inbounds":{"value":{"shipmentDestination":"STORAGE","storageWarehouseId":"EXAMPLE_000","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","cargoType":"PALLETIZED","palletCount":1,"items":[{"logisticsSku":"D1234567890","quantity":1,"caseDetails":{"weightUnit":"lb","unitsPerCase":1,"weight":1,"length":1,"width":1,"height":1,"dimensionUnit":"in"}}]}}}}}}},"get":{"operationId":"GetInboundingShipmentsV6","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/inbounds_InboundShipmentResponse"},"type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Get inbounding shipments based on the provided shipmentIds.","summary":"Get a list of shipments","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"description":"The shipmentIds to get shipments for. If this query parameter is not provided, a list of all shipments will be returned subject to limit and offset query parameters","in":"query","name":"shipmentIds","required":false,"schema":{"type":"array","items":{"type":"integer","format":"int32"}}},{"description":"The number of shipments to return. Only applies when `shipmentIds` is not passed in. Defaults to 20, capped at 100","in":"query","name":"limit","required":false,"schema":{"default":20,"format":"double","type":"number"}},{"description":"The number of shipments to skip before returning. Only applies when `shipmentIds` is not passed in. Defaults to 0","in":"query","name":"offset","required":false,"schema":{"default":0,"format":"double","type":"number"}},{"description":"Array of statuses. Only return shipments with given statuses. If empty, return all shipments.","in":"query","name":"statuses","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/inbounds_LogisticsInboundShipmentStatus"}}},{"description":"Array of booking IDs to get shipments for. Can be used instead of or in combination with shipmentIds.","in":"query","name":"bookingIds","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"in":"query","name":"shippingPlanExternalIds","required":false,"schema":{"type":"array","items":{"type":"string"}}}]}},"/logistics/api/2026-02/inbounds/async/shipments":{"post":{"operationId":"CreateInboundingShipmentAsyncV1","responses":{"202":{"description":"Inbound Shipment creation accepted."},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Create an inbound shipment asynchronously. This endpoint performs comprehensive synchronous validation of the request payload before accepting the creation request:\n- if all validations pass, a 202 Accepted response is returned and the request is queued for background processing (including downstream system integrations, which occur asynchronously);\n- if any validation fails, a 400 Bad Request is returned immediately with error details explaining the violated rule.\nAfter receiving a 202 response, shipment creation continues in the background and you can use the `shippingPlanExternalId` from the request to retrieve the shipment status via the [Get Shipment](#operation/GetInboundingShipmentsV6) endpoint once processing completes.\n\nThis endpoint is recommended for handling large shipments (up to **30,000 DSKUs**) when you prefer a quick, non-blocking API response instead of waiting for shipment creation to complete, or when asynchronous processing is required for your integration.","summary":"Create a shipment asynchronously","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInboundShipmentAsyncRequestV1"},"examples":{"Direct_Inbound_With_Box_Content_Labels":{"value":{"shipmentDestination":"NETWORK","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","prep":{"boxContentLabels":true},"items":[{"logisticsSku":"D1234567890","quantity":1,"lineItemId":"10"}]}},"Multiple_Node_Direct_Inbound":{"value":{"shipmentDestination":"NETWORK","from":{"name":"John Smith","address1":"123 Main St","city":"New York","provinceCode":"NY","countryCode":"US","zip":"10001"},"shippingPlanExternalId":"plan-123","shippingPlanName":"My Shipping Plan","destinationWarehouseId":"WH_12345","prep":{"boxContentLabels":false},"packages":[{"numberOfIdenticalPkgs":2,"weight":90,"weightUnit":"lb","length":15,"width":12.5,"height":10,"dimensionUnit":"in","items":[{"logisticsSku":"D1234567890","quantity":50,"lineItemId":"11"}]}]}}}}}}}},"/logistics/api/2026-02/inbounds/shipments/{shipmentId}":{"get":{"operationId":"GetInboundingShipment","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_InboundShipmentResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Get an inbounding shipment.","summary":"Get a shipment","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}}]}},"/logistics/api/2026-02/inbounds/shipments/{shipmentId}/document":{"get":{"operationId":"GetTransferDocumentV3","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_DocumentResult"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Document not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Request document for an inbounding shipment.","summary":"Request document for a shipment","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}},{"in":"query","name":"documentOption","required":true,"schema":{"$ref":"#/components/schemas/inbounds_DocumentOption"}},{"in":"query","name":"documentFormat","required":true,"schema":{"$ref":"#/components/schemas/inbounds_BoxLabelsFormat"}}]}},"/logistics/api/2026-02/inbounds/shipments/{shipmentId}/update":{"patch":{"operationId":"UpdateInboundingShipment","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_InboundShipmentResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Update an inbounding shipment.","summary":"Update a shipment","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UpdateInboundShipmentRequest"}}}}}},"/logistics/api/2026-02/inbounds/shipments/{shipmentId}/quotes":{"get":{"operationId":"GetInboundingShipmentQuoteResult","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_QuoteResultResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Get result of asynchronous request for quotes. Returns quotes once asynchronous request is complete.","summary":"Get quotes for a shipment","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}},{"in":"query","name":"shippingOption","required":false,"schema":{"$ref":"#/components/schemas/inbounds_InboundShippingOption"}}]},"post":{"operationId":"InitQuoteProcessForInboundingShipmentV2","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Asynchronous endpoint for starting a request for quotes on an inbounding shipment. Returns success if request was accepted.","summary":"Begin asynchronous request quotes for a shipment","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}},{"in":"query","name":"shippingOption","required":false,"schema":{"$ref":"#/components/schemas/inbounds_InboundShippingOption"}}]}},"/logistics/api/2026-02/inbounds/shipments/{shipmentId}/quotes/buy":{"post":{"operationId":"InitQuotePurchaseProcessForInboundingShipmentV2","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Asynchronous endpoint for starting a request to buy quotes on an inbounding shipment. Returns success if request was accepted.","summary":"Begin asynchronous request to buy a quote for a shipment","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_PurchaseQuotesRequest"}}}}},"get":{"operationId":"GetInboundingShipmentQuotePurchaseResult","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_QuoteResultResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Get result of asynchronous request to buy quotes. Returns quotes once asynchronous request is complete.","summary":"Get all quotes that have been successfully bought for a shipment","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"in":"path","name":"shipmentId","required":true,"schema":{"format":"int32","type":"integer"}},{"in":"query","name":"shippingOption","required":false,"schema":{"$ref":"#/components/schemas/inbounds_InboundShippingOption"}}]}},"/logistics/api/2026-02/inbounds/warehouses":{"get":{"operationId":"GetInboundsWarehouses","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_InboundWarehouseResponseLogisticsApi"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}}},"description":"Get inbounds-warehouses that can store products.","summary":"Get a list of inbounds warehouses","tags":["Inbounds"],"security":[{"BEARER":["read_logistics_inbounds"]}],"parameters":[{"in":"query","name":"fetchFulfillmentCentres","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"fetchStorageWarehouses","required":false,"schema":{"type":"boolean"}}]}},"/logistics/api/2026-02/mcp":{"post":{"operationId":"HandleMcpRequest","responses":{"200":{"description":"Request processed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"tags":["MCP"],"security":[{"BEARER":[]}],"parameters":[]}},"/logistics/api/2026-02/oauth/authorize":{"get":{"operationId":"AuthorizationRedirect","responses":{"301":{"description":"Redirect","content":{"application/json":{"schema":{"properties":{},"additionalProperties":{"type":"string"},"type":"object"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}}},"description":"Initiates OAuth authorization code grant flow per https://www.rfc-editor.org/rfc/rfc6749#section-1.3.1.\n\nThe flow involves an interactive login.  On successful login and authorization you receive a call back with a code that can only be used once.\n\nUsing the TokenExchange endpoint the code can be exchanged for an access token that does not expire.\n\nAccess token can be used to access Logistics API by passing the \"Authorization: Bearer\" header per https://www.rfc-editor.org/rfc/rfc6750#section-2.1","tags":["OAuth"],"security":[],"parameters":[{"in":"query","name":"response_type","required":true,"schema":{"type":"string","enum":["code"]}},{"description":"Must be set to <i>identity</i> to create an API token tied to your Flexport Seller Portal user identity.","in":"query","name":"client_id","required":true,"schema":{"type":"string"}},{"description":"The scope of the authorization request.  Multiple scopes may be provided, separated by ' '. Possible scope values are:\nread_logistics_products write_logistics_products read_logistics_reports write_logistics_reports read_logistics_bundles write_logistics_bundles read_logistics_orders write_logistics_orders read_logistics_webhooks write_logistics_webhooks read_logistics_parcels write_logistics_parcels read_logistics_returns write_logistics_returns read_logistics_freight write_logistics_freight read_logistics_events read_logistics_inbounds write_logistics_inbounds","in":"query","name":"scope","required":true,"schema":{"type":"string"}},{"description":"Optional. OAuth flow redirects to the redirect_uri after successful\nauthentication with the one-time use \"code\" passed as query parameter.\nIf <i>identity</i> client_id is used, redirect is to the Flexport Seller Portal UI page.","in":"query","name":"redirect_uri","required":false,"schema":{"type":"string"}},{"description":"An opaque value used by the client to maintain state between the request and callback.  The authorization server includes this value when redirecting the user-agent back to the client.","in":"query","name":"state","required":false,"schema":{"type":"string"}},{"description":"Reserved for use by partners.","in":"query","name":"authFlow","required":false,"schema":{"$ref":"#/components/schemas/AuthFlow"}}]}},"/logistics/api/2026-02/oauth/token":{"post":{"operationId":"TokenExchange","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}}},"description":"Exchanges the one-time code your callback received from AuthorizationRedirect endpoint for a permanent access\ntoken.","tags":["OAuth"],"security":[{"CLIENT_CREDENTIALS":[]},{"NONE":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/TokenRequest"}}}}}},"/logistics/api/2026-02/orders":{"post":{"operationId":"CreateOrder","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel202407"},{}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Create an order to be fulfilled.\n<P><B>Shipment and Delivery SLAs</B>\nAll orders are assigned a shipping date based on when they were originally placed.\nAll orders are assigned a shipping SLA for expected shipment time and delivery time after being imported.\nTo meet buyer expectations it's vital that this reflects customer expectations when the order is placed.<P>\nThe logic of evaluating the provided field is:<P>\n<OL>\n<LI>If the <B>promisedDeliveryByTime</B> field is present and valid, the value will be set as the SLA time\n<LI>Otherwise, if the <B>deliveryDays</B> value is set and valid, that number of days will be added onto\nthe calculated shipment date to determine the delivery date.</LI>\n<LI>Otherwise if the <B>shipMethod</B> is present, it will be mapped to a calculated delivery speed,\nif unrecognized or invalid, the shipping delivery date will be set to 5 days after the shipment date</LI>\n</OL>\n\nIf you implemented Flexport FastTags, call https://tags.deliverr.dev/reference/#getshippingoptions\nand use the name of the response object as the shipMethod for the order you're submitting.","summary":"CreateOrder","tags":["Orders"],"security":[{"BEARER":["write_logistics_orders"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderInput202503"}}}}}},"/logistics/api/2026-02/orders/{orderId}":{"get":{"operationId":"GetOrder","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModelV2"},{}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Returns a FulfillmentOrder resource by ID.","tags":["Orders"],"security":[{"BEARER":["read_logistics_orders"]}],"parameters":[{"in":"path","name":"orderId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/orders/external_id/{externalOrderId}":{"get":{"operationId":"GetOrderByExternalIdV2","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModelV2"},{}]}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}}},"description":"Get order information for an order created via the \"Create order\"\nendpoint, using the external order ID given during order creation.","tags":["Orders"],"security":[{"BEARER":["read_logistics_orders"]}],"parameters":[{"in":"path","name":"externalOrderId","required":true,"schema":{"$ref":"#/components/schemas/ExternalOrderIdType"}}]}},"/logistics/api/2026-02/orders/{orderId}/retry":{"post":{"operationId":"RetryOrder","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel"},{}]}}}},"400":{"description":"Address is invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Seller unauthorized for address validation bypass","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Retries processing of a fulfillment order.","tags":["Orders"],"security":[{"BEARER":["write_logistics_orders"]}],"parameters":[{"in":"path","name":"orderId","required":true,"schema":{"$ref":"#/components/schemas/OrderIdType"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetryOrderBody"}}}}}},"/logistics/api/2026-02/orders/{orderId}/cancel":{"post":{"operationId":"CancelOrder","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel"},{}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Cancel an order that was created via the \"Create Order\" endpoint. If an order has already been processed and shipped, the order cannot be cancelled.","tags":["Orders"],"security":[{"BEARER":["write_logistics_orders"]}],"parameters":[{"in":"path","name":"orderId","required":true,"schema":{"$ref":"#/components/schemas/OrderIdType"}}]}},"/logistics/api/2026-02/parcels":{"post":{"operationId":"CreateParcelV3","responses":{"201":{"description":"Parcel created","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreateParcelAPIResponse"},{}]}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"headers":{"retry-after":{"schema":{"type":"integer","format":"int32"},"description":"The timestamp after which the next request will be allowed","required":true},"x-ratelimit-limit":{"schema":{"type":"integer","format":"int32"},"description":"The number of allowed requests in the current period","required":true},"x-ratelimit-remaining":{"schema":{"type":"integer","format":"int32"},"description":"The number of remaining requests in the current period","required":true},"x-ratelimit-reset":{"schema":{"type":"integer","format":"int32"},"description":"The number of seconds left in the current period","required":true}}}},"description":"Create a parcel and purchase a label for that parcel.\n\nError Handling and Troubleshooting\n1) SELLER_NOT_FOUND - Seller is not registered or their registration process has not been completed.\n\n2) INVALID_INJECTION_LOCATION - Injection location is not valid or is not serviceable for the seller.\n\n3) EXCEEDS_MAX_DIMENSIONS - Dimensions of the parcel being processed exceed the maximum allowable limits set by the shipping carrier.\n\n4) INVALID_DESTINATION_ADDRESS - Destination address provided for the parcel is incorrect, incomplete or cannot be validated by the system.\n\n5) CUSTOMS_INFORMATION_REQUIRED - The essential customs details, which are required for international shipping, have not been provided or are incomplete.\n\n6) FAILED_TO_DETERMINE_ZONE - Unable to identify or determine the appropriate shipping zone for the parcel based on the provided destination address.\n\n7) SERVICE_LEVEL_UNSUPPORTED_FOR_DESTINATION - The level of service selected (e.g. Standard, Expedited, International) is not supported for the provided destination address.\n\n8) SERVICE_LEVEL_NOT_CONFIGURED - The service level selected is not configured for the seller.\n\n9) RETURNS_UNSUPPORTED - Returns are not supported for parcels associated with the seller.","summary":"Create a parcel","tags":["Parcels"],"security":[{"BEARER":["write_logistics_parcels"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateParcelRequestV3"}}}}}},"/logistics/api/2026-02/parcels/cancel":{"post":{"operationId":"CancelParcel","responses":{"200":{"description":"Successfully cancelled parcel"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Cancels a parcel that was previously created.\n\nError Handling and Troubleshooting\n\n1) PARCEL_NOT_FOUND - The parcelId provided in the API request is incorrect.\n\n2) LABEL_ALREADY_CANCELLED - The parcel is already cancelled.","summary":"Cancel a parcel","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelParcelRequest"}}}}}},"/logistics/api/2026-02/parcels/{parcelId}":{"get":{"operationId":"GetParcelV2","responses":{"200":{"description":"Fetched Parcel","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreateParcelAPIResponse"},{}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Parcel not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Fetch the parcel with a specified Parcel ID.\n\nError Handling and Troubleshooting\n\n1) PARCEL_NOT_FOUND - The parcelId provided in the API request is incorrect.","summary":"Get a parcel by ID","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[{"description":"Unique ID used to track the parcel, returned after acquiring a\npurchase label.","in":"path","name":"parcelId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/parcels/{parcelId}/tracking":{"get":{"operationId":"GetParcelTrackingV2","responses":{"200":{"description":"Contains the tracking information for the parcel","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ParcelTrackingAPIGetResponse"},{}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Fetch the tracking information for the parcel with the specified Parcel ID.\n\nError Handling and Troubleshooting\n1) PARCEL_NOT_FOUND - The parcelId provided in the API request is incorrect.\n\n2) PARCEL_TRACKING_NOT_FOUND - Failed to find tracking details for parcel.","summary":"Get a parcel's tracking information by Parcel ID","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[{"description":"Unique ID used to track the parcel, returned after acquiring a\npurchase label.","in":"path","name":"parcelId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/parcels/tracking/{trackingCode}":{"get":{"operationId":"GetParcelTrackingByTrackingCodeV2","responses":{"200":{"description":"Contains the tracking information for the parcel","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ParcelTrackingAPIGetResponse"},{}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Fetch the tracking information for the parcel with a specified tracking code. Only valid for Parcel users.\n\nError Handling and Troubleshooting\n\n1) PARCEL_NOT_FOUND - The parcelId provided in the API request is incorrect.\n\n2) PARCEL_TRACKING_NOT_FOUND - Failed to find tracking details for parcel.","summary":"Get a parcel's tracking information by tracking code","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[{"description":"tracking code used to track the parcel","in":"path","name":"trackingCode","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/parcels/{parcelId}/tracking_url":{"get":{"operationId":"GetTrackingUrl","responses":{"200":{"description":"Contains the tracking URL for the parcel","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Fetch the tracking URL for a parcel given a Parcel ID.\n\nError Handling and Troubleshooting\n\n1) PARCEL_NOT_FOUND - The parcelId provided in the API request is incorrect.","summary":"Get the tracking URL for a parcel","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[{"description":"Unique ID used to track the parcel, returned after acquiring a\npurchase label.","in":"path","name":"parcelId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/parcels/quote":{"post":{"operationId":"GetParcelQuoteV2","responses":{"200":{"description":"Successfully fetched quote","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ParcelQuoteAPIResponse"},{}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Fetch a quote for a label purchase without purchasing a label.\n\nError Handling and Troubleshooting\n\n1) INVALID_SELLER - The seller information appears to be incomplete or there are discrepancies with the seller's status.\n\n2) INVALID_INJECTION_LOCATION - Injection location is not valid or is not serviceable for the seller.\n\n3) EXCEEDS_MAX_DIMENSIONS - Dimensions of the parcel being processed exceed the maximum allowable limits set by the shipping carrier.\n\n4) FAILED_TO_DETERMINE_ZONE - Unable to identify or determine the appropriate shipping zone for the parcel based on the provided destination address.\n\n5) INVALID_DESTINATION_ADDRESS - Destination address provided for the parcel is incorrect, incomplete or cannot be validated by the system.\n\n6) SERVICE_LEVEL_NOT_CONFIGURED - The service level selected is not configured for the seller.","summary":"Get a parcel quote","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateQuoteRequestV2"}}}}}},"/logistics/api/2026-02/parcels/jobs/{id}":{"get":{"operationId":"GetBulkParcelJob","responses":{"200":{"description":"Contains the Bulk Parcel Job for the specified ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkParcelJobAPIResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Fetch the Bulk Parcel Job for the specified ID.\n\nPossible statuses and their meaning\n1) CREATING: This bulk job is currently being processed.\n2) COMPLETED: This bulk job has been successfully completed.\n3) PARTIALLY_COMPLETED: Some parcels in this bulk job have failed.\n4) FAILED: This bulk job has failed.\n\nError Handling and Troubleshooting\n\n1) BULK_PARCEL_JOB_ID_NOT_FOUND - The bulk_parcel_job_ID provided in the API request is incorrect.","summary":"Get a Bulk Parcel Job by ID","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[{"description":"The Bulk Parcel Job ID","in":"path","name":"id","required":true,"schema":{"format":"double","type":"number"}}]}},"/logistics/api/2026-02/parcels/jobs":{"post":{"operationId":"CreateBulkParcelJob","responses":{"200":{"description":"Successfully created bulk parcel job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkParcelJobAPIResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Create a Bulk Parcel Job.\n\nError Handling and Troubleshooting\n\n1) INVALID_SELLER - The seller information appears to be incomplete or there are discrepancies with the seller's status.","summary":"Create a bulk parcel job","tags":["Parcels"],"security":[{"BEARER":["read_logistics_parcels"]}],"parameters":[],"requestBody":{"description":"The bulk parcel job request","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBulkParcelJobRequest","description":"The bulk parcel job request"}}}}}},"/logistics/api/2026-02/parcels/master_carton":{"post":{"operationId":"CreateMasterCarton","responses":{"200":{"description":"Successfully created Master Carton Label","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMasterCartonResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Create a Master Carton Label.\n\nError Handling and Troubleshooting\n\n1) SELLER_NOT_FOUND - Seller is not registered or their registration process has not been completed.","summary":"Create a master carton label","tags":["Parcels"],"security":[{"BEARER":["write_logistics_parcels"]}],"parameters":[],"requestBody":{"description":"Create master carton job request","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMasterCartonRequest","description":"Create master carton job request"}}}}}},"/logistics/api/2026-02/parcels/master_carton/link_parcel":{"post":{"operationId":"LinkMasterCarton","responses":{"200":{"description":"Successfully linked Master Carton","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MasterCartonLinkParcelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Link Master Carton Label.\n\nError Handling and Troubleshooting\n\n1) SELLER_NOT_FOUND - Seller is not registered or their registration process has not been completed.\n\n2) MASTER_CARTON_NOT_FOUND - Master carton details with the provided barcode is unavailable.","summary":"Link Master Carton Label","tags":["Parcels"],"security":[{"BEARER":["write_logistics_parcels"]}],"parameters":[],"requestBody":{"description":"Link master carton job request","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MasterCartonLinkParcelRequest","description":"Link master carton job request"}}}}}},"/logistics/api/2026-02/products":{"post":{"operationId":"CreateProduct","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiProductResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnprocessableEntityError"}}}}},"description":"Create a product","tags":["Products"],"security":[{"BEARER":["write_logistics_products"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_CreateProductModel"}}}}},"get":{"operationId":"GetProducts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/products_ApiProductResponse"},"type":"array"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}}},"description":"Get paginated list of products","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"description":"number of records to return, defaults to 20, capped at 100","in":"query","name":"limit","required":false,"schema":{"default":20,"format":"double","type":"number"}},{"description":"number of records to skip before returning, defaults to 0","in":"query","name":"offset","required":false,"schema":{"default":0,"format":"double","type":"number"}}]}},"/logistics/api/2026-02/products/{logisticsSku}":{"get":{"operationId":"GetProduct","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiProductResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_NotFoundError"}}}}},"description":"Get product information for a product by logisticsSku.","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"description":"The globally unique product identifier created by Flexport and assigned on product creation.","in":"path","name":"logisticsSku","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/products/{logisticsSku}/aliases":{"get":{"operationId":"GetProductAliases","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProductAliasesResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get available product alias information for product by logisticsSku.","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"in":"path","name":"logisticsSku","required":true,"schema":{"$ref":"#/components/schemas/ProductIdType"}}]}},"/logistics/api/2026-02/products/{logisticsSku}/inventory":{"get":{"operationId":"GetInventory","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiInventoryResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get available inventory information for product by logisticsSku.","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"in":"path","name":"logisticsSku","required":true,"schema":{"$ref":"#/components/schemas/ProductIdType"}},{"in":"query","name":"poolName","required":false,"schema":{"$ref":"#/components/schemas/InventoryPool"}},{"description":"If true, aggregates inventory across all pack sizes for the given logisticsSku.\nIf false or omitted, returns inventory for the specified pack only.","in":"query","name":"aggregatePacks","required":false,"schema":{"type":"boolean"}}]}},"/logistics/api/2026-02/products/inventory/all":{"get":{"operationId":"GetAllInventory","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiInventoryResponse"},"type":"array"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Get a list of available inventory information for products. There are no more results if an empty page is returned.\nTo obtain reserve storage quantities, the poolName parameter can be set to 'STORAGE'\n\nThis endpoint returns a paginated list of inventory records, including both case packs and individual products.","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"description":"number of records to return, defaults to 20, capped at 100","in":"query","name":"limit","required":false,"schema":{"default":20,"format":"double","type":"number"}},{"description":"number of records to skip before returning, defaults to 0","in":"query","name":"offset","required":false,"schema":{"default":0,"format":"double","type":"number"}},{"in":"query","name":"poolName","required":false,"schema":{"$ref":"#/components/schemas/InventoryPool"}}]}},"/logistics/api/2026-02/products/inventory/cursor":{"get":{"operationId":"GetAllInventoryByCursor","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiCursorPaginatedInventoryResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Get a cursor-paginated list of available inventory information for products.\nTo obtain reserve storage quantities, the poolName parameter can be set to 'STORAGE'\n\nThis endpoint uses cursor-based pagination for efficient iteration through large result sets.\nThe cursor is the logisticsSku of the last item in the current page.\nWhen nextCursor is undefined, there are no more pages.","tags":["Products"],"security":[{"BEARER":["read_logistics_products"]}],"parameters":[{"description":"number of records to return, defaults to 20, capped at 100","in":"query","name":"limit","required":false,"schema":{"default":20,"format":"double","type":"number"}},{"description":"the cursor from the previous page's nextCursor field, omit for first page","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"poolName","required":false,"schema":{"$ref":"#/components/schemas/InventoryPool"}}]}},"/logistics/api/2026-02/products/warehouse":{"post":{"operationId":"GetWarehouseDetails","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WarehouseDetailsResponse"},"type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntityError"}}}}},"description":"Get warehouse information for a given list of logisticsSkus.","tags":["Products"],"security":[{"BEARER":["write_logistics_products"]}],"parameters":[{"in":"query","name":"poolName","required":false,"schema":{"$ref":"#/components/schemas/InventoryPool"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogisticsSkus"}}}}}},"/logistics/api/2026-02/orders/rs":{"post":{"operationId":"CreateOrderV2","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplenishmentOrderResponseV2"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Creates an outbound order from reserve storage\n<P><B>Limitations</B></P>\n<OL>\n<LI> Currently only supports wholesale orders (sending to Amazon and Walmart is not supported)\n<LI> All products must be available in a single reserve storage warehouse","summary":"Create Order","tags":["Outbounds"],"security":[{"BEARER":["write_logistics_orders_b2b"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplenishmentOrderRequestV2"}}}}}},"/logistics/api/2026-02/orders/rs/{orderId}":{"get":{"operationId":"GetOrderV2","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplenishmentOrderResponseV2"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get order information for a reserve storage outbound order by orderId.","summary":"Get Order","tags":["Outbounds"],"security":[{"BEARER":["read_logistics_orders_b2b"]}],"parameters":[{"description":"The unique order id returned during creation process.","in":"path","name":"orderId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/orders/rs/external_id/{externalId}":{"get":{"operationId":"GetOrderByExternalId","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplenishmentOrderResponseV2"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get order information for an order created via the \"Create order\" endpoint, using the external ID given during order creation.","summary":"Get Order By External ID","tags":["Outbounds"],"security":[{"BEARER":["read_logistics_orders_b2b"]}],"parameters":[{"description":"The external ID given during order creation.","in":"path","name":"externalId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/orders/rs/{shipmentId}/attachments":{"post":{"operationId":"GetShipmentAttachmentUrl","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentAttachmentUploadResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Get shipment attachment url for uploading shipment attachment document.","summary":"Get Shipment Attachment Url","tags":["Outbounds"],"security":[{"BEARER":["write_logistics_orders_b2b"]}],"parameters":[{"description":"The unique shipment id returned during creation process.","in":"path","name":"shipmentId","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"The request object for getting upload url for uploading shipment attachment document.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentAttachmentUploadRequest","description":"The request object for getting upload url for uploading shipment attachment document."}}}}}},"/logistics/api/2026-02/orders/rs/{orderId}/cancel":{"post":{"operationId":"CancelOrder","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Cancel a reserve storage outbound order using order id.\nOnly order in submitted state is allowed to be cancelled.","tags":["Outbounds"],"security":[{"BEARER":["write_logistics_orders_b2b"]}],"parameters":[{"description":"The unique order id returned during creation process.","in":"path","name":"orderId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/reports/{reportReference}":{"get":{"operationId":"GetReportStatus","responses":{"200":{"description":"Report status and url","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_Report"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_UnauthorizedError"}}}},"404":{"description":"A report with the given report reference was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_NotFoundError"}}}}},"description":"Returns a report or report status identified by the reportReference id","tags":["Reports"],"security":[{"BEARER":["read_logistics_reports"]}],"parameters":[{"in":"path","name":"reportReference","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/reports":{"post":{"operationId":"GenerateReport","responses":{"200":{"description":"Report is being created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_ReportGenerationResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_UnauthorizedError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_UnprocessableEntityError"}}}}},"description":"Creates a new report that can be downloaded in CSV format","tags":["Reports"],"security":[{"BEARER":["write_logistics_reports"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports_ReportGenerationRequest"}}}}}},"/logistics/api/2026-02/returns":{"post":{"operationId":"ReturnsCreateOrder","responses":{"201":{"description":"Return order details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnsApiOrder"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}}},"description":"Creates return order for inspection.","tags":["Returns"],"security":[{"BEARER":["write_logistics_returns"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReturnRequest"}}}}},"get":{"operationId":"GetReturns","responses":{"200":{"description":"Paginated Return Orders","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ReturnsApiOrder"},"type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}}},"tags":["Returns"],"security":[{"BEARER":["read_logistics_returns"]}],"parameters":[{"in":"query","name":"externalReturnId","required":false,"schema":{"type":"string"}},{"in":"query","name":"rma","required":false,"schema":{"type":"string"}},{"in":"query","name":"trackingCode","required":false,"schema":{"type":"string"}},{"in":"query","name":"status","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/LogisticsReturnStatus"}}},{"in":"query","name":"limit","required":false,"schema":{"format":"int32","type":"integer","maxLength":250,"minLength":1}},{"in":"query","name":"page_info","required":false,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/returns/{returnId}/cancel":{"post":{"operationId":"ReturnsCancelOrder","responses":{"204":{"description":"Successfully cancelled the return"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Cancel a return that was created. Return will not be cancelled if it is received.","tags":["Returns"],"security":[{"BEARER":["write_logistics_returns"]}],"parameters":[{"description":"Unique ID used to track the return.","in":"path","name":"returnId","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/returns/{returnId}":{"get":{"operationId":"ReturnsGetOrder","responses":{"200":{"description":"Return details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnsApiOrder"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get return by returnId. This will include ReturnOrder, ReturnItems with inspection\nstatus and ShippingLabel.","tags":["Returns"],"security":[{"BEARER":["read_logistics_returns"]}],"parameters":[{"description":"Unique ID used to track the return.","in":"path","name":"returnId","required":true,"schema":{"format":"double","type":"number"}}]}},"/logistics/api/2026-02/warehouses/active":{"get":{"operationId":"GetActiveWarehouses","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}}},"description":"Get all available active warehouses from all countries.","tags":["Warehouses"],"security":[{"BEARER":["read_logistics_warehouses"]}],"parameters":[{"description":"Filter warehouses by country code.\nCurrently Available values:\n- \"US\" - United States\n- \"NL\" - Netherlands","in":"query","name":"countryCode","required":false,"schema":{"type":"string"}}]}},"/logistics/api/2026-02/webhooks":{"post":{"operationId":"CreateWebhook","responses":{"202":{"description":"Webhook has been created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookModel"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntityError"}}}}},"description":"Create a webhook to subscribe to a type of event.\n\nCurrent retry behavior for webhooks (subject to change) is as follows:\n- If there is an error calling the endpoint it is first retried after about 5 minutes\n- It is then retried with exponentially increasing interval\n- Maximum interval between two retries is one hour\n- Total number of attempts is 10","tags":["Webhooks"],"security":[{"BEARER":["write_logistics_webhooks"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateModel"}}}}},"get":{"operationId":"GetWebhooks","responses":{"200":{"description":"List of webhook entries","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookModel"},"type":"array"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}}},"description":"Get all webhooks currently registered and active.","tags":["Webhooks"],"security":[{"BEARER":["read_logistics_webhooks"]}],"parameters":[]}},"/logistics/api/2026-02/webhooks/{webhookId}":{"get":{"operationId":"GetWebhook","responses":{"200":{"description":"Webhook details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookModel"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"A webhook with the webhook id provided was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Get a specific webhook using the webhook identifier.","tags":["Webhooks"],"security":[{"BEARER":["read_logistics_webhooks"]}],"parameters":[{"in":"path","name":"webhookId","required":true,"schema":{"$ref":"#/components/schemas/WebhookIdType"}}]},"delete":{"operationId":"DeleteWebhook","responses":{"204":{"description":"Webhook has been deleted"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"404":{"description":"A webhook with the webhook id provided was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"description":"Delete a webhook that has been created.","tags":["Webhooks"],"security":[{"BEARER":["write_logistics_webhooks"]}],"parameters":[{"in":"path","name":"webhookId","required":true,"schema":{"$ref":"#/components/schemas/WebhookIdType"}}]}},"/logistics/api/2026-02/inbounds/shipment/archive":{"post":{"operationId":"ArchiveInboundingShipment","responses":{"204":{"description":""},"400":{"description":"Shipment cannot be archived","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_UnauthorizedError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_NotFoundError"}}}}},"description":"Archive an inbounding shipment.","summary":"Archive a shipment","tags":["Inbounds"],"security":[{"BEARER":["write_logistics_inbounds"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inbounds_ArchiveShipmentRequest"}}}}}},"/logistics/api/2026-02/products/{logisticsSku}/barcode":{"post":{"operationId":"CreateProductBarcode","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiProductResponse"}}}},"400":{"description":"Barcode value provided not unique","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_NotFoundError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnprocessableEntityError"}}}}},"description":"Validates and assigns a new barcode to a product provided logisticsSku.","tags":["Products"],"security":[{"BEARER":["write_logistics_products"]}],"parameters":[{"description":"The globally unique product identifier created by Flexport and assigned on product creation.","in":"path","name":"logisticsSku","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_BarcodeOption"}}}}}},"/logistics/api/2026-02/products/update/{logisticsSku}":{"patch":{"operationId":"UpdateProduct","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ApiProductResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_BadRequestError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_ForbiddenError"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UnprocessableEntityError"}}}}},"description":"Update a product","tags":["Products"],"security":[{"BEARER":["write_logistics_products"]}],"parameters":[{"in":"path","name":"logisticsSku","required":true,"schema":{"$ref":"#/components/schemas/products_ProductIdType"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/products_UpdateProductModel"}}}}}}},"servers":[{"url":"https://logistics-api.flexport.com","description":"Logistics API"}],"tags":[{"name":"Bundles","description":"The Bundles API allows you to create and retrieve bundles.\n"},{"name":"Bundles","description":"The Bundles API allows you to create and retrieve bundles.\n"},{"name":"Events","description":"The Events API allows you to retrieve historical events.\n"},{"name":"Events","description":"The Events API allows you to retrieve historical events.\n"},{"name":"Inbounds","description":"The Inbounds API allows you to create, track, and update inbound shipments. \nYou can also request and purchase rate quotes for those shipments.  \nInbounds created using the API can either be sent to our LAX forwarding facility, a select reserve-storage facility, or direct to your assigned one-node facility (applies only to select Merchants).\nUnless you have an assigned one-node facility, you cannot use the API to create an inbound that is sent directly to a specific Fulfillment-Network warehouse.\n"},{"name":"Inbounds","description":"The Inbounds API allows you to create, track, and update inbound shipments. You can also request and purchase rate quotes for those shipments.\nInbounds created using the API can either be sent to our LAX forwarding facility, a select reserve-storage facility, or direct to your assigned one-node facility (applies only to select Merchants). Unless you have an assigned one-node facility, you cannot use the API to create an inbound that is sent directly to a specific Fulfillment-Network warehouse."},{"name":"OAuth","description":"OAuth 2.0 implementation endpoints.\n"},{"name":"Orders","description":"The Orders API allows you to\ncreate orders, track order lifecycles and get current order status\n(including shipment information) for those orders.\n"},{"name":"Outbounds","description":"Outbounds API allows you to create outbound orders from reserve storage warehouses to \nfulfilment centres. The APIs also allow you to track the status of the reserve storage outbound orders and cancel them.\n"},{"name":"Parcels","description":"Parcel is a new offering from Deliverr that allows merchants to\naffordably deliver across the US hassle-free. <P>\nParcel is currently only available to select merchants.\n"},{"name":"Products","description":"The Products API allows you to create and retrieve products and their respective inventory and warehouse details.<P>\nProduct records are the primary entities for tracking physical product attributes, including inventory and dimensions.\nA product record represents a physical item in the Deliverr network.\nProduct records with at least one barcode are required to be present before inbounding inventory.<P>\n<BR><B>Dimensions</B><P>\nProduct <b>weight</b> and <b>dimensions</b> attributes are vital values for proper billing and material handling.\nIf these values are known with high confidence, they can be passed through when creating Product records.\nHowever, once the dimensions have been verified, the Product record will show a <B>dimsLocked</B> value of <b>true</b>, and updates to\n <b>weight</b> or <b>dimensions</b> will no longer be accepted after that point.\n If dimensions are not provided when products are first received to the Deliverr network, they will be measured and updated as part of the inbounding process.</P>\n"},{"name":"Products","description":"The Products API allows you to create and retrieve products and their respective inventory and warehouse details.<P>\nProduct records are the primary entities for tracking physical product attributes, including inventory and dimensions.\nA product record represents a physical item in the Deliverr network.\nProduct records with at least one barcode are required to be present before inbounding inventory.<P>\n<BR><B>Dimensions</B><P>\nProduct <b>weight</b> and <b>dimensions</b> attributes are vital values for proper billing and material handling.\nIf these values are known with high confidence, they can be passed through when creating Product records.\nHowever, once the dimensions have been verified, the Product record will show a <B>dimsLocked</B> value of <b>true</b>, and updates to\n <b>weight</b> or <b>dimensions</b> will no longer be accepted after that point.\n If dimensions are not provided when products are first received to the Deliverr network, they will be measured and updated as part of the inbounding process.</P>\n"},{"name":"Reports","description":"The Reports API allows you to generate new reports and download them as CSV files. Here is a complete list of available reports\n\n| Report Code                                     | Report Name and Link                                                                                                                                                                           | startDate/endDate parameters used |\n| -----------------------------------------       | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |\n| Claims-Claims_Submitted                         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4409567424535-Claims-Claims-Submitted\">Claims - Claims Submitted</a>                                                                   | YES                               |\n| Inbounds-Packages                               | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008316362-Inbounds-Packages-Report\">Inbounds - Packages Report</a>                                                                 | YES                               |\n| Inbounds-Shipments                              | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008315782-Inbounds-Shipments-Report\">Inbounds - Shipments Report</a>                                                               | YES                               |\n| Inbounds-Shipping_Plan_Reconciliation           | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4408237571095--Inbounds-Inventory-Shipping-Plan-Reconciliation-Report\">Inbounds - Inventory / Shipping Plan Reconciliation Report </a> | NO                                |\n| Inbounds-Inventory_Reconciliation               | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4408237571095--Inbounds-Inventory-Shipping-Plan-Reconciliation-Report\">Inbounds - Inventory / Shipping Plan Reconciliation Report </a> | NO                                |\n| Inventory-Levels_Today                          | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008318542-Inventory-Levels-Today-Report\">Inventory - Levels Today Report</a>                                                       | NO                                |\n| Inventory-Units_In_Long_Term_Storage            | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008733222-Inventory-Units-in-Long-Term-Storage-Report\">Inventory - Units in Long Term Storage Report</a>                           | NO                                |\n| Orders-All_Orders                               | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500011593962-Orders-Orders-Report\">Orders - Orders Report</a>                                                                         | YES                               |\n| Orders-Shipments                                | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500011618401-Orders-Shipments-Report\">Orders - Shipments Report</a>                                                                   | YES                               |\n| Products-All_SKUs_With_Alias_Counts             | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008751601-Products-All-SKUs-With-Alias-Counts-Report\">Products - All SKUs With Alias Counts Report</a>                             | NO                                |\n| Products-All_SKUs_With_Dims_And_Alias_Counts    | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008751601-Products-All-SKUs-With-Dims-And-Alias-Counts-Report\">Products - All SKUs With Dims And Alias Counts Report</a>           | NO                                |\n| Products-All_CasePacks_With_Dims_And_Inventory  | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/28755825781271-Products-All-Case-Packs-With-Dims-And-Inventory-Report\">Products - All Case Packs With Dims And Inventory Report</a>    | NO                                |\n| Products-Available_SKUs_With_Alias_Counts       | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008752801-Products-Available-SKUs-With-Alias-Counts-Report\">Products - Available SKUs With Alias Counts Report</a>                 | NO                                |\n| Products-Available_SKUs_With_No_Aliases         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008752921-Products-Available-SKUs-With-No-Aliases-Report\">Products - Available SKUs With No Aliases Report</a>                     | NO                                |\n| Products-Catalog_Item_Master                    | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/35940142972055-Products-Catalog-Item-Master\">Products - Catalog Item Master</a>                                                      | NO                                |\n| Products-SKUs_With_Linked_Aliases               | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4413866128279-Products-SKUs-with-Linked-Aliases-Report\">Products - SKUs with Linked Aliases Report</a>                                 | NO                                |\n| Returns-All_Returns                             | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4415993499159-Returns-All-Returns\">Returns - All Returns</a>                                                                           | YES                               |\n| Returns-All_SKUs                                | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4415986009239-Returns-All-Return-Items-by-MSKU\">Returns - All Return Items by MSKU</a>                                                 | YES                               |\n"},{"name":"Reports","description":"The Reports API allows you to generate new reports and download them as CSV files. Here is a complete list of available reports\n\n| Report Code                               | Report Name and Link                                                                                                                                                                           | startDate/endDate parameters used | countryCode supported |\n| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | --------------------- |\n| Claims-Claims_Submitted                   | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4409567424535-Claims-Claims-Submitted\">Claims - Claims Submitted</a>                                                                   | YES                               | NO                    |\n| Inbounds-Packages                         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008316362-Inbounds-Packages-Report\">Inbounds - Packages Report</a>                                                                 | YES                               | NO                    |\n| Inbounds-Shipments                        | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008315782-Inbounds-Shipments-Report\">Inbounds - Shipments Report</a>                                                               | YES                               | NO                    |\n| Inbounds-Shipping_Plan_Reconciliation     | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4408237571095--Inbounds-Inventory-Shipping-Plan-Reconciliation-Report\">Inbounds - Inventory / Shipping Plan Reconciliation Report </a> | NO                                | NO                    |\n| Inbounds-Inventory_Reconciliation         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4408237571095--Inbounds-Inventory-Shipping-Plan-Reconciliation-Report\">Inbounds - Inventory / Shipping Plan Reconciliation Report </a> | NO                                | NO                    |\n| Inventory-Levels_Today                    | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008318542-Inventory-Levels-Today-Report\">Inventory - Levels Today Report</a>                                                       | NO                                | NO                    |\n| Inventory-Units_In_Long_Term_Storage      | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008733222-Inventory-Units-in-Long-Term-Storage-Report\">Inventory - Units in Long Term Storage Report</a>                           | NO                                | NO                    |\n| Orders-All_Orders                         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500011593962-Orders-Orders-Report\">Orders - Orders Report</a>                                                                         | YES                               | NO                    |\n| Orders-Shipments                          | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500011618401-Orders-Shipments-Report\">Orders - Shipments Report</a>                                                                   | YES                               | NO                    |\n| Products-All_SKUs_With_Alias_Counts       | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008751601-Products-All-SKUs-With-Alias-Counts-Report\">Products - All SKUs With Alias Counts Report</a>                             | NO                                | NO                    |\n| Products-Available_SKUs_With_Alias_Counts | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008752801-Products-Available-SKUs-With-Alias-Counts-Report\">Products - Available SKUs With Alias Counts Report</a>                 | NO                                | NO                    |\n| Products-Available_SKUs_With_No_Aliases   | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/1500008752921-Products-Available-SKUs-With-No-Aliases-Report\">Products - Available SKUs With No Aliases Report</a>                     | NO                                | NO                    |\n| Products-SKUs_With_Linked_Aliases         | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4413866128279-Products-SKUs-with-Linked-Aliases-Report\">Products - SKUs with Linked Aliases Report</a>                                 | NO                                | NO                    |\n| Returns-All_Returns                       | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4415993499159-Returns-All-Returns\">Returns - All Returns</a>                                                                           | YES                               | NO                    |\n| Returns-All_SKUs                          | <a href=\"https://support.portal.flexport.com/hc/en-us/articles/4415986009239-Returns-All-Return-Items-by-MSKU\">Returns - All Return Items by MSKU</a>                                                 | YES                               | NO                    |\n"},{"name":"Returns","description":"The returns API allows you to do following:<P>\n1. Create return orders\n2. Get return order details\n3. Cancel return order\n"},{"name":"Warehouses","description":"The Warehouses API allows you to retrieve active warehouse information.\n"},{"name":"Webhooks","description":"The Webhooks API allows you to subscribe for updates to events by registering your endpoint that will receive event notifications.<p>\nIf webhook callout cannot be delivered because the endpoint was down, or for any other reason,\nit is retried multiple times for a period of at least one day.\n"}],"x-tagGroups":[{"name":"Logistics","tags":["Accounts","Bundles","Channels","Freight","Inbounds","OAuth","Orders","Outbounds","Parcel-Integration","Parcels","Products","Reports","Returns","Tracking","Uploads","Warehouses"]},{"name":"Webhooks","tags":["Events","Webhooks"]}],"webhooks":{"Parcel.TrackingUpdated":{"post":{"summary":"Parcel.TrackingUpdated","description":"Event for a parcel tracking update.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParcelTrackingUpdatedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Return.Updated":{"post":{"summary":"Return.Updated","description":"Event when a return order has been updated.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnUpdatedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Inventory.Adjusted":{"post":{"summary":"Inventory.Adjusted","description":"Event when inventory changed.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryAdjustedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Created":{"post":{"summary":"Shipment.Created","description":"Event when a new shipment was created.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentCreatedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Cancelled":{"post":{"summary":"Shipment.Cancelled","description":"Event when a new shipment was cancelled.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentCancelledEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Shipped":{"post":{"summary":"Shipment.Shipped","description":"Order may contain one or more shipments.  Each shipment triggers a Shipment.Shipped event.  After the entire order ships, Order.Shipped is triggered.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentShippedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.PartiallyShipped":{"post":{"summary":"Shipment.PartiallyShipped","description":"Event when a new shipment was partially shipped.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentPartiallyShippedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Inbound.Received":{"post":{"summary":"Inbound.Received","description":"Event when an inbound was received.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundReceivedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Inbound.ShipmentStatusChanged":{"post":{"summary":"Inbound.ShipmentStatusChanged","description":"Event when an inbound shipment status has changed.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundShipmentStatusChangeEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Freight.TrackingUpdated":{"post":{"summary":"Freight.TrackingUpdated","description":"Event for a freight tracking update.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreightTrackingUpdatedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Cancelled":{"post":{"summary":"Order.Cancelled","description":"Event if an order was cancelled.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCancelledEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Shipped":{"post":{"summary":"Order.Shipped","description":"Order.Shipped is sent when the entire order has shipped.  If order consists of multiple shipments, each shipment also triggers a Shipment.Shipped event.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderShippedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Held":{"post":{"summary":"Order.Held","description":"Order.Held is sent when an order is held.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderHeldEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Submitted":{"post":{"summary":"Order.Submitted","description":"Event when an order was submitted.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderSubmittedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.PickingStarted":{"post":{"summary":"Order.PickingStarted","description":"Event when order picking has started at the warehouse.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderPickingStartedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Packed":{"post":{"summary":"Order.Packed","description":"Event when an order was packed at the warehouse.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderPackedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Order.Delivered":{"post":{"summary":"Order.Delivered","description":"Event when an order was delivered.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderDeliveredEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Submitted":{"post":{"summary":"Shipment.Submitted","description":"Event when a shipment was submitted.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentSubmittedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.PickingStarted":{"post":{"summary":"Shipment.PickingStarted","description":"Event when shipment picking has started at the warehouse.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentPickingStartedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Packed":{"post":{"summary":"Shipment.Packed","description":"Event when a shipment was packed at the warehouse.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentPackedEvent"}}}},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"Shipment.Delivered":{"post":{"summary":"Shipment.Delivered","description":"Event when a shipment was delivered.","tags":["Events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentDeliveredEvent"}}}}}}}}