SAOP Customers and Orders API (from Swagger UI snippets)
=======================================================

Content type:
- application/xml (request and response)

--------------------------------------------------
1) GET /api/Customers/{Code}
--------------------------------------------------

Description:
- Returns a single Customer by Code.

Path parameters:
- Code (string) – required.

Response (Status 200, application/xml):

<?xml version="1.0"?>
<Customer>
  <Code>string</Code>
  <Name>string</Name>
  <Address>string</Address>
  <Country>string</Country>
  <PostalCode>string</PostalCode>
  <City>string</City>
  <ActivityCode>string</ActivityCode>
  <RegistrationNumber>string</RegistrationNumber>
  <WebSiteURL>string</WebSiteURL>
  <SubjectToVAT>string</SubjectToVAT>
  <TaxNumber>string</TaxNumber>
  <ExpirationDays>1</ExpirationDays>
  <RebatePercent>1.1</RebatePercent>
  <Currency>string</Currency>
  <PriceList>string</PriceList>
  <Notes>string</Notes>
  <Usage>string</Usage>
  <FirstGroupCode>string</FirstGroupCode>
  <SecondGroupCode>string</SecondGroupCode>
  <CustomerPayerCode>string</CustomerPayerCode>
  <EANCustomerCode>string</EANCustomerCode>
  <BranchOfficeName>string</BranchOfficeName>
  <TaxAccounting>string</TaxAccounting>
  <SuggestFirstFreeCode>1</SuggestFirstFreeCode>
  <SalesClerkID>string</SalesClerkID>
  <PurchaseClerkID>string</PurchaseClerkID>
  <Name1>string</Name1>
  <Name2>string</Name2>
  <Name3>string</Name3>
  <CustomerStatus>true</CustomerStatus>
  <Name1Transfer>string</Name1Transfer>
  <Name2Transfer>string</Name2Transfer>
  <Name3Transfer>string</Name3Transfer>
  <CustomerType>string</CustomerType>
  <Region>string</Region>
  <EntityType>string</EntityType>
  <Street>string</Street>
  <HomeNumber>string</HomeNumber>
  <CustomerCodeGroup>string</CustomerCodeGroup>
  <SupplierExpirationDays>1</SupplierExpirationDays>
  <ExpirationDaysGroupID>string</ExpirationDaysGroupID>
  <DiscountGroupID>string</DiscountGroupID>
  <SupplierDiscountGroupID>string</SupplierDiscountGroupID>
  <LanguageID>string</LanguageID>
  <SupplierPriceList>string</SupplierPriceList>
  <AccountingBookGroupID>string</AccountingBookGroupID>
  <SupplierAccountingBookGroupID>string</SupplierAccountingBookGroupID>
  <DiscountPriceList>string</DiscountPriceList>
  <OrderBookID>string</OrderBookID>
  <CustomerLocations>
    <CustomerLocation>
      <LocationID>string</LocationID>
      <DefaultLocation>true</DefaultLocation>
    </CustomerLocation>
  </CustomerLocations>
  <Defaulter>true</Defaulter>
  <UpfrontPayment>true</UpfrontPayment>
  <ShippingMethodId>string</ShippingMethodId>
  <SearchTag>string</SearchTag>
  <RecordInserted>1970-01-01T00:00:00.001Z</RecordInserted>
  <RecordInsertedBy>string</RecordInsertedBy>
  <RecordLastModified>1970-01-01T00:00:00.001Z</RecordLastModified>
  <RecordLastModifiedBy>string</RecordLastModifiedBy>
  <InstitutionalSector>string</InstitutionalSector>
  <NRInstitutionalSector>string</NRInstitutionalSector>
  <CustomerRating>string</CustomerRating>
  <InvoicingMethod>string</InvoicingMethod>
  <AlertMessage>string</AlertMessage>
  <AlertMinimalAmount>1.1</AlertMinimalAmount>
  <BlockingUpMessage>string</BlockingUpMessage>
  <BlockingUpAmount>1.1</BlockingUpAmount>
  <AlertNumberOfDays>1</AlertNumberOfDays>
  <BlockingUpNumberOfDays>1</BlockingUpNumberOfDays>
  <SIDReporting>true</SIDReporting>
  <SIDLimitAmount>1.1</SIDLimitAmount>
  <AnalyticId>string</AnalyticId>
  <ParityCode>string</ParityCode>
  <ExternalID>string</ExternalID>
  <FullName>string</FullName>
