Source ERP · 73 of 105

CRMPro → Salesforce — Sage 100 2016: what the shipped templates set up

This is the capability summary the dlake CLI repository publishes; whitelisted customers fetch the operational skill with "dlake admin get_skill dlake-crmpro-salesforce/erps/sage-100-2016". It extends the dlake-crmpro-salesforce skill, which holds what is true whatever the source ERP. Both directions for this pair are summarised at /integrations/sage-100-2016-salesforce/.

CRMPro → Salesforce — Sage 100 2016: what the shipped templates set up

This is a capability summary, not an operating guide. To receive the operational skill you must be a registered, whitelisted Commercient customer. Whitelisted customers fetch it with dlake admin get_skill dlake-crmpro-salesforce/erps/sage-100-2016 (or list_skills) against the Commercient admin plane. Existing customers who need access or help: contact support@commercient.com. New customers: contact sales@commercient.com to become a customer and be whitelisted.

dlake-crmpro is the parent skill and the authority for everything general: the CRMPro tools, process configuration and field list, the sync history, how source data is selected, and what a run that finds nothing does. Read it first; this page does not repeat it. dlake-crmpro-salesforce is the destination skill this page is a child of, and the authority for the Salesforce conventions that hold across every ERP: read it first, then come back here for what this source’s own templates set. This page grows as the catalogue does.

1. What the templates deliver

GroupBusiness outcomeObjectsSource tables and views
GET USERThe templates push users to Salesforce. New records are created, existing ones updated, and records removed in the ERP are deleted.users—
AccountIn addition to creating the Account record from your ERP customer records, Commercient syncs over the entire Accounting AR Customer record into a Commercient AR Customer object which is a Managed Custom Object (MCO). A lookup field is provided to lookup to the default AR Customer record MCO from the Account record. New records are created and existing ones updated; none are deleted.Account, Commercient AR Customer Managed Custom Object, Commercient Salesperson Managed Custom Objectcustomers, shipping addresses, salespeople
Customer Multi Ship AddressesIf you are using multiple ship to addresses for a given AR Customer in your ERP system then you will be able to see all the addresses inside the CRM Account screen in a Commercient Multi Ship To Address MCO related list. New records are created and existing ones updated; none are deleted.Commercient Ship-To Address Managed Custom Objectshipping addresses
InvoiceBoth Open and Historical invoices are synchronized. Open invoice changes, such as a balance change, or a terms change are reflected in the CRM as they sync based on the frequency of the sync you have chosen (every hour, for example). New records are created and existing ones updated; none are deleted.Commercient Invoice History Header Managed Custom Object, Commercient Invoice History Detail Managed Custom Object, Commercient Payment History Managed Custom Objectinvoice history headers, open invoices, salespeople, invoice history lines, items
Sales orderCommercient will sync the Sales Orders from the ERP Sales Order Entry module to the Commercient Sales Order Header (MCO) objects in CRM. In the CRM, customer service and sales people can visualize the status of the order such as on hold, backorder, forward order, scheduled for delivery, whether it has shipped, and completion status. New records are created and existing ones updated; none are deleted.Commercient Sales Order Line Managed Custom Object, Commercient Sales Order Header Managed Custom Objectsales order lines, sales order headers

2. The process rows the templates create

Each template’s setup writes one process configuration row. These are the values it sets; a column the inserts never set is not listed.

Display nameDestination objectMatching keyRun sequence
GET USERusers—0
Sage 100 2016 Sales PersonCommercient Salesperson Managed Custom ObjectCommercient external key2
Sage 100 2016 AccountAccountCommercient AR customer code3
Sage 100 2016 CustomerCommercient AR Customer Managed Custom ObjectCommercient external key4
Sage 100 2016 Shipping addressCommercient Ship-To Address Managed Custom ObjectCommercient external key5
Sage 100 2016 Sales order headerCommercient Sales Order Header Managed Custom ObjectCommercient sales order number6
Sage 100 2016 Sales order detailCommercient Sales Order Line Managed Custom ObjectCommercient external key7
Sage 100 2016 Invoice history headerCommercient Invoice History Header Managed Custom ObjectCommercient external key8
Sage 100 2016 Invoice history detailCommercient Invoice History Detail Managed Custom ObjectCommercient external key9
Sage 100 2016 Invoice paymentCommercient Payment History Managed Custom ObjectCommercient external key10
Sage 100 2016 Customer Reverse LookupAccountCommercient AR customer code11

