National Agency for Food and Drug Administration and Control (NAFDAC)Pharmaceutical Traceability Dashboard
PILOT PROJECT
SUPPLY CHAIN INTELLIGENCE

PharmaTrace overview

A private pilot for pharmaceutical company onboarding, GS1 identification and pack movement.

Synthetic demonstration. All company and product examples are fictional. This final demo version of the pilot is a static presentation and has no account controls, live data, payment confirmation or NAFDAC/GS1 API session.
Company profiles
3
Fictional examples
Pending review
1
Sample queue
GS1 identity
01 / 21
GTIN and serial AIs
API status
Pilot
Live credentials pending

Sample review queue

Meridian Medicines Ltd
Local manufacturer
Submitted
Northbridge Pharma Imports
Importer and distributor
Needs changes
Lakeview Therapeutics
Marketing authorisation holder
Internal demo approval

Current capabilities

Company and product master dataDemo
GS1 DataMatrix scan parsingPilot
Pack events and review holdsPilot
NAFDAC NTIS exchangePending
GS1 Nigeria Trackgenic readConfigured access pending
Partner API for NAFDAC and GS1 Nigeria teamsPilot
Camera product verificationPilot
Automatic invoice email after paymentPilot
Regulatory review by NAFDAC, GS1 Nigeria and NewsoftPilot
COMPANY REGISTRATION

Company onboarding

Fields in the current applicant preview and the administrator review queue.

Application drafts in the live demo are browser-local. This copy is illustrative and does not collect submissions or evidence files.

Company and contact details

Legal company nameRequired
RC No.Immediately after company name
Company categoryManufacturer, importer and others
Company emailRequired
Full registered addressStreet, city, state, country
Contact person's nameRequired
Contact phoneCountry code
Contact emailRequired

GS1 and product details

Location GLN-13Check digit validated
Product GTIN-14Check digit validated
Product nameRequired
NAFDAC referenceIndependent verification required

Review sequence

1
Company identity and RC evidence
2
GS1 identifier ownership
3
NAFDAC product status

Document upload and durable application submission require a production evidence store and controls.

Apply to join Live form

What happens next

Each application is reviewed by Newsoft (company identity), GS1 Nigeria (identifier ownership) and NAFDAC (product status) in the Regulatory review tab. When all three approve, Newsoft activates the company and sends its API key.

REGULATORY APPROVAL

Regulatory review

NAFDAC, GS1 Nigeria and Newsoft review each company application here. Sign in with your email and password.

Three sign-offs before a company is activated

1. Company identity
RC evidence and authorised contact. Signed off by Newsoft
2. GS1 identifier ownership
Company prefix, GTIN and GLN. Signed off by GS1 Nigeria
3. NAFDAC product status
Registration and pack-level eligibility. Signed off by NAFDAC
4. Activation
Newsoft activates the company, issues its API key and starts its serial pool

Every decision is recorded with the reviewer's email and time. Any reviewer can ask for changes or reject, with a note to the company.

PACKAGING CODE REQUEST

Codes and payment

Three steps: enter the number of codes, see the value, then pay. Once payment is confirmed, an invoice is emailed automatically and serials can be issued.

Company account

Request

Value

-

Tier
Rate

Local manufacturers pay ₦5,374.00 per 1,000 codes. Importers, including importer combinations, pay USD 7.51 per 1,000 codes. Other quantities are prorated to two decimal places.

Payment

Complete steps 1 and 2 to see the amount due and the payment link.

Payments awaiting confirmation Administrator

Payment control

Request
Company, product GTIN and quantity
Quote
Rate and matching currency/link
Verify
Independent transaction confirmation before code issue
Invoice
Emailed automatically to the company once payment is confirmed

The supplied static Flutterwave links do not receive a unique quote or transaction reference from the app. Confirm the checkout amount and currency before sharing. Opening a link never marks a request paid.

GS1 SERIAL SERVICE

Serialization

The Newsoft serial service, built in Python (FastAPI) with PostgreSQL: GTIN registry, automatic serial pools and issue of paid codes.

How it works

1. Register GTIN
Checked against the company's confirmed GS1 prefix
2. Pool fills
100,000 random serials per GTIN by default, adjustable up to 5,000,000, topped up whenever it falls below 20% of its size
3. Issue paid codes
Only against a confirmed payment, never more than was paid for
4. Print and trace
CSV with the GS1 string for the DataMatrix printer

