0ne Record Docs
  • GENERAL OVERVIEW
    • Introduction
    • Before getting started
    • Changelog
    • Status
  • About the API
    • Environments
    • Versionning
      • Breaking change
    • Conditions & Limit
    • Pagination
    • Date Handling
    • Identifier
    • Filtering and Sorting
    • Groups
    • Troubleshooting
  • Security
    • Authentication
    • Authorization
  • REST API
    • Container
      • Get all container
      • Get a container by id
      • Create a container
      • Update a container
      • Delete a container
    • Container Type
      • Get all container type
      • Get a container type by type
      • Create a container type
      • Update a container type
      • Delete a container type
    • Country
    • Place
    • Shipment
      • Get all shipment
      • Get shipment by id
      • Create a shipment
      • Update a shipment
      • Delete a shipment
    • Shipment Anomaly
      • Get all shipment anomaly
      • Get a shipment anomaly by id
      • Create a shipment anomaly
      • Update a shipment anomaly
      • Delete a shipment anomaly
    • Shipment Anomaly Category
      • Get all shipment anomaly category
      • Get a shipment anomaly category by name
      • Create a shipment anomaly category
      • Delete a shipment anomaly category
    • Shipment Anomaly Type
      • Get all shipment anomaly type
      • Get a shipment anomaly type by code
      • Create a shipment anomaly type
      • Update a shipment anomaly type
      • Delete a shipment anomaly type
    • Shipment Customs
      • Get all shipment customs
      • Get shipment customs by id
      • Create a shipment customs
      • Update a shipment customs
      • Delete a shipment customs
    • Shipment Customs Type
      • Get all shipment customs type
      • Get shipment customs type by name
    • Shipment Detail
      • Get all shipment detail
      • Get shipment detail by id
    • Shipment Document
      • Get all shipment document
      • Get shipment document by id
      • Create a shipment document
      • Delete a shipment document
    • Shipment Event
      • Get all shipment events
      • Get shipment event by id
      • Create a shipment event
      • Update a shipment event
      • Delete a shipment event
    • Shipment Event Type
      • Get all shipment event type
      • Get shipment event type by name
    • Shipment Operator
      • Get all shipment operator
      • Get shipment operator by id
      • Create a shipment operator
      • Update a shipment operator
      • Delete a shipment operator
    • Shipment Preparation
      • Get all shipment preparation
      • Get shipment preparation by id
      • Create a shipment preparation
      • Update a shipment preparation
      • Delete a shipment preparation
    • Shipment Security
      • Get all shipment security
      • Get shipment security
      • Create a shipment security
      • Update a shipment security
      • Delete a shipment security
    • Shipment Security Type
      • Get all shipment security type
      • Get shipment security type by code
    • Shipment Service
      • Get all shipment service
      • Get shipment service by id
      • Create a shipment service
      • Update a shipment service
      • Delete a shipment service
    • Shipment Service Type
      • Get all shipment service type
      • Get shipment service type by id
      • Create a shipment service type
      • Update shipment service type
      • Delete a shipment service type
    • Society Subscription
      • Get all society subscription
      • Get a society subscription by id
      • Create a society subscription
      • Update a society subscription
      • Delete a society subscription
  • Notification
    • Webhook
      • Request
      • Restriction & Limitation
      • Supported Authentication Methods
      • Payload signature
    • SocketIO
      • Environments
      • Authentication
      • Authorization
      • Namespaces
        • Shipment Notification Namespace
      • Handling Errors
    • Example payload
      • Shipment payload
      • Shipment event payload
      • Shipment operator
Powered by GitBook
On this page
  1. REST API
  2. Shipment

Update a shipment

PreviousCreate a shipmentNextDelete a shipment

Last updated 1 year ago

Depending on the state of a shipment, some or all of its attributes can be modified. List of attributes are described in page.

