DX STF Client API

GetSettlementById

Settlement Requests

Settlement

The following routes are available for this service:
GET	/api/settlement/{Id}	Get specific Settlement by Settlement Id


// @DataContract
export class DocumentIdentification
{
    // @DataMember(Name="identifier")
    public identifier: string;

    // @DataMember(Name="type")
    public type: string;

    // @DataMember(Name="creationDateAndTime")
    public creationDateAndTime: string;

    public constructor(init?: Partial<DocumentIdentification>) { (Object as any).assign(this, init); }
}

// @DataContract
export class Identifier
{
    // @DataMember(Name="authority")
    public authority: string;

    // @DataMember(Name="text")
    public text: string;

    public constructor(init?: Partial<Identifier>) { (Object as any).assign(this, init); }
}

// @DataContract
export class ContactInformation
{

    public constructor(init?: Partial<ContactInformation>) { (Object as any).assign(this, init); }
}

// @DataContract
export class Partner
{
    // @DataMember(Name="identifier")
    public identifier: Identifier;

    // @DataMember(Name="contactInformation")
    public contactInformation: ContactInformation[] = [];

    public constructor(init?: Partial<Partner>) { (Object as any).assign(this, init); }
}

// @DataContract
export class Header
{
    // @DataMember(Name="documentIdentification")
    public documentIdentification: DocumentIdentification;

    // @DataMember(Name="sender")
    public sender: Partner;

    // @DataMember(Name="receiver")
    public receiver: Partner;

    public constructor(init?: Partial<Header>) { (Object as any).assign(this, init); }
}

export enum DocumentAction
{
    ADD = 'ADD',
    CHANGE_BY_REFRESH = 'CHANGE_BY_REFRESH',
    DELETE = 'DELETE',
    REJECTED = 'REJECTED',
}

export enum DocumentStatus
{
    ADDITIONAL_TRANSMISSION = 'ADDITIONAL_TRANSMISSION',
    COPY = 'COPY',
    ORIGINAL = 'ORIGINAL',
}

export class AvpList
{
    public code: string;
    public value: string;

    public constructor(init?: Partial<AvpList>) { (Object as any).assign(this, init); }
}

export class BaseDocument
{
    public currencyCode: string;
    public creationDateTime: string;
    public documentActionCode: DocumentAction;
    public documentStatusCode: DocumentStatus;
    public documentStructureVersion: string;
    public lastUpdateDateTime?: string;
    public revisionNumber?: number;
    public avpList: AvpList[] = [];

    public constructor(init?: Partial<BaseDocument>) { (Object as any).assign(this, init); }
}

export class PaymentMethod
{
    public automatedClearingHousePaymentFormat: string;
    public paymentMethodCode: string;
    public paymentMethodIdentification: string;

    public constructor(init?: Partial<PaymentMethod>) { (Object as any).assign(this, init); }
}

export class Ecom_PartyIdentificationType
{
    public gln: string;
    public name: string;
    public additionalPartyIdentification: AvpList[] = [];

    public constructor(init?: Partial<Ecom_PartyIdentificationType>) { (Object as any).assign(this, init); }
}

export class CommunicationChannel
{
    public communicationChannelCode: string;
    public communicationChannelName: string;
    public communicationValue: string;

    public constructor(init?: Partial<CommunicationChannel>) { (Object as any).assign(this, init); }
}

export class Contact
{
    public contactTypeCode: string;
    public personName: string;
    public departmentName: string;
    public jobTitle: string;
    public responsibility: string;
    public communicationChannel: CommunicationChannel[] = [];

    public constructor(init?: Partial<Contact>) { (Object as any).assign(this, init); }
}

export class Address
{
    public streetAddressOne: string;
    public streetAddressTwo: string;
    public streetAddressThree: string;
    public city: string;
    public postalCode: string;
    public provinceCode: string;
    public countryCode: string;

    public constructor(init?: Partial<Address>) { (Object as any).assign(this, init); }
}

