Appearance
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 | ❌ Not supported |
| 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.
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. |
The App4Sales Platform Gateway URL is platform configuration and is not configured per connector.