Inbound Receipts by PO

POST/xml/inventory/receipts/

Receipts

This endpoint is new and in active development / testing.

This endpoint allows you to retrieve inbound receipts for one or more purchase orders. See the code examples for how to send the request to the FCP API.

Request Elements

Name
InventoryReceiptsRequest
Type
XML
Required
required
Description
The root XML element contains your API credentials and a list of purchase orders to be submitted.
Name
MerchantId
Type
integer
Required
required
Description
The unique ID number for your Fulﬁllment Control Panel account.
Name
MerchantToken
Type
string
Required
required
Description
Security token to protect against unauthorized orders.
Name
PurchaseOrderList
Type
XML
Required
required
Description
Contains all PO Number elements to be submitted.
Name
PurchaseOrderNumber
Type
string
Required
required
Description
Your identifying reference number for the PO.

Example Request / Payload

Request

<?xml version="1.0"?>
<InventoryReceiptsRequest>
  <MerchantId>{{CLIENT_ID}}</MerchantId>
  <MerchantToken>{{CLIENT_TOKEN}}</MerchantToken>
  <MerchantName>{{CLIENT_NAME}}</MerchantName>
  <PurchaseOrderList>
    <PurchaseOrderNumber>54324</PurchaseOrderNumber>
    <PurchaseOrderNumber>323271</PurchaseOrderNumber>
  </PurchaseOrderList>
</InventoryReceiptsRequest>

Example Response

Response

<?xml version="1.0" encoding="UTF-8"?>
<InventoryReceiptsResponse xmlns="https://fcp.efulfillmentservice.com/xml/inventory/receipts" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://fcp.efulfillmentservice.com/xml/inventory/receipts/InventoryReceiptsResponse.xsd">
    <Status>Success</Status>
    <Description/>
    <AsnList>
        <Asn>
            <AsnId>10000227</AsnId>
            <AsnStatus>Completed</AsnStatus>
            <CreatedAt>2025-01-16T18:30:34</CreatedAt>
            <PoNumber>54324</PoNumber>
            <RefNumber>253453</RefNumber>
            <ItemList>
                <Item>
                    <Sku>00-1111</Sku>
                    <ReceivedQuantity>1.00</ReceivedQuantity>
                    <DamagedQuantity>0.00</DamagedQuantity>
                </Item>
            </ItemList>
        </Asn>
        <Asn>
            <AsnId>0</AsnId>
            <AsnStatus>Not Found</AsnStatus>
            <CreatedAt/>
            <PoNumber>323271</PoNumber>
            <RefNumber/>
            <ItemList/>
        </Asn>
    </AsnList>
</InventoryReceiptsResponse>