# Beaconwright Tallyforge Synthclerk

*/Agents/Beaconwright_Tallyforge_Synthclerk*

## Solution Overview

Beaconwright Tallyforge Synthclerk continuously ingests emailed freight manifests, EDI 315 ocean status messages, and port terminal APIs to reconcile container movements against demurrage and detention billing rules. It cross-references arrival timestamps with carrier tariff schedules and generates formatted daily settlement reports, immediately calculating exact fee liabilities for ocean freight.

Supply chain controllers and freight auditors at mid-sized importing firms hire this digital clerk to stop revenue leakage from erroneous storage fees. It targets the reconciliation gap where delayed containers incur compounding daily charges that carriers often miscalculate, matching complex multi-tiered port tariffs against actual gate-out times before accounts payable clears the invoice.

Operating as an autonomous agent in the middle of the logistics stack, it pulls raw event timelines from headless visibility APIs and pushes validated payables into corporate ERPs. Because disputing terminal charges impacts carrier relationships, the Synthclerk generates a Slack alert with a pre-drafted claim packet for any contested fee exceeding five hundred dollars, requiring a human logistics analyst to approve the dispute before it is routed back to the freight forwarder.

## Icp Opportunities

- [Headless Data Extraction](/Opportunities/Headless_Data_Extraction) — Headless SaaS
- [Model Routing Agent](/Opportunities/Model_Routing_Agent) — Agent
- [Exception Handling as a Service](/Opportunities/Exception_Handling_as_a_Service) — Service-as-Software
- [Compliance State Ledger](/Opportunities/Compliance_State_Ledger) — Headless SaaS
- [Interaction Safety Proxy](/Opportunities/Interaction_Safety_Proxy) — Agent

## Agent Definition

**Goals**:
- [Demurrage Cost Avoidance](/Metrics/Demurrage_Cost_Avoidance)
- [Reconciliation Match Rate](/Metrics/Reconciliation_Match_Rate)
- [Dispute Win Rate](/Metrics/Dispute_Win_Rate)
**Tools**:
- [Project44](/Products/Project44)
- [SAP](/Products/SAP)
- [Slack](/Products/Slack)
**Skills**:
- [Data Reconciliation](/Skills/Data_Reconciliation)
- [Tariff Interpretation](/Skills/Tariff_Interpretation)
- [Invoice Processing](/Skills/Invoice_Processing)
- [Complex Problem Solving](/Skills/Complex_Problem_Solving)
**Contacts**:
- Email
- API
- Slack
**Identity**: did:web:agents.beaconwright.example/synthclerk
**Core Tasks**:
- [Ingest Freight Manifests](/Tasks/Ingest_Freight_Manifests)
- [Cross-Reference Arrival Timestamps](/Tasks/Cross-Reference_Arrival_Timestamps)
- [Match Port Tariffs](/Tasks/Match_Port_Tariffs)
- [Push Validated Payables](/Tasks/Push_Validated_Payables)
- [Generate Daily Settlement Reports](/Tasks/Generate_Daily_Settlement_Reports)
**Escalation**: Any contested demurrage or detention fee exceeding five hundred dollars generates a pre-drafted claim packet and pauses for human logistics analyst approval via Slack.
**Memory Kind**: persistent
**Memory Note**: Retains historical demurrage billing rules, complex multi-tiered port tariffs, and past container dispute outcomes to accurately apply fee calculations across varying carrier relationships.
**Autonomy Mode**: guarded
**Replaces Role**: [Freight Auditor](/JobTypes/Freight_Auditor)
**Solves Problem**: [Erroneous Demurrage Billing](/Problems/Erroneous_Demurrage_Billing)
**Responsibilities**:
- Reconcile Container Movements
- Calculate Detention Liabilities
- Validate Freight Invoices
- Prepare Claim Packets

## Agent Function Cascade

