Outbound | POST | {Client’s URL}

Summary

This API pushes the Sales Order level details to External fulfilment system

Description

This API will call the External Fulfillment System (EFS) and send the details of Sale Orders and Sale Order line items.

This API trigger will be scheduled at a certain frequency by Increff OMS system at the following events:

• SUBORDER_CREATE
• SUBORDER_PARTIAL_CANCEL
• SUBORDER_CANCEL
• SUBORDER_COMPLETE
• SUBORDER_PROPERTIES_UPDATE
• PACKED

The above listed events can be enabled or disabled from Increff’s CIMS user interface with help of Increff support team

<aside> 🗒️ Note:

• subOrderItems Object is no longer part of the API Request Body.
• New Field Additions are highlighted in the Field Description table below </aside>

Request Body

{
    "billingAddress": {
        "city": "New York",
        "country": "USA",
        "email": "[email protected]",
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "line3": "",
        "name": "John Doe",
        "phone": "123-456-7890",
        "state": "NY",
        "zip": "10001"
    },
    "bundledSkuDefinitions": [
        {
            "bundledParentBarcode": "BUNDLE12345",
            "bundledParentChannelSkuId": "BCHSKU12345",
            "bundledParentClientSkuCode": "BCSKU123",
            "childSkus": [
                {
                    "barcode": "BAR67890",
                    "channelSkuCode": "CHSKU789",
                    "clientSkuCode": "CSKU678",
                    "qty": 3
                }
            ]
        }
    ],
    "channelName": "CHANNEL_XYZ",
    "eventType": "SUBORDER_CREATE",
    "isPriority": true,
    "locationCode": "LOC12345",
    "messageId": 123456789,
    "onHold": false,
    "packedAt": "2025-06-13T15:30:00+05:30[UTC]"
    "orderCode": "ORD98765",
    "orderCustomAttributes": {
        "attribute1": "Value1",
        "attribute10": "Value10",
        "attribute2": "Value2",
        "attribute3": "Value3",
        "attribute4": "Value4",
        "attribute5": "Value5",
        "attribute6": "Value6",
        "attribute7": "Value7",
        "attribute8": "Value8",
        "attribute9": "Value9",
        "channelMetadata":
        {
        "MetaDataTest1": "test_13669a9d0d24",
        "MetaDataTest2": "test_13669a9d0d25"
               },
        "currency": "USD"
    },
    "orderItems": [
        {
            "cancelledQuantity": 2,
            "channelDiscount": 5,
            "barcode": "51100L",
            "channelSkuCode": "CHSKU987",
            "clientSkuId": "SKU123",
            "customerCancelledQty": 1,
            "giftChargePerUnit": 10,
            "isBundled": false,
            "isVirtual": false,
            "orderedQuantity": 10,
            "orderItemCustomAttributes": {
                "attribute1": "Value1",
                "attribute10": "Value10",
                "attribute2": "Value2",
                "attribute3": "Value3",
                "attribute4": "Value4",
                "attribute5": "Value5",
                "attribute6": "Value6",
                "attribute7": "Value7",
                "attribute8": "Value8",
                "attribute9": "Value9",
                "channelMetadata": {
                "MetaDataTest1": "test_13669a9d0d24",
                "MetaDataTest2": "test_13669a9d0d25"
                      }
            },
            "sellerCancelledQty": 1,
            "sellerDiscount": 15,
            "sellerRejectQty": 0,
            "sellingPricePerUnit": 100,
            "shippingCharge": 20
        }
    ],
    "orderTime": "2024-12-25T10:00:00Z",
    "parentOrderCode": "PARENT12345",
    "paymentMethod": "COD",
    "requiredBy": "2024-12-30T18:00:00Z",
    "shippingAddress": {
        "city": "New York",
        "country": "USA",
        "email": "[email protected]",
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "line3": "",
        "name": "John Doe",
        "phone": "123-456-7890",
        "state": "NY",
        "zip": "10001"
    },
    "startProcessingTime": "2024-12-25T10:30:00Z",
    "virtualSkuDefinitions": [
        {
            "childSkus": [
                {
                    "barcode": "BAR12345",
                    "channelSkuCode": "CHSKU987",
                    "clientSkuCode": "CSKU123",
                    "qty": 5
                }
            ],
            "virtualParentBarcode": "VIRTUAL12345",
            "virtualParentChannelSkuId": "VSKU12345",
            "virtualParentClientSkuCode": "VCSKU123"
        }
    ]
}

Response Body

HttpStatus : 200