Customer API
Overview
The WMS Customers API is a Business Central API page designed to manage customer data. This API allows external systems to interact with customer records, providing functionality for creating, reading, and updating customer information.
API Details
- Publisher: smart
- API Group: wms
- API Version: v2.0
- Entity Name: customer
- Entity Set Name: customers
- Source Table: Customer
- ODataKeyFields: No
Fields
The following fields are exposed in the API:
| Field Name | Source Field | Required | Description |
|---|---|---|---|
No | Customer."No." | Yes | Unique identifier for the customer. |
Name | Customer.Name | Yes | Name of the customer. |
GenBusPostingGroup | Customer."Gen. Bus. Posting Group" | No | General business posting group. |
VatBusPostingGroup | Customer."VAT Bus. Posting Group" | No | VAT business posting group. |
CustomerPostingGroup | Customer."Customer Posting Group" | No | Customer posting group. |
Notes
- Ensure that the SMA WMS Connector Setup is properly configured with a valid customer template before using this API.
Example Usage
Create a New Customer
POST host/instance/api/smart/wms/v2.0/companies(companyId)/customers
Content-Type: application/json
{
"No": "CUST001",
"Name": "Sample Customer",
"GenBusPostingGroup": "DOMESTIC",
"VatBusPostingGroup": "STANDARD",
"CustomerPostingGroup": "RETAIL"
}
Retrieve a Customer
GET host/instance/api/smart/wms/v2.0/companies(companyId)/customers('CUST001')
Update a Customer
PATCH /host/instance/api/smart/wms/v2.0/companies(companyId)/customers('CUST001')
Content-Type: application/json
{
"Name": "Updated Customer Name"
}