Skip to main content

Generate Inbound Order Document

Automatically generate a document for a CartonCloud inbound order (Purchase Order) when the order reaches a nominated status and email it out.

The middleware listens for CartonCloud inbound orders. When an inbound order for a specific customer reaches a specific status, the order details are retrieved from the CartonCloud API, a document is generated from them using a specified template, and the document is emailed to the configured email addresses.

A common use of this functionality is generating GS1 barcode / matrix labels for the order products.

info

Unfortunately at this time the CartonCloud API doesn't support adding documents directly to inbound orders, so generated documents must be emailed.

Prerequisites​

In addition to the Utilities for CartonCloud prerequisites, a webhook subscribing to the Order status change trigger needs to be registered against the middleware. This needs to be provisioned through a request to CartonCloud Support.

Configuration​

Any number of generation rules can be configured, each defining:

  • Customers - The CartonCloud customers whose inbound orders are monitored.
  • Status - The inbound order status which triggers the document generation, e.g. DRAFT, ALLOCATED, VERIFIED.
  • Document - The document to be generated, along with any options it takes such as label dimensions or the number of labels per product.
  • Recipients - The email addresses the generated document is sent to, along with the subject and body of the email.

Because rules are matched on both customer and status, different customers can receive different documents, and the same customer can have separate documents generated at different points in the receipting process.

Document Generation​

Documents are generated from a template and the inbound order details held in CartonCloud, which typically includes the order reference, the customer, the destination warehouse, and each product on the order with its product code / SKU, description, and quantity.

Documents are generated as PDF's, ready to be printed or forwarded on.

GS1 Barcode / Matrix Labels​

Where GS1 barcode and matrix labels are being generated, the label content is built from the product details held in CartonCloud together with the inbound order quantities, producing a label sheet covering the products on the order.