CityScreen Deals

CityScreen Deals is a sales and deal management platform for out-of-home (OOH) advertising. It manages the full commercial lifecycle of an advertising deal — from the first customer inquiry, through proposal preparation and inventory reservation, to booking, invoicing, and payment.

CityScreen Deals is configured per organization. The entity types, fields, document kinds, and business processes you see in your instance are defined by your administrator; they may differ from the examples in this documentation.

The commercial lifecycle

A deal in CityScreen Deals moves through a defined sequence of stages:

  1. Inquiry — a customer expresses interest in advertising placement.

  2. Negotiations — the sales team prepares one or more proposals, selects inventory, sets pricing, and iterates with the customer through revisions.

  3. Reserved — the parties agree on a proposal and the selected inventory is held.

  4. Booked — the commitment is confirmed.

  5. Paid — payment is registered against the deal.

  6. Done — the advertising period is complete.

A deal can also be canceled at any point before completion.

At each stage, CityScreen Deals supports the work that stage demands: browsing and filtering inventory, building proposals with pricing and discounts, generating contracts and invoices from templates, and recording payments.

Where CityScreen Deals fits

CityScreen Deals covers the commercial side of out-of-home advertising — everything that happens before a campaign begins playing on screens or surfaces, and the financial settlement that follows.

  • CityScreen Play (the content management system) takes over once a deal is booked. Booked proposals are pushed to CS Play, where campaign playback is scheduled and managed. In return, CS Play provides the digital display catalog that CityScreen Deals uses for inventory selection.

  • CityScreen Context exposes available inventory to the programmatic marketplace. CityScreen Deals feeds availability data to CityScreen Context so that unsold inventory can be offered to demand-side platforms.

  • Financial systems receive invoices and payment data. CityScreen Deals can push documents to external accounting and e-invoicing systems.

CityScreen Deals does not manage ad playback, audience measurement, or content scheduling — those responsibilities belong to CityScreen Play and the broader CityScreen platform.

Who this documentation is for

This documentation addresses two audiences:

  • Sales managers who work with deals, proposals, customers, and inventory day to day. Start with your first deal for a guided path through the core workflow.

  • Organization administrators who configure the platform — entity types, fields, templates, business processes, roles, and employee groups. Start with setting up an organization for the recommended setup order.

Documentation map

Section What it covers

How CS Deals is put together

Organizations, entity types, what ships fixed and what is configured

Key concepts

Core vocabulary: deals, proposals, displays, criteria, saturation, entity types, business processes

Your first deal

A sales manager’s path from inventory to a booked deal

Setting up an organization

Administrator checklist in dependency order

Deals

The deal pipeline, stages, and day-to-day deal work

Proposals & pricing

Proposal types, digital and printed pricing, discounts, revisions

Inventory

Digital and printed displays, the map, availability and saturation

Customers & contacts

Customer records, contacts, counterparty types

Paperwork

Document records, invoices, batch reports, file attachments

Templates

DOCX, XLSX and PPTX templates — placeholders, repeating sections, computed values

Dashboards

Sales and saturation widgets

Process automation

BPMN modeling, service tasks, user tasks, publishing, monitoring

The entity system

Entity types, data types, expressions, field permissions

Administration

Organizations, employees, groups, roles, permissions, data import and export

Integrations

CityScreen Play, CityScreen Context, booking widget, SAP, ClearTax

Terminology

Terms that CityScreen Deals uses in more than one sense, or differently from industry convention