Skip to main content

DawaTrack Integrations

Connect your own system to the same record

A manufacturer's or distributor's ERP writes its receipts and shipments to DawaTrack, and reads back where each batch went. Three ways in: the Partner API, a connector for SAP Business One, and the national report file.

Your ERP or warehouse system sends events to the DawaTrack ledger through the Partner API, and signed webhooks come back. The ledger feeds receivers' confirmations, recall reach, and an EPCIS 2.0 file. POST /events signed webhook Your system ERP or warehouse Goods receipt 812 Delivery 455 Webhook inbox DawaTrack one ledger RECEIVE · SHIPDISPENSE · RECALL Receivers confirm each shipment, by line Recall reach every recorded holder EPCIS 2.0 file GS1 standard export

Three ways in

DawaTrack Partner API

REST and webhooks, working today

OAuth2 client credentials, a scope per kind of call, and the same traceability ledger the portal reads. Every write takes an idempotency key, so a call sent twice records once.

  • Events: commission, ship, receive, dispense, quarantine and release, one at a time or up to 1,000 in a bulk job; a document cancelled in your system is retracted.
  • Receipts and consignments: confirm a shipment waiting for you, and see which of your consignments each receiver has confirmed.
  • Batches: a batch's distribution tree, its orphans and its events as GS1 EPCIS 2.0, for any batch you take part in.
  • Recalls: open a recall or run a drill, and follow who it reached.
  • Webhooks: signed pushes for recalls, orders and shipment confirmations, so you do not have to poll.
  • Sandbox: test credentials with demo data, issued without review.

Our team can help you scope the integration. You or your vendor build it against our REST API and sandbox.

One call, start to finish

  1. 1

    Get a token

    POST /oauth/token/ with your client ID and secret. It lasts 60 minutes.

  2. 2

    Send the event

    POST /events/ with an Idempotency-Key, so a retry never records twice.

  3. 3

    It's on the ledger

    201 Created. The batch's tree, its recalls and its EPCIS export now include it.

  4. 4

    Hear back by webhook

    When the receiver confirms, or a recall reaches the batch, a signed push arrives.

Step 2: a receipt from a supplier outside DawaTrackJSON
POST /partner-api/v1/events/
Authorization: Bearer <access token>
Idempotency-Key: sapb1:ACME:PurchaseDeliveryNotes:812:0:BTH-2026-041

{
  "event_type": "RECEIVE",
  "gtin": "06164004321562",
  "batch_number": "BTH-2026-041",
  "quantity": 12000,
  "expiry_date": "2027-11-30",
  "sender": {
    "name": "Manufacturer Abroad",
    "gln": "0614141000005"
  }
}

201 Created

Example request. Shipments from that receipt then name it as their parent, so the batch can be followed onward.

The details

Authentication
OAuth2 client credentials; tokens last 60 minutes
Retries
An Idempotency-Key on every write
Bulk
Up to 1,000 events in one job
Rate limit
5000/day per partner
Pages
25 results, up to 100
Webhooks
16 events, HMAC-SHA256 signed with a timestamp, 5 attempts
Standards
GS1 GTIN, GLN and SSCC; EPCIS 2.0 export
Sandbox
Credentials straight away, demo batch SANDBOX-BATCH-001
Reference
OpenAPI schema, an interactive explorer and a Postman collection

DawaTrack SAP Business One

A connector, built and waiting for its first live system

A small program that runs where it can reach your SAP Business One Service Layer. It reads your goods receipts and deliveries and writes them to DawaTrack through the Partner API, with the same rules every partner's calls follow.

  • Goods receipts become receipts, from a supplier on DawaTrack or one outside it.
  • Deliveries become shipments, one per batch or serial, each naming the receipt its units came from, first in first out.
  • Opening stock is loaded once at go-live from your on-hand export.
  • Nothing is guessed: a line with no GTIN, no batch or an unmapped customer is stopped and listed in the run report for you to fix.
One connector run: a goods receipt becomes a RECEIVE, deliveries become SHIP events, and a delivery line with no batch is stopped and listed in the run report. SAP BUSINESS ONE Goods receipt POPDN 812 · BTH-2026-041 DeliveryDLN 455 · 2 lines DeliveryDLN 457 · 2 lines Connector Partner API DAWATRACK RECEIVE 12,000 SHIP 600SHIP 400 SHIP 250 (line 1) RUN REPORT DLN 457 line 2: no batch. Stopped, nothing guessed.
An example run. Document numbers and quantities are illustrative.

Not yet

  • Not run against a live SAP system. It is built and tested against SAP's published Service Layer documentation; some field names are confirmed only from SAP's documents, and the first customer's data will confirm them.
  • Run by hand. A schedule or a background service is set up with the first customer, to fit where its SAP Business One runs.
  • Stock transfers between your warehouses and cancelled documents are listed in the run report, not yet written.
  • Other ERPs: no ready connector. They connect through the Partner API.

DawaTrack National report

One EPCIS 2.0 file, sent by you

A supplier downloads its traceability events for a period as one GS1 EPCIS 2.0 document from the supplier portal, built to GS1's published schema, ready to send where it is asked for.

Not yet

No live submission. DawaTrack does not send data to PPB, NATS or the Digital Health Agency itself. The NATS specification is not yet public; when it is, DawaTrack will map its EPCIS output to it.

Illustrative. The file holds your events for the period you choose.

Start in the sandbox

Free, self-serve test credentials with demo data, issued without review.