accounting-bridge-sync

Syncs procurement events to accounting systems via acct_* tools for bills and GL variance.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill accounting-bridge-sync-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accounting-bridge-sync
Source: https://github.com/tapway/shogun-os/tree/main/skills/procurement/accounting-bridge-sync
Command: npx skills add https://github.com/tapway/shogun-os --skill accounting-bridge-sync-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Procurement teams that receive goods against purchase orders often must manually create supplier bills and reconcile inventory valuation with the general ledger, which is slow and error-prone. This Skill documents the trigger flows that automate those accounting entries when an accounting provider is connected. ## Core Features & Use Cases - PO-Received to Purchase Bill: Automatically creates a supplier bill via acct_create_purchase_bill when a GRN is recorded against a PO. - Inventory Cost Sync: Syncs weekly stock valuation to the GL Inventory Asset account using acct_get_balance_sheet. - GL Variance Flagging: Detects valuation discrepancies beyond tolerance and posts alerts to #procurement and #finance with a saved discrepancy report. - Use Case: A GRN is recorded for PO-2024-0158; the bridge creates bill BILL-2024-0892 for MYR 12,400, then the Friday valuation run flags a 0.37% GL variance to both channels. ## Quick Start Set ENABLE_ACCOUNTING_SYNC=true in the procurement profile's .env and ask the agent to sync the latest PO receipt to accounting.

Frequently Asked Questions about accounting-bridge-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically create a supplier bill when goods are received against a PO?

Enable ENABLE_ACCOUNTING_SYNC=true in the procurement profile's .env. When a GRN with movement_type=receive is recorded, the bridge calls acct_create_purchase_bill with the PO's vendor and line items, returning the bill number and total.

How do I sync inventory valuation to the general ledger?

The weekly valuation run (Friday 5PM cron) retrieves total stock valuation, calls acct_get_balance_sheet for the GL Inventory Asset balance, and computes the variance. Out-of-tolerance variances are flagged for manual journal entry review.

Which accounting systems does this procurement bridge support?

The bridge works with accounting providers connected through the finance-manager profile, specifically Bukku, QuickBooks, and Xero. It communicates through the acct_* MCP tools rather than calling provider APIs directly.

How do I prevent duplicate supplier bills for the same purchase order?

Before creating a bill, call acct_list_purchase_bills with the PO number as the reference to check whether a bill already exists. This duplicate check is a documented step in the PO-received trigger flow.

When should I not enable the accounting sync bridge?

Leave ENABLE_ACCOUNTING_SYNC=false for procurement-only deployments without a connected accounting system or for manual journal entry workflows. The procurement inventory layer functions fully without it, and all bridge flows skip gracefully with a log warning.