Manufacturo

Overview

Manufacturo is a manufacturing execution system (MES) that provides inventory management, production planning, and shop floor control capabilities. Silkline's integration with Manufacturo enables seamless synchronization of purchase orders, materials, and suppliers between the two systems.

To complete your integration with Manufacturo, you will need to provide the following information:

  • Base URL - Your Manufacturo instance URL

  • Site Code - The site code for your Manufacturo instance

  • API Key - Authentication key for API access

This guide walks you through finding or creating those credentials within Manufacturo.

Prerequisites

Please ensure you have Administrator permissions in your Manufacturo instance, or someone has shared their access with you.

Instructions

1

Finding your Manufacturo Base URL

Your base URL is the root URL of your Manufacturo instance (without any trailing paths).

If your Manufacturo URL is https://mycompany.manufacturo.com, your Base URL is https://mycompany.manufacturo.com

2

Finding your Site Code

Your site code is typically found in your Manufacturo instance settings or can be provided by your Manufacturo administrator.

The site code is usually a short alphanumeric identifier like MAIN or SITE01

3

Creating an API Key

  1. Log into your Manufacturo instance

  2. Navigate to the Integrator section from the main dashboard

  3. Click on the Keys tab in the Integrator interface

  4. Click the "+ Add Api Key" button

  5. Provide a descriptive name for the key (e.g., "Silkline Integration")

  6. Configure the appropriate permissions for the integration. The Silkline integration requires comprehensive access across multiple modules:

    Core Integration Permissions:

    • Integrator - Full access (Actions, Parameters, Triggers, Screens, API keys, Scripts, Custom endpoints, etc.)

    • Master Data - Full access (Products, Units of Measurement, Suppliers/Customers)

    • Inventory Management - Full access (Inventory, Containers, Purchase Orders, Move Orders, Shipping Orders)

    • Inventory Operations - Full access (Inventory moves, Receiving, Status changes, etc.)

    Additional Required Permissions:

    • Organization Management - Full access (Users, Roles, Sites, Areas, Locations, Work Centers)

    • Process & Procedures - Full access (Process Plans, BOMs, Procedures, Standard Operations)

    • Shopfloor Operations - Full access (Orders, Batches, Procedure Runs, Equipment Usage)

    • Shopfloor Management - Full access (Orders, Labor, Higher Pedigree)

    • Kanban Management - Full access (Kanban loops, Higher Pedigree)

    • Nonconformance - Full access (NCs, Conditions, Dispositions)

    • MRP - Full access (Master Schedule, MRP Runs, Reports)

    • Document Management - Full access (Read, Edit, Archive, Approve)

    • Costing - Full access (Read, Edit)

    • Action Boards - Full access (Boards, Actions, Calls)

    • Alertigo - Full access (Connections, Jobs, Configuration)

    • Reporting - Full access (Configuration, Preview)

Note: The Silkline integration requires comprehensive permissions across all Manufacturo modules to enable full bidirectional synchronization of data including purchase orders, materials, inventory, suppliers, and organizational data. This ensures seamless integration between Silkline and Manufacturo systems.

  1. Click Create or Generate to create the API key 8. Copy the generated API key immediately and store it securely

Important: The API key will only be displayed once for security reasons. Be sure to copy and store it securely before closing the dialog. You will need this key for the integration setup.

You can monitor API key usage in the Monitoring tab, which shows execution statistics, success rates, and failure counts for each key.

4

Configure the Integration in Silkline

  1. Follow the Managing Integrations guide to create your Manufacturo integration in Silkline

What Gets Synchronized

The integration syncs the following data between Manufacturo and Silkline:

Purchase Orders

Purchase orders and their line items are synchronized to Manufacturo, including:

  • Order details (order number, supplier, terms, dates)

  • Line items (product codes, quantities, unit costs, due dates)

  • Order status and tracking information

  • Quality clauses and inspection requirements

Materials/Parts

Material master data is synchronized from Manufacturo to Silkline, including:

  • Part codes and revisions

  • Part names and descriptions

  • Unit of measure information

  • Tracking levels (serial, lot, or none)

  • Active/inactive status

Suppliers

Supplier information is synchronized from Silkline to Manufacturo, including:

  • Supplier codes and names

Receipts

Receipt information is synchronized from Manufacturo to Silkline via webhooks:

  • Direct receiving events

  • Quantity received updates

  • Receipt confirmations

Detailed Data Mappings

Purchase Order Mapping

Silkline Field
Manufacturo Field
Notes

Order Number

orderNumber

Purchase order identifier

Supplier

partner

Supplier information (code and name)

Order Lines

orderLines

Array of order line items

Order State

status

Order status (NEW, CANCELLED, etc.)

Order Line Mapping

Silkline Field
Manufacturo Field
Notes

Line Number

orderDetailNumber

Line item identifier

Material

productCode/productRevision

Part code and revision

Quantity

quantity

Number of units ordered

Unit Cost

