Ninja Van Singapore Connector for Odoo
Create Ninja Van orders, print waybill labels and track shipments - using your own Ninja Van API keys (BYOK)
Ship with Ninja Van straight from Odoo
This module turns any outgoing Odoo delivery into a Ninja Van Singapore parcel: it creates the order, receives the Ninja Van tracking number, prints a scannable waybill label, fetches the official Ninja Van PDF waybill, and keeps the delivery status in sync. It is a bring-your-own-key (BYOK) connector - you paste the OAuth2 client id and client secret issued to you in the Ninja Dashboard, and every request goes straight to the Ninja Van endpoint you configure. No middleware, no third-party relay.
Order Creation
Create a Ninja Van order from a stock picking in one click. The connector builds the Create Order payload (sender, receiver, parcel dimensions and weight, service level), registers it with Ninja Van, and stores the allocated tracking number on the delivery.
Printable Waybill Label
A self-contained, printable HTML waybill with sender / receiver blocks, parcel metrics and a scannable Code128 barcode of the Ninja Van tracking number - rendered locally, no external print service. The official Ninja Van PDF waybill can also be fetched and attached to the delivery.
Tracking
A public Ninja Van tracking link is generated automatically on every delivery. Ninja Van delivers parcel status by webhook (it publishes no pull/polling tracking endpoint): route your Ninja Van webhook into Odoo and the matching delivery's status and last scan are updated from the webhook payload.
Cancel Before Pickup
Cancel a booked Ninja Van order before it is collected, clearing the tracking number and tracking reference from the delivery.
Singapore-specific, done right
| Capability | Detail |
|---|---|
| OAuth2 authentication | Exchanges your client id / secret for a short-lived bearer token (client_credentials grant) and refreshes it automatically. |
| Tracking number | Validated and normalised to the public Ninja Van alphanumeric format; deterministic id derived from your order reference when not pre-supplied. |
| Singapore postal codes | 6-digit Singapore postcode validation on both sender and receiver addresses. |
| Service levels | Standard, Next Day and Same Day; service types Parcel, Document and Marketing Material. |
| Singapore timeslots | Delivery timeslot built in Singapore time (+08:00), with pickup scheduled on the next business day (Sundays skipped). |
| Public tracking | Auto-built Ninja Van tracking URL per delivery (en-sg/tracking?id=). |
| Audit log | Every Ninja Van API call logged with operation, status, duration and error excerpt. |
How it works
- Create a shipping method with provider Ninja Van (Singapore).
- Paste your Ninja Van client id and client secret, and confirm the country code (SG).
- Press Test Ninja Van Connection to confirm your credentials.
- On any outgoing delivery, open Ninja Van Label to create the order, preview and print the waybill, or download the official PDF waybill.
- Track the parcel from the delivery, or enable the scheduled status refresh.
Requirements
- Odoo 18.0 or 19.0 (Community or Enterprise).
- An active Ninja Van merchant account with an OAuth2 client id and client secret.
- HTTPS outbound from your Odoo server to the Ninja Van endpoint.
This connector generates the Ninja Van-format order payload and transmits it with your own credentials. It is not a Ninja Van-certified relay or middleware and stores no credentials outside your own database.
Support & what you are buying
We provide software, not an integration service. This is a bring-your-own-key (BYOK) connector: you bring your own Ninja Van merchant account and OAuth2 client id / secret. We are not a Ninja Van partner, reseller or certified integrator, and we do not act as an intermediary for your shipments - every API request is sent directly from your Odoo instance to Ninja Van with your own keys.
Email support is included at support@pokutsoft.com. If the module does not work as described, contact us - purchases are refundable in line with the Odoo Apps Store refund policy.
Türkçe
Bir yazılım satıyoruz, entegratörlük hizmeti değil. Bu, kendi anahtarınızı getirdiğiniz (BYOK) bir bağlayıcıdır: kendi Ninja Van bayi hesabınızı ve OAuth2 client id / secret bilgilerinizi kullanırsınız. Ninja Van'ın iş ortağı, bayisi veya yetkili entegratörü değiliz ve gönderileriniz için aracılık yapmayız - her API isteği doğrudan sizin Odoo sunucunuzdan kendi anahtarlarınızla Ninja Van'a gider.
E-posta desteği dahildir: support@pokutsoft.com. Modül açıklandığı gibi çalışmazsa bizimle iletişime geçin; satın alımlar Odoo Apps Store iade politikası kapsamında iade edilebilir.
Screenshots
Api Log
Settings
Update date: 2026-07-02