FISH

// Financial Integration Service Hub

API Operational
v0.1.0

<FISH/>

Finance Integration Layer for Campaign Management Systems

Enterprise backend connecting campaign management systems Olive, HALO, with finance systems e.g. Prisma UK, Spectra US, etc. Handles campaign creation, placement management, budget controls, and financial reconciliation.

⚡ API Documentation 🔄 Master Data Sync

🔐 Authentication

# Headers Authorization: Bearer {wpp_jwt_token} CM-System: CM1 | CM2

🌐 Environments

prod fish-prod.choreograph.com
stg fish-staging.choreograph.com
dev fish-dev.choreograph.com

// API Flow Sequences

DIAGRAM

Campaign & Placement Creation Flow

CORE FLOW 
sequenceDiagram
    autonumber
    participant Client
    participant WPP as WPP Auth
    participant FISH as FISH API
    participant Prisma as Prisma Finance

    rect rgb(30, 30, 45)
        Note over Client,WPP: Authentication
        Client->>WPP: Request JWT Token
        WPP-->>Client: JWT Token
    end

    rect rgb(40, 35, 50)
        Note over Client,Prisma: 1. Campaign Creation
        Client->>FISH: POST /campaigns
        Note right of Client: Headers: Authorization, CM-System
        FISH->>Prisma: Create campaign
        Prisma-->>FISH: finance_system_campaign_id
        FISH-->>Client: CampaignResponse
    end

    rect rgb(30, 45, 40)
        Note over Client,Prisma: 2. Placement Creation
        Client->>FISH: POST /placements
        Note right of Client: Body: { campaign_id, supplier_code, ... }
        FISH->>Prisma: Create placement
        Prisma-->>FISH: finance_system_placement_id
        FISH-->>Client: PlacementResponse
    end

    rect rgb(45, 35, 45)
        Note over Client,Prisma: 3. Fee Creation (Optional)
        Client->>FISH: POST /fees
        Note right of Client: Body: { placement_id, fee_type, ... }
        FISH->>Prisma: Create fee
        Prisma-->>FISH: finance_system_fee_id
        FISH-->>Client: PlacementFeeResponse
    end

Endpoints in this flow

1 POST /campaigns
2 POST /placements
3 POST /fees optional