unitCost

Price per unit (if cost tracking enabled)

Due Date

dueDate

Expected delivery date (uses needDate by default, or expectedDeliveryDate if configured)

Description

comment

Line item description

Status

status

Line status (NEW, CANCELLED, etc.)

Material Mapping

Silkline Field
Manufacturo Field
Notes

Material Number

code

Part number/SKU

Revision

revision

Part revision

Name

text

Part name/description

Unit of Measure

default_uom_code

Unit type (EA, KG, etc.)

Tracking Level

is_serial_tracked/is_lot_tracked

Serial/lot tracking flags

Active Status

active

Part availability

Receipt Mapping

Manufacturo Field
Silkline Field
Notes

OrderNumber

Order Number

Links to Silkline order

OrderDetailNumber

Line Number

Links to specific order line

Quantity

Units Received

Quantity received

Webhook Events

The integration uses webhooks for real-time synchronization:

Product Created/Updated Event

  • Trigger: When a product is created or updated in Manufacturo

  • Action: Syncs the product data to Silkline as a material

  • Frequency: Real-time via webhook

  • Event Type: ProductCreatedUpdatedPublicEvent

  • Data Synced: Product code, revision, site code, and all product master data

Direct Receiving Event

  • Trigger: When inventory is received in Manufacturo

  • Action: Updates the corresponding order line in Silkline with received quantities

  • Frequency: Real-time via webhook

  • Event Type: DirectReceivingEvent

  • Data Synced: Order number, line number, quantity received, and receipt details

Reverse Receiving Event (Unrecieve)

  • Trigger: When inventory is reversed or "unreceived" in Manufacturo

  • Action: Updates the corresponding order line in Silkline to reflect the reduced received quantities

  • Frequency: Real-time via webhook

  • Event Type: ReverseReceivingEvent

  • Data Synced: Order number, line number, previous quantity, current quantity, and reversal details

  • Use Cases:

    • Correcting receiving errors

    • Returning defective materials

    • Adjusting inventory discrepancies

    • Processing material returns

Configuration Options

The integration supports several configuration options:

Parts Configuration

  • Type: Insert or upsert mode

  • Site Code: Override default site code for parts

  • Defaults: Default values for new parts (UOM, tracking settings, etc.)

Orders Configuration

  • Site Code: Override default site code for orders

  • Include Line Unit Cost: Whether to sync unit costs

  • Prefer Expected Delivery Date: When enabled, uses expectedDeliveryDate as the primary source for order line due dates, falling back to needDate if not available. When disabled (default), uses needDate first, then expectedDeliveryDate.

  • Defaults: Default pedigree codes for order lines

Suppliers Configuration

  • Site Code: Override default site code for suppliers

Frequently Asked Questions

How often does the data sync?

  • Purchase Orders: Synced in real-time when created or updated in Silkline

  • Materials: Synced in real-time when created or updated in Manufacturo

  • Receipts: Synced in real-time when inventory is received in Manufacturo

  • Reverse Receiving: Synced in real-time when inventory is reversed/unreceived in Manufacturo

  • Product Updates: Synced in real-time when products are created or updated in Manufacturo

  • Full Sync: Periodic full synchronization every 15 minutes

What happens if there's a conflict between systems?

For overlapping data models:

  • Purchase Orders: Silkline is the primary source for order creation and updates

  • Materials: Manufacturo is the primary source for part master data

  • Receipts: Manufacturo is the primary source for receiving information

Can I sync orders with zero quantities?

No, order lines with zero quantities are filtered out during synchronization to prevent issues in Manufacturo.

What if a part doesn't exist in Manufacturo?

The integration will skip order lines for parts that don't exist in Manufacturo and log a warning. Ensure all materials are synchronized before creating purchase orders.

How are order statuses mapped?

Silkline Status
Manufacturo Status

Open

NEW

Canceled

CANCELLED

Closed

RECEIVED

What happens to received or closed order lines?

Once an order line has been received or closed in Manufacturo, certain fields (like unit cost and inventory status) cannot be updated. The integration preserves the existing Manufacturo values for these fields.

How does reverse receiving work?

Reverse receiving (unrecieve) allows you to correct receiving errors or process returns by reducing the received quantity on an order line. When a reverse receiving event occurs in Manufacturo:

  • The system fetches the latest quantity completed from Manufacturo to ensure accuracy

  • The corresponding Silkline order line is updated to reflect the new received quantity

  • Both the previous and current quantities are tracked for audit purposes

  • This is commonly used for correcting receiving mistakes, processing returns, or adjusting inventory discrepancies

What happens when a product is created or updated in Manufacturo?

When a product is created or updated in Manufacturo, the integration automatically:

  • Syncs the product data to Silkline as a material/part

  • Updates all relevant product attributes including tracking settings, UOM, and active status

  • Triggers material ingestion to ensure the latest product information is available in Silkline

  • Maintains consistency between the two systems for all product master data

Last updated