Miridia
Portal
Integrations

Shipment integration

The shipment integration operations of the Core API.

Base URL: https://api.miridia.io. Read Authentication and Conventions before you call these operations.

MethodPathOperation
POST/api/v1/integration/shipments/quotationsCreate shipment quotation

Create shipment quotation

POST/api/v1/integration/shipments/quotations

Access. Send a bearer token or an API key. The caller needs the Shipments modify permission.

Request body

Send JSON with the shape CreateShipmentQuotationIntegrationCommand.

FieldTypeRequiredDescription
quotationCreateShipmentQuotationRequestNo
contextIntegrationContextRequestNo

Response

200. Returns a SingleResult envelope. The data field is ShipmentQuotationResponse.

Request
curl -X POST "https://api.miridia.io/api/v1/integration/shipments/quotations" \
  -H "Authorization: Bearer $MIRIDIA_TOKEN" \
  -H "X-Business-Id: $MIRIDIA_BUSINESS_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "quotation": {
    "providerId": 0,
    "shipmentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "subTotal": 0,
    "totalPrice": 0,
    "totalTax": 0,
    "totalDiscount": 0,
    "discount": 0,
    "serviceLevelText": "string",
    "serviceLevelDescription": "string",
    "discountType": "Percentage",
    "fulfillmentType": "Package",
    "currency": "Eur",
    "taxIncluded": true,
    "collection": {
      "dateOfCollection": "2026-09-29T08:00:00Z",
      "estimatedDateOfCollection": "2026-09-29T08:00:00Z",
      "dateOfScheduledCollection": "2026-09-29T08:00:00Z",
      "earliestDateOfCollection": "2026-09-29T08:00:00Z",
      "latestDateOfCollection": "2026-09-29T08:00:00Z",
      "collectBeforeTime": "string",
      "collectAfterTime": "string",
      "additionalRemarks": "string"
    },
    "delivery": {
      "estimatedDateOfDelivery": "2026-09-29T08:00:00Z",
      "dateOfDelivery": "2026-09-29T08:00:00Z",
      "earliestDateOfDelivery": "2026-09-29T08:00:00Z",
      "latestDateOfDelivery": "2026-09-29T08:00:00Z",
      "deliverBeforeTime": "string",
      "deliverAfterTime": "string",
      "additionalRemarks": "string"
    },
    "items": [
      {}
    ]
  },
  "context": {
    "configuredProviderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id": "string",
    "idType": "Long",
    "content": "string",
    "metadata": {
      "key": "string"
    },
    "reportedQuantity": 0,
    "dateCreated": "2026-09-29T08:00:00Z"
  }
}'

Models

The operations on this page use these object types. Select a type to see its fields.

