PharmaTrace overview
A private pilot for pharmaceutical company onboarding, GS1 identification and pack movement.
Sample review queue
Local manufacturerSubmitted
Importer and distributorNeeds changes
Marketing authorisation holderInternal demo approval
Current capabilities
Company onboarding
Fields in the current applicant preview and the administrator review queue.
Company and contact details
GS1 and product details
Review sequence
Company identity and RC evidence
GS1 identifier ownership
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 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
RC evidence and authorised contact. Signed off by Newsoft
Company prefix, GTIN and GLN. Signed off by GS1 Nigeria
Registration and pack-level eligibility. Signed off by NAFDAC
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.
Applications
Staff accounts Newsoft
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.
The calculator and payment links work in this copy. Placing tracked orders, confirming payment and issuing serials need the PharmaTrace server.
Company account
Request
Value
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.
Your code orders
Payments awaiting confirmation Administrator
Payment control
Company, product GTIN and quantity
Rate and matching currency/link
Independent transaction confirmation before code issue
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.
Serialization
The Newsoft serial service, built in Python (FastAPI) with PostgreSQL: GTIN registry, automatic serial pools and issue of paid codes.
How it works
Checked against the company's confirmed GS1 prefix
100,000 random serials per GTIN by default, adjustable up to 5,000,000, topped up whenever it falls below 20% of its size
Only against a confirmed payment, never more than was paid for
CSV with the GS1 string for the DataMatrix printer
Register a product GTIN
Serial pools
Paid orders ready to issue
Code format
| AI | Data | Example |
|---|---|---|
| (01) | GTIN-14 | 06151234000121 |
| (17) | Expiry, YYMMDD | 280630 |
| (10) | Batch or lot | AMX2609A |
| (21) | Serial number | K7Q2M9XR4T8W |
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.
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
The camera reads the GS1 DataMatrix on the pack
GTIN check digit, expiry date, batch and serial are read and validated
Was this serial issued? Is the batch recalled? Was the pack already dispensed?
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.
Track and trace
Identifiers and events currently represented in the private software pilot.
GS1 DataMatrix data
| Application identifier | Meaning |
|---|---|
| (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
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
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.
| Process | Mapped endpoint |
|---|---|
| Products / locations | Read-only adapter |
| Serialization | uploadserialization - disabled |
| Commissioning | commissionepc - disabled |
| Packing / unpacking | Disabled |
| Shipping / receiving | Disabled |
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.
| Team | What the key can do | Endpoints |
|---|---|---|
| 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 alert | GET /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 it | GET /api/partner/companies GET /api/partner/gtins PUT /api/partner/prefixes/{prefix} |
How a team connects
Newsoft creates the partner account with the team's technical contact
A key is issued once, expires after 180 days and can be revoked at any time
The team calls the API over HTTPS with the header X-Partner-Key
Partner access Administrator
PharmaTrace API
| Endpoint | Use |
|---|---|
| POST /api/onboarding | Company application |
| POST /api/gtins | Register a GTIN and start its pool |
| POST /api/orders | Quote a code order |
| POST /api/orders/{id}/verify-payment | Confirm a Flutterwave payment |
| POST /api/orders/{id}/serials | Issue paid serials, JSON or CSV |
| POST /api/events | Commission, ship, dispense, decommission |
| GET /api/verify | Pack verification |
| /api/partner/… | NAFDAC and GS1 Nigeria partner access |
Full reference: /docs on the live server.