**Ai Role**: AI runs the entire freight audit lifecycle as a digital agent—ingesting data, calculating liabilities, and drafting claims—operating under a guarded autonomy model where it pauses to require a human logistics analyst's approval via Slack only for contested fees exceeding five hundred dollars.
**Cascade**:
- Kind: Code · Step: Ingest Status Messages · Verb: ingest · Realizes: Process Incoming Electronic Data · Oversight: none
- Kind: Code · Step: Calculate Fee Liabilities · Verb: calculate · Realizes: Compute Tariffs And Fees · Oversight: none
- Kind: Generative · Step: Audit Demurrage Invoices · Verb: audit · Realizes: Audit Freight Invoices · Oversight: none
- Kind: Generative · Step: Stage Dispute Packets · Verb: draft · Realizes: Prepare Claim Documentation · Oversight: none
- Kind: Human · Note: Logistics analyst approves contested fees exceeding 500 dollars via Slack. · Step: Approve Major Disputes · Verb: approve · Realizes: Authorize Financial Settlement · Oversight: approves
- Kind: Code · Step: Push Payables To ERP · Verb: post · Realizes: Process Accounts Payable · Oversight: none
**Optimizes**:
- [Demurrage Leakage Rate](/Metrics/Demurrage_Leakage_Rate)
- [Invoice Match Rate](/Metrics/Invoice_Match_Rate)
- [Dispute Resolution Time](/Metrics/Dispute_Resolution_Time)
- [Settlement Cycle Time](/Metrics/Settlement_Cycle_Time)

## Agent Representative Offer

**Warranty**: Provides a service credit for the processing fee of any incorrectly validated invoice that results in unwarranted demurrage or detention liabilities.
**Price Band**: ~$0.50 to $2.50 per processed freight manifest or generated claim packet, depending on monthly volume
**Pricing Kind**: UsageMeter
**Deliverables**:
- Reconciled container movement ledger
- Validated freight payable records loaded into SAP
- Pre-drafted demurrage claim packets routed via Slack
- Daily settlement and liability reports
**Delivery Mode**: Provisioned instantly via API and OAuth, the agent integrates directly into SAP, Project44, and Slack to begin ingesting and reconciling manifests on a pay-per-document metered basis.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- merchant-payments-protocol

## Agent Composes Headless Saas

- [EDI Ingestion API](/Software/EDI_Ingestion_API) — Data Pipeline
- [Freight Visibility API](/Software/Freight_Visibility_API) — Logistics Tracking
- [Carrier Tariff API](/Software/Carrier_Tariff_API) — Pricing Data
- [Demurrage Calculation Engine](/Software/Demurrage_Calculation_Engine) — Financial Engine
- [Payables Integration API](/Software/Payables_Integration_API) — ERP Sync

## Agent Sequence Diagram

```mermaid
sequenceDiagram
participant Webhook as Trigger
participant Agent as Beaconwright Tallyforge Synthclerk
participant EDI as EDI Ingestion API
participant FVA as Freight Visibility API
participant CTA as Carrier Tariff API
participant DCE as Demurrage Calculation Engine
participant PIA as Payables Integration API
participant HLA as Human: Logistics Analyst
Webhook->>Agent: Inbound EDI Status Message
Agent->>EDI: Parse container event data
EDI-->>Agent: Parsed container movements
Agent->>FVA: Verify arrival and departure timestamps
FVA-->>Agent: Validated shipment lifecycle events
Agent->>CTA: Fetch carrier-specific tariff schedules
CTA-->>Agent: Multi-tiered daily charge rates
Agent->>DCE: Calculate fee liabilities and audit invoice
DCE-->>Agent: Demurrage calculation results
alt Contested fee exceeds 500 dollars
Agent->>HLA: Slack alert with pre-drafted claim packet
HLA-->>Agent: Approve dispute packet
end
Agent->>PIA: Push payables to ERP and stage disputes
PIA-->>Agent: Settlement report generated
Agent-->>Webhook: Processing complete
```

## Neighborhood

### What it uses

- [Sap](/Products/Sap) — uses · Products
- [Slack](/Software/Slack) — uses · Software
- [Project44](/Products/Project44) — uses · Products
- [Microsoft Outlook](/Software/Microsoft_Outlook) — uses · Software

### What it does

