Appearance
AMZSMobileManagement
Codeunit service for mobile-specific business operations: authentication, GPS tracking, work order management, AKC (roadside assistance) operations, invoicing, and attachments.
Service Details
| Property | Value |
|---|---|
| Endpoint | /Codeunit/AMZSMobileManagement |
| SOAP Namespace | urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement |
| Full URL (Production) | http://nav.amzs.si:7047/DynamicsNAV90-WSC/WS/AMZS%20d.d./Codeunit/AMZSMobileManagement |
Authentication & User Management
AuthUser
Authenticates a mobile user by username and PIN code. Returns user details including blocked status, existence flag, resource ID, responsibility center, and telephone number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AuthUser
Parameters:
| Name | Type | Description |
|---|---|---|
userName | String | The username to authenticate |
pINCode | String | The user's PIN code |
blocked | Boolean | Output: whether the user account is blocked |
exists | Boolean | Output: whether the user exists in the system |
resourceID | String | Output: the resource ID associated with the user |
responsibilityCenter | String | Output: the user's assigned responsibility center |
telNo | String | Output: the user's telephone number |
Returns: MMAuthUser_Result
| Field | Type | Description |
|---|---|---|
return_value | Boolean | Whether authentication was successful |
blocked | Boolean | Whether the user account is blocked |
exists | Boolean | Whether the user exists in the system |
resourceID | String | The resource ID associated with the user |
responsibilityCenter | String | The user's assigned responsibility center |
ChangeUserPIN
Changes the PIN code for an authenticated user. Requires the current PIN for verification before setting the new one.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:ChangeUserPIN
Parameters:
| Name | Type | Description |
|---|---|---|
userName | String | The username whose PIN is being changed |
pINCode | String | The current PIN code for verification |
newPINCode | String | The new PIN code to set |
Returns: Boolean -- true if the PIN was changed successfully.
GetLastVersion
Retrieves the latest version identifier from the server. Used to check if the mobile app needs to sync new data.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetLastVersion
Parameters:
| Name | Type | Description |
|---|---|---|
iDVersion | Integer | The current version ID known to the client |
Returns: Integer -- The latest version ID on the server.
UserAllowToPost
Checks the posting permissions for a given user, including whether they can post general documents, mobile invoices, and AKC commitments.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UserAllowToPost
Parameters:
| Name | Type | Description |
|---|---|---|
userName | String | The username to check permissions for |
allowToPost | Boolean | Output: whether the user is allowed to post |
allowToPostMobileInvoice | Boolean | Output: whether the user can post mobile invoices |
allowToCommitToAKC | Boolean | Output: whether the user can commit to AKC |
Returns: MMUserAllowToPost_Result
| Field | Type | Description |
|---|---|---|
allowToPost | Boolean | Whether the user is allowed to post |
allowToPostMobileInvoice | Boolean | Whether the user can post mobile invoices |
allowToCommitToAKC | Boolean | Whether the user can commit to AKC |
GetUserID
Retrieves the NAV user ID for a given performer code. Used to map mobile performer identifiers to backend user IDs.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetUserID
Parameters:
| Name | Type | Description |
|---|---|---|
performerCode | String | The performer code to look up |
userIDPerformer | String | Output: the resolved NAV user ID |
Returns: String -- The NAV user ID for the given performer.
GetAKCRespCenter
Retrieves the AKC responsibility center for a given user. Determines which regional center the user operates under for roadside assistance dispatching.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetAKCRespCenter
Parameters:
| Name | Type | Description |
|---|---|---|
userName | String | The username to look up |
responsibilityCenter | String | Output: the AKC responsibility center code |
Returns: String -- The responsibility center code.
GetUserStatus
Retrieves the current status of a resource (performer). Used to determine if a user is available, busy, or in another state.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetUserStatus
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID to check |
status | String | Output: the current status string |
Returns: MMGetUserStatus_Result
| Field | Type | Description |
|---|---|---|
return_value | Boolean | Whether the status was retrieved successfully |
status | String | The current status of the user/resource |
UpdatePerfomerStatus
Updates the status of a performer/resource in the backend system. Used when a field worker changes their availability.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdatePerfomerStatus
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID to update |
pefromerStatus | Integer | The new status code to set |
Returns: void
INFO
Note the typo in the parameter name pefromerStatus -- this matches the backend service definition and must be used as-is.
GetPerfomerStatus
Retrieves the current status of a performer as a string value.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetPerfomerStatus
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID to query |
pefromerStatus | String | Output: the performer's current status |
Returns: String -- The performer status as a string.
Location & Tracking
UpdateUserLocation
Sends the current GPS location of a user to the backend for real-time tracking. Includes device token for push notification routing and optional association with a work order.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateUserLocation
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID of the user |
latitude | BigDecimal | GPS latitude coordinate |
longitude | BigDecimal | GPS longitude coordinate |
status | Integer | The current status code of the user |
measurementDT | Date | Timestamp of the GPS measurement |
deviceToken | String | Firebase/push notification device token |
workOrderNo | String | The work order number currently being serviced (if any) |
Returns: Boolean -- true if the location update was accepted.
AcceptBooking
Accepts or updates the status of a booking assignment. Used when a field worker responds to a dispatched job. Returns the updated status.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AcceptBooking
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID of the performer accepting the booking |
status | String | The new status to set for the booking |
measurementDT | Date | Timestamp of the status change |
entryNo | Integer | The booking entry number |
latitude | BigDecimal | GPS latitude at time of acceptance |
longitude | BigDecimal | GPS longitude at time of acceptance |
Returns: String -- The resulting booking status.
ConnectUserVehicle
Associates a user/resource with a service vehicle. Used when a field worker begins using a specific company vehicle.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:ConnectUserVehicle
Parameters:
| Name | Type | Description |
|---|---|---|
resourceID | String | The resource ID of the user |
vehicleNo | String | The vehicle number to associate |
entryNo | Integer | The booking or assignment entry number |
Returns: Boolean -- true if the vehicle was connected successfully.
GetMobileData
Retrieves comprehensive mobile tracking data for a booking entry, including all location addresses, timestamps, and distance calculations for multi-leg journeys (starting location, intermediate destination, final location, vehicle end location).
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetMobileData
Parameters:
| Name | Type | Description |
|---|---|---|
entryNo | Integer | The booking entry number |
startingLocationAdd | String | Output: starting location address |
intermediateDestinationAdd | String | Output: intermediate destination address |
finalLocationAdd | String | Output: final location address |
vehicleEndLocationAdd | String | Output: vehicle end location address |
startingLocation | String | Output: starting location coordinates/ID |
intermediateDestination | String | Output: intermediate destination coordinates/ID |
finalLocation | String | Output: final location coordinates/ID |
vehicleEndLocation | String | Output: vehicle end location coordinates/ID |
towStartTime | String | Output: tow start time |
intermediateTime | String | Output: intermediate stop time |
finalDestinationTime | String | Output: final destination arrival time |
vehicleEndLocationTime | String | Output: vehicle end location time |
towStartDate | Date | Output: tow start date |
intermediateDate | Date | Output: intermediate stop date |
finalDestinationDate | Date | Output: final destination date |
vehicleEndLocationDate | Date | Output: vehicle end location date |
partDistance1 | BigDecimal | Output: distance of first leg (km) |
partDistance2 | BigDecimal | Output: distance of second leg (km) |
partDistance3 | BigDecimal | Output: distance of third leg (km) |
distance | BigDecimal | Output: total distance (km) |
Returns: MMGetMobileData_Result
| Field | Type | Description |
|---|---|---|
startingLocationAdd | String | Starting location address |
intermediateDestinationAdd | String | Intermediate destination address |
finalLocationAdd | String | Final location address |
vehicleEndLocationAdd | String | Vehicle end location address |
startingLocation | String | Starting location coordinates/ID |
intermediateDestination | String | Intermediate destination coordinates/ID |
finalLocation | String | Final location coordinates/ID |
vehicleEndLocation | String | Vehicle end location coordinates/ID |
towStartTime | String | Tow start time |
intermediateTime | String | Intermediate stop time |
finalDestinationTime | String | Final destination arrival time |
vehicleEndLocationTime | String | Vehicle end location time |
towStartDate | Date | Tow start date |
intermediateDate | Date | Intermediate stop date |
finalDestinationDate | Date | Final destination date |
vehicleEndLocationDate | Date | Vehicle end location date |
partDistance1 | BigDecimal | Distance of first leg (km) |
partDistance2 | BigDecimal | Distance of second leg (km) |
partDistance3 | BigDecimal | Distance of third leg (km) |
distance | BigDecimal | Total distance (km) |
UpdateAKcBookingLocation
Triggers a server-side update of the AKC booking location data based on the document number. The server recalculates location-related fields from tracked GPS data.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAKcBookingLocation
Parameters:
| Name | Type | Description |
|---|---|---|
docNo | String | The document number of the AKC booking |
Returns: void
UpdateAkcBookingManualDistance
Allows manual entry of distance values for an AKC booking, overriding GPS-calculated distances. Supports separate day, night, and holiday distance values.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAkcBookingManualDistance
Parameters:
| Name | Type | Description |
|---|---|---|
akcBookingEntryNo | Integer | The AKC booking entry number |
manualEntryKm | Boolean | Whether manual distance entry is enabled |
distanceDay | BigDecimal | Distance traveled during daytime (km) |
distanceNight | BigDecimal | Distance traveled during nighttime (km) |
distanceHoliday | BigDecimal | Distance traveled during holidays (km) |
Returns: void
Work Order Operations
CreateWorkOrder
Creates a new work order in the backend system. Returns the assigned document number. Used to initiate field service jobs from the mobile app.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CreateWorkOrder
Parameters:
| Name | Type | Description |
|---|---|---|
entryNo | Integer | The booking entry number to create the work order from |
documentNo | String | Output: the generated document number |
memberNo | String | The membership number of the customer |
performerID | Integer | The ID of the performer assigned to the work order |
performerType | Integer | The type of performer (e.g., technician, tow driver) |
orderDate | Date | The date of the work order |
orderStatus | Integer | The initial status of the work order |
customerName | String | The customer's name |
customerAddress | String | The customer's address |
postCode | String | The customer's postal code |
city | String | The customer's city |
Returns: String -- The assigned document number for the new work order.
SendWorkOrderTime
Records a time event on a work order. Used to track arrival time, start of work, completion, and other time-stamped milestones.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:SendWorkOrderTime
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
measurementDT | Date | The timestamp of the time event |
timeType | Integer | The type of time event being recorded |
Returns: void
SendReturnToAMZS
Marks whether the customer's vehicle needs to be returned to an AMZS facility after service.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:SendReturnToAMZS
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
returnToAMZS | Boolean | Whether the vehicle should be returned to AMZS |
Returns: void
UpdatePerfomerOnWO
Updates the performer (field worker) assigned to an existing work order. Used for reassigning jobs to different AKC performers.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdatePerfomerOnWO
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
aKCPerfomerNo | String | The new AKC performer number to assign |
Returns: void
CreateOrderReservation
Creates a service appointment reservation for a customer. Includes date, time slot, vehicle details, and work instructions.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CreateOrderReservation
Parameters:
| Name | Type | Description |
|---|---|---|
resDate | Date | The reservation date |
resFromTime | String | Start time of the reservation slot |
resToTime | String | End time of the reservation slot |
customerNo | String | The customer number |
vehicleNo | String | The vehicle number |
counterStatus | BigDecimal | The vehicle's odometer/counter reading |
workInsturction | String | Work instructions or notes for the reservation |
webUserId | String | The web user ID creating the reservation |
Returns: void
AKC (Roadside Assistance) Operations
UpdateAKCRoadAss
Updates roadside assistance details on a work order, including additional working hours and toll charges.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAKCRoadAss
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
additionalWorkingHours | Integer | Number of additional working hours |
toll | BigDecimal | Toll charges incurred |
Returns: void
UpdateAKCRoadAss2
Extended version of UpdateAKCRoadAss with additional fields for SPI success status, agreed pricing, new membership sign-up, fuel pumping, and vehicle unlocking services.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAKCRoadAss2
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
additionalWorkingHours | Integer | Number of additional working hours |
toll | BigDecimal | Toll charges incurred |
successfulSPI | Boolean | Whether the roadside repair (SPI) was successful |
agreedPrice | BigDecimal | An agreed-upon price with the customer |
newMembership | Boolean | Whether a new AMZS membership was signed |
fuelPumping | Boolean | Whether fuel pumping service was provided |
unlocking | Boolean | Whether vehicle unlocking service was provided |
Returns: void
INFO
This is the v2 variant of UpdateAKCRoadAss. Prefer this method when additional detail fields are needed for the roadside assistance report.
UpdateAKCTow
Updates towing operation details on a work order, including loading difficulty, rescue operations, car lift usage, waiting time, and toll charges.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAKCTow
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
difficultLoading | Integer | Difficulty level of vehicle loading |
rescue | Integer | Rescue operation type/level |
carLift | Boolean | Whether a car lift was used |
carLiftUse | Integer | Duration or count of car lift usage |
waiting | Integer | Waiting time (in minutes) |
toll | BigDecimal | Domestic toll charges |
tollEU | BigDecimal | EU/international toll charges |
Returns: void
UpdateAKCTow2
Extended version of UpdateAKCTow with additional fields for secure vehicle storage, empty ride tracking, and agreed pricing.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UpdateAKCTow2
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
difficultLoading | Integer | Difficulty level of vehicle loading |
rescue | Integer | Rescue operation type/level |
carLift | Boolean | Whether a car lift was used |
carLiftUse | Integer | Duration or count of car lift usage |
waiting | Integer | Waiting time (in minutes) |
toll | BigDecimal | Domestic toll charges |
tollEU | BigDecimal | EU/international toll charges |
secureStorageofVehicles | Integer | Duration or type of secure vehicle storage |
emptyRide | Boolean | Whether an empty ride (no vehicle transported) occurred |
agreedPrice | BigDecimal | An agreed-upon price with the customer |
Returns: void
INFO
This is the v2 variant of UpdateAKCTow. Prefer this method when additional detail fields are needed for the towing report.
AKCPriceCalculation
Triggers server-side price calculation for all AKC services on a work order. Must be called before retrieving prices with AKCGetPrice or AKCGetPricePurchase.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCPriceCalculation
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number to calculate prices for |
Returns: void
AKCGetPrice
Retrieves the calculated sales price for AKC services on a work order, broken down into net amount, gross amount (including VAT), and the VAT amount.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCGetPrice
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
amount2 | BigDecimal | Output: net amount (excluding VAT) |
amountIncVAT | BigDecimal | Output: gross amount (including VAT) |
vATAmount | BigDecimal | Output: VAT amount |
Returns: MMAKCGetPrice_Result
| Field | Type | Description |
|---|---|---|
amount2 | BigDecimal | Net amount (excluding VAT) |
amountIncVAT | BigDecimal | Gross amount (including VAT) |
vATAmount | BigDecimal | VAT amount |
AKCGetPricePurchase
Retrieves the calculated purchase price for AKC services on a work order. Used when billing involves a third-party or subcontracted service.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCGetPricePurchase
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
amount2 | BigDecimal | Output: net purchase amount (excluding VAT) |
amountIncVAT | BigDecimal | Output: gross purchase amount (including VAT) |
vATAmount | BigDecimal | Output: purchase VAT amount |
Returns: MMAKCGetPricePurchase_Result
| Field | Type | Description |
|---|---|---|
amount2 | BigDecimal | Net purchase amount (excluding VAT) |
amountIncVAT | BigDecimal | Gross purchase amount (including VAT) |
vATAmount | BigDecimal | Purchase VAT amount |
AkcPostInv
Posts (finalizes) an AKC sales invoice for a work order. Returns the posted invoice number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AkcPostInv
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
invoiceNo | String | Output: the posted invoice number |
webUserID | String | The web user ID performing the posting |
Returns: String -- The posted invoice number.
AkcPostShipment
Posts (finalizes) an AKC shipment for a work order. Returns the posted shipment/invoice number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AkcPostShipment
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
invoiceNo | String | Output: the posted shipment/invoice number |
webUserID | String | The web user ID performing the posting |
Returns: String -- The posted shipment/invoice number.
CommitToAkC
Commits a completed work order to the AKC system for final processing and archival.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CommitToAkC
Parameters:
| Name | Type | Description |
|---|---|---|
documentNo | String | The document number to commit |
Returns: void
AKCIsMobileWorkOrder
Flags a work order as originating from the mobile application.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCIsMobileWorkOrder
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
isMobile | Boolean | Whether the work order is a mobile work order |
Returns: void
AKCManualItemEntry
Adds a manual item entry (material or service line) to an AKC work order with a specified quantity. The unit price is determined by the backend based on the item number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCManualItemEntry
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
itemNo | String | The item number to add |
qty | BigDecimal | The quantity of the item |
Returns: void
AKCManualItemEntryAggredPrice
Adds a manual item entry to an AKC work order with an agreed (overridden) unit price. Used when the price differs from the standard catalog price.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:AKCManualItemEntryAggredPrice
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
itemNo | String | The item number to add |
unitPrice | BigDecimal | The agreed unit price |
Returns: void
DeleteAllAKCSalesLInes
Deletes all AKC sales lines from a work order. Used to reset the invoice lines before recalculation or when the work order details change significantly.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:DeleteAllAKCSalesLInes
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
Returns: void
WARNING
This operation is destructive and removes all existing sales lines. Ensure price recalculation is triggered after calling this method.
Customer & Vehicle
CheckCreateVehicleChassis
Checks for an existing vehicle by chassis number and creates a new vehicle record if one does not exist. Associates the vehicle with a customer. Returns the vehicle code.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CheckCreateVehicleChassis
Parameters:
| Name | Type | Description |
|---|---|---|
chassisNo | String | The vehicle chassis (VIN) number |
customerNo | String | The customer number to associate the vehicle with |
vehicleCode | String | Output: the vehicle code (existing or newly created) |
webUserID | String | The web user ID performing the operation |
Returns: String -- The vehicle code.
GetCustomerData
Retrieves full customer details by customer number, including name, address, contact information, and membership number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetCustomerData
Parameters:
| Name | Type | Description |
|---|---|---|
customerNo | String | The customer number to look up |
customerName | String | Output: the customer's name |
customerAddress | String | Output: the customer's street address |
customerPostCode | String | Output: the customer's postal code |
customerCity | String | Output: the customer's city |
customerEmail | String | Output: the customer's email address |
customerMobilePhoneNo | String | Output: the customer's mobile phone number |
membershipNo | String | Output: the customer's AMZS membership number |
Returns: MMGetCustomerData_Result
| Field | Type | Description |
|---|---|---|
customerName | String | The customer's name |
customerAddress | String | The customer's street address |
customerPostCode | String | The customer's postal code |
customerCity | String | The customer's city |
customerEmail | String | The customer's email address |
customerMobilePhoneNo | String | The customer's mobile phone number |
membershipNo | String | The customer's AMZS membership number |
CreateMembershipCustomer
Creates a new customer record linked to an AMZS membership. Used when a membership holder does not yet have a customer record in the system.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CreateMembershipCustomer
Parameters:
| Name | Type | Description |
|---|---|---|
no | String | Output: the created customer number |
membershipNo | String | The AMZS membership number |
performerCode | String | The performer code creating the customer |
Returns: String -- The newly created customer number.
Fast Invoice
CreateFastInvoiceMobile
Creates and posts a fast (simplified) invoice from the mobile app in a single operation. Used for quick point-of-sale transactions in the field. Returns the posted invoice number.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CreateFastInvoiceMobile
Parameters:
| Name | Type | Description |
|---|---|---|
customerNo | String | The customer number |
itemNo | String | The item number being invoiced |
paymentMethodCode | String | The payment method code (e.g., cash, card) |
customerName | String | The customer's name |
customerAddress | String | The customer's address |
customerPostCode | String | The customer's postal code |
customerCity | String | The customer's city |
postedInvNo | String | Output: the posted invoice number |
performerCode | String | The performer code creating the invoice |
Returns: String -- The posted invoice number.
CalculateFastInvPrice
Calculates the price for a fast invoice before posting. Returns both the net amount (excluding VAT) and gross amount (including VAT).
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:CalculateFastInvPrice
Parameters:
| Name | Type | Description |
|---|---|---|
customerNo | String | The customer number |
itemNo | String | The item number to calculate the price for |
amountNoVAT | BigDecimal | Output: net amount (excluding VAT) |
amountIncVAT | BigDecimal | Output: gross amount (including VAT) |
performerCode | String | The performer code |
Returns: MMCalculateFastInvPrice_Result
| Field | Type | Description |
|---|---|---|
amountNoVAT | BigDecimal | Net amount (excluding VAT) |
amountIncVAT | BigDecimal | Gross amount (including VAT) |
Attachments & Documents
UploadAttachemnt
Uploads a file attachment to a work order. The attachment content must be base64-encoded. Can also be used to upload signature images.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UploadAttachemnt
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderID | String | The work order ID to attach the file to |
userID | String | The user ID performing the upload |
attachment | String | The file content, base64-encoded |
fileName | String | The file name including extension |
signature | Boolean | Whether this attachment is a signature image |
Returns: void
WARNING
The attachment parameter must contain base64-encoded binary data. Ensure the encoded string does not exceed the SOAP message size limit configured on the server. Note the typo in the method name (Attachemnt) -- this matches the backend service definition.
UploadAttachemntInv
Uploads a file attachment to an invoice document. Functions identically to UploadAttachemnt but targets invoice documents instead of work orders.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:UploadAttachemntInv
Parameters:
| Name | Type | Description |
|---|---|---|
docNo | String | The invoice document number to attach the file to |
userID | String | The user ID performing the upload |
attachment | String | The file content, base64-encoded |
fileName | String | The file name including extension |
signature | Boolean | Whether this attachment is a signature image |
Returns: void
WARNING
The attachment parameter must contain base64-encoded binary data. Note the typo in the method name (Attachemnt) -- this matches the backend service definition.
SetSignature
Sets the signature status on a work order. Used to indicate whether a customer signature has been captured.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:SetSignature
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
signature | Integer | The signature status code |
Returns: void
GetSignature
Retrieves the signature status or data for a work order.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetSignature
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
signature | String | Output: the signature data or status |
Returns: String -- The signature data or status string.
GetDMSImage
Retrieves a DMS (Document Management System) image associated with a work order as a base64-encoded string.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:GetDMSImage
Parameters:
| Name | Type | Description |
|---|---|---|
workOrderNo | String | The work order number |
base64StringText | String | Output: the image as a base64-encoded string |
Returns: String -- The base64-encoded image data.
DMSServiceInit
Initializes the DMS (Document Management System) service connection. Must be called before performing DMS-related operations.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:DMSServiceInit
Parameters: None
Returns: void
Communication
SMSSend
Sends an SMS notification related to a document (e.g., work order completion notification to the customer). The SMS content and recipient are determined server-side based on the document.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:SMSSend
Parameters:
| Name | Type | Description |
|---|---|---|
docNo | String | The document number triggering the SMS |
Returns: void
SendMailAkcWorkoOrder
Sends an email with AKC work order details to the specified email address.
SOAP Action: urn:microsoft-dynamics-schemas/codeunit/AMZSMobileManagement:SendMailAkcWorkoOrder
Parameters:
| Name | Type | Description |
|---|---|---|
docNo | String | The work order document number |
email | String | The recipient email address |
webUserID | String | The web user ID sending the email |
Returns: void
INFO
Note the typo in the method name (WorkoOrder) -- this matches the backend service definition and must be used as-is in the SOAP action.