STOS logo Pakistan Single Window integration for ports, terminals and off dock facilities

Pakistan Single Window Integration: PSW for Terminals

Pakistan Single Window is the national trade single window, and it is taking over WeBOC functions in phases. For a terminal operator the operational events do not change, but the channel, the credentials and the visibility around them do. This page explains what actually shifts, what PSW API integration involves, and how to judge whether terminal software is genuinely ready for it.

Integration status ● Monitored
Customs EDI
Connected
PCS PSW
Connected
Shipping line CODECO
Connected
Retry queue
2 messages
Context

What PSW is, and what it means for a terminal

A single window means information is filed once and reaches every agency that needs it. That is a trader facing promise, but terminals sit inside the same chain and feel the consequences directly.

What does not change

The physical operation is the operation. A box still arrives, is grounded, is stripped or held whole, is released and leaves. The reportable milestones are the same ones a terminal has always owned.

  • Gate in of the container or cargo
  • Grounding and yard position
  • De-stuffing tally and per index detail for CFS cargo
  • Stuffing and service completion on export
  • Gate out against the gate pass
  • Bonded carrier, seal and port of exit for transhipment

What does change

The change is structural rather than operational, and it lands on the integration layer and on data quality rather than on the yard.

  • The channel the event is reported through
  • The identity and credentials the terminal presents
  • How many parties can see the same declaration data
  • How quickly a terminal side data error becomes visible
  • The number of channels running in parallel during the phased migration

References: Pakistan Single Window documents the phased migration of WeBOC functions at psw.gov.pk, and publishes the Pakistani Port Community System at pcs.gov.pk.

The real consequence

Shared visibility raises the cost of bad data

Under a single window, the record a terminal reports is not filed into a quiet corner. It is the record other parties in the chain plan against, which changes what a small mistake costs.

Late is wrong

A gate in reported at the end of the shift is not a record of the movement, it is a guess about it. Events have to be raised by the operational screen at the moment of the movement, which is only possible when reporting lives inside the terminal operating system.

References carry everything

IGM and index identify an import consignment, the GD number keys the export side, and the container and seal number tie the physical box to both. If those references are entered loosely, no amount of integration quality downstream will save the record.

Roles and least privilege

When more parties can see terminal data, who inside the terminal may change it matters more. STOS controls access per user and per role, so a gate clerk, a billing clerk and an EDI officer each see only what their job needs, with an auditable record of who did what.

Anatomy

What PSW API integration actually consists of

Whatever the channel is called, a terminal integration has the same three parts. Vendors who only talk about the first one have not built the other two.

1. The outbound path

Terminal events become messages. The critical design decision is that the event is raised by the operational screen the clerk already completes, not by a separate customs client that somebody remembers to open. If reporting is a separate task, it will be late, and late reporting is the defect that generates every downstream dispute.

2. The inbound path

Notifications create and update terminal records. Vessel arrival populates containers and indexes with BL, packages, weight, seal and line. Handling codes such as examination attach themselves. On export, cargo arrival notified against a Goods Declaration updates the loading program with no keystrokes at all.

3. The operable middle

An integration status panel per partner, a message log, queued retries and controlled re-processing. Most real failures are connectivity or expired credentials, so the question is not whether messages ever fail, it is whether the terminal can see it within minutes and fix it without sending a duplicate.

Delivery

Planning a transition that runs two channels at once

Because functions move in phases, the safe assumption is a period of parallel operation rather than a cut over weekend.

1

Inventory your events

List every operational milestone the facility currently reports and what triggers it. Terminals are routinely surprised by how much reporting depends on one person remembering a step.

2

Separate event from channel

Confirm the terminal operating system raises an internal event and then delivers it, rather than embedding the customs format in the gate screen. This is what makes a second channel additive instead of disruptive.

3

Agree identity and credentials

Establish how the facility identifies itself, who owns the credentials and who renews them. Expiry is one of the most common causes of a stalled queue.

4

Run in parallel deliberately

Where both channels are live for a function, decide explicitly which is authoritative for which message, and record that decision. Ambiguity here produces duplicates.