export class FinancialRoutingNumber
{
    public number: string;
    public numberTypeCode: string;

    public constructor(init?: Partial<FinancialRoutingNumber>) { (Object as any).assign(this, init); }
}

export class FinancialAccount
{
    public number: string;
    public numberTypeCode: string;
    public name: string;

    public constructor(init?: Partial<FinancialAccount>) { (Object as any).assign(this, init); }
}

export class FinancialInstitutionInformation
{
    public financialInstitutionBranchName: string;
    public financialInstitutionName: string;
    public financialRoutingNumber: FinancialRoutingNumber;
    public financialAccount: FinancialAccount;
    public swiftCode: string;
    public exportersCode: string;

    public constructor(init?: Partial<FinancialInstitutionInformation>) { (Object as any).assign(this, init); }
}

export class TransactionalParty extends Ecom_PartyIdentificationType
{
    public contact: Contact[] = [];
    public address: Address;
    public communicationChannel: AvpList[] = [];
    public financialInstitutionInformation: FinancialInstitutionInformation;
    public dutyFeeTaxRegistration: string;
    public entityIdentification: string;

    public constructor(init?: Partial<TransactionalParty>) { super(init); (Object as any).assign(this, init); }
}

export class DocumentReference
{
    public creationDateTime?: string;
    public revisionNumber?: number;
    public lineItemNumber?: number;
    public entityIdentification: string;

    public constructor(init?: Partial<DocumentReference>) { (Object as any).assign(this, init); }
}

export class TransactionalReference extends DocumentReference
{
    public transactionalReferenceTypeCode: string;

    public constructor(init?: Partial<TransactionalReference>) { super(init); (Object as any).assign(this, init); }
}

export class SettlementAdjustment
{
    public adjustmentAmount?: number;
    public financialAdjusmentReasonPartyRoleCode: string;
    public financialAdjustmentReasonCode: string;
    public transactionalReference: TransactionalReference;

    public constructor(init?: Partial<SettlementAdjustment>) { (Object as any).assign(this, init); }
}

export class ContentOwner
{
    public gln: string;
    public additionalPartyIdentification: AvpList[] = [];

    public constructor(init?: Partial<ContentOwner>) { (Object as any).assign(this, init); }
}

export class InvoiceDocumentReference extends DocumentReference
{
    public invoiceTypeCode: string;
    public contentOwner: ContentOwner;

    public constructor(init?: Partial<InvoiceDocumentReference>) { super(init); (Object as any).assign(this, init); }
}

export class Ecom_PartyIdentification
{
    public additionalPartyIdentification: AvpList[] = [];
    public gln: string;

    public constructor(init?: Partial<Ecom_PartyIdentification>) { (Object as any).assign(this, init); }
}

export class SettlementParty extends Ecom_PartyIdentification
{
    public partyRoleCode: string;

    public constructor(init?: Partial<SettlementParty>) { super(init); (Object as any).assign(this, init); }
}

export class SettlementLineItem
{
    public amountPaid?: number;
    public lineItemNumber: number;
    public originalAmount?: number;
    public settlementAdjustment: SettlementAdjustment[] = [];
    public avpList: AvpList;
    public debitCreditAdvice: DocumentReference;
    public invoice: InvoiceDocumentReference;
    public requestForPayment: DocumentReference;
    public settlementParty: SettlementParty[] = [];

    public constructor(init?: Partial<SettlementLineItem>) { (Object as any).assign(this, init); }
}

export class SettlementExtensionLineItem
{
    public number: number;
    public documentType: string;
    public documentNumber: string;
    public itemText: string;

    public constructor(init?: Partial<SettlementExtensionLineItem>) { (Object as any).assign(this, init); }
}

export class AdjustmentAndDiscountSummary
{
    public amountTotal: number;
    public amountNett: number;
    public amountVat: number;
    public reasonMessage: string;

