{"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"},"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})$"},"InboundShipmentResponseV4":{"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"},"shippingPlanExternalId":{"type":"string"},"shippingPlanName":{"type":"string"}},"required":["id","receivingId","status","addresses","prep","shippingPlanId"],"type":"object","additionalProperties":false},"LogisticsInboundShipmentStatus":{"enum":["PENDING","READY_TO_SHIP","IN_TRANSIT","ARRIVED","PREPARING_FOR_DISTRIBUTION","IN_PREP","FORWARDING","RECEIVING","COMPLETED"],"type":"string"},"AddressesOutput":{"properties":{"to":{"$ref":"#/components/schemas/InboundAddress"},"from":{"$ref":"#/components/schemas/InboundAddress"}},"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},"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},"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},"ShopifyFreightResponse":{"properties":{"pickup":{"$ref":"#/components/schemas/FreightPickupResponse"},"pallets":{"items":{"$ref":"#/components/schemas/FreightPalletResponse"},"type":"array"}},"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},"CreateInboundShipmentRequestV4":{"properties":{"from":{"$ref":"#/components/schemas/InboundAddress"},"items":{"items":{"$ref":"#/components/schemas/ItemDataV2"},"type":"array","description":"(optional if packages are provided) The items on the shipment. Specify items if creating a blind inbound."},"packages":{"items":{"$ref":"#/components/schemas/PackageInputV1"},"type":"array","description":"(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."},"prep":{"$ref":"#/components/schemas/PrepRequestData"},"shippingPlanExternalId":{"type":"string"},"shippingPlanName":{"type":"string"}},"required":["from","prep"],"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},"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"},"DocumentResponse":{"properties":{"ready":{"type":"boolean"},"url":{"type":"string"}},"required":["ready","url"],"type":"object","additionalProperties":false},"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},"UpdateInboundShipmentRequestV3":{"properties":{"from":{"$ref":"#/components/schemas/InboundAddress"},"shippingOption":{"$ref":"#/components/schemas/InboundShippingOption"},"packages":{"items":{"$ref":"#/components/schemas/UpdatePackageInput"},"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},"InboundShippingOption":{"enum":["SPD_EXTERNAL","FREIGHT_EXTERNAL","LTL_EXTERNAL","LTL_INTERNAL","FTL_INTERNAL","SPD_INTERNAL"],"type":"string"},"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/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"},"ids":{"items":{"type":"string"},"type":"array"},"shippingProvider":{"type":"string"},"trackingNumber":{"type":"string"}},"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},"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"},"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"},"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},"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},"CreateOrderInput202307":{"properties":{"address":{"$ref":"#/components/schemas/AddressInput"},"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"},"externalOrderId":{"type":"string","description":"A unique order reference meaningful to the external system submitting the order."},"isSubscriptionOrder":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-Boolean_","description":"Is this order part of a recurring subscription for the customer"},"lineItems":{"items":{"$ref":"#/components/schemas/OrderLineItemInput"},"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."},"shipMethod":{"$ref":"#/components/schemas/InputMaybe_Scalars-at-String_","description":"Text of ship method like 'Standard', 'UPS GROUND', etc."},"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"}},"required":["address","externalOrderId","lineItems"],"type":"object","additionalProperties":false},"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},"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},"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},"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},"InputMaybe_Scalars-at-Date_":{"$ref":"#/components/schemas/Maybe_Scalars-at-Date_"},"InputMaybe_SourceId_":{"$ref":"#/components/schemas/Maybe_SourceId_"},"OrderIdType":{"type":"string","description":"A unique identifier for this order.","pattern":"^\\d+$"},"ExternalOrderIdType":{"type":"string","description":"A unique order reference meaningful to the external system submitting the order."},"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},"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},"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},"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},"ShippingMethod":{"type":"string"},"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},"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},"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"},"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},"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"},"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. 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},"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"},"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"}},"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","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"],"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":"2023-10","contact":{"name":"Logistics API","url":"https://support.portal.flexport.com/hc/en-us/articles/1500009448562-Contacting-the-Support-team"},"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\nThe Logistics API is a REST API with the OpenAPI3 specification available at: https://logistics-api.flexport.com/logistics/api/2023-10/documentation/raw\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\n## API Users\n\nThere are two primary user categories for the Logistics API:\n\n| User type                | Meaning within the API reference                                              |\n|--------------------------|-------------------------------------------------------------------------------|\n| You are a merchant if    | you use the API to develop an integration for your own business or shop.      |\n| You are a partner if     | you use the API to develop an application to serve Flexport merchants or your own customers.        |\n\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 carries permission scopes with it.  This allows you to create one access token to access products, and another one to access orders, for example.\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://sellerportal.deliverr.com/settings/api-tokens).  \n1. Using the API as described [here](#tag/OAuth/operation/AuthorizationRedirect)\n\nYou must be an Administrator of your organization to manage access tokens.\n\nMerchant tokens expire after one year by default and are rejected with 401 when expired. Partner (3PL) tokens do not expire. Administrators can revoke tokens at any time.\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/operation/CreateProduct) 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.\n2) [Create an inbound shipment](#tag/Inbounds/operation/CreateInboundingShipmentV4) 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).\n3) 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\n4) [Place an order](spec#tag/Orders/operation/CreateOrder202307) 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/2023-10/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## 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://sellerportal.deliverr.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://logistics-api.flexport.com/logistics/api/2023-04/documentation/spec#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-the-Support-team)\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/2023-10/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/2023-10/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/2023-10/bundles":{"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/2023-10/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/2023-10/inbounds/shipments":{"post":{"operationId":"CreateInboundingShipmentV4","responses":{"201":{"description":"Inbound Shipment created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundShipmentResponseV4"}}}},"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/CreateInboundShipmentRequestV4"}}}}},"get":{"operationId":"GetInboundingShipmentsV4","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/InboundShipmentResponseV4"},"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"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/LogisticsInboundShipmentStatus"}}}]}},"/logistics/api/2023-10/inbounds/shipments/{shipmentId}":{"get":{"operationId":"GetInboundingShipmentV4","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundShipmentResponseV4"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/2023-10/inbounds/shipments/{shipmentId}/document":{"get":{"operationId":"GetTransferDocumentV2","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Document not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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":{"type":"string"}},{"in":"query","name":"documentFormat","required":true,"schema":{"type":"string"}}]}},"/logistics/api/2023-10/inbounds/shipments/{shipmentId}/update":{"patch":{"operationId":"UpdateInboundingShipmentV3","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundShipmentResponseV3"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/UpdateInboundShipmentRequestV3"}}}}}},"/logistics/api/2023-10/inbounds/shipments/{shipmentId}/quotes":{"get":{"operationId":"GetInboundingShipmentQuoteResult","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResultResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/InboundShippingOption"}}]},"post":{"operationId":"InitQuoteProcessForInboundingShipmentV2","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundRateQuoteResult"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/InboundShippingOption"}}]}},"/logistics/api/2023-10/inbounds/shipments/{shipmentId}/quotes/buy":{"post":{"operationId":"InitQuotePurchaseProcessForInboundingShipmentV2","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundRateBuyResultV2"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/PurchaseQuotesRequest"}}}}},"get":{"operationId":"GetInboundingShipmentQuotePurchaseResult","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResultResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Shipment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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/InboundShippingOption"}}]}},"/logistics/api/2023-10/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/2023-10/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/2023-10/orders":{"post":{"operationId":"CreateOrder202307","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel"},{}]}}}},"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>","summary":"CreateOrder","tags":["Orders"],"security":[{"BEARER":["write_logistics_orders"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderInput202307"}}}}}},"/logistics/api/2023-10/orders/{orderId}":{"get":{"operationId":"GetOrder","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel"},{}]}}},"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":"Returns a FulfillmentOrder resource by ID.","tags":["Orders"],"security":[{"BEARER":["read_logistics_orders"]}],"parameters":[{"in":"path","name":"orderId","required":true,"schema":{"$ref":"#/components/schemas/OrderIdType"}}]}},"/logistics/api/2023-10/orders/external_id/{externalOrderId}":{"get":{"operationId":"GetOrderByExternalId","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrderModel"},{}]}}},"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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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/2023-10/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"}}]}}},"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":"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 |\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-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-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":"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":"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"}}}}}}}}