</Customer>

Key fields for analytics context:
- Code : customer identifier.
- AnalyticId : links customer to a generic Analytic (from analytics APIs).
- Address / PostalCode / City / Country / Street / HomeNumber : routing-related location data.

--------------------------------------------------
2) GET /api/Customers/GetCustomers
--------------------------------------------------

Description:
- Returns customers in bulk with optional search/paging. Inline model is the same structure as a single Customer but without the outer <Customer> tag.

Query parameters:
- Not fully captured in SAOP_DOCS.txt, but Swagger UI shows this as a list endpoint with typical searchQuery fields (analyticId, active, requestType, page, pageSize, recordDtModifiedFrom).

Response (Status 200, application/xml):

<?xml version="1.0"?>
<InlineModel>
  <Code>string</Code>
  <Name>string</Name>
  <Address>string</Address>
  <Country>string</Country>
  <PostalCode>string</PostalCode>
  <City>string</City>
  <ActivityCode>string</ActivityCode>
  <RegistrationNumber>string</RegistrationNumber>
  <WebSiteURL>string</WebSiteURL>
  <SubjectToVAT>string</SubjectToVAT>
  <TaxNumber>string</TaxNumber>
  <ExpirationDays>1</ExpirationDays>
  <RebatePercent>1.1</RebatePercent>
  <Currency>string</Currency>
  <PriceList>string</PriceList>
  <Notes>string</Notes>
  <Usage>string</Usage>
  <FirstGroupCode>string</FirstGroupCode>
  <SecondGroupCode>string</SecondGroupCode>
  <CustomerPayerCode>string</CustomerPayerCode>
  <EANCustomerCode>string</EANCustomerCode>
  <BranchOfficeName>string</BranchOfficeName>
  <TaxAccounting>string</TaxAccounting>
  <SuggestFirstFreeCode>1</SuggestFirstFreeCode>
  <SalesClerkID>string</SalesClerkID>
  <PurchaseClerkID>string</PurchaseClerkID>
  <Name1>string</Name1>
  <Name2>string</Name2>
  <Name3>string</Name3>
  <CustomerStatus>true</CustomerStatus>
  <Name1Transfer>string</Name1Transfer>
  <Name2Transfer>string</Name2Transfer>
  <Name3Transfer>string</Name3Transfer>
  <CustomerType>string</CustomerType>
  <Region>string</Region>
  <EntityType>string</EntityType>
  <Street>string</Street>
  <HomeNumber>string</HomeNumber>
  <CustomerCodeGroup>string</CustomerCodeGroup>
  <SupplierExpirationDays>1</SupplierExpirationDays>
  <ExpirationDaysGroupID>string</ExpirationDaysGroupID>
  <DiscountGroupID>string</DiscountGroupID>
  <SupplierDiscountGroupID>string</SupplierDiscountGroupID>
  <LanguageID>string</LanguageID>
  <SupplierPriceList>string</SupplierPriceList>
  <AccountingBookGroupID>string</AccountingBookGroupID>
  <SupplierAccountingBookGroupID>string</SupplierAccountingBookGroupID>
  <DiscountPriceList>string</DiscountPriceList>
  <OrderBookID>string</OrderBookID>
  <CustomerLocations>
    <CustomerLocation>
      <LocationID>string</LocationID>
      <DefaultLocation>true</DefaultLocation>
    </CustomerLocation>
  </CustomerLocations>
  <Defaulter>true</Defaulter>
  <UpfrontPayment>true</UpfrontPayment>
  <ShippingMethodId>string</ShippingMethodId>
  <SearchTag>string</SearchTag>
  <RecordInserted>1970-01-01T00:00:00.001Z</RecordInserted>
  <RecordInsertedBy>string</RecordInsertedBy>
  <RecordLastModified>1970-01-01T00:00:00.001Z</RecordLastModified>
  <RecordLastModifiedBy>string</RecordLastModifiedBy>
  <InstitutionalSector>string</InstitutionalSector>
  <NRInstitutionalSector>string</NRInstitutionalSector>
  <CustomerRating>string</CustomerRating>
  <InvoicingMethod>string</InvoicingMethod>
  <AlertMessage>string</AlertMessage>
  <AlertMinimalAmount>1.1</AlertMinimalAmount>
  <BlockingUpMessage>string</BlockingUpMessage>
  <BlockingUpAmount>1.1</BlockingUpAmount>
  <AlertNumberOfDays>1</AlertNumberOfDays>
  <BlockingUpNumberOfDays>1</BlockingUpNumberOfDays>
  <SIDReporting>true</SIDReporting>
  <SIDLimitAmount>1.1</SIDLimitAmount>
  <AnalyticId>string</AnalyticId>
  <ParityCode>string</ParityCode>
  <ExternalID>string</ExternalID>
  <FullName>string</FullName>