    public constructor(init?: Partial<AdjustmentAndDiscountSummary>) { (Object as any).assign(this, init); }
}

export class TotalAmountSplit
{
    public amountTotal: number;
    public amountNett: number;
    public amountVat: number;

    public constructor(init?: Partial<TotalAmountSplit>) { (Object as any).assign(this, init); }
}

export class SettlementExtension
{
    public settlementExtensionLineItem: SettlementExtensionLineItem[] = [];
    public adjustmentAndDiscountSummary: AdjustmentAndDiscountSummary[] = [];
    public totalAmountSplit: TotalAmountSplit;

    public constructor(init?: Partial<SettlementExtension>) { (Object as any).assign(this, init); }
}

export class Settlement extends BaseDocument
{
    public batchIdentification: string;
    public paymentEffectiveDate: string;
    public settlementCurrency: string;
    public settlementHandlingTypeCode: string;
    public totalAmount?: number;
    public paymentMethod: PaymentMethod;
    public payee: TransactionalParty;
    public payer: TransactionalParty;
    public remitTo: TransactionalParty;
    public settlementIdentification: string;
    public settlementLineItem: SettlementLineItem[] = [];
    public extension: SettlementExtension;

    public constructor(init?: Partial<Settlement>) { super(init); (Object as any).assign(this, init); }
}

export class SettlementMessage
{
    public header: Header;
    public settlement: Settlement;

    public constructor(init?: Partial<SettlementMessage>) { (Object as any).assign(this, init); }
}

/** @description Settlement */
// @Api(Description="Settlement")
// @ApiResponse(Description="Settlement data", IsDefaultResponse=true, StatusCode=200)
// @ApiResponse(Description="No Content", ResponseType="typeof(ServiceStack.IReturnVoid)", StatusCode=204)
// @ApiResponse(Description="Specified argument was out of the range of valid values.", ResponseType="typeof(System.ArgumentOutOfRangeException)", StatusCode=400)
export class GetSettlementById implements IGetDocumentById
{
    /** @description Settlement ID or Token */
    // @ApiMember(Description="Settlement ID or Token", ExcludeInSchema=true, ParameterType="path")
    public id: string;

    public constructor(init?: Partial<GetSettlementById>) { (Object as any).assign(this, init); }
}

