> For the complete documentation index, see [llms.txt](https://eshop.gitbook.io/eshopbox-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eshop.gitbook.io/eshopbox-developers/consignment/recall-consignment/create-a-recall-consignment.md).

# Create a Recall Consignment

## Create Recall consignment 

<mark style="color:green;">`POST`</mark> `https://{{workspace}}.myeshopbox.com/api/v1/recall-consignment`

This endpoint allows you to create recall consignment

#### Headers

| Name           | Type   | Description                                              |
| -------------- | ------ | -------------------------------------------------------- |
| Authentication | string | The Bearer token which allows to grant access to the API |

#### Request Body

| Name            | Type   | Description                                                 |
| --------------- | ------ | ----------------------------------------------------------- |
| itemsFileUrl    | string | Items file url                                              |
| refPartyID      | string | This is the party id where your items will be received.     |
| fromWarehouseId | string | This is the warehouse id from where your items will return. |

{% tabs %}
{% tab title="200 Recall consignment successfully created." %}

```
{
    "id": 1,
    "accountId": 12,
    "fromWarehouseId": 1,
    "toPartyId": 2,
    "consignmentNumber": "CON/45/873",
    "inventoryType":"GOOD",
    "itemsFileUrl": "https://storage.cloud.google.com/fileItems.appspot.com/items.pdf",
    "failedItemsUrl": "https://storage.cloud.google.com/failedItems.appspot.com/itemsFailed.pdf",
    "status": "COMPLETED",
    "successCount": 20,
    "failureCount": 2,
    "containersQty": 2,
    "scheduledDetails":{
    "pickingType": "ESHOPBOX",
		"scheduledTimeSlotFrom": "2019-09-01 09:23:02",
        "scheduledTimeSlotTo": "2019-09-02 02:23:02",
         "stockTransferNoteUrl": "https://storage.cloud.google.com/stockTransfer.appspot.com/transfer.pdf",
        "ewayBillUrl": "https://storage.cloud.google.com/ewayBill.appspot.com/bill.pdf",
        "invoiceUrl": "https://storage.cloud.google.com/invoice.appspot.com/invoice.pdf"
    },
    "operatingModel":"Billing",
    "createdAt": "2020-03-18T17:15:58.000+05:30",
    "updatedAt": "2020-03-18T17:15:58.000+05:30"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X POST https://{{workspace}}.myeshopbox.com/api/v1/recall-consignment\
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": {
        "fromWarehouseId": "7",
        "refPartyID": "10",
        "itemsFileUrl":"https://xyz.csv"
      }
    }'
```

{% endtab %}
{% endtabs %}