As long as it is not handled by the warehouse, all the attributes can be modified:

  • after creation of export shipment with ORDER , before GOODS_RECEIPT event.

  • after creation of import shipment with ORDER , before PICKUP or GOODS_RECEIPT event, whichever comes first.

  • after creation of export delivery shipment with DELIVERY_ORDER , before DELIVERY_PREPARATION event.

For export shipment, as long as it has not reach the DELIVERY_PREPARATION , the master mawbNumber and house hawbNumber numbers can be added/modified. This is also the last moment at which e.g. can be added.

For every type of shipments, the customerReference can be modified until the final DELIVERY_COMPANY/DELIVERY . Once delivered, the shipment will be archived in read-only mode, so not editable any more.

create shipment
event
event
event
event
services
event

Update shipment

put

Update shipment

Authorizations
Path parameters
shipmentIdstringRequired
Body
orderReferencestring | nullableOptional
customerReferencestring | nullableOptional
quantityExpectednumber | nullableOptional
quantityTypeExpectedstring · enum | nullableOptionalPossible values:
grossWeightExpectednumber | nullableOptional
grossWeightTaxableExpectednumber | nullableOptional
volumeExpectednumber | nullableOptional
quantityRealnumber | nullableOptional
quantityTypeRealstring · enum | nullableOptionalPossible values:
grossWeightRealnumber | nullableOptional
grossWeightTaxableRealnumber | nullableOptional
volumeRealnumber | nullableOptional
mawbNumberstring | nullableOptional
hawbNumberstring | nullableOptional
hblstring | nullableOptional
mblstring | nullableOptional
goodsDescriptionstring | nullableOptional
flystring | nullableOptional
shipstring | nullableOptional
isSecurebooleanOptionalDefault: false
isDangerousbooleanOptionalDefault: false
limitBoardingTimestring | nullableOptional
shippingReferencestring | nullableOptional
departurestring | nullableOptional
departureCountrystring · enum | nullableOptionalPossible values:
arrivalstring | nullableOptional
arrivalCountrystring · enum | nullableOptionalPossible values:
Responses
put
PUT /shipment/{shipmentId} HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 570

{
  "orderReference": "text",
  "customerReference": "text",
  "quantityExpected": 1,
  "quantityTypeExpected": "AUT",
  "grossWeightExpected": 1,
  "grossWeightTaxableExpected": 1,
  "volumeExpected": 1,
  "quantityReal": 1,
  "quantityTypeReal": "AUT",
  "grossWeightReal": 1,
  "grossWeightTaxableReal": 1,
  "volumeReal": 1,
  "mawbNumber": "text",
  "hawbNumber": "text",
  "hbl": "text",
  "mbl": "text",
  "goodsDescription": "text",
  "fly": "text",
  "ship": "text",
  "isSecure": true,
  "isDangerous": true,
  "limitBoardingTime": "text",
  "shippingReference": "text",
  "departure": "text",
  "departureCountry": "AD",
  "arrival": "text",
  "arrivalCountry": "AD"
}
{
  "shipmentId": "123e4567-e89b-12d3-a456-426614174000",
  "departure": "text",
  "departureCountry": "AD",
  "arrival": "text",
  "arrivalCountry": "AD",
  "orderReference": "text",
  "customerReference": "text",
  "quantityExpected": 1,
  "quantityTypeExpected": "AUT",
  "grossWeightExpected": 1,
  "grossWeightTaxableExpected": 1,
  "volumeExpected": 1,
  "quantityReal": 1,
  "quantityTypeReal": "AUT",
  "grossWeightReal": 1,
  "grossWeightTaxableReal": 1,
  "volumeReal": 1,
  "mawbNumber": "text",
  "hawbNumber": "text",
  "hbl": "text",
  "mbl": "text",
  "goodsDescription": "text",
  "fly": "text",
  "ship": "text",
  "isSecure": true,
  "isDangerous": true,
  "limitBoardingTime": "text",
  "shippingReference": "text",
  "assignations": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "anomalies": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "customs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "details": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "documents": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "events": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "operators": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "securities": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "services": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "preparations": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "createdAt": null,
  "updatedAt": null
}