Receive Parts Against PO

This API receives parts against existing purchase orders using packing-slip information.

User security

Purchase Order > Processing > Receive Parts Against PO

Field	Description
`WebMethod`	`GJM25ULJ` – required
`Option`	`scan` checks for errors without receiving parts; `update` receives parts against purchase orders.
`CompanyCode`	required
`APSubledgerCode`	required
`DateOfRecord`	Optional; defaults to the current system date.
`AuditNumber`	Returned result (read-only).
`attachment`	Returned audit report as a base64-encoded PDF (read-only).
`errorsFound`	Returned result; should be `0` (read-only).

Errors are returned in the errors node in the same format used by other Jonas API functions.

BatchHeader

Field	Description
`PurchaseOrderNumber`	required
`PackingSlipNumber`	Optional; depends on the setting in the PO Profile.
`WarehouseCode`	Optional default warehouse for the line items; defaults to the value from the purchase order.
`DateReceived`	Optional default receipt date for the line items; defaults to the current system date.
`PackingSlipAttachment`	Optional base64-encoded file; applies only when using `PackingSlipNumber`. DIGIO is required.

PackingSlipAttachment

Field	Description
`name`	Filename
`content`	Base64-encoded file content

BatchDetail

Field	Description
`ItemNumber`	required
`WarehouseCode`	Optional; defaults to the value from `BatchHeader`.
`DateReceived`	Optional; defaults to the value from `BatchHeader`.
`QuantityReceived`	Optional; defaults to the outstanding quantity from the purchase order.
`FreightAmount`	Optional.

PARTS_SerializedInventory

Include this node when receiving serialized parts.

Field	Description
`SerialNumber`	Required for serialized parts.
`ArrivedOnDate`	Optional; defaults to the `DateReceived` value in `BatchDetail`.
`CostAmount`	Optional; defaults to the value from the purchase order.
`Comments`	Optional.
`ReservedForCustomerJobWO`	Optional; defaults to the allocation from the purchase order.

Optional nodes can be omitted from the JSON.

Scan example

Use Option: "scan" to check the receipt for errors. To post the receipt, use Option: "update". Replace the packing-slip attachment content with the base64-encoded file.

{
  "WebMethod": "GJM25ULJ",
  "Option": "scan",
  "CompanyCode": "ZX",
  "APSubledgerCode": "AP",
  "DateOfRecord": "2017-10-31",
  "BatchHeader": [{
    "PurchaseOrderNumber": "000006",
    "PackingSlipNumber": "000000000015",
    "WarehouseCode": "MAIN",
    "DateReceived": "2017-10-31",
    "PackingSlipAttachment": {
      "name": "packingSlip15.pdf",
      "content": "JVBERi0xLjQNCjEgMCBvYmoNCjw8DQov...(base64 encoded file)"
    },
    "BatchDetail": [{
      "ItemNumber": "0001",
      "WarehouseCode": "MAIN",
      "DateReceived": "2017-10-31",
      "QuantityReceived": "9",
      "FreightAmount": "0.125",
      "PARTS_SerializedInventory": [{
        "SerialNumber": "12345",
        "ArrivedOnDate": "2017-10-31",
        "CostAmount": "0.125",
        "Comments": "optional",
        "ReservedForCustomerJobWO": ""
      }]
    }]
  }]
}