Skip to main content
ERPNext Meta & TikTok Catalog Connector — A build-to-order Frappe app that keeps your ERPNext catalog, prices, stock, and pro — 1/1Illustrative preview

A build-to-order Frappe app that keeps your ERPNext catalog,

prices, stock, and promotions in continuous sync with Facebook/Instagram Shops and TikTok's product catalog.

ECOSIRE scopes, builds, installs, and supports it for your exact item model.

What is ERPNext Meta & TikTok Catalog Connector?

A build-to-order Frappe app that keeps your ERPNext catalog, prices, stock, and promotions in continuous sync with Facebook/Instagram Shops and TikTok's product catalog. ECOSIRE scopes, builds, installs, and supports it for your exact item model. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Dedicated `Social Catalog Channel` DocType per destination (Meta Commerce catalog, TikTok catalog, or both) with masked API credentials and per-channel field mapping
Full-feed generation to Meta Commerce Manager via the Graph/Marketing Catalog Batch API and to TikTok's Business catalog API
Incremental delta sync driven by `hooks.py` `doc_events` (`on_update` on `Item`, `Item Price`, and stock ledger changes) queued through `frappe.enqueue`
Scheduled full reconcile via `scheduler_events` (hourly/daily configurable) to catch anything a delta missed
`Social Catalog Item Map` resolving each ERPNext `Item`/variant to a channel `retailer_id`, GTIN/MPN, brand, and Google product category
Availability and inventory derived from `Bin` actual/projected qty against a per-channel stock buffer, so ads never oversell
Variant handling: `variant_of` templates mapped to variant groups with a shared `item_group_id` and per-variant attributes
Set / collection / kit products assembled from BOM or a configured grouping field into channel product groups
Multi-currency `Item Price` resolution to the correct `price` and `sale_price` per catalog and region
Promotions feed emitting sale price plus effective start/end windows aligned to your campaign calendar
`Social Catalog Sync Log` DocType capturing every request, response, retry, and per-SKU rejection reason from Meta/TikTok
Whitelisted (`@frappe.whitelist()`) 'resync now' method surfaced as a client-script button on the Item form and callable via the Frappe REST API
Dedicated Role Profile and permission scoping so only authorized users manage channels or trigger pushes
Image and content mapping (primary + additional images, title/description length rules) with validation before push to reduce catalog rejections
Compatible with Frappe/ERPNext v15 and v16, packaged as an installable app on your own bench

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

If you run shopping ads on Meta or TikTok, your product catalog is your ad inventory — but ERPNext has no native concept of a Meta Commerce Manager feed or a TikTok catalog. Teams end up exporting a spreadsheet, hand-fixing GTINs and image URLs, uploading it to Commerce Manager, and doing it all again whenever a price drops or a variant sells out. The result is stale ads: rejected items, "out of stock" tags on things you can ship, and Dynamic Ads / Advantage+ campaigns pointed at products that no longer exist. ERPNext's Item, Item Price, and Bin DocTypes already hold the truth — what's missing is a reliable pipe that maps that truth into the exact schema Meta and TikTok expect and keeps it fresh without a human in the loop.

ECOSIRE builds a proper Frappe app (installed on your bench, frappe/erpnext v15 or v16) that adds a Social Catalog Channel DocType per destination (a Meta Commerce catalog, a TikTok catalog, or both), plus a Social Catalog Item Map that resolves each ERPNext Item/variant to a channel product with its retailer_id, GTIN/MPN, brand, Google product category, and image set. A full feed is generated on demand and on a scheduler_events cron (typically hourly for a full reconcile), while incremental deltas fire from hooks.py doc_events — an on_update on Item, Item Price, and stock ledger changes queues a targeted push through frappe.enqueue so a price edit or a low-stock threshold reaches Commerce Manager and TikTok within minutes, not overnight. We push via the Marketing/Graph API (Catalog Batch endpoints) and the TikTok Business catalog API, store credentials in a masked Password field, and log every request/response, retry, and rejection in a Social Catalog Sync Log DocType so you can see exactly which SKU Meta refused and why.

Under the hood the connector handles the parts that break naive exports: variant_of templates map to variant groups with item_group_id, set/collection products are assembled from BOM or a configured grouping field, availability and inventory are derived from Bin actual/projected qty against a per-channel buffer, and multi-currency Item Price lists resolve to the right price/sale_price per catalog. A Promotion mapping emits sale price and effective-date windows so your ad creative reflects live campaigns. Everything is permission-scoped with a dedicated Role Profile, exposes whitelisted methods (@frappe.whitelist()) for a manual "resync now" client-script button on the Item form, and ships with a Frappe REST-friendly surface so your own automations can trigger a channel push. Field mappings, category taxonomies, and buffer rules are configuration, not hard-code — so your merchandisers adjust them without a developer.

Because this is build-to-order, we start from your real ERPNext instance rather than a generic template. A short scoping call confirms your item model (variants, sets, kits), which channels and catalogs you're feeding, your GTIN/brand data quality, and your currency/region matrix. We then build against a staging copy of your data, run UAT with your team pushing to a sandbox catalog, and only cut over to production catalogs once feeds validate clean. Typical delivery is one working week from confirmed scope, and you receive the full source, a git repo, technical and user documentation, training, and a post-go-live support window — you own it, and it runs on your bench.

What you get

  • Installable source code for your build, packaged as a Frappe app for your bench (v15 or v16)
  • Installation and configuration on your environment, including Meta/TikTok API credential wiring and channel setup
  • Technical documentation: DocType schema, hook/scheduler events, field mappings, and API integration notes
  • User guide plus a live training session for your merchandising and marketing team
  • UAT on a staging copy of your data with a documented rollback plan before production cut-over
  • Post-go-live support window for bug fixes and sync-issue resolution
  • Git repository handover with full commit history and setup instructions
  • Feed validation report confirming clean Meta Commerce Manager and TikTok catalog ingestion