</InlineModel>

Notes:
- This is the primary endpoint Rams can use to pull customer master data in bulk.
- For routing, the important fields are Code, AnalyticId and address/location fields.

--------------------------------------------------
3) GET /api/Order/GetOrder/{orderYear}/{orderBook}/{orderNumber}
--------------------------------------------------

Description:
- Returns full order header details, including analytics dimension fields and embedded customer/address info.

Path parameters:
- orderYear (integer) – required.
- orderBook (string) – required.
- orderNumber (integer) – required.

Response (Status 200, application/xml):

<?xml version="1.0"?>
<OrderHeaderDetail>
  <OrderYear>1</OrderYear>
  <OrderBook>string</OrderBook>
  <OrderNumber>1</OrderNumber>
  <InvoiceBook>string</InvoiceBook>
  <WarehouseId>string</WarehouseId>
  <CustomerId>string</CustomerId>
  <CustomerTitle1>string</CustomerTitle1>
  <CustomerTitle2>string</CustomerTitle2>
  <CustomerTitle3>string</CustomerTitle3>
  <CustomerAddress>string</CustomerAddress>
  <CustomerHouseNo>string</CustomerHouseNo>
  <CustomerPostalCode>string</CustomerPostalCode>
  <CustomerCity>string</CustomerCity>
  <CustomerCountry>string</CustomerCountry>
  <CustomerTaxNumber>string</CustomerTaxNumber>
  <CustomerShopID>string</CustomerShopID>
  <CustomerPayerId>string</CustomerPayerId>
  <PayerTitle1>string</PayerTitle1>
  <PayerTitle2>string</PayerTitle2>
  <PayerTitle3>string</PayerTitle3>
  <PayerAddress>string</PayerAddress>
  <PayerHouseNo>string</PayerHouseNo>
  <PayerPostalCode>string</PayerPostalCode>
  <PayerCity>string</PayerCity>
  <PayerCountry>string</PayerCountry>
  <PayerTaxNumber>string</PayerTaxNumber>
  <OrderDate>1970-01-01T00:00:00.001Z</OrderDate>
  <ConfirmationDate>1970-01-01T00:00:00.001Z</ConfirmationDate>
  <CustomerConfirmationDate>1970-01-01T00:00:00.001Z</CustomerConfirmationDate>
  <OrderReference>string</OrderReference>
  <QuotationNumber>string</QuotationNumber>
  <DeliveryAddress>string</DeliveryAddress>
  <DeliveryMethod>string</DeliveryMethod>
  <CurrencyId>string</CurrencyId>
  <PriceListId>string</PriceListId>
  <CostCenterId>string</CostCenterId>
  <CostUnitId>string</CostUnitId>
  <ClerkId>string</ClerkId>
  <WorkOrderId>string</WorkOrderId>
  <AnalyticId>string</AnalyticId>
  <AccountingBookGroupId>string</AccountingBookGroupId>
  <CustomerClerkID>string</CustomerClerkID>
  <CustomerClerkName>string</CustomerClerkName>
  <RebatePercentage>1.1</RebatePercentage>
  <RebatePercentage2>1.1</RebatePercentage2>
  <RebatePercentage3>1.1</RebatePercentage3>
  <RebatePercentage4>1.1</RebatePercentage4>
  <RebatePercentage5>1.1</RebatePercentage5>
  <RebateAmountDocument>1.1</RebateAmountDocument>
  <DocumentSalesType>string</DocumentSalesType>
  <DiscountGroupId>string</DiscountGroupId>
  <Comment>string</Comment>
  <ParityCode>string</ParityCode>
  <ParityPlace>string</ParityPlace>
  <AttachmentID>string</AttachmentID>
  <AnnexID>string</AnnexID>
  <FolderID>string</FolderID>
  <DocumentHeaderDescription>string</DocumentHeaderDescription>
  <DocumentFooterDescription>string</DocumentFooterDescription>
  <DeliveryDate>1970-01-01T00:00:00.001Z</DeliveryDate>
  <CustomerDeliveryDate>1970-01-01T00:00:00.001Z</CustomerDeliveryDate>
  <OrderStatus>string</OrderStatus>
  <OrderDetailsStatus>string</OrderDetailsStatus>
  <GrossAmount>1.1</GrossAmount>
  <DiscountAmount>1.1</DiscountAmount>
  <RebateAmount>1.1</RebateAmount>
  <NetAmount>1.1</NetAmount>
  <VATAmount>1.1</VATAmount>
  <PaymentAmount>1.1</PaymentAmount>
  <ReferenceDeliveryNote>string</ReferenceDeliveryNote>
  <ReferenceWarehouseDocument>string</ReferenceWarehouseDocument>
  <ReferenceBill>string</ReferenceBill>
  <ReferenceInvoice>string</ReferenceInvoice>
  <ReferenceAdvancePayment>string</ReferenceAdvancePayment>
  <ReferenceServiceInvoice>string</ReferenceServiceInvoice>
  <Consigment>true</Consigment>
  <ConsigmentWarehouseID>string</ConsigmentWarehouseID>
  <ExchangeRateDate>1970-01-01T00:00:00.001Z</ExchangeRateDate>
  <ExchangeRate>1.1</ExchangeRate>
  <LanguageID>string</LanguageID>
  <VATCalculated>string</VATCalculated>
  <VATInvoiceType>string</VATInvoiceType>
  <ExciseDuty>true</ExciseDuty>
  <DiscountAmountType>true</DiscountAmountType>
  <DiscountCalculationMethod>true</DiscountCalculationMethod>
  <PaymentPeriod>1</PaymentPeriod>
  <OrderType>string</OrderType>
  <QuotationYear>1</QuotationYear>
  <LocationID>string</LocationID>
  <CarrierID>string</CarrierID>
  <VehicleRegistrationNumber>string</VehicleRegistrationNumber>
  <TrailerRegistrationNumber>string</TrailerRegistrationNumber>
  <Driver>string</Driver>
  <UnloadingTime>1970-01-01T00:00:00.001Z</UnloadingTime>
  <UnloadingNote>string</UnloadingNote>
  <PaymentPurposeCode>string</PaymentPurposeCode>
  <CashPayment>true</CashPayment>
  <CashierID>string</CashierID>
  <PaymentTypeID>string</PaymentTypeID>
  <CustomerClerkSEQ>string</CustomerClerkSEQ>
  <InsertedBy>string</InsertedBy>
  <InsertedTime>1970-01-01T00:00:00.001Z</InsertedTime>
  <ModifiedBy>string</ModifiedBy>
  <ModifiedTime>1970-01-01T00:00:00.001Z</ModifiedTime>
  <Analytics_AN1_ID>string</Analytics_AN1_ID>
  <Analytics_AN2_ID>string</Analytics_AN2_ID>
  <Analytics_AN3_ID>string</Analytics_AN3_ID>
  <DeliveryPlace>string</DeliveryPlace>
  <DocumentDeliveryTitle1>string</DocumentDeliveryTitle1>
  <DocumentDeliveryTitle2>string</DocumentDeliveryTitle2>
  <DocumentDeliveryTitle3>string</DocumentDeliveryTitle3>
  <DocumentDeliveryAddress>string</DocumentDeliveryAddress>
  <DocumentDeliveryHouseNo>string</DocumentDeliveryHouseNo>
  <DocumentDeliveryPostalCode>string</DocumentDeliveryPostalCode>
  <DocumentDeliveryCity>string</DocumentDeliveryCity>
  <DocumentDeliveryCountry>string</DocumentDeliveryCountry>
  <!-- ... remaining fields not fully captured in snippet ... -->
</OrderHeaderDetail>

Key fields for analytics and routing:
- CustomerId : links to customer master (Code/ID, depending on model).
- AnalyticId : generic analytic reference.
- Analytics_AN1_ID, Analytics_AN2_ID, Analytics_AN3_ID : references to Analytic1/2/3 dimensions.
- DeliveryAddress, DocumentDeliveryAddress, DeliveryPlace + city/postal/country : potential delivery locations for routing.

Open questions / TODO:
- Identify list/search endpoint for Orders (e.g. to query by Analytics_AN1_ID / date range) if needed in later phases.
- Confirm whether CustomerId matches Customers.Code or another key (likely the same, but not guaranteed by docs alone).