Stop Wasting Hours
Debugging eAdapter XML
The definitive 80-page guide to CargoWise eAdapter integration. Production-tested XML examples, working code in 4 languages, and solutions to every cryptic error you'll encounter.
Sound familiar?
Every CargoWise Developer
Hits These Walls
DataContext validation errors with no useful message
The XML looks right but CW returns a generic "validation failed" with zero detail on which field.
ProcessingLog returns flat text, not structured XML
You expected parseable XML back but got a wall of unstructured text you need to regex apart.
HTTP 200 but nothing happened in CargoWise
The request "succeeded" but no shipment was created. No error. Just... silence.
Can't search organisations via eAdapter
The docs mention it should work but the OrgAddress DataContext behaves completely differently than expected.
Date format mismatches silently drop fields
Send a date as DD/MM/YYYY instead of CW's expected format and the field just vanishes. No warning.
Shipment created but party addresses are blank
You sent the full address XML but CargoWise matched to an existing org code and ignored your data.
eAdapter returns different XML for the same request type
Same endpoint, same DataContext, different response shape depending on whether the record exists.
No documentation for which fields are actually required
CW's schema says optional but the request fails without it. Trial and error is your only friend.
Mapping table codes with no public reference list
Need to send a PackageType code? Good luck finding the valid values. They're not in the schema.
Event-based triggers fire in unpredictable order
Your workflow triggers overlap, fire twice, or miss entirely depending on server-side configuration.
What's inside
Everything You Need to Ship
a Working eAdapter Integration
Not theory. Not documentation rewrites. 80+ pages of real patterns from production integrations processing thousands of shipments. 8 chapters, 6 appendices, and 50+ code examples you can copy straight into your codebase.
Chapter 1
Connection & Authentication
HTTP setup in Node.js, Python, C#, and cURL. Credential management, health checks, timeout strategies, retry logic with exponential backoff, and environment configuration for dev/staging/production.
Chapter 2
XML Schema Deep Dive
UniversalShipment, DataContext, DataTarget types, and the XSR query message — fully annotated. Plus XML building best practices, response parsing patterns, and the namespace gotcha that causes cryptic failures.
Chapter 3
Sending Shipments & Bookings
The 3-step sync pattern (create, query, update), S-number extraction regex, complete shipment XML with parties, containers, and routing. Plus charges, document references, customised fields, SubShipments, and air freight differences.
Chapter 4
Error Handling & Debugging
The HTTP 200 problem decoded. ProcessingLog parsing. 10 common errors with exact solutions. Plus a production-grade response parser class, structured error logging, dead letter queue patterns, and a 10-step debugging checklist.
Chapter 5
Organisation & Party Management
Native XML org search queries (by code, name, country). The matching hierarchy explained. Org code caching strategy, XSR response extraction, name normalisation, and how to create new organisations via eAdapter.
Chapter 6
Validation & Data Integrity
Every undocumented field rule: date formats, field lengths, required-but-marked-optional fields. Container number validation (ISO 6346 with check digit), address splitting, pack type mapping, and a pre-send validation framework.
Chapter 7
Event Triggers & Webhooks
Outbound event configuration, XUS vs XUE comparison, trigger matrix planning. SOAP envelope unwrapping, message classification and routing, webhook security, duplicate handling, and monitoring metrics.
Chapter 8
Production Checklist
35-item go-live checklist across 6 categories. Scaling architecture with message queues. Connection pooling and parallel processing. 10 real production pitfall stories with solutions.
Plus 6 Reference Appendices
Everything Else You'll
Reach For Daily
Appendix A
Code Tables & Reference
Container types, carrier codes, transport modes, currency codes, document types, incoterms. Every mapping table you need.
Appendix B
Native XML Query Reference
Ready-to-use queries for shipments, consols, invoices, charges, customs declarations, and exchange rates. Entity path reference included.
Appendix C
Tools, Libraries & Further Reading
Open source libraries (Node.js, Ruby, PHP), commercial platforms, glossary of 16 CargoWise terms, and 12+ FAQ answers.
Appendix D
Real-World Integration Patterns
4 complete code patterns: e-commerce order sync, CW event to customer notification, scheduled bulk sync, and multi-carrier rate comparison.
Appendix E
XSLT Transformation Guide
Production XSLT templates for transforming between your internal format and CW Universal XML, including container code mapping.
Appendix F
Troubleshooting Decision Tree
Step-by-step diagnosis for: messages not arriving, data appearing wrong, outbound events not firing, and performance issues.
Get instant access
Save Weeks of Debugging for Less
Than One Hour of Developer Time
One guide. Every eAdapter pattern, error solution, XML template, and code example you need. PDF format. Instantly searchable. Yours forever.
One-time payment · No subscription
Secure checkout via Stripe. VAT/GST handled automatically.
Want Us to Handle the
Integration For You?
CargoMode connects your shipping documents to CargoWise automatically — AI extraction, carrier tracking, and one-click sync. No XML required.
Book a Demo