Who this is for

Social-commerce brand on ERPNext

A DTC or retail brand running Meta Advantage+ / Dynamic Ads and TikTok shopping campaigns whose catalog lives in ERPNext and who needs prices, stock, and promotions to stay accurate across both ad platforms without manual re-uploads.

Ecommerce / marketing operations lead

Owns catalog quality and ad feed health, tired of spreadsheet exports and rejected products, and wants a single source of truth in ERPNext that pushes clean feeds and surfaces per-SKU rejection reasons.

ERPNext administrator / in-house developer

Responsible for the bench and integrations, wants a proper Frappe app with real DocTypes, hooks, scheduler events, whitelisted methods, and a git repo they can own and extend — not an opaque black box.

Agency or systems integrator serving retail clients

Manages Meta/TikTok catalogs on behalf of ERPNext-based merchants and needs a repeatable, well-documented connector they can deploy per client with configurable field and category mapping.

How ERPNext Meta & TikTok Catalog Connector Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Delivery modelBuild-to-order, built and installed for your exact item model in one working weekLong in-house build competing with other prioritiesInstant install but generic, one-size mappingNot available — no social catalog concept
Meta + TikTok coverageBoth channels, one `Social Catalog Channel` per destinationWhatever you scope and maintain yourselfOften Meta-only or one channel per appNone
Sync freshnessDoc-event deltas within minutes + scheduled full reconcileDepends on effort; often nightly cron onlyUsually scheduled export, limited real-timeManual spreadsheet export
Variants / sets / stockVariant groups, BOM-based sets, `Bin`-derived buffered availabilityBuildable but time-consuming to get rightBasic mapping, variants often flattenedNot applicable
Rejection visibility`Social Catalog Sync Log` with per-SKU reason, retries, responsesOnly what you build inLimited logs, often summary countsNone — errors surface in Commerce Manager only
Ownership & extensibilityFull source + git repo handover, you own itYou own it but carry all build riskClosed app, per-seat/subscription lock-inN/A
ERPNext fitProper Frappe app: DocTypes, hooks, whitelisted methods, Role ProfileDepends on your team's Frappe depthFramework-native but generic assumptionsCore Item/Price/Bin only, no feed layer
SupportPost-go-live window + optional maintenance for API changesSelf-supportedVendor SLA, varies by tierCommunity only

Frequently Asked Questions about ERPNext Meta & TikTok Catalog Connector

Is this a download I can install today from the Frappe Marketplace?

No. This is a build-to-order product. ECOSIRE scopes, builds, installs, and supports the connector against your specific ERPNext item model and channel setup. There is no instant download — you get source you own, built for your instance.

How long does delivery take?

Typically one working week from confirmed scope. After a short scoping call we build against a staging copy of your data, run UAT with your team, and cut over to production catalogs once feeds validate clean. Complex variant/set models or many channels can extend the timeline, which we confirm before starting.

Which ERPNext versions and destinations are supported?

Frappe/ERPNext v15 and v16 on your own bench. It feeds Meta Commerce Manager (Facebook and Instagram Shops via the Graph/Marketing Catalog Batch API) and TikTok's Business catalog API — one or both, with a separate `Social Catalog Channel` per destination.

How does it keep feeds fresh — is it a nightly export?

Both. Incremental deltas fire from `hooks.py` doc events when an `Item`, `Item Price`, or stock level changes, queued via `frappe.enqueue` so changes reach the catalogs within minutes. A scheduled full reconcile (`scheduler_events`, configurable) runs on top to catch anything a delta missed.

How are variants, sets, and stock availability handled?

Variants map from `variant_of` templates into channel variant groups; sets/kits assemble from BOM or a configured grouping field; availability is derived from `Bin` actual/projected qty against a per-channel buffer so ads don't oversell. All mappings are configuration you can adjust, not hard-coded logic.

What about support and updates after go-live?

Every build includes a post-go-live support window for bug fixes and sync-issue resolution. Because you receive the full source and git repo, your team can extend it, and ECOSIRE can quote ongoing maintenance or platform-API updates (Meta/TikTok change their catalog APIs periodically) as a separate arrangement.

Do you need access to our Meta and TikTok accounts?

We configure the integration using API credentials and catalog IDs you provide, stored in masked password fields in ERPNext. During UAT we push to a sandbox/test catalog. You keep full control of your Business Manager and TikTok assets; we never require ownership of your ad accounts.

Request a quote

ERPNext Meta & TikTok Catalog Connector

A build-to-order Frappe app that keeps your ERPNext catalog, prices, stock, and promotions in continuous sync with Facebook/Instagram Shops and TikTok's product catalog. ECOSIRE scopes, builds, installs, and supports it for your exact item model.

  • Dedicated `Social Catalog Channel` DocType per destination (Meta Commerce catalog, TikTok catalog, or both) with masked API credentials and per-channel field mapping
  • Full-feed generation to Meta Commerce Manager via the Graph/Marketing Catalog Batch API and to TikTok's Business catalog API
  • Incremental delta sync driven by `hooks.py` `doc_events` (`on_update` on `Item`, `Item Price`, and stock ledger changes) queued through `frappe.enqueue`
  • Scheduled full reconcile via `scheduler_events` (hourly/daily configurable) to catch anything a delta missed

Request a Quotation

Tell us about your ERPNext Meta & TikTok Catalog Connector requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.