5

Reconcile daily

Compare what the terminal believes it reported against what was acknowledged, as a daily routine rather than a monthly audit. The integration status panel is a start of shift check.

6

Keep the role staffed

A named documentation and EDI officer owns the message log, re-processing and the customs detail screens. Integration quality tracks that role more closely than it tracks the software.

Procurement

Questions worth asking any TOS vendor

PSW compliant terminal software is easy to claim in a brochure. These questions separate an integration that has been operated from one that has been demonstrated.

Show me the message log

Ask to see a real message log with failures in it, and ask what the operator does next. A vendor who cannot show you a failure has never run this at a live gate.

What stops a duplicate?

Resending a message that already reached the authority is the classic terminal EDI incident. Ask what the system does to make the operator check the log before a manual resend.

How do you add a channel?

Ask what it takes to add or retire a partner channel. If the answer touches the gate and yard screens, the event model and the transport are tangled together.

What happens to CFS detail?

De-stuffing reporting at index level is where thin integrations fall over, because the unit being tracked changes from the container to the cargo inside it. Ask specifically about tally sheets and grounded index records.

Who owns credential renewal?

A boring question with an expensive answer. Establish whether renewal is your task, the vendor task, or nobody task.

What is the local support model?

Customs integration issues are time critical and local. Ask where the people who understand Pakistani port and customs practice actually sit.

Related

The rest of the Pakistani customs picture

WeBOC, PSW, PortVerse and PACE are four names for stages of the same journey. A terminal has to keep operating through all of them.

WeBOC integration

The event by event detail: which message flows at gate in, grounding, de-stuffing, stuffing and gate out, and the EDI message codes involved.

WeBOC integration

PortVerse and the PCS

PortVerse is the Port Community System developed by Pakistan Single Window. What a PCS changes for terminals, lines and clearing agents.

PortVerse integration

STOS

The Smart Terminal Operating System underneath: cargo, gate, shed and examinations, financial and analytics modules with EDI integration built in.

Explore STOS
FAQ

Pakistan Single Window questions

Pakistan Single Window is the national trade single window: one platform through which traders and the parties around them file information once and reach the government agencies involved in import, export and transit. It is taking over the functions previously carried out in WeBOC in phases. PSW also developed PortVerse, the Pakistani Port Community System.

Less than operators often expect at the operational level, and more than they expect at the integration level. The physical events a terminal reports do not change: gate in, grounding, de-stuffing, stuffing and service completion, and gate out are still the milestones. What changes is the channel those events are reported through, the identity and credentials the terminal presents, and the fact that other parties in the trade chain can now see the same declaration data the terminal is working against.

The same three pieces as any customs integration: an outbound path that turns terminal events into messages at the moment the operational screen is completed, an inbound path that creates and updates terminal records from vessel, declaration and release notifications, and an operable middle where failures are visible, queued and retried without creating duplicates. The transport and credentials are configuration. The event model is the part that has to be right.

STOS lists PCS PSW among its partner integrations alongside Customs EDI, Maersk, Hapag Lloyd, CODECO and weighbridge systems, and its EDI layer is built so that terminal events are generated once and delivered to whichever partner channel is enabled for that facility. The exact set of connections enabled for a given terminal is confirmed during onboarding rather than assumed.

Because the migration is phased, a terminal should plan for a period in which some functions are served by one channel and some by another, rather than a single cut over date. That is an argument for a terminal operating system that separates the operational event from the channel it is sent on, so adding, changing or retiring a channel is a configuration exercise instead of a rewrite of the gate and yard screens.

PACE, the Pakistan Automated Customs Environment, is the next customs platform for Pakistan. For a terminal the planning conclusion is the same one that applies to the WeBOC to PSW transition: national platforms will keep evolving, so the durable investment is a clean internal event model and an integration layer that can be pointed at a new channel, not a set of screens hard wired to one platform.

Plan your single window transition with people who work here

Ciphertronix builds STOS in Karachi for Pakistani port and terminal operations. Customs and partner integration is part of the platform, and so is the local support that keeps it running.