App4Sales Platform

The App4Sales Platform connector integrates with the App4Sales Platform Gateway to retrieve projected stock in real time and export intake orders to the gateway's third-party order service.

Connector	Supported Features
Items	✅ Attributes   ✅ Name   ✅ Images   ✅ Family Code   ❌ Attachments   ✅ Stocks   ❌ Restock orders   ⚠️ Unit of Measures (no related UOM's)
Prices	✅ Supported (with configurable default price list per currency)
Projected Stock	✅ Supported
Orders	✅ Exporting   ✅ Retrieving
Customers	✅ Retrieving   ✅ Creating   ❌ Updating   ❌ Deleting

Projected Stock

The connector can be used as the connector in a projected stock flow. When projected stock is requested, OCP calls the App4Sales Platform Gateway directly and calculates the projected quantity for the requested item and date.

The projected quantity is based on:

Value	Usage
Shelf stock	Current stock baseline for the item.
To be delivered	Outgoing quantity without date information, subtracted from baseline.
Delivery date entries	Incoming quantities with dates up to and including the requested date.

Delivery date entries without a real date are ignored for date-based projections.

Prices

The connector supports price list synchronization. Price lists, item prices and quantity tiers are retrieved from the App4Sales Platform Gateway.

Each price list is marked as the default price list for its currency by matching it against the connector's Default price list per currency setting (see Settings). A currency without a configured default is left untouched during sync, so any existing default price list for that currency (set manually or by another connector) is preserved.

Orders

Exporting orders

The connector can be used as an order export connector. When an intake order is exported, OCP sends the order to the App4Sales Platform Gateway third-party order endpoint.

Additionally you can setup a hook to modify the order before export.

Retrieving orders

Order retrieval uses a background sync job that periodically imports order history from the App4Sales Platform Gateway and stores it in the connector's own database. When orders are requested through the retrieve orders flow, the connector serves the data from its local store.

The sync job fetches orders in paginated batches, starting from the most recently imported order date. For each order, it fetches the associated order lines via a separate real-time call to the gateway.

Dependency on focus connector

Order history is only available when a focus connector is configured in the legacy App4Sales backend. Customers without a focus connector configured will not have a working order history once the App4Sales app starts using OCP as its main data source.

Sync delay

Imported order data reflects the last time the legacy backend ran a history sync. Newly created orders will not appear in OCP until that sync has been executed.

Customers

The connector supports customer synchronization and creation.

Retrieving customers is supported via the customer synchronization flow.

Creating customers is also supported. On success, the gateway returns an external customer identifier that OCP stores against the customer record.

The following data is sent when creating a customer:

Field	Required	Description
CustomerCode	✅	The OCP customer code used to identify the customer.
Name	✅	The customer's display name.
CocNumber	❌	Chamber of commerce number.
VatNumber	❌	VAT identification number.
Addresses	❌	List of customer addresses.
ContactDetails	❌	List of customer contact details.

WARNING

Updating and deleting customers is not yet supported by this connector.

Settings

Configure the following fields in the OCP App when setting up the App4Sales Platform connector:

Field	Description
AdministrationName	Administration name used by the gateway to route App4Sales Platform requests.
Default price list (currency)	Per-currency dropdown listing the price lists available for that currency, labeled by their gateway description (falling back to the price list code if no description is set). Selecting a price list marks it as the default for the currency during price sync; leaving it unset ((No default)) leaves the currency's default price list untouched by this connector. Dropdowns are only shown once the connector's gateway settings have been saved successfully.

The App4Sales Platform Gateway URL is platform configuration and is not configured per connector.