The provider adapter that connects the LataSys 3PL Connector to the ShipHero GraphQL API - orders, despatches with shipped lots, live stock, products, suppliers, inbound and returns.
What the adapter covers
|
Orders out, despatches back Confirmed orders push with line-level detail and shipping lines resolved from the order's requested delivery method. Despatch write-back fetches the shipments' carrier, tracking and the exact lots the warehouse shipped - validated as native Odoo stock moves, short-ships becoming backorders. |
Stock, products and suppliers Scheduled lot-level inventory syncs with pagination that respects ShipHero's query-cost quotas. Product match and push, supplier push, warehouse list fetch straight into the mappings, ASNs as purchase orders and GRN reconciliation. |
|
Returns and cancellations Return labels generated at ShipHero, arrivals and undeliverable parcels handled through the core app's RMA lifecycle, graded receipts and credit notes. Cancelling in Odoo cancels at the warehouse. |
Carriers and services Fetch the account's carriers from ShipHero's experimental API, or - on any account - compile them from the shipping labels of orders already despatched, with delivery methods auto-created for anything unmatched. Requested-method mapping translates checkout choices to ShipHero shipping lines (title, carrier, method). |
How it works
Order push
|
Status poll and despatch write-back
|
Token lifecycle
|
Connection test and warehouse fetch
|
Setup in four steps
- Install this adapter alongside the 3PL Connector core app.
- Create an instance, pick ShipHero, enter your Third-Party Developer email/password (or paste a refresh token) and press Test Connection - tokens renew themselves from then on.
- Map with one click each: Fetch Warehouses, Fetch Carriers (experimental API or compiled from your order history), Load Missing Defaults for statuses, Load Requested Methods for shipping lines.
- Choose your syncs, activate, and watch the first order arrive in the Sync Log.
Frequently asked questions
Do I need a ShipHero account first?
Yes - this adapter connects an existing ShipHero account (3PL client or brand). You create a Third-Party Developer user in ShipHero; the adapter handles tokens from there.
Does it respect ShipHero's API quotas?
Yes - queries paginate conservatively and the adapter is built around ShipHero's query-cost credit system.
My account lacks the experimental carriers API - can I still map carriers?
Yes. Switch the instance to Use Historical Orders and the carrier list compiles from the shipping labels of orders already despatched, creating delivery methods for anything unmatched.
Are shipped lots handled?
Fully - despatch write-back carries the lots ShipHero shipped into native Odoo stock moves, with configurable policies for un-batched or unknown batches.
Recent releases
| 2.2.x - Jul 2026 | Carrier source choice (experimental API or historical-order sweep with auto-created delivery methods), requested-method mapping onto shipping lines, despatch lots aligned with the live schema, order-list pagination fix. |
| 2.x - Jun/Jul 2026 | Order push with shipped-lot despatch write-back, supplier push, warehouse fetch, returns with labels, ASN/GRN as purchase orders, webhook endpoint, automatic token lifecycle. |
Documentation & support
Setup reference, process maps and troubleshooting live in the LataSys Help Center. An optional maintenance & support subscription (GBP 29/month) is available - subscribe at shop.latasys.app/subscribe.
Visit the Help Center: support.latasys.com
Learn more: 3pl.odoo.latasys.com · Build your bundle and buy direct
ShipHero is a trademark of its respective owner. The name is used solely to
identify the third-party service this module interoperates with; no affiliation or
endorsement is implied.
LataSys Limited · latasys.com
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Sales (sale_management)
• Discuss (mail) • Invoicing (account) • Inventory (stock) • Purchase (purchase) |
| Community Apps Dependencies | Show |
| Lines of code | 17698 |
| Technical Name |
latasys_3pl_shiphero |
| License | OPL-1 |
| Website | https://latasys.com |
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