- [Generate Daily Settlement Reports](/Tasks/Generate_Daily_Settlement_Reports) — performs · Tasks
- [Cross-Reference Arrival Timestamps](/Tasks/Cross-Reference_Arrival_Timestamps) — performs · Tasks
- [Match Port Tariffs](/Tasks/Match_Port_Tariffs) — performs · Tasks
- [Ingest Freight Manifests](/Tasks/Ingest_Freight_Manifests) — performs · Tasks
- [Calculate Fee Liabilities](/Tasks/Calculate_Fee_Liabilities) — performs · Tasks
- [Cross-Reference Carrier Tariffs](/Tasks/Cross-Reference_Carrier_Tariffs) — performs · Tasks
- [Generate Settlement Reports](/Tasks/Generate_Settlement_Reports) — performs · Tasks
- [Ingest EDI Status Messages](/Tasks/Ingest_EDI_Status_Messages) — performs · Tasks
- [Push Payables To ERP](/Tasks/Push_Payables_To_ERP) — performs · Tasks

### What it addresses

- [Erroneous Demurrage Billing](/Problems/Erroneous_Demurrage_Billing) — addresses · Problems
- [Demurrage Fee Leakage](/Problems/Demurrage_Fee_Leakage) — addresses · Problems
- [Crypto-to-Fiat Reconciliation](/Problems/Crypto-to-Fiat_Reconciliation) — addresses · Problems

### Optimizes

- [Demurrage Cost Avoidance](/Metrics/Demurrage_Cost_Avoidance) — optimizes · Metrics
- [Dispute Win Rate](/Metrics/Dispute_Win_Rate) — optimizes · Metrics
- [Reconciliation Match Rate](/Metrics/Reconciliation_Match_Rate) — optimizes · Metrics
- [Dispute Resolution Time](/Metrics/Dispute_Resolution_Time) — optimizes · Metrics
- [Demurrage Leakage Rate](/Metrics/Demurrage_Leakage_Rate) — optimizes · Metrics
- [Settlement Cycle Time](/Metrics/Settlement_Cycle_Time) — optimizes · Metrics
- [Invoice Match Rate](/Metrics/Invoice_Match_Rate) — optimizes · Metrics
- [Variance Resolution Rate](/Metrics/Variance_Resolution_Rate) — optimizes · Metrics
- [Month-End Close Time](/Metrics/Month-End_Close_Time) — optimizes · Metrics
- [First-Pass Yield](/Metrics/First-Pass_Yield) — optimizes · Metrics

### Required skills

- [Data Reconciliation](/Skills/Data_Reconciliation) — requires skill · Skills
- [Complex Problem Solving](/Skills/Complex_Problem_Solving) — requires skill · Skills
- [Tariff Interpretation](/Skills/Tariff_Interpretation) — requires skill · Skills
- [Invoice Processing](/Skills/Invoice_Processing) — requires skill · Skills
- [Financial Analysis](/Skills/Financial_Analysis) — requires skill · Skills
- [Reading Comprehension](/Skills/Reading_Comprehension) — requires skill · Skills
- [Systems Analysis](/Skills/Systems_Analysis) — requires skill · Skills

### Replaces this role

- [Freight Auditor](/JobTypes/Freight_Auditor) — replaces · JobTypes
- [Staff Accountant](/JobTypes/Staff_Accountant) — replaces · JobTypes

### Latent gaps

- [Model Routing Agent](/Opportunities/Model_Routing_Agent) — latent gap · Opportunities
- [Interaction Safety Proxy](/Opportunities/Interaction_Safety_Proxy) — latent gap · Opportunities
- [Compliance State Ledger](/Opportunities/Compliance_State_Ledger) — latent gap · Opportunities
- [Exception Handling as a Service](/Opportunities/Exception_Handling_as_a_Service) — latent gap · Opportunities
- [Headless Data Extraction](/Opportunities/Headless_Data_Extraction) — latent gap · Opportunities
- [Audit Forge](/Opportunities/Audit_Forge) — latent gap · Opportunities
- [Token Route Engine](/Opportunities/Token_Route_Engine) — latent gap · Opportunities
- [Dispute Proxy](/Opportunities/Dispute_Proxy) — latent gap · Opportunities
- [Human Loop Desk](/Opportunities/Human_Loop_Desk) — latent gap · Opportunities
- [Context Vault](/Opportunities/Context_Vault) — latent gap · Opportunities

### Problems this exposes