Every one of these inserts the active setting as 0, so an imported process is inactive until an operator activates it.

3. The views

“Change detection” names which of the three kinds dlake-crmpro defines the view’s own filter makes it; where a view’s shape is not one of those three the column is left empty and the view’s own filter is the authority.

ViewChange detectionSource tables
salesperson feedinsert + updatesalespeople
account feedinsert + updatecustomers, shipping addresses
customer feedinsert + updatecustomers, salespeople
shipping address feedinsert + updateshipping addresses
sales order feedinsert + updatesales order headers
sales order line feedinsert + updatesales order lines, sales order headers
invoice history feedinsert + updateinvoice history headers, open invoices, salespeople
invoice history line feedinsert + updateinvoice history lines, items
payment history feedinsert + updatepayment history, invoice history headers
customer account lookup feedinsert + updatecustomers

4. Order of work

The templates set run sequence from 0 to 11. A run processes active rows in ascending run sequence, which is the order the templates put them in:

  • 0 — GET USER
  • 2 — Sage 100 2016 Sales Person
  • 3 — Sage 100 2016 Account
  • 4 — Sage 100 2016 Customer
  • 5 — Sage 100 2016 Shipping address
  • 6 — Sage 100 2016 Sales order header
  • 7 — Sage 100 2016 Sales order detail
  • 8 — Sage 100 2016 Invoice history header
  • 9 — Sage 100 2016 Invoice history detail
  • 10 — Sage 100 2016 Invoice payment
  • 11 — Sage 100 2016 Customer Reverse Lookup

These views read another process’s sync output, which is what makes the order a dependency order: the row appears in the view only once the process that writes that sync output has run, so a parent flows on one run and its children on the next.

  • account feed reads user sync output
  • customer account lookup feed reads AR customer sync output (generic name)
  • customer feed reads Salesforce account sync output (generic name), salesperson sync output (generic name)
  • shipping address feed reads Salesforce account sync output (generic name), AR customer sync output (generic name), salesperson sync output (generic name)
  • invoice history feed reads Salesforce account sync output (generic name), AR customer sync output (generic name), salesperson sync output (generic name), shipping address sync output (generic name)
  • invoice history line feed reads invoice history sync output (generic name)
  • payment history feed reads invoice history sync output (generic name)
  • sales order line feed reads sales order sync output (generic name)
  • sales order feed reads Salesforce account sync output (generic name), AR customer sync output (generic name), salesperson sync output (generic name)

5. Field mapping

Each template carries its intended mapping in field mapping.

TemplateObjectMapped fieldsFirst ERP → Salesforce pairs
Sage 100 2016 Sales PersonCommercient Salesperson Managed Custom Object26Salesperson division,Salesperson number → Commercient external key, Salesperson name → Commercient name, Salesperson division → Commercient salesperson division, Salesperson number → Commercient salesperson number, Address line 1 → Commercient address line 1
Sage 100 2016 AccountAccount22AR division number, Customer number → Commercient AR customer code, Customer name → Name, Address line 1 → Billing address line 1, Address line 2 → Billing address line 2, Address line 3 → Billing address line 3
Sage 100 2016 CustomerCommercient AR Customer Managed Custom Object79Customer number → Commercient external key, Customer name → Commercient name, Customer number → Commercient customer number, Customer name → Commercient customer name, AR division number → Commercient AR division number
Sage 100 2016 Shipping addressCommercient Ship-To Address Managed Custom Object34AR division number,Customer number,Ship-to code → Commercient external key, AR division number,Customer number,Ship-to code → Commercient name, AR division number → Commercient AR division number, Customer number → Commercient customer number, Ship-to code → Commercient ship to code
Sage 100 2016 Sales order headerCommercient Sales Order Header Managed Custom Object106Sales order number → Commercient sales order number, Order date → Commercient order date, Order type → Commercient order type, Order status → Commercient order status, Master repeating order number → Commercient master repeating order number
Sage 100 2016 Sales order detailCommercient Sales Order Line Managed Custom Object65Sales order number,Line key → Commercient external key, Order type → Commercient order type, Sales order number → Commercient sales order number, Line key → Commercient line key, Line sequence number → Commercient line sequence number
Sage 100 2016 Invoice history headerCommercient Invoice History Header Managed Custom Object124Invoice number, Header sequence number → Commercient external key, Invoice number, Header sequence number → Commercient name, Invoice number → Commercient invoice number, Header sequence number → Commercient header sequence number, Module code → Commercient module code
Sage 100 2016 Invoice history detailCommercient Invoice History Detail Managed Custom Object59Invoice number, Header sequence number, Detail sequence number → Commercient external key, Invoice number → Commercient invoice number, Header sequence number → Commercient header sequence number, Detail sequence number → Commercient detail sequence number, Item code → Commercient item code
Sage 100 2016 Invoice paymentCommercient Payment History Managed Custom Object33AR division number → Commercient AR division number, Customer number → Commercient customer number, Invoice number → Commercient invoice number, Invoice type → Commercient invoice type, Invoice header sequence number → Commercient invoice header sequence number
Sage 100 2016 Customer Reverse LookupAccount2AR division number,Customer number → Commercient AR customer code, the linked Salesforce record → Commercient Sage customer record

