Complete Packaging without Shipment Command

Actors​

• Akinon Order Management System (OMS)

• Akinon Omnitron System

• Integrated Application (ERP)

Domain Objects​

• Packaging Order

• OMS Command (Packaging Order Command)

Source and Target States for Use of Command​

CompletePackagingWithoutShipmentCommand is used only for the following status transitions.

Source Status	Enum Value	Target Status	Enum Value
Waiting	100	Packed	500
Preparing	200	Packed	500
Ready for Packaging	400	Packed	500

Process​

1. The OMS application copies orders from the Akinon Omnitron Application to itself to prepare delivery/distribution plans, generate packaging orders and transfer them to operation points.

2. The products in the order are distributed to the Packaging Orders by running the rules in the distribution scenarios designated by the brand.

3. Packaging Orders are transferred to the Akinon Instore App or the brand’s integrated software. (Packaging Orders Webhooks)

4. Packaging orders assigned to the Store/Warehouse commence in the Waiting status. If used, they may be moved to the Preparing or Ready for Packaging status.

5. When the packaging is made physically ready for distribution in one or more steps, the transition to the Packed status is made by using the screens in the Akinon Instore application or when another piece of software integrated into the OMS application triggers the predefined CompletePackagingWithoutShipmentCommand. During this process:

   • Package record is moved to the Packed status

   • PackageItem record is moved to the Packed status

   • OrderItem record is moved to the Preparing status. No shipping record is created. When the process is completed, the reservations of the products in the package are deleted.

6. If the remote_invoice_callparameter is set to true during status transition, invoice information is received from the defined customer invoice service.

7. If the sync_remote_order_statusparameter is not set to false during status transition, Omnitron is informed for orderitems with moved status records.

8. If there is a record in the package.status.packedevent type in the information services, webhook information stating that the package has been packed is sent to the defined URL address. After running this command, a copy of the document is made available for viewing and reporting on the Packaging Order detail pages (Akinon Instore + Akinon OMS Web) of the OMS application.

Command Parameters and Prerequisites​

For each packaging order:

Parameter	Parameter Name	Parameter Type	Parameter Description	Requirement
Packaging Order ID	package	integer	Dynamic for each order	Mandatory
Command Transition ID	transition	integer	Prepared and reported during OMS installation	Optional if slug is given
Slug	slug	slug	Unique slug for stste transition	Optional if Command Transition ID is given
Package Item IDs	package_items	list	A list of package item IDs	Mandatory
Barcode	barcodes	list	Barcode numbers of order items	Optional
Barcode Order Item ID	(barcodes)order_item	integer	Barcode numbers of order items	Mandatory (for sending barcodes)
Barcode Barcode number+	(barcodes)barcode	string	Barcode numbers of order items	Mandatory (for sending barcodes)

Regardless of scenarios, the process of lowering and raising quotas continues, the quota amount continues to increase and decrease on a location basis. However, for these alterations to impact planning, the scenario rules must have the SELECT_BY_QUOTA value.

• The maximum quota value specifies how many packages can be created from the respective location. The quota value is a user-unspecified parameter used for monitoring the maximum quota value and performing increase or decrease operations.

• max_quota - quota = available_quota

• If the available_quota value is 0, no packages can be created. (To encounter this scenario, the SELECT_BY_QUOTA value must be chosen in the scenario rules.)

• For packages with a status below 400 and in the cancellation_waiting state, the quota value increases by 1. (During this stage, when the package is in the waiting state, the quota amount is considered to increase by 1.)

• Upon packaging a package, the quota value decreases by 1. Consequently, the available_quota increases, enhancing the likelihood of packaging from the respective location.

• In the event of a package cancellation, the quota amount decreases by 1 in a similar way.

POST Complete Packaging without Shipment Command​

Path: https://{customer_api_url}-oms.akinon.net/api/v1/oms/packages/{package_id}/command/

• Package ID: XXX

• Transition ID: NNN (set after OMS installation)

• Slug: SSS (Unique Slug Value)

Request Body​

{
  "transition": NNN,
  "slug": SSS,
  "package": XXX,
  "package_items": [1,2,3],
  "barcodes": [
      {
          "order_item": 1,
          "barcode": "123456"
      }
  ]
}

Successful Response​

Status Code: 204 No Content