- [Synthetic Client Interaction Errors](/Problems/Synthetic_Client_Interaction_Errors) — exposes problem · Problems
- [Inference Compute Cost Runaway](/Problems/Inference_Compute_Cost_Runaway) — exposes problem · Problems
- [Human-In-Loop Exception Handling](/Problems/Human-In-Loop_Exception_Handling) — exposes problem · Problems
- [Algorithmic Audit Traceability](/Problems/Algorithmic_Audit_Traceability) — exposes problem · Problems
- [Agent Capability Decay](/Problems/Agent_Capability_Decay) — exposes problem · Problems
- [Synthetic Agent Orchestration](/Problems/Synthetic_Agent_Orchestration) — exposes problem · Problems
- [Unstructured Data Tally Ingestion](/Problems/Unstructured_Data_Tally_Ingestion) — exposes problem · Problems
- [Human Supervisor Escalation Bottlenecks](/Problems/Human_Supervisor_Escalation_Bottlenecks) — exposes problem · Problems
- [External API Rate Limiting](/Problems/External_API_Rate_Limiting) — exposes problem · Problems
- [Cryptographic Audit Trail Deficits](/Problems/Cryptographic_Audit_Trail_Deficits) — exposes problem · Problems
- [Automated Billing Dispute Churn](/Problems/Automated_Billing_Dispute_Churn) — exposes problem · Problems
- [Proprietary Data Context Leakage](/Problems/Proprietary_Data_Context_Leakage) — exposes problem · Problems
- [Runaway Token Compute Costs](/Problems/Runaway_Token_Compute_Costs) — exposes problem · Problems
- [Unstructured Invoice Reconciliation Failures](/Problems/Unstructured_Invoice_Reconciliation_Failures) — exposes problem · Problems

### Composed of

- [Demurrage Calculation Engine](/Software/Demurrage_Calculation_Engine) — composes · Software
- [Payables Integration API](/Software/Payables_Integration_API) — composes · Software
- [Freight Visibility API](/Software/Freight_Visibility_API) — composes · Software
- [Carrier Tariff API](/Software/Carrier_Tariff_API) — composes · Software
- [EDI Ingestion API](/Software/EDI_Ingestion_API) — composes · Software
- [General Ledger API](/Software/General_Ledger_API) — composes · Software
- [Reconciliation Matching Engine](/Software/Reconciliation_Matching_Engine) — composes · Software
- [Blockchain Indexing API](/Software/Blockchain_Indexing_API) — composes · Software
- [Bank Transaction Sync API](/Software/Bank_Transaction_Sync_API) — composes · Software
- [Cost Basis Engine](/Software/Cost_Basis_Engine) — composes · Software

### Similar Agents

- [Variance Detection Worker](/Agents/Variance_Detection_Worker) — similar · Agents
- [Dockside Cargo Inspection Agent](/Agents/Dockside_Cargo_Inspection_Agent) — similar · Agents
- [Gateway Extraction Worker](/Agents/Gateway_Extraction_Worker) — similar · Agents
- [Inventory Reconciliation Agent](/Agents/Inventory_Reconciliation_Agent) — similar · Agents
- [AP Orchestration Agent](/Agents/AP_Orchestration_Agent) — similar · Agents

### Similar Startups

- [Beaconharbor](/Startups/Beaconharbor) — similar · Startups
- [Truewharf](/Startups/Truewharf) — similar · Startups
- [Billablevessel](/Startups/Billablevessel) — similar · Startups
- [Bloomdock](/Startups/Bloomdock) — similar · Startups
- [Variancewire](/CompanyTypes/Import-Export_Seafood_Brokers/Problems/Reconcile_Trade_Finance_Settlements/Startups/Variancewire) — similar · Startups
- [Accessorialpost](/Startups/Accessorialpost) — similar · Startups
- [Clearquay](/Startups/Clearquay) — similar · Startups
- [Consolidatelane](/Startups/Consolidatelane) — similar · Startups
- [Axiomquay](/Startups/Axiomquay) — similar · Startups
- [Cargowharf](/Startups/Cargowharf) — similar · Startups

### Similar Metrics

- [Demurrage Costs](/Metrics/Demurrage_Costs) — similar · Metrics
- [Demurrage Claim Discrepancy Rate](/Metrics/Demurrage_Claim_Discrepancy_Rate) — similar · Metrics
- [Demurrage Cost](/Metrics/Demurrage_Cost) — similar · Metrics