You can use the Serialized Logistics for Agro API to integrate the third-party systems with the Serialized Logistics for Agro application.


The Serialized Logistics for Agro API uses the Representational State Transfer (REST) standard to interact with other systems.


The Serialized Logistics for Agro API is an extension of the Serialized Logistics for Agro application of Movilitas.Cloud and enables you to send requests from external systems to the application.


This article describes how to send a Replace Inbound Order request to Movilitas.Cloud by using the Serialized Logistics for Agro API.


Note: Through API, you can update orders in Open status only. To update ongoing orders, you need to go to the Serialized Logistics for Agro application. Make sure that the Enable ongoing orders update checkbox is selected under the Settings tab.


API Tool to Use


In this document, we provide examples by using the cURL command-line tool. You can use any API tool to perform the API requests, for example, Postman or Katalon Studio.


Before You Begin


Before you start sending any messages:


1. You must enable the Serialized Logistics for Agro application in the Admin UI.

2. You must create an API key and secret. 

3. You must create a shopfloor channel with Serialized Logistics for Agro API source. You will need the channel key for your requests.

4. You must configure the Serialized Logistics for Agro application and the channel required to connect to SAP AII in the Admin UI.

5. You must have the authentication token to send requests over API. Select one of the following ways:

  • Apply a dynamic token. Send an authentication request over the Authentication API. For more information about the Authentication API, open the Tenant Dashboard in Movilitas.Cloud, select API keys, and choose Authentication API Documentation. Also, see Authentication Request.
  • Apply a static token. Generate a static token for your previously created API key.


For more information, see Configuring the Movilitas.Cloud APIs.


Procedure


1. Use the PUT method and the following URL:


https://api.movilitas.cloud/v1/serialized_logistics_agro/v1/api/inbound_order


2. For the header, define the following:


KeyAction
Content-TypeApply JSON format for the content. Use the value application/json.
x-access-tokenProvide the authentication token.


3. In the body of the request, define the parameters and their values based on the table below.


FieldRequired or Optional?TypeDescription
channel_keyRequiredStringThe channel key of your Serialized Logistics for Agro API channel. 
order_idRequiredStringOrder ID
order_typeRequiredString

The type of the order. Enter one of the following values:

  • Internal
  • External
  • Returns
order_exp_dateOptionalStringOrder expiration date. Free text field.
warehouse_tagRequiredStringThe warehouse tag that identifies your warehouse.


Note: Make sure that you have registered the warehouse under the Serialized Logistics for Agro application --> Warehouses tab and apply the value given in the Warehouse tag field.

supplier_tagOptionalStringThe supplier tag that identifies your supplier.


Note: Make sure that you have registered the supplier under the Serialized Logistics for Agro application --> Suppliers tab and apply the value given in the Supplier tag field.

item_listRequiredObject[]

The object array of the line items related to the order. Each line item object contains the details of the line item.


You can add multiple line items that have different or the same product data, there is no restriction. For example:

  • You have two line items with the same product code and batch but with different sales parameters.
  • You have line items with completely different product codes, batches, and other data.
      item_numberRequiredStringLine item number
      product_codeRequiredStringProduct code as per the GS1 standard.
      product_code_typeRequiredStringProduct code type. The application supports one value, "GTIN".
      product_descriptionOptionalStringProduct description
      product_groupOptionalStringProduct group code (AGI code)
      product_group_typeOptionalStringProduct group type (AGI)
      product_group_descriptionOptionalStringProduct group description
      batchOptionalStringProduct batch
      unit_of_measurementRequiredStringThe unit of measurement for the quantity. For example, "Liter", "Pcs", or "Kg".
      quantityRequiredNumberThe quantity of the line item.
      sales_unit_of_measurementOptionalString

The sales unit of measurement for the sales quantity. Enter one of the following values:

  • IGB
  • GEB
  • PAL
  • LTR
  • KGM

If you do not want to define the sales unit of measurement, you can leave the field empty by entering "" as the value or you can omit the field in your request.

      sales_quantityOptionalNumberThe sales quantity of the line item.


4. Send the request. The inbound order is updated and listed under the Serialized Logistics for Agro application --> Inbound orders tab in Open status.


Sample cURL Request 


curl -X PUT \
  https://api.movilitas.cloud/v1/serialized_logistics_agro/v1/api/inbound_order \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJzX2FqazQyS2RLQWhHciE3TUZtY1Q2UzhTQ3NDQ2hzc2RoTXRFUlNBIUNwUDhlZDkzU2htQ0hoaHIyTmg3Y0dBIiwiX2lkIjoiNWQyNzA4ZDc3NDQ1OTcxYjI5MmY4ZDI3IiwiaWF0IjoxNTYzOTU3MjA4LCJleHAiOjE1NjQwNDM2MDh9.dYGzl-K1UT8jAeb-XQ0n_chI8VJzKRJiXhtnU4GenPc' \
  -d '{
    "channel_key": "EunyP8TFMvFDEJH12bXeEhumUh03v91KiI2Zdemy",
    "order_id": "11112",
    "order_type": "Internal",
    "order_exp_date": "230409",
    "warehouse_tag": "ADFT",
    "item_list": [
        {
            "item_number": "001",
            "product_code": "20562151256246",
            "product_code_type": "GTIN",
            "product_description": "Herbicide 10L",
            "product_group": "00987865",
            "product_group_type": "AGI",
            "batch": "ENO9F0203",
            "unit_of_measurement": "Liter",
            "quantity": 30
        }
    ]
}



Sample Response (Success 200) 


{
    "success": true,
    "message": "Inbound order replaced"
}