Resource

https://api.warehousefs.com/public/v1/stored-value-manifests/{shipvineIdentifier}

The stored value manifests resource allows the merchant to view which values have been assigned by Shipvine to stored value cards such as gift cards or gift certificates.

GET

Request

URL Template

The {shipvineIdentifier} field in the URL template should be replaced with the Shipvine identifier for the fulfillment request. You can obtain this identifier by inspecting the /OutboundShipments/OutboundShipment/FulfillmentRequest/WfsIdentifier element of the Outbound Shipment resource.

Example Request URL

https://api.warehousefs.com/public/v1/stored-value-manifests/2-13-319-68634-558-5

Query Parameters

No query parameters may be included in the request.

Entity Body

No entity body may be included in the request.

Response

If successful, the API will return 200 OK as well as a <StoredValueManifest /> element in the entity body.

If any error occurs, the HTTP status code will not be 200 OK. An <Errors /> element may be present in the entity body.

Example Response Entity Body

<?xml version="1.0" encoding="utf-8"?>
<StoredValueManifest xmlns="urn:WarehouseFS-1.0">
  <FulfillmentRequest>
    <MerchantIdentifier>Test</MerchantIdentifier>
    <WfsIdentifier>2-13-319-68634-558-5</WfsIdentifier>
  </FulfillmentRequest>
  <Lines> <!-- (1) -->
    <Line>
      <Item>
        <MerchantIdentifier>STANDARD GIFT CARD</MerchantIdentifier> <!-- (2) -->
      </Item>
      <Value>
        <Amount>25.0000</Amount> <!-- (3) -->
        <Currency>USD</Currency>
      </Value>
      <Code>GIFT79876LG</Code> <!-- (4) -->
    </Line>
    <Line>
      <Item>
        <MerchantIdentifier>STANDARD GIFT CARD</MerchantIdentifier>
      </Item>
      <Value>
        <Amount>25.0000</Amount>
        <Currency>USD</Currency>
      </Value>
      <Code>GIFT79877LG</Code>
    </Line>
    <Line>
      <Item>
        <MerchantIdentifier>STANDARD GIFT CARD</MerchantIdentifier>
      </Item>
      <Value>
        <Amount>50.0000</Amount>
        <Currency>USD</Currency>
      </Value>
      <Code>GIFT82454DF</Code>
    </Line>
  </Lines>
</StoredValueManifest>

1. If the fulfillment request contains more than one gift card (either two separate lines of gift cards of separate values, or multiple quantities of a gift card of a single value), then you'll see multiple <Line /> elements in the response. For example, if the fulfillment request contains 2 x $50 gift card in one line and 1 x $100 gift card in another line, then the <StoredValueManifest /> will have three <Line /> elements in the response.
2. If you offer different kinds of gift cards, such as a blue gift card and a green gift card, you can distinguish the kind of gift card with the merchant identifier field.
3. The value assigned to the gift card, which corresponds to the <StoredValue /> element in the original API submission.
4. The barcode that was scanned on the gift card.