DIY Developer Guide: Building Custom Integrations for Zulily

Overview

Zulily is an online retailer specializing in daily deals and flash sales for apparel, home goods, and more, catering to a vast eCommerce audience. This DIY Developer Guide for Zulily offers a step-by-step framework for building secure, scalable, and efficient custom integrations with fulfillment platforms, ERP systems, and inventory management solutions.


Prerequisites for Zulily Integrations

  • Zulily API documentation and developer access credentials
  • FTP/SFTP credentials for EDI file exchanges (if applicable)
  • Familiarity with:
    • RESTful APIs (where available) or EDI standards (850, 856, 810)
    • JSON, XML, or Flat File formats
  • Tools: Postman, FTP Clients, EDI Translators, SDKs (Node.js, Python)

Step 1: Authentication for Zulily Integrations

Authentication can depend on integration method:

  • API Integrations: Use API Keys or OAuth 2.0.
  • EDI Integrations: Use Secure FTP (SFTP) for transmitting order files and receiving confirmations.

API Authentication Example:

Authorization: Bearer YOUR_ACCESS_TOKEN

Step 2: Endpoint Discovery and Data Mapping

Common API/EDI Resources:

  • Purchase Orders (850)
  • Advance Ship Notices (856)
  • Invoices (810)
  • Inventory Updates

Process:

  • Review Zulily API or EDI documentation.
  • Map ERP and inventory fields (e.g., SKU, quantity, price) to Zulily’s data structure.

Important considerations:

  • SKU and product ID consistency
  • Properly handling ship dates, expected arrival dates, and carrier details
  • Correct tax and discount calculations

Step 3: Building Integration Workflows

Integration Patterns:

  • Inbound (to Zulily): Inventory updates, product data feeds.
  • Outbound (from Zulily): Receive purchase orders, shipping confirmations, and invoices.

Example: Receiving a Purchase Order (EDI 850)


  123456789
  
    ABC123
    50
  

Example: Sending an Advance Ship Notice (EDI 856)


  SHIP123
  
    
      ABC123
      50
    
  

Step 4: Error Handling and Pagination

Error Handling:

  • Capture FTP file delivery failures or API-specific error codes.
  • Implement retry logic for server errors (5xx) and timeout scenarios.

Pagination (for APIs):

  • Use page and pageSize parameters when pulling large datasets.

Example:

GET /api/orders?page=2&pageSize=100

Step 5: Testing and Validation

  • Use EDI testing tools or Postman for endpoint validation.
  • Confirm purchase order imports, shipping notice deliveries, and inventory syncs.
  • Perform load testing for peak sales event scenarios.

Step 6: Deployment and Security

  • Deploy integrations securely using cloud providers (AWS, Azure, GCP).
  • Use secure credential storage for API keys and FTP/SFTP passwords.
  • Enforce HTTPS/TLS and secure FTP for all data transmissions.
  • Enable real-time error logging and system monitoring.

Step 7: Maintenance and Monitoring

  • Monitor Zulily API status and EDI transmission reports.
  • Set up alerts for order processing failures and shipment delays.
  • Track KPIs such as order fulfillment rates, shipping accuracy, and invoice processing times.

Optional Enhancements

  • Middleware solutions (Celigo, MuleSoft, Boomi) for managing complex workflows.
  • Dashboards for real-time tracking of orders, shipments, and inventory.
  • Event-driven notifications (webhooks if available) for immediate status updates.

Summary

Building custom Zulily integrations helps vendors streamline order management, improve shipping accuracy, and maintain seamless inventory updates. This DIY Developer Guide for Zulily provides a secure, scalable blueprint for creating high-performance fulfillment and order integrations.


Apiworx is dedicated to helping eCommerce businesses scale faster than ever possible before by streamlining and managing complex OmniChannel data flows, we save our customers time and money, allowing them to scale their businesses faster and more effectively.  We focus on automation and integration of often-overlooked back-office systems and processes such as order and inventory management.   We work with major partners in the industry and build best-in-breed automation and integration solutions.