Cargo Partner

LicenseStablePHPIssuesMerge Requests

Description

Cargo Partner integrates Enso sales, purchases, stock, and fulfilment flows with the Cargo Partner API.

The package stores the remote credentials and warehouse mapping, exposes settings and product integration endpoints, registers an inventory fulfilment provider, and keeps open orders synchronized with the remote platform.

It is intended for private deployments that need Cargo Partner as an external fulfilment or stock source.

Installation

This is a proprietary package distributed through the private Enso registry.

Run the package migrations after installation:

php artisan migrate

Then configure the integration from the Cargo Partner settings screen. The settings record stores:

  • base URL
  • client credentials
  • login credentials
  • warehouse and virtual position mapping
  • operative label
  • enabled flag

In production, the package schedules remote order synchronization every 30 minutes when the integration is enabled.

Features

  • Settings API for enabling the integration and storing encrypted credentials.
  • Product actions for publish, update, and stock checks.
  • Inventory fulfilment provider for both sales and purchases.
  • Cached access token handling per API version.
  • Scheduled synchronization for open sales and purchases.

Usage

Enable the integration from the settings form before using the fulfilment flow.

Products can be published to Cargo Partner through the registered product integration actions, while sales and purchases are fulfilled through the inventory fulfilment pipeline.

To trigger a manual remote refresh for open orders:

php artisan enso:cargo-partner:fetch-order-updates

The package exposes helper methods such as:

  • LaravelEnso\\CargoPartner\\Models\\Sale::fulfill()
  • LaravelEnso\\CargoPartner\\Models\\Purchase::fulfill()
  • LaravelEnso\\CargoPartner\\Models\\Product::publish()

API

HTTP routes

Settings:

  • GET api/integrations/cargoPartner/settings
  • PATCH api/integrations/cargoPartner/settings/{settings}

Products:

  • GET api/integrations/cargoPartner/products/{product}/checkStock
  • POST api/integrations/cargoPartner/products/{product}/publish
  • PATCH api/integrations/cargoPartner/products/{product}/update

Artisan commands

  • enso:cargo-partner:fetch-order-updates

Behavior:

  • iterates open Cargo Partner sales
  • iterates open Cargo Partner purchases
  • dispatches the sync flow for each order

Depends On

Required Enso packages:

Runtime companion packages:

Companion frontend package:

Edit this page on GitHub
Last Updated: 4/20/2026, 6:05:18 PM