| POST | /api/claim | Add new claim |
|---|
export class TokenDto implements ICommandResponse
{
public token: string;
public constructor(init?: Partial<TokenDto>) { (Object as any).assign(this, init); }
}
// @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 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 BillOfLading
{
public creationDate: string;
public revisionNumber: number;
public entityIdentification: string;
public tagNumbers: string[] = [];
public totalBags: number;
public constructor(init?: Partial<BillOfLading>) { (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 Quantity
{
public value?: number;
public measurementUnitCode: string;
public codeListVersion: string;
public constructor(init?: Partial<Quantity>) { (Object as any).assign(this, init); }
}
export class TransactionalItem
{
public measurementUnitCode: string;
public measurementType: string;
public measurementValue: string;
public constructor(init?: Partial<TransactionalItem>) { (Object as any).assign(this, init); }
}
export class SerialNumberRange
{
public maximumValue: string;
public minimumValue: string;
public constructor(init?: Partial<SerialNumberRange>) { (Object as any).assign(this, init); }
}
export class TransactionalItemDimension
{
public measurementUnitCode: string;
public depth: string;
public height: string;
public width: string;
public constructor(init?: Partial<TransactionalItemDimension>) { (Object as any).assign(this, init); }
}
export class TransactionalItemLogisticUnitInformation
{
public numberOfLayers?: number;
public numberOfUnitsPerLayer?: number;
public numberOfUnitsPerPallet?: number;
public packagingTerms: string;
public packageTypeCode: string;
public maximumStackingFactor?: number;
public returnablePackageTransportCostPayment: string;
public dimensionsOfLogisticUnit: TransactionalItemDimension[] = [];
public constructor(init?: Partial<TransactionalItemLogisticUnitInformation>) { (Object as any).assign(this, init); }
}
export class TransactionalItemDataCarrierAndIdentification
{
public gs1TransactionalItemIdentificationKey: string;
public dataCarrier: string;
public constructor(init?: Partial<TransactionalItemDataCarrierAndIdentification>) { (Object as any).assign(this, init); }
}
export class TradeItemWaste
{
public wasteIdentification: string;
public typeOfWaste: AvpList[] = [];
public constructor(init?: Partial<TradeItemWaste>) { (Object as any).assign(this, init); }
}
export class TransactionalItemOrganicInformation
{
public isTradeItemOrganic?: boolean;
public organicCertification: string;
public constructor(init?: Partial<TransactionalItemOrganicInformation>) { (Object as any).assign(this, init); }
}
export class TransactionalItemData
{
public availableForSaleDate?: string;
public batchNumber: string;
public bestBeforeDate?: string;
public countryOfOrigin: string;
public itemExpirationDate?: string;
public lotNumber: string;
public packagingDate?: string;
public productionDate?: string;
public productQualityIndication: string;
public sellByDate?: string;
public serialNumber: string[] = [];
public shelfLife: string;
public tradeItemQuantity?: number;
public itemInContactWithFoodProduct?: boolean;
public transactionalItemWeight: TransactionalItem[] = [];
public transactionalItemVolume: TransactionalItem[] = [];
public serialNumberRange: SerialNumberRange[] = [];
public transactionalItemDimensions: TransactionalItemDimension[] = [];
public transactionalItemLogisticUnitInformation: TransactionalItemLogisticUnitInformation;
public transactionalItemDataCarrierAndIdentification: TransactionalItemDataCarrierAndIdentification;
public tradeItemWaste: TradeItemWaste[] = [];
public transactionalItemOrganicInformation: TransactionalItemOrganicInformation;
public avpList: AvpList[] = [];
public constructor(init?: Partial<TransactionalItemData>) { (Object as any).assign(this, init); }
}
export class Colour
{
public colourCode: string;
public colourDescription: string;
public constructor(init?: Partial<Colour>) { (Object as any).assign(this, init); }
}
export class Size
{
public descriptiveSize: string;
public sizeCode: string;
public constructor(init?: Partial<Size>) { (Object as any).assign(this, init); }
}
export class TradeItemClassification
{
public gpcCategoryCode: string;
public additionalTradeItemClassificationCode: AvpList[] = [];
public gpcCategoryName: string;
public gpcAttribute: AvpList[] = [];
public constructor(init?: Partial<TradeItemClassification>) { (Object as any).assign(this, init); }
}
export class TransactionalTradeItem
{
public gtin: string;
public additionalTradeItemIdentification: AvpList[] = [];
public tradeItemQuantity?: number;
public tradeItemDescription: string;
public productVariantIdentifier: string;
public itemTypeCode: string;
public tradeItemDataOwner: string;
public butterFatReference: string;
public transactionalItemData: TransactionalItemData[] = [];
public colour: Colour[] = [];
public size: Size;
public tradeItemClassification: TradeItemClassification;
public avpList: AvpList[] = [];
public constructor(init?: Partial<TransactionalTradeItem>) { (Object as any).assign(this, init); }
}
export class ClaimsNotificationItemDiscrepancy
{
public price: number;
public quantity: Quantity;
public transactionalTradeItem: TransactionalTradeItem;
public constructor(init?: Partial<ClaimsNotificationItemDiscrepancy>) { (Object as any).assign(this, init); }
}
export class ClaimsNotificationDiscrepancyInformation
{
public claimAmount: number;
public claimReasonCode: string;
public discrepancyDescription: string;
public actualReceived: ClaimsNotificationItemDiscrepancy;
public expectedToReceive: ClaimsNotificationItemDiscrepancy;
public avpList: AvpList[] = [];
public constructor(init?: Partial<ClaimsNotificationDiscrepancyInformation>) { (Object as any).assign(this, init); }
}
export class ClaimTotals
{
public baseAmount?: number;
public totalTaxAmount?: number;
public totalClaimAmount?: number;
public constructor(init?: Partial<ClaimTotals>) { (Object as any).assign(this, init); }
}
export class ClaimExtension
{
public claimTotals: ClaimTotals;
public shipFrom: TransactionalParty;
public shipTo: TransactionalParty;
public constructor(init?: Partial<ClaimExtension>) { (Object as any).assign(this, init); }
}
export class ClaimNotification extends BaseDocument
{
public claimsNotificationTypeCode: string;
public isManualProcessNeededForClaimsResolution: boolean;
public isSupplementalMessageBeingSent: boolean;
public supplementalMessageDescription: string;
public claimsNotificationIdentification: string;
public buyer: TransactionalParty;
public remitTo: TransactionalParty;
public seller: TransactionalParty;
public billOfLading: BillOfLading;
public claimsNotification: DocumentReference;
public dispatchAdvice: DocumentReference;
public purchaseOrder: DocumentReference;
public invoice: DocumentReference;
public claimsNotificationDiscrepancyInformation: ClaimsNotificationDiscrepancyInformation[] = [];
public extension: ClaimExtension;
public constructor(init?: Partial<ClaimNotification>) { super(init); (Object as any).assign(this, init); }
}
export class ClaimMessage
{
public header: Header;
public claimNotification: ClaimNotification;
public constructor(init?: Partial<ClaimMessage>) { (Object as any).assign(this, init); }
}
/** @description Claim */
// @Api(Description="Claim")
// @ApiResponse(Description="Add claim request received", IsDefaultResponse=true, ResponseType="typeof(DX.Framework.Core.Commands.Dto.TokenDto)", StatusCode=202)
// @ApiResponse(Description="Claim not accepted, Confirm Sender GLN", ResponseType="typeof(ServiceStack.ErrorResponse)", StatusCode=403)
export class AddClaim
{
/** @description Claim model containing all of the claim data */
// @ApiMember(Description="Claim model containing all of the claim data", Name="claim", ParameterType="model")
public claim: ClaimMessage;
public constructor(init?: Partial<AddClaim>) { (Object as any).assign(this, init); }
}
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/claim HTTP/1.1
Host: stf-api-uat.data-xchange.co.za
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
claim:
{
header:
{
documentIdentification:
{
identifier: String,
type: String
},
sender:
{
identifier:
{
authority: String,
text: String
},
contactInformation:
[
{
}
]
},
receiver:
{
identifier:
{
authority: String,
text: String
},
contactInformation:
[
{
}
]
}
},
claimNotification:
{
claimsNotificationTypeCode: String,
isManualProcessNeededForClaimsResolution: False,
isSupplementalMessageBeingSent: False,
supplementalMessageDescription: String,
claimsNotificationIdentification: String,
buyer:
{
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
}
]
},
remitTo:
{
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
}
]
},
seller:
{
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
}
]
},
billOfLading:
{
creationDate: 0001-01-01T00:00:00.0000000+00:00,
revisionNumber: 0,
entityIdentification: String,
tagNumbers:
[
String
],
totalBags: 0
},
claimsNotification:
{
creationDateTime: 0001-01-01,
revisionNumber: 0,
lineItemNumber: 0,
entityIdentification: String
},
dispatchAdvice:
{
creationDateTime: 0001-01-01,
revisionNumber: 0,
lineItemNumber: 0,
entityIdentification: String
},
purchaseOrder:
{
creationDateTime: 0001-01-01,
revisionNumber: 0,
lineItemNumber: 0,
entityIdentification: String
},
invoice:
{
creationDateTime: 0001-01-01,
revisionNumber: 0,
lineItemNumber: 0,
entityIdentification: String
},
claimsNotificationDiscrepancyInformation:
[
{
claimAmount: 0,
claimReasonCode: String,
discrepancyDescription: String,
actualReceived:
{
price: 0,
quantity:
{
value: 0,
measurementUnitCode: String,
codeListVersion: String
},
transactionalTradeItem:
{
gtin: String,
additionalTradeItemIdentification:
[
{
code: String,
value: String
}
],
tradeItemQuantity: 0,
tradeItemDescription: String,
productVariantIdentifier: String,
itemTypeCode: String,
tradeItemDataOwner: String,
butterFatReference: String,
transactionalItemData:
[
{
availableForSaleDate: 0001-01-01,
batchNumber: String,
bestBeforeDate: 0001-01-01,
countryOfOrigin: String,
itemExpirationDate: 0001-01-01,
lotNumber: String,
packagingDate: 0001-01-01,
productionDate: 0001-01-01,
productQualityIndication: String,
sellByDate: 0001-01-01,
serialNumber:
[
String
],
shelfLife: String,
tradeItemQuantity: 0,
itemInContactWithFoodProduct: False,
transactionalItemWeight:
[
{
measurementUnitCode: String,
measurementType: String,
measurementValue: String
}
],
transactionalItemVolume:
[
{
measurementUnitCode: String,
measurementType: String,
measurementValue: String
}
],
serialNumberRange:
[
{
maximumValue: String,
minimumValue: String
}
],
transactionalItemDimensions:
[
{
measurementUnitCode: String,
depth: String,
height: String,
width: String
}
],
transactionalItemLogisticUnitInformation:
{
numberOfLayers: 0,
numberOfUnitsPerLayer: 0,
numberOfUnitsPerPallet: 0,
packagingTerms: String,
packageTypeCode: String,
maximumStackingFactor: 0,
returnablePackageTransportCostPayment: String,
dimensionsOfLogisticUnit:
[
{
measurementUnitCode: String,
depth: String,
height: String,
width: String
}
]
},
transactionalItemDataCarrierAndIdentification:
{
gs1TransactionalItemIdentificationKey: String,
dataCarrier: String
},
tradeItemWaste:
[
{
wasteIdentification: String,
typeOfWaste:
[
{
code: String,
value: String
}
]
}
],
transactionalItemOrganicInformation:
{
isTradeItemOrganic: False,
organicCertification: String
},
avpList:
[
{
code: String,
value: String
}
]
}
],
colour:
[
{
colourCode: String,
colourDescription: String
}
],
size:
{
descriptiveSize: String,
sizeCode: String
},
tradeItemClassification:
{
gpcCategoryCode: String,
additionalTradeItemClassificationCode:
[
{
code: String,
value: String
}
],
gpcCategoryName: String,
gpcAttribute:
[
{
code: String,
value: String
}
]
},
avpList:
[
{
code: String,
value: String
}
]
}
},
expectedToReceive:
{
price: 0,
quantity:
{
value: 0,
measurementUnitCode: String,
codeListVersion: String
},
transactionalTradeItem:
{
gtin: String,
additionalTradeItemIdentification:
[
{
code: String,
value: String
}
],
tradeItemQuantity: 0,
tradeItemDescription: String,
productVariantIdentifier: String,
itemTypeCode: String,
tradeItemDataOwner: String,
butterFatReference: String,
transactionalItemData:
[
{
availableForSaleDate: 0001-01-01,
batchNumber: String,
bestBeforeDate: 0001-01-01,
countryOfOrigin: String,
itemExpirationDate: 0001-01-01,
lotNumber: String,
packagingDate: 0001-01-01,
productionDate: 0001-01-01,
productQualityIndication: String,
sellByDate: 0001-01-01,
serialNumber:
[
String
],
shelfLife: String,
tradeItemQuantity: 0,
itemInContactWithFoodProduct: False,
transactionalItemWeight:
[
{
measurementUnitCode: String,
measurementType: String,
measurementValue: String
}
],
transactionalItemVolume:
[
{
measurementUnitCode: String,
measurementType: String,
measurementValue: String
}
],
serialNumberRange:
[
{
maximumValue: String,
minimumValue: String
}
],
transactionalItemDimensions:
[
{
measurementUnitCode: String,
depth: String,
height: String,
width: String
}
],
transactionalItemLogisticUnitInformation:
{
numberOfLayers: 0,
numberOfUnitsPerLayer: 0,
numberOfUnitsPerPallet: 0,
packagingTerms: String,
packageTypeCode: String,
maximumStackingFactor: 0,
returnablePackageTransportCostPayment: String,
dimensionsOfLogisticUnit:
[
{
measurementUnitCode: String,
depth: String,
height: String,
width: String
}
]
},
transactionalItemDataCarrierAndIdentification:
{
gs1TransactionalItemIdentificationKey: String,
dataCarrier: String
},
tradeItemWaste:
[
{
wasteIdentification: String,
typeOfWaste:
[
{
code: String,
value: String
}
]
}
],
transactionalItemOrganicInformation:
{
isTradeItemOrganic: False,
organicCertification: String
},
avpList:
[
{
code: String,
value: String
}
]
}
],
colour:
[
{
colourCode: String,
colourDescription: String
}
],
size:
{
descriptiveSize: String,
sizeCode: String
},
tradeItemClassification:
{
gpcCategoryCode: String,
additionalTradeItemClassificationCode:
[
{
code: String,
value: String
}
],
gpcCategoryName: String,
gpcAttribute:
[
{
code: String,
value: String
}
]
},
avpList:
[
{
code: String,
value: String
}
]
}
},
avpList:
[
{
code: String,
value: String
}
]
}
],
extension:
{
claimTotals:
{
baseAmount: 0,
totalTaxAmount: 0,
totalClaimAmount: 0
},
shipFrom:
{
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
}
]
},
shipTo:
{
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
}
]
}
},
currencyCode: String,
documentActionCode: ADD,
documentStatusCode: ADDITIONAL_TRANSMISSION,
documentStructureVersion: String,
lastUpdateDateTime: 0001-01-01,
revisionNumber: 0,
avpList:
[
{
code: String,
value: String
}
]
}
}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
}