Campaign Delivery

Campaign Delivery Service APIs

Facilitates the delivery of campaign resources to registered beneficiaries.

PreviousCampaign NextContracts

Last updated 1 year ago

Was this helpful?

Create a Delivery.

Creates Delivery On successful Delivery Ok response is returned.

post

/v1/_create

Body

requestInfoobject

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

deliveryobjectrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/delivery/v1/_create' \
  --header 'Content-Type: application/json'

200

400

500

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "delivery": {
    "clientReferenceId": "GUID",
    "tenantId": "tenantA",
    "campaignId": "ID-1",
    "registrationId": "R-ID-1",
    "warehouseId": "WARE-HOUSE-3",
    "deliveredBy": "UUID",
    "deliveryDate": 1663218161,
    "additionalFields": {
      "schema": "HOUSEHOLD",
      "version": 2,
      "fields": [
        {
          "key": "height",
          "value": 180
        }
      ]
    },
    "auditDetails": {
      "createdBy": "text",
      "lastModifiedBy": "text",
      "createdTime": 1,
      "lastModifiedTime": 1
    },
    "status": "DELIVERED",
    "resources": [
      {
        "resourceId": "ID-1",
        "quantityToBeDelivered": 100,
        "reasonIfNotDelivered": "text",
        "isDelivered": true,
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        },
        "quantityDelivered": "BALE"
      }
    ],
    "deliveryId": "UUID"
  }
}

Delivery Request created successfully.

Update A Delivery.

Update Delivery, Ok response is returned.

post

/v1/_update

Body

requestInfoobject

deliveryall of

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/delivery/v1/_update' \
  --header 'Content-Type: application/json'

200

400

500

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "delivery": {
    "clientReferenceId": "GUID",
    "tenantId": "tenantA",
    "campaignId": "ID-1",
    "registrationId": "R-ID-1",
    "warehouseId": "WARE-HOUSE-3",
    "deliveredBy": "UUID",
    "deliveryDate": 1663218161,
    "additionalFields": {
      "schema": "HOUSEHOLD",
      "version": 2,
      "fields": [
        {
          "key": "height",
          "value": 180
        }
      ]
    },
    "auditDetails": {
      "createdBy": "text",
      "lastModifiedBy": "text",
      "createdTime": 1,
      "lastModifiedTime": 1
    },
    "status": "DELIVERED",
    "resources": [
      {
        "resourceId": "ID-1",
        "quantityToBeDelivered": 100,
        "reasonIfNotDelivered": "text",
        "isDelivered": true,
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        },
        "quantityDelivered": "BALE"
      }
    ],
    "deliveryId": "UUID"
  }
}

Updated Delivery successfully.

Search Delivery.

Search Delivery Ok response is returned.

post

/v1/_search

Body

requestInfoobject

deliverySearchCriteriaobject

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/delivery/v1/_search' \
  --header 'Content-Type: application/json'

200

400

500

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "totalCount": 0,
  "deliveries": [
    {
      "clientReferenceId": "GUID",
      "tenantId": "tenantA",
      "campaignId": "ID-1",
      "registrationId": "R-ID-1",
      "warehouseId": "WARE-HOUSE-3",
      "deliveredBy": "UUID",
      "deliveryDate": 1663218161,
      "additionalFields": {
        "schema": "HOUSEHOLD",
        "version": 2,
        "fields": [
          {
            "key": "height",
            "value": 180
          }
        ]
      },
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "status": "DELIVERED",
      "resources": [
        {
          "resourceId": "ID-1",
          "quantityToBeDelivered": 100,
          "reasonIfNotDelivered": "text",
          "isDelivered": true,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          },
          "quantityDelivered": "BALE"
        }
      ],
      "deliveryId": "UUID"
    }
  ]
}

Fetched Search Delivery.