Order Acknowledgement

Single Order Acknowledgement

Once a custom order has been purchased by the customer and is pending fulfillment, we require transmission of an order acknowledgement to the Spectrum REST API. This request will typically trigger dependent processes, such as delivery of factory print-ready files. It also ensures accurate and meaningful reporting within the Spectrum Admin interface.

Note: If you are using Shopify, order capture happens automatically using the Spectrum + Shopify Integration.

An order acknowledgement consists a single order with one or more line items.

POST https://{SpectrumEnvironment}/api/order/acknowledgement HTTP/1.1
SPECTRUM_API_TOKEN: {SpectrumApiToken}
Content-Type: application/json

The available {SpectrumEnvironment} base URLs are listed in the Environments page.

Required

  • purchaseOrderNumber (string)

  • orderDate (ISO 8601 date string)

  • lineItems (array)

  • lineItems[n] (object)

    • recipeSetId (string)

    • skuQuantities[n] (string)

      • quantity (string)

      • sku(string)

Order Optional Fields

  • customerServiceContact (string)

Line Item Optional Fields

  • giftMessage (string)

  • shipmentVendor (string)

  • shipmentTracking (string)

  • estimatedDeliveryDate (ISO 8601 date string)

Example request body

Example JSON response (200 Success)

Example JSON response (409 Conflict)

Example JSON response (500 Error)

Multiple Order Acknowledgements

Spectrum can also handle multiple order acknowledgements, which is helpful when a bulk update is desired over a single request. The same fields for the single order acknowledgement are required.

Example request body

Full Order Details

Finally, Spectrum can capture order and line item details for customer shipping information. This information is stored securely and encrypted within Spectrum, and it can be forwarded to fulfillment partners.

Required

  • purchaseOrderNumber (string)

  • orderDate (ISO 8601 date string)

  • lineItems (array)

  • lineItems[n] (object)

    • recipeSetId (string)

    • sku (array)

    • quantity (string)

    • skuQuantities[n] (string)

      • quantity (string)

      • sku(string)

  • customerAddress (object)

    • firstName (string)

    • lastName (string)

    • address1 (string)

    • city (string)

    • state (string)

    • postalCode (string

    • country (string)

  • shippingAddress (object)

    • [same required fields as customerAddress]

Optional

  • customerServiceContact (string)

Example request body

PreviousPricing & AvailabilityNextShipment Notification

Last updated

Was this helpful?