6. Community templates

The catalogue carries 244 community templates for this pair. A community template is authored in a tenant rather than shipped with the product, and it imports the same way as any other. Its own names, notes, field mapping and SQL are tenant content, so what this section states is what the set amounts to: how many templates there are, what they default to doing, which destination objects they write and which groups they fall in. They are not part of the shipped set described above.

  • Templates: 244
  • Default operations: insert on 244, update on 244, delete on 244
  • Marked as circular sync: 2
  • Licence groups they span: 14
  • Destination objects: Account, Commercient Inventory Item Managed Custom Object, Commercient Sales Order Line Managed Custom Object, Commercient Invoice History Detail Managed Custom Object, Commercient Invoice History Header Managed Custom Object, Commercient Payment History Managed Custom Object, Commercient Sales Order Header Managed Custom Object, Commercient AR Customer Managed Custom Object, Commercient Purchase Order Header Managed Custom Object, Commercient Vendor Managed Custom Object, Commercient Item Warehouse Managed Custom Object, Commercient Purchase Order Line Managed Custom Object, Commercient Ship-To Address Managed Custom Object, Commercient Salesperson Managed Custom Object, Commercient general ledger Account Managed Custom Object, Product, Content document, Account, Commercient Sales Order History Line Managed Custom Object, Commercient Sales Order History Header Managed Custom Object, 16 more and 14 custom objects
  • Object display names: Sync Item, Sync Item warehouse, Sync Account, Sync Customer, Sync Invoice history detail, Sync Invoice history header, Sync sales order detail, Sync Transaction payment history, Sync general ledger account, Sync Purchase order detail, Sync Purchase order header, Sync Sales order header, 49 more and 42 further templates
  • Template groups: Account, Product, Invoice History Headers, Sales order, Purchase Order, Customer Multi Ship Addresses, Invoice, File or Document Sync

7. Verifying

The detail of this section is part of the operational skill. Whitelisted customers fetch it with dlake admin get_skill dlake-crmpro-salesforce/erps/sage-100-2016.

8. Where this sits

dlake-crmpro is the general operating surface — the CRMPro tools, the setup and transaction tables, field mapping, and the source view contract that applies to every destination. This page adds what the shipped Sage 100 2016 → Salesforce templates set up. dlake-crmpro-salesforce is the destination skill this page sits under: its own text is the authority for the Salesforce conventions that hold across every ERP, and its ERP table lists this page alongside every sibling ERP page for this destination. For the extract leg that fills the source data, see dlake-normalsync; for the on-premises agent that runs it, dlake-syncagent; for the writeback leg, dlake-txdownloaderpro; for standing an integration up, dlake-integration-setup.

How to get started

  • Already a customer: the operational skill tells you how to connect, choose what to sync and run it. Fetch it with dlake admin get_skill dlake-crmpro-salesforce/erps/sage-100-2016, or ask support@commercient.com.
  • New to Commercient: contact sales@commercient.com. Becoming a customer includes registration and whitelisting, after which the operational skills and tools are available to you.