Shipping Sdk Laravel Laravel Package

Product Decisions This Supports

• Feature Development:

  • Inventory Management: Streamline car inventory operations (sync, hold, release, withhold) for logistics platforms, auction houses, or dealerships.
  • Document Automation: Automate document uploads (e.g., export certificates, invoices) for compliance and tracking, reducing manual data entry.
  • Real-Time Notifications: Implement asynchronous job resolution callbacks (e.g., photo/document processing) to trigger alerts or UI updates.
  • Voyage Tracking: Integrate voyage data (e.g., ETA, port status) into shipping dashboards or customer portals.

• Roadmap Priorities:

  • Phase 1: Core inventory and document management (sync cars, upload photos/documents).
  • Phase 2: Real-time updates via webhooks (e.g., shipment status changes, job completion).
  • Phase 3: Advanced analytics (e.g., voyage trends, document expiry alerts).

• Build vs. Buy:

  • Buy: Avoid reinventing REST API clients, webhook handlers, and async job systems. Leverage Dinas’s mature SDK for reliability and compliance with their API.
  • Build: Customize workflows (e.g., unique document validation logic) via the SDK’s extensible facade/API layer.

• Use Cases:

  • Logistics Platforms: Manage yard inventory, track shipments, and automate document workflows.
  • Automotive Auctions: Sync vehicle listings, upload photos, and handle bids with real-time updates.
  • Dealerships: Integrate with shipping providers for cross-border vehicle transfers (e.g., Japan-US).
  • Compliance Tools: Automate document tracking (e.g., export certificates) with expiry alerts.

When to Consider This Package

• Adopt If:

  • Your Laravel app needs to integrate with Dinas Shipping API for inventory, documents, or voyages.
  • You require webhook support for asynchronous updates (e.g., shipment status changes).
  • Your team lacks bandwidth to build a custom REST client + webhook handler from scratch.
  • You need real-time job resolution callbacks (e.g., photo/document processing notifications).
  • Your use case aligns with Dinas’s supported features (cars, photos, documents, voyages).

• Look Elsewhere If:

  • You need multi-provider shipping integration (e.g., FedEx, DHL). Use a generic SDK like ShipEngine.
  • Your stack isn’t Laravel/PHP. Port the SDK or use a language-specific client (e.g., Python, Node.js).
  • You require advanced customization beyond the SDK’s scope (e.g., unique API endpoints). Extend the SDK or build a wrapper.
  • Compliance or security policies prohibit third-party SDKs. Use direct API calls with a custom client.
  • Your team prefers GraphQL over REST. Check if Dinas offers a GraphQL API or build a wrapper.

How to Pitch It (Stakeholders)

For Executives:

*"This Laravel package from Dinas Shipping eliminates the need to build a custom integration for their API, saving 3–6 months of dev time and reducing technical debt. It handles:

• Inventory sync: Automate car listings, holds, and releases.
• Document workflows: Upload and track export certificates, invoices, etc., with expiry alerts.
• Real-time updates: Webhooks notify our system of shipment status changes or job completions (e.g., photo processing).
• Scalability: Built-in async job queues and broadcasting (Pusher) support high-volume operations.

ROI: Faster time-to-market for logistics features, reduced manual errors in document handling, and seamless compliance tracking. The MIT license and active maintenance (last release: May 2026) ensure long-term reliability."*

For Engineering:

*"This SDK provides a batteries-included solution for Dinas Shipping API integration in Laravel:

• Facade Pattern: Simple, fluent methods for cars, photos, documents, and voyages (e.g., Shipping::syncCars()).
• Webhook Automation: Handles verification, logging, and job dispatching for incoming events (e.g., api.job for async operations).
• Async Job Callbacks: Register callbacks for job resolution (e.g., onResolve) to trigger actions like notifications or UI updates.
• Real-Time Broadcasting: Opt-in Pusher integration for frontend updates (e.g., ShippingJobResolved events).
• Direct API Access: Need more control? Access underlying API clients directly (e.g., Shipping::cars()->getCars()).

Trade-offs:

• Lock-in: Tied to Dinas’s API schema. Customize via config or extend the facade.
• Dependencies: Requires Spatie’s webhook-client package (already a common dependency in Laravel).
• Testing: Low stars (0) but active maintenance (May 2026 release) and CI/CD pipelines suggest stability.

Recommendation: Use this for core shipping workflows and build custom logic on top (e.g., unique validation rules) via the facade or dependency injection."*