AddressResponse
FieldTypeDescription
idstring (uuid)
placeIdstring
namestring
websitestring
fullAddressstring
streetstring
suburbstring
citystring
countrystring
postcodestring
unitstring
numberstring
provincestring
latitudenumber (double)
longitudenumber (double)
BusinessResponse
FieldTypeDescription
idstring (uuid)
registeredNamestring
registrationNumberstring
displayNamestring
phoneNumberstring
websitestring
emailstring
requiresOrderIntegrationboolean
requiresOrderFulfillmentboolean
requiresAccountingIntegrationboolean
requiresDispatchBuilderboolean
billingAddressAddressResponse
shippingAddressAddressResponse
currentUserPrimitiveUserResponse
CollectionRequest
FieldTypeDescription
dateOfCollectionstring (date-time)
estimatedDateOfCollectionstring (date-time)
dateOfScheduledCollectionstring (date-time)
earliestDateOfCollectionstring (date-time)
latestDateOfCollectionstring (date-time)
collectBeforeTimestring
collectAfterTimestring
additionalRemarksstring
CollectionResponse
FieldTypeDescription
addressAddressResponse
instructionsstring
contactContactResponse
businessNamestring
collectAfterTimestringFormatted in HH not hh (24 hours)
collectBeforeTimestringFormatted in HH not hh (24 hours)
dateOfCollectionstring (date-time)
ContactResponse
FieldTypeDescription
idstring (uuid)
titlestring
descriptionstring
firstNamestring
lastNamestring
emailstring
phoneNumberstring
mobileNumberstring
CreateShipmentQuotationRequest
FieldTypeDescription
providerIdinteger (int32)The root provider id for the quotation. Not the configured provider integration id.
shipmentIdstring (uuid)
orderIdstring (uuid)
subTotalnumber (double)
totalPricenumber (double)
totalTaxnumber (double)
totalDiscountnumber (double)
discountnumber (double)
serviceLevelTextstring
serviceLevelDescriptionstring
discountTypeenum DiscountTypeOne of: None, Percentage, FixedValue.
fulfillmentTypeenum FulfillmentTypeOne of: Unknown, Package, Pallet, Container, Miscellaneous.
currencyenum CurrencyCodeOne of: Invalid, Eur, Usd, Gbp, Zar, Zmw.
taxIncludedboolean
collectionCollectionRequest
deliveryDeliveryRequest
itemsFulfillmentItemRequest[]
CurrencyResponse
FieldTypeDescription
iso4217string
utf8Symbolstring
currencyCodeenum CurrencyCodeOne of: Invalid, Eur, Usd, Gbp, Zar, Zmw.
CustomerIntegrationProviderResponse
FieldTypeDescription
providerPrimitiveIntegrationProviderResponse
customerCustomerResponse
CustomerResponse
FieldTypeDescription
idstring (uuid)
isBusinessboolean
titlestring
websitestring
emailstring
businessNamestring
groupIdstring (uuid)The customer group this customer belongs to, if any. Used as a price-list assignment scope.
phoneNumberstringThis would generally represent the phone number for the customer if the customer is a business. Otherwise, the contact details should be part of the contact, and not the customer. Limits: maximum 20 characters.
integrationTypeenum IntegrationProviderTypeOne of: None, Commerce, Accounting, Erp, Crm, Fulfillment, Warehouse, WorkflowManager.
dateCreatedstring (date-time)
billingAddressAddressResponse
shippingAddressAddressResponse
integrationsCustomerIntegrationProviderResponse[]
contactsContactResponse[]
primaryContactContactResponse
parentCustomerResponse
attachmentsMetadataFileAttachment[]
totalSalesinteger (int32)
totalSpentnumber (double)
metadatamap<string, string>
DeliveryRequest
FieldTypeDescription
estimatedDateOfDeliverystring (date-time)
dateOfDeliverystring (date-time)
earliestDateOfDeliverystring (date-time)
latestDateOfDeliverystring (date-time)
deliverBeforeTimestring
deliverAfterTimestring
additionalRemarksstring
DeliveryResponse
FieldTypeDescription
addressAddressResponse
instructionsstring
contactContactResponse
businessNamestring
deliverAfterTimestringFormatted in HH not hh (24 hours)
deliverBeforeTimestringFormatted in HH not hh (24 hours)
dateOfDeliverystring (date-time)
DimensionTypeWithSymbols
FieldTypeDescription
lengthTypeenum LengthTypeOne of: Unknown, Centimeter, Meter, Inch, Foot.
weightTypeenum WeightTypeOne of: Unknown, Kilogram, Tonne, Pound, Stone, UsTon, ImperialTon, Gram.
volumeTypeenum VolumeTypeOne of: None, Litre, CubicCentimeter, CubicMeter, Gallon, CubicInch, CubicFoot.
lengthSymbolstring
weightSymbolstring
volumeSymbolstring
DispatchResponse
FieldTypeDescription
idstring (uuid)
codestring
descriptionstring
dispatchStatusenum DispatchStatusesOne of: Active, Pending, Dispatched, Cancelled, Complete, Draft, InTransit, Unassigned.
dateOfDeparturestring (date-time)
scheduledDateOfDeparturestring (date-time)
dateOfCompletionstring (date-time)
shipmentsShipmentResponse[]
driversDriverResponse[]
vehicleVehicleResponse
businessBusinessResponse
DriverResponse
FieldTypeDescription
idstring (uuid)
idNumberstring
licenseNumberstring
licenseTypeIdinteger (int32)
licenseRenewalDatestring (date-time)
licenseIssuedDatestring (date-time)
userDriverUserResponse
DriverUserResponse
FieldTypeDescription
idstring (uuid)
firstNamestring
lastNamestring
emailstring
phoneNumberstring
FulfillmentItemRequest
FieldTypeDescription
weightnumber (double)
widthnumber (double)
lengthnumber (double)
heightnumber (double)
declaredValuenumber (double)
descriptionstring
correlationIdstring (uuid)
FulfillmentItemResponse
FieldTypeDescription
weightnumber (double)
widthnumber (double)
lengthnumber (double)
heightnumber (double)
titlestring
quantitynumber (double)
declaredValuenumber (double)
descriptionstring
FulfillmentProviderServiceTypeModel