TypeScript GetSettlementById DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /api/settlement/{Id} HTTP/1.1 
Host: stf-api-uat.data-xchange.co.za 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<SettlementMessage xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DX.STF.Models.Dto.GS1">
  <Header>
    <documentIdentification>
      <creationDateAndTime>0001-01-01T00:00:00</creationDateAndTime>
      <identifier>String</identifier>
      <type>String</type>
    </documentIdentification>
    <receiver>
      <contactInformation>
        <ContactInformation />
      </contactInformation>
      <identifier>
        <authority>String</authority>
        <text>String</text>
      </identifier>
    </receiver>
    <sender>
      <contactInformation>
        <ContactInformation />
      </contactInformation>
      <identifier>
        <authority>String</authority>
        <text>String</text>
      </identifier>
    </sender>
  </Header>
  <Settlement>
    <AvpList>
      <AvpList>
        <Code>String</Code>
        <Value>String</Value>
      </AvpList>
    </AvpList>
    <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
    <CurrencyCode>String</CurrencyCode>
    <DocumentActionCode>ADD</DocumentActionCode>
    <DocumentStatusCode>ADDITIONAL_TRANSMISSION</DocumentStatusCode>
    <DocumentStructureVersion>String</DocumentStructureVersion>
    <LastUpdateDateTime>0001-01-01T00:00:00</LastUpdateDateTime>
    <RevisionNumber>0</RevisionNumber>
    <BatchIdentification>String</BatchIdentification>
    <Extension>
      <AdjustmentAndDiscountSummary>
        <AdjustmentAndDiscountSummary>
          <AmountNett>0</AmountNett>
          <AmountTotal>0</AmountTotal>
          <AmountVat>0</AmountVat>
          <ReasonMessage>String</ReasonMessage>
        </AdjustmentAndDiscountSummary>
      </AdjustmentAndDiscountSummary>
      <SettlementExtensionLineItem>
        <SettlementExtensionLineItem>
          <DocumentNumber>String</DocumentNumber>
          <DocumentType>String</DocumentType>
          <ItemText>String</ItemText>
          <Number>0</Number>
        </SettlementExtensionLineItem>
      </SettlementExtensionLineItem>
      <TotalAmountSplit>
        <AmountNett>0</AmountNett>
        <AmountTotal>0</AmountTotal>
        <AmountVat>0</AmountVat>
      </TotalAmountSplit>
    </Extension>
    <Payee>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Payee>
    <Payer>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Payer>
    <PaymentEffectiveDate>0001-01-01T00:00:00</PaymentEffectiveDate>
    <PaymentMethod>
      <AutomatedClearingHousePaymentFormat>String</AutomatedClearingHousePaymentFormat>
      <PaymentMethodCode>String</PaymentMethodCode>
      <PaymentMethodIdentification>String</PaymentMethodIdentification>
    </PaymentMethod>
    <RemitTo>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </RemitTo>
    <SettlementCurrency>String</SettlementCurrency>
    <SettlementHandlingTypeCode>String</SettlementHandlingTypeCode>
    <SettlementLineItem>
      <SettlementLineItem>
        <AmountPaid>0</AmountPaid>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
        <DebitCreditAdvice>
          <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
          <EntityIdentification>String</EntityIdentification>
          <LineItemNumber>0</LineItemNumber>
          <RevisionNumber>0</RevisionNumber>
        </DebitCreditAdvice>
        <Invoice>
          <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
          <EntityIdentification>String</EntityIdentification>
          <LineItemNumber>0</LineItemNumber>
          <RevisionNumber>0</RevisionNumber>
          <ContentOwner>
            <AdditionalPartyIdentification>
              <AvpList>
                <Code>String</Code>
                <Value>String</Value>
              </AvpList>
            </AdditionalPartyIdentification>
            <Gln>String</Gln>
          </ContentOwner>
          <InvoiceTypeCode>String</InvoiceTypeCode>
        </Invoice>
        <LineItemNumber>0</LineItemNumber>
        <OriginalAmount>0</OriginalAmount>
        <RequestForPayment>
          <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
          <EntityIdentification>String</EntityIdentification>
          <LineItemNumber>0</LineItemNumber>
          <RevisionNumber>0</RevisionNumber>
        </RequestForPayment>
        <SettlementAdjustment>
          <SettlementAdjustment>
            <AdjustmentAmount>0</AdjustmentAmount>
            <FinancialAdjusmentReasonPartyRoleCode>String</FinancialAdjusmentReasonPartyRoleCode>
            <FinancialAdjustmentReasonCode>String</FinancialAdjustmentReasonCode>
            <TransactionalReference>
              <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
              <EntityIdentification>String</EntityIdentification>
              <LineItemNumber>0</LineItemNumber>
              <RevisionNumber>0</RevisionNumber>
              <TransactionalReferenceTypeCode>String</TransactionalReferenceTypeCode>
            </TransactionalReference>
          </SettlementAdjustment>
        </SettlementAdjustment>
        <SettlementParty>
          <SettlementParty>
            <AdditionalPartyIdentification>
              <AvpList>
                <Code>String</Code>
                <Value>String</Value>
              </AvpList>
            </AdditionalPartyIdentification>
            <Gln>String</Gln>
            <PartyRoleCode>String</PartyRoleCode>
          </SettlementParty>
        </SettlementParty>
      </SettlementLineItem>
    </SettlementLineItem>
    <TotalAmount>0</TotalAmount>
    <settlementIdentification>String</settlementIdentification>
  </Settlement>
</SettlementMessage>