| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Discuss (mail) • Invoicing (account) |
| Lines of code | 1342 |
| Technical Name |
carrier_sg_ninjavan |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Discuss (mail) • Invoicing (account) |
| Lines of code | 1342 |
| Technical Name |
carrier_sg_ninjavan |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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 gencbaris@outlook.com.tr. 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: gencbaris@outlook.com.tr. 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
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module