This model represents the different services which the fulfillment provider provides.

FieldTypeDescription
idinteger (int32)
valuestring
FulfillmentRequirementTypeModel
FieldTypeDescription
idinteger (int32)
valuestring
GeometryFieldsResponse
FieldTypeDescription
weightnumber (double)
widthnumber (double)
lengthnumber (double)
heightnumber (double)
lengthTypeenum LengthTypeOne of: Unknown, Centimeter, Meter, Inch, Foot.
weightTypeenum WeightTypeOne of: Unknown, Kilogram, Tonne, Pound, Stone, UsTon, ImperialTon, Gram.
weightSymbolstring
lengthSymbolstring
IntegrationContextRequest
FieldTypeDescription
configuredProviderIdstring (uuid)
idstring
idTypeenum UidTypeOne of: Unknown, Long, Guid, String.
contentstringCan be used to store the raw data received from the external system. Maps to SerializedData...
metadatamap<string, string>Additional metadata related to the integration object.
reportedQuantityinteger (int32)The available-to-sell quantity the provider reports for this product. Null when the provider does not report a quantity.
dateCreatedstring (date-time)
MetadataFileAttachment

Not quite as complete as the normal FileAttachment aggregate.

FieldTypeDescription
idstring (uuid)
typeenum MetadataAttachmentTypeOne of: File, Link.
fileAttachmentIdstring (uuid)Left as Guid.Empty for Link entries.
titlestring
urlstring
contentTypestring
descriptionstring
OrderCarrierMetadata
FieldTypeDescription
carrierIdstring (uuid)
earliestCollectionstring (date-time)
collectionRequestedstring (date-time)
collectionAfterRequeststring (date-time)
dateDeliveredstring (date-time)
dateOfReturnRequestedstring (date-time)
timeframestring
requestedCollectionboolean
shipmentLabelGeneratedboolean
requestedReturnboolean
packageCountinteger (int32)
packagesOrderPackageMetadata[]
OrderIntegrationDetailsResponse
FieldTypeDescription
idstring (uuid)
integrationIdstringThe integration id as displayed on the relevant integration
providerPrimitiveIntegrationProviderResponse
OrderItemResponse

Order Item maps onto ProductOrder and contains a property with all of the product information.

