Skip to content

Order Intake Overview

The Order Intake system is the entry point for customers to submit their orders to GelatoConnect. This system addresses three fundamental questions about order processing:

Who can send the order?

Orders can be sent by customers that are created and managed by partners (tenants) within the GelatoConnect system.

How can the order be sent?

Orders are submitted via connectors using defined protocols that are assigned to customers. The system supports multiple connector types and protocols to accommodate different integration needs.

Example: Orders can be submitted via SiteFlow API connector over HTTP protocol, assigned to a customer created by an partner.

What is the order?

An order is an entity containing a list of products and shipping details, stored under a partner's (tenant) account and sent by a customer via a configured connector.

Example: An order containing flat_A5_200gsm and folded_A6_170gsm products to be delivered to a Norway address, sent through a customer's credentials via Simple FTP connector.

Order Management API

The Order Management API provides RESTful endpoints to manage the complete order lifecycle:

Order Submission

Use the Submit Order API to create new orders in the system. This endpoint accepts order details including: - Product specifications and quantities - Shipping address information - File attachments for printing - Custom metadata and packaging instructions

Order Modification

  • Cancel Order: Stop production and shipment until the order status changes to "shipped"
  • Update Shipment: Modify shipping methods or addresses before dispatch

Order Retrieval

  • Get Order: Retrieve detailed information about specific orders
  • Search Orders: Query orders based on various criteria like status, date ranges, and shipping countries

Order Processing Flow

  1. Order Submission: Customer submits order via configured connector
  2. Order Validation: System validates order data, products, and shipping information
  3. Order Routing: Order is routed to appropriate production facilities
  4. Status Updates: Order progresses through various states (new, processing, production, shipped)
  5. Order Fulfillment: Products are produced and shipped to the specified address

Order Structure

Each order contains:

Order Level

  • Order Reference ID: Customer's internal order identifier
  • Currency and Pricing: Financial details and retail pricing information
  • Shipping Information: Delivery address and method preferences
  • Metadata: Custom key-value pairs for tracking and integration

Product Level

  • Product Specification: Either productUid or productName with variants
  • Quantity: Number of items to produce
  • Files: Print-ready files with type specifications
  • Custom Options: Trim settings, packaging instructions, and metadata

Package Level

  • Shipping Method: Carrier and service type selection
  • Packaging Instructions: Custom packaging and packing slip requirements
  • Delivery Tracking: Tracking information once shipped

Supported Connectors

The system supports various connector types to accommodate different integration approaches:

  • HTTP-based APIs: RESTful endpoints with JSON payloads
  • FTP/SFTP: File-based order submission for legacy systems
  • Custom Protocols: Tailored connectors for specific customer needs

Each connector can be configured with custom mapping templates to transform incoming order data into the standard GelatoConnect format.