POST Create receipt

Introduction

Create a new receipt record in the YMS system. This API allows you to submit receipt information including carrier, customer, equipment details, item lines, appointment data, and dynamic field values. The receipt will be registered and assigned a unique identifier upon successful creation.

POST /receipt/create

Body Request Parameters

{
  "receiptId": "string",
  "receiptType": "string",
  "poNo": "string",
  "carrierId": "string",
  "customerId": "string",
  "referenceNo": "string",
  "equipmentType": "string",
  "equipmentNo": "string",
  "totalPalletQty": 0,
  "itemLines": [
    {
      "itemId": "string",
      "itemName": "string",
      "itemQty": "string",
      "palletQty": "string",
      "itemSpecDesc": "string",
      "itemSpecName": "string",
      "uomId": "string",
      "qty": "string"
    }
  ],
  "appointmentTime": "string",
  "appointmentId": "string",
  "sealNo": "string",
  "dataChannel": "YMS",
  "eventTime": "string",
  "extraData": "string",
  "carrierName": "string",
  "customerName": "string",
  "dynamicFieldValues": [
    {
      "fieldCode": "string",
      "value": "string",
      "values": [
        "string"
      ]
    }
  ],
  "preferenceLocationType": "SPOT"
}

Request Parameters

Name	Location	Type	Required	Description
X-Tenant-ID	header	string	No	none
X-Yard-ID	header	string	No	none
Item-Time-Zone	header	string	No	none
Authorization	header	string	No	none
Item-Bam-Client	header	string	No	none
x-facility-id	header	string	No	none
body	body	object	No	none
» receiptId	body	string	No	Receipt ID (RN-xxx)
» receiptType	body	string	Yes	Receipt type (Required)
» poNo	body	string	Yes	Purchase order number (Required)
» carrierId	body	string	Yes	Carrier ID (Required)
» customerId	body	string	Yes	Customer ID (Required)
» referenceNo	body	string	Yes	Reference number
» equipmentType	body	string	No	Equipment type (Required)
» equipmentNo	body	string	No	Equipment number (Required)
» totalPalletQty	body	integer	No	Total pallet quantity
» itemLines	body	[ItemInfo]	No	Item information list
»» itemId	body	string	No	Item identifier
»» itemName	body	string	No	Item name
»» itemQty	body	string	No	Item quantity
»» palletQty	body	string	No	Item pallet Qty
»» itemSpecDesc	body	string	No	Item spec desc
»» itemSpecName	body	string	No	Item spec name
»» uomId	body	string	No	item uomId
»» qty	body	string	No	qty
» appointmentTime	body	string	No	Appointment time (Required)
» appointmentId	body	string	No	Appointment ID
» sealNo	body	string	No	none
» dataChannel	body	string	No	Data source channel
» eventTime	body	string	No	Event time for idempotency control
» extraData	body	string	No	Extra data in JSON format
» carrierName	body	string	No	Carrier name
» customerName	body	string	No	Customer name
» dynamicFieldValues	body	[object]	No	Dynamic field values
»» fieldCode	body	string	Yes	Field code
»» value	body	string	No	none
»» values	body	[string]	No	多选值列表，优先于 value 使用
» preferenceLocationType	body	string	No	Preference location type (SPOT / DOCK / null)

Detailed Description

» receiptType: Receipt type (Required) Regular Receipt/Material Receive/Return

Enum Values

Property	Value
» dataChannel	YMS
» dataChannel	WMS
» dataChannel	OMS
» dataChannel	TMS
» dataChannel	FMS
» preferenceLocationType	SPOT
» preferenceLocationType	DOCK

Response Example

200 Response

{
  "code": 0,
  "msg": "",
  "success": false,
  "data": {
    "id": 0,
    "receiptId": "",
    "receiptStatus": "",
    "receiptType": "",
    "poNo": "",
    "carrierId": "",
    "customerId": "",
    "referenceNo": "",
    "equipmentType": "",
    "equipmentNo": "",
    "totalPalletQty": 0,
    "itemLines": [
      {
        "itemId": "",
        "itemName": "",
        "itemQty": "",
        "palletQty": "",
        "itemSpecDesc": "",
        "itemSpecName": "",
        "uomId": "",
        "qty": ""
      }
    ],
    "appointmentTime": "",
    "appointmentId": "",
    "sealNo": "",
    "dataChannel": "",
    "eventTime": "",
    "extraData": "",
    "carrierName": "",
    "customerName": "",
    "dynamicFieldValues": [
      {
        "entityId": "",
        "entityType": "",
        "fieldCode": "",
        "value": "",
        "values": [
          ""
        ],
        "fieldName": "",
        "longValue": "",
        "shortValue": "",
        "valueType": "",
        "optionsType": "",
        "options": [
          ""
        ]
      }
    ],
    "proNos": [
      ""
    ],
    "invoicePros": [
      ""
    ],
    "doNos": [
      ""
    ],
    "tripNo": "",
    "entryId": "",
    "preferenceLocationType": ""
  }
}

Response

Status Code	Definition	Description	Data Model
200	OK (opens in a new tab)	none	RReceiptView

POST Search Equipment Statuses with Paging POST Update Receipt