FieldTypeDescription
idstring (uuid)
codestring
quantityOrderednumber (double)
unitenum UnitOfMeasureOne of: Each, Kilogram, Gram, Litre, Millilitre, Metre, Centimetre, SquareMetre, CubicMetre, Pair, Pack, Box, Roll, Sheet.
orderShipmentOrderShipmentResponse
productProductResponse
shipmentShipmentResponse
carrierPrimitiveIntegrationProviderResponse
dimensionPresetPrimitiveDimensionPreset
titlestring
descriptionstring
primaryImageUrlstring
geometryGeometryFieldsResponse
billingPriceDetailsResponse
OrderResponse
FieldTypeDescription
dateCreatedstring (date-time)
dateModifiedstring (date-time)
idstring (uuid)
codestring
deliveryItemCountinteger (int32)
orderItemCountnumber (double)Total quantity of items ordered across all line items. Surfaced for list views.
descriptionstring
purchaseOrderNumberstringThe customer's purchase order number, when this order was raised from a received customer PO.
billingPriceDetailsResponse
shippingCostsOrderShippingCostsResponse
fulfillmentStatusenum FulfillmentStatusOne of: Unknown, Unassigned, PendingCollection, PendingDelivery, Fulfilled, Cancelled.
customerIpAddressstring
serviceLevelenum ServiceLevelOne of: Unknown, Standard, Express, SameDay, Overnight, TwoDay, InternationalStandard, InternationalExpress, OnDemand, Freight.
weightTypeenum WeightTypeOne of: Unknown, Kilogram, Tonne, Pound, Stone, UsTon, ImperialTon, Gram.
lengthTypeenum LengthTypeOne of: Unknown, Centimeter, Meter, Inch, Foot.
statusenum OrderStatusOne of: Unknown, New, PendingCollection, PendingDelivery, Complete, Cancelled, PendingReturn, Returned.
fulfillmentTypeenum FulfillmentTypeOne of: Unknown, Package, Pallet, Container, Miscellaneous.
fulfillmentSubTypeenum FulfillmentSubTypeOne of: Unknown, GeneralPackage, FoodDelivery, MedicalDelivery, GroceriesDelivery, StandardPallet, StandardInternationalPallet, StandardUsPallet, StandardEuroPallet, CustomPallet, General10Ft, General20Ft, HighCube20Ft, General40Ft, HighCube40Ft, General45Ft, HighCube45Ft, FlatRack20FtWithSides, FlatRack20FtWithoutSides, FlatRack40FtWithSides, FlatRack40FtWithoutSides, OpenTop20Ft, OpenTop40Ft, Reefer20Ft, Reefer40Ft, MiniVan, DryVan, Flatbed, Tanker, AutoHauler, BoxTruck, Trailer, LowBoy, Dumper, Pickup, TowTruck, DumpTruck.
dateOfScheduledCollectionstring (date-time)
dateCreatedOnIntegrationstring (date-time)
effectiveDatestring (date-time)
dateOfDeliveryCompletionstring (date-time)
dateImportedstring (date-time)
countryCodeenum CountryCodeOne of: Invalid, Global, FallbackZa, Be, De, Lu, Nl, Za, Zw, Gb, Us, Zm.
paymentProcessedboolean
paymentUrlstring
integrationOrderUrlstring
multiCarrierboolean
currencyCodeenum CurrencyCodeOne of: Invalid, Eur, Usd, Gbp, Zar, Zmw.
paymentMethodenum PaymentMethodOne of: Unknown, Cash, Card, CashOnDelivery, CardOnDelivery, Eft, Crypto, Paypal, WireTransfer, DebitOrder.
attachmentsMetadataFileAttachment[]
orderItemsOrderItemResponse[]
orderShipmentsOrderShipmentResponse[]
destinationAddressAddressResponse
originAddressAddressResponse
originLocationIdstring (uuid)The location/store the order is attributed to (trace which store it came from).
originLocationTitlestring
sourceChannelIdstring (uuid)The sales channel (medium) the order came through.
sourceChannelTitlestring
sourceChannelSalesChannelResponse
customerCustomerResponse
carrierMetadataOrderCarrierMetadata
dimensionTypeDimensionTypeWithSymbols
currencyMetadataCurrencyResponse
fulfillmentProvidersPrimitiveIntegrationProviderResponse[]
packageSizesPrimitiveDimensionPreset[]
integrationsOrderIntegrationDetailsResponse[]
metadatamap<string, string>
OrderShipmentResponse
FieldTypeDescription
shipmentQuotationShipmentQuotationResponse
orderOrderResponse
shipmentShipmentResponse
fulfillmentProviderPrimitiveIntegrationProviderResponse
canModifyItemsbooleanWhether the item set of this shipment can still be changed, through PUT /orders/{orderId}/shipments/{shipmentId}/items. False once the shipment leaves the Active status, or once a label, an invoice, a fulfillment request, an approved quotation, or a manual lock names the load it carries.
OrderShippingCostsResponse
FieldTypeDescription
shippingSubTotalnumber (double)
shippingDiscountnumber (double)
shippingTaxnumber (double)
shippingTotalnumber (double)
PriceDetailsResponse
FieldTypeDescription
subTotalnumber (double)
totalPricenumber (double)
totalTaxnumber (double)
totalDiscountnumber (double)
discountnumber (double)
discountTypeenum DiscountTypeOne of: None, Percentage, FixedValue.
taxIncludedboolean
taxRatenumber (double)
taxTypeenum TaxTypeOne of: None, Sales, Vat, Gst, Pst, Hst, Qst, Ist, Ust, Cst.
currencyCurrencyResponse
PrimitiveDimensionPreset
FieldTypeDescription
titlestring
weightnumber (double)
widthnumber (double)
lengthnumber (double)
heightnumber (double)
idstring (uuid)
fulfillmentTypeenum FulfillmentTypeOne of: Unknown, Package, Pallet, Container, Miscellaneous.
lengthTypeenum LengthTypeOne of: Unknown, Centimeter, Meter, Inch, Foot.
weightTypeenum WeightTypeOne of: Unknown, Kilogram, Tonne, Pound, Stone, UsTon, ImperialTon, Gram.
PrimitiveIntegrationProviderResponse
FieldTypeDescription
configuredProviderIdstring (uuid)
idinteger (int32)
titlestring
descriptionstring
logoUrlstring
PrimitiveUserResponse
FieldTypeDescription
idstring (uuid)
displayNamestring
firstNamestring
lastNamestring
emailstring
phoneNumberstring
SalesChannelResponse
FieldTypeDescription
idstring (uuid)
titlestring
kindenum SalesChannelKindOne of: Direct, PointOfSale, Online, Marketplace.
defaultLocationIdstring (uuid)
ShipmentItemResponse
FieldTypeDescription
idstring (uuid)
orderItemIdstring (uuid)
productIdstring (uuid)
quantitynumber (double)
unitenum UnitOfMeasureOne of: Each, Kilogram, Gram, Litre, Millilitre, Metre, Centimetre, SquareMetre, CubicMetre, Pair, Pack, Box, Roll, Sheet.
titlestring
descriptionstring
geometryGeometryFieldsResponse
subTotalnumber (double)
totalPricenumber (double)
totalTaxnumber (double)
totalDiscountnumber (double)
discountnumber (double)
discountTypeenum DiscountTypeOne of: None, Percentage, FixedValue.
ShipmentQuotationResponse
FieldTypeDescription
idstring (uuid)
providerPrimitiveIntegrationProviderResponse
itemsFulfillmentItemResponse[]
requiredServicesFulfillmentProviderServiceTypeModel[]
requirementsFulfillmentRequirementTypeModel[]
collectionCollectionResponse
deliveryDeliveryResponse
totalDeclaredValuenumber (double)
isInternationalboolean
isApprovedByUserboolean
totalItemsinteger (int32)
serviceLevelTextstring
serviceLevelenum ServiceLevelOne of: Unknown, Standard, Express, SameDay, Overnight, TwoDay, InternationalStandard, InternationalExpress, OnDemand, Freight.
fulfillmentTypeenum FulfillmentTypeOne of: Unknown, Package, Pallet, Container, Miscellaneous.
deliveryTypeenum FulfillmentDeliveryTypeOne of: Unknown, DoorToDoor, DoorToCollectionPoint, CollectionPointToDoor, CollectionPointToCollectionPoint, DoorToPort, PortToDoor, PortToPort, LockerToLocker.
weightTypeenum WeightTypeOne of: Unknown, Kilogram, Tonne, Pound, Stone, UsTon, ImperialTon, Gram.
lengthTypeenum LengthTypeOne of: Unknown, Centimeter, Meter, Inch, Foot.
countryCodeenum CountryCodeOne of: Invalid, Global, FallbackZa, Be, De, Lu, Nl, Za, Zw, Gb, Us, Zm.
dateOfEstimatedCollectionstring (date-time)The estimated collection and delivery dates, when they are known. They are null when no estimate exists. Do not substitute today's date.
dateOfEstimatedDeliverystring (date-time)
currencyCurrencyResponse
subTotalnumber (double)
totalPricenumber (double)
totalTaxnumber (double)
totalDiscountnumber (double)
discountnumber (double)
discountTypeenum DiscountTypeOne of: None, Percentage, FixedValue.
taxIncludedboolean
shipmentShipmentResponse
ShipmentResponse
FieldTypeDescription
dateCreatedstring (date-time)
dateModifiedstring (date-time)
idstring (uuid)
fulfillmentTypeenum FulfillmentTypeOne of: Unknown, Package, Pallet, Container, Miscellaneous.
statusenum ShipmentStatusOne of: Unknown, Active, PendingCollection, CollectionUnassigned, CollectionAssigned, CollectionRejected, CollectionException, CollectionFailedAttempt, Collected, AtHub, ReturnedToHub, InTransit, AtDestinationHub, DeliveryUnassigned, DeliveryAssigned, DeliveryRejected, DeliveryException, OutForDelivery, DeliveryFailedAttempt, InLocker, Delivered, Cancelled.
hasDimensionsboolean
dateOfDeparturestring (date-time)
titlestringLimits: maximum 100 characters.
providerServiceLevelIdUid
providerServiceLevelIdTypeenum UidTypeOne of: Unknown, Long, Guid, String.
serviceLevelenum ServiceLevelOne of: Unknown, Standard, Express, SameDay, Overnight, TwoDay, InternationalStandard, InternationalExpress, OnDemand, Freight.
codestring
descriptionstringLimits: maximum 3000 characters.
handlingTypeenum HandlingTypeOne of: Unknown, Delivery, Collection, Unassigned.
requiresApprovalboolean
totalDeclaredValuenumber (double)
quantityOfItemsnumber (double)
trackingIdstring
barcodestring
deliveryDeliveryResponse
collectionCollectionResponse
currencyCurrencyResponse
dispatchDispatchResponse
businessBusinessResponse
customerCustomerResponse
itemsShipmentItemResponse[]
fulfillmentContactsContactResponse[]
orderShipmentsOrderShipmentResponse[]
waypointsShipmentWaypointResponse[]
metadatamap<string, string>
attachmentsMetadataFileAttachment[]
ShipmentWaypointResponse
FieldTypeDescription
idstring (uuid)
segmentPositioninteger (int32)
titlestring
dateCheckedInstring (date-time)
dateCheckedOutstring (date-time)
dateCreatedstring (date-time)
dateModifiedstring (date-time)
addressAddressResponse
VehicleResponse
FieldTypeDescription
idstring (uuid)
licensePlatestring
dateOfLicenseExpirystring (date-time)
licenseDiscstring
vehicleIdentificationNumberstring
modelstring
makestring
acquisitionDatestring (date-time)
vehicleTypeenum VehicleTypeOne of: Motorcycle, LightMotorVehicle, HeavyMotorVehicleSub16, HeaveMotorVehicleOver16.
dateCreatedstring (date-time)
dateModifiedstring (date-time)