Register a product GTIN

Serial pools

Paid orders ready to issue

Code format

AIDataExample
(01)GTIN-1406151234000121
(17)Expiry, YYMMDD280630
(10)Batch or lotAMX2609A
(21)Serial numberK7Q2M9XR4T8W

Serials are 12 characters from A to Z and 2 to 9, without I or O, drawn from a cryptographic random source. The database rejects any repeat of a GTIN and serial pair.

PRODUCT AUTHENTICATION

Verify a product

Scan the GS1 DataMatrix on the pack with your camera to authenticate it against the PharmaTrace register.

Scan the pack

Result

Scan a pack to see its details and authentication result here.

How verification works

1. Scan
The camera reads the GS1 DataMatrix on the pack
2. Check the code
GTIN check digit, expiry date, batch and serial are read and validated
3. Check the register
Was this serial issued? Is the batch recalled? Was the pack already dispensed?
4. Result
Genuine, check this pack, or not in the register, with the reason

A pack whose serial is unknown, already dispensed or from a recalled batch should be held and reported. Every scan is recorded for the NAFDAC team.

PACK-LEVEL PILOT

Track and trace

Identifiers and events currently represented in the private software pilot.

GS1 DataMatrix data

Application identifierMeaning
(01)GTIN
(17)Expiry date
(10)Batch or lot
(21)Serial number

The pilot checks the GTIN check digit and compares decoded attributes with its private sample registry. A match alone does not establish medicine authenticity.

Event workflow

CommissioningLocal pilot
ShippingLocal pilot
ReceivingLocal pilot
DispensingLocal pilot
Recall holdReview only

No event is sent to GS1 Nigeria or NAFDAC by this copy.

Verify a pack

Scan a pack with the camera, or from a photo, in the Verify product tab.

Record a pack event Company account

INTEROPERABILITY

Integration readiness

GS1 Nigeria Trackgenic and NAFDAC NTIS are distinct integration tracks.

GS1 Nigeria Trackgenic

The December 2022 draft guide identifies token, product and location master-data endpoints. A server-side, read-only connector is present in the hosted dashboard and makes no external calls until current credentials, brand-owner authorization and an enable switch are configured.

ProcessMapped endpoint
Products / locationsRead-only adapter
Serializationuploadserialization - disabled
Commissioningcommissionepc - disabled
Packing / unpackingDisabled
Shipping / receivingDisabled

NAFDAC NTIS

Awaiting NAFDAC's current technical specification, authorized service account, approved mappings and test sign-off. Trackgenic access does not provide NTIS access.

Official references

This snapshot documents readiness. It is not a regulatory approval or production certification.

Connect the NAFDAC and GS1 Nigeria teams

Each team gets its own partner account and API keys, limited to what it needs. Every call is logged.

TeamWhat the key can doEndpoints
NAFDAC traceability team
Regulator
Read the company, GTIN and GLN registry; trace any issued pack with its full event history; pull the event feed and verification reports; recall a batch so every later scan returns an alertGET /api/partner/companies
GET /api/partner/gtins
GET /api/partner/trace/{gtin}/{serial}
GET /api/partner/events
GET /api/partner/verifications
GET /api/partner/summary
POST /api/partner/recalls
GS1 Nigeria team
Standards body
Read the company prefix and GTIN registry; confirm or reject that a GS1 company prefix belongs to the company using itGET /api/partner/companies
GET /api/partner/gtins
PUT /api/partner/prefixes/{prefix}

How a team connects

1. Account
Newsoft creates the partner account with the team's technical contact
2. Key
A key is issued once, expires after 180 days and can be revoked at any time
3. Connect
The team calls the API over HTTPS with the header X-Partner-Key

Partner access Administrator

PharmaTrace API

EndpointUse
POST /api/onboardingCompany application
POST /api/gtinsRegister a GTIN and start its pool
POST /api/ordersQuote a code order
POST /api/orders/{id}/verify-paymentConfirm a Flutterwave payment
POST /api/orders/{id}/serialsIssue paid serials, JSON or CSV
POST /api/eventsCommission, ship, dispense, decommission
GET /api/verifyPack verification
/api/partner/…NAFDAC and GS1 Nigeria partner access

Full reference: /docs on the live server.