Overview

AMZS Mobilna Blagajna communicates with Microsoft Dynamics NAV 9.0 via SOAP web services. This documentation catalogs every SOAP method the mobile app calls, including parameters, return types, and data structures.

Service Architecture

┌─────────────────────┐        SOAP/HTTP (NTLM)        ┌──────────────────────────┐
│  Android App        │ ──────────────────────────────► │  Dynamics NAV 9.0        │
│  (kSOAP2 + easyWSP) │                                 │                          │
│                     │                                 │  Codeunit Services (2)   │
│  NtlmTransport      │                                 │  Page Services (21)      │
└─────────────────────┘                                 └──────────────────────────┘

Base URLs

Environment	Base URL
Production	http://nav.amzs.si:7047/DynamicsNAV90-WSC/WS
Staging	http://navdev.amzs.si:7047/dev9amzs/WS

All service URLs are constructed as:

{BASE_URL}/{COMPANY_NAME}/{SERVICE_TYPE}/{SERVICE_NAME}

Where:

• COMPANY_NAME is URL-encoded (e.g., AMZS%20d.d. or ČLANSKA%20BAZA)
• SERVICE_TYPE is either Codeunit or Page
• SERVICE_NAME is the NAV service name

Companies

Company	URL-encoded	Used For
AMZS d.d.	AMZS%20d.d.	All services except membership
ČLANSKA BAZA	%C4%8CLANSKA%20BAZA	MobileContactMembership only

Service Types

Codeunit Services (RPC-style)

Custom business logic methods exposed as SOAP operations. Each method has its own SOAP action and parameter set.

Service	Endpoint	Methods
AMZSMobileManagement	/Codeunit/AMZSMobileManagement	47
AMZSDD_WebSharedCodeUnits	/Codeunit/AMZSDD_WebSharedCodeUnits	60

Page Services (CRUD)

Standard NAV page services exposing entity data with uniform CRUD operations.

Each page service provides up to 10 standard methods:

Method	Description
Read	Read a single record by primary key
ReadMultiple	Read multiple records with filters
ReadByRecId	Read by internal record ID
Create	Create a new record
CreateMultiple	Create multiple records
Update	Update an existing record
UpdateMultiple	Update multiple records
Delete	Delete a record
GetRecIdFromKey	Get internal record ID from key
IsUpdated	Check if record has been updated

See Page Services for the complete list.

SOAP Envelope Format

All requests use SOAP 1.1 with .NET style envelopes:

<?xml version="1.0" encoding="UTF-8"?>
<v:Envelope xmlns:v="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:d="http://www.w3.org/2001/XMLSchema">
  <v:Body>
    <MethodName xmlns="urn:microsoft-dynamics-schemas/codeunit/ServiceName">
      <paramName>value</paramName>
    </MethodName>
  </v:Body>
</v:Envelope>

Transport Configuration

Setting	Value
SOAP Version	1.1
Timeout	20,000 ms
Authentication	NTLM
dotNet mode	true
implicitTypes	true

Type Mapping

NAV Type	Java Type	SOAP Serialization
Text / Code	String	Direct
Integer	Integer	Direct
Decimal	BigDecimal	Serialized as String
Boolean	Boolean	Direct
DateTime	java.util.Date	ISO 8601
Option (Enum)	Custom Enum class	Integer value
Base64 (Binary)	String	Base64-encoded