| POST | /api/transactionalParty | Add new transactional party |
|---|
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*
import com.google.gson.annotations.*
import com.google.gson.reflect.*
/**
* Transactional Party
*/
@Api(Description="Transactional Party")
@ApiResponse(Description="Add Transactional Party request received", IsDefaultResponse=true, StatusCode=202)
// @ApiResponse(Description="Transactional Party not accepted, Confirm Sender GLN", ResponseType=UnauthorizedAccessException::class, StatusCode=403)
open class AddTransactionalParty
{
/**
* Transactional Party model containing all of the transactional party data
*/
@ApiMember(Description="Transactional Party model containing all of the transactional party data", ParameterType="model")
open var transactionalParty:TransactionalPartyMessage? = null
}
open class TransactionalPartyMessage
{
open var header:Header? = null
open var transactionalParty:TransactionalPartyMessageType? = null
}
@DataContract
open class Header
{
@DataMember(Name="documentIdentification")
@SerializedName("documentIdentification")
open var documentIdentification:DocumentIdentification? = null
@DataMember(Name="sender")
@SerializedName("sender")
open var sender:Partner? = null
@DataMember(Name="receiver")
@SerializedName("receiver")
open var receiver:Partner? = null
}
@DataContract
open class DocumentIdentification
{
@DataMember(Name="identifier")
@SerializedName("identifier")
open var identifier:String? = null
@DataMember(Name="type")
@SerializedName("type")
open var Type:String? = null
@DataMember(Name="creationDateAndTime")
@SerializedName("creationDateAndTime")
open var creationDateAndTime:Date? = null
}
@DataContract
open class Partner
{
@DataMember(Name="identifier")
@SerializedName("identifier")
open var identifier:Identifier? = null
@DataMember(Name="contactInformation")
@SerializedName("contactInformation")
open var contactInformation:ArrayList<ContactInformation> = ArrayList<ContactInformation>()
}
@DataContract
open class Identifier
{
@DataMember(Name="authority")
@SerializedName("authority")
open var authority:String? = null
@DataMember(Name="text")
@SerializedName("text")
open var text:String? = null
}
@DataContract
open class ContactInformation
{
}
open class TransactionalPartyMessageType : TransactionalParty()
{
open var creationDateTime:Date? = null
open var lastUpdateDateTime:Date? = null
open var documentActionCode:DocumentAction? = null
open var documentStatusCode:DocumentStatus? = null
open var documentStructureVersion:String? = null
open var revisionNumber:Long? = null
open var avpList:ArrayList<AvpList> = ArrayList<AvpList>()
}
open class TransactionalParty : Ecom_PartyIdentificationType()
{
open var contact:ArrayList<Contact> = ArrayList<Contact>()
open var address:Address? = null
open var communicationChannel:ArrayList<AvpList> = ArrayList<AvpList>()
open var financialInstitutionInformation:FinancialInstitutionInformation? = null
open var dutyFeeTaxRegistration:String? = null
open var entityIdentification:String? = null
}
open class Ecom_PartyIdentificationType
{
open var gln:String? = null
open var name:String? = null
open var additionalPartyIdentification:ArrayList<AvpList> = ArrayList<AvpList>()
}
open class AvpList
{
open var code:String? = null
open var value:String? = null
}
open class Contact
{
open var contactTypeCode:String? = null
open var personName:String? = null
open var departmentName:String? = null
open var jobTitle:String? = null
open var responsibility:String? = null
open var communicationChannel:ArrayList<CommunicationChannel> = ArrayList<CommunicationChannel>()
}
open class CommunicationChannel
{
open var communicationChannelCode:String? = null
open var communicationChannelName:String? = null
open var communicationValue:String? = null
}
open class Address
{
open var streetAddressOne:String? = null
open var streetAddressTwo:String? = null
open var streetAddressThree:String? = null
open var city:String? = null
open var postalCode:String? = null
open var provinceCode:String? = null
open var countryCode:String? = null
}
open class FinancialInstitutionInformation
{
open var financialInstitutionBranchName:String? = null
open var financialInstitutionName:String? = null
open var financialRoutingNumber:FinancialRoutingNumber? = null
open var financialAccount:FinancialAccount? = null
open var swiftCode:String? = null
open var exportersCode:String? = null
}
open class FinancialRoutingNumber
{
open var number:String? = null
open var numberTypeCode:String? = null
}
open class FinancialAccount
{
open var number:String? = null
open var numberTypeCode:String? = null
open var name:String? = null
}
enum class DocumentAction
{
Add,
ChangeByRefresh,
Delete,
Rejected,
}
enum class DocumentStatus
{
AdditionalTransmission,
Copy,
Original,
}
open class TokenDto : ICommandResponse
{
open var token:UUID? = null
}
Kotlin AddTransactionalParty DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /api/transactionalParty HTTP/1.1
Host: stf-api-uat.data-xchange.co.za
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
transactionalParty:
{
header:
{
documentIdentification:
{
identifier: String,
type: String
},
sender:
{
identifier:
{
authority: String,
text: String
},
contactInformation:
[
{
}
]
},
receiver:
{
identifier:
{
authority: String,
text: String
},
contactInformation:
[
{
}
]
}
},
transactionalParty:
{
lastUpdateDateTime: 0001-01-01,
documentActionCode: ADD,
documentStatusCode: ADDITIONAL_TRANSMISSION,
documentStructureVersion: String,
revisionNumber: 0,
avpList:
[
{
code: String,
value: String
}
],
contact:
[
{
contactTypeCode: String,
personName: String,
departmentName: String,
jobTitle: String,
responsibility: String,
communicationChannel:
[
{
communicationChannelCode: String,
communicationChannelName: String,
communicationValue: String
}
]
}
],
address:
{
streetAddressOne: String,
streetAddressTwo: String,
streetAddressThree: String,
city: String,
postalCode: String,
provinceCode: String,
countryCode: String
},
communicationChannel:
[
{
code: String,
value: String
}
],
financialInstitutionInformation:
{
financialInstitutionBranchName: String,
financialInstitutionName: String,
financialRoutingNumber:
{
number: String,
numberTypeCode: String
},
financialAccount:
{
number: String,
numberTypeCode: String,
name: String
},
swiftCode: String,
exportersCode: String
},
dutyFeeTaxRegistration: String,
entityIdentification: String,
gln: String,
name: String,
additionalPartyIdentification:
[
{
code: String,
value: String
}
]
}
}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
}