Temporary changes to subscription |
This document explains different types of temporary changes that may be relevant for a subscription. Common for them all is that they have a start and end date, in which something different is to be done in the subscription.
If a customer wants to change the product for a limited period, the method to use is SaveTemporaryProduct. and the method takes a customer number, title code, startdate, enddate and the product code as input.
<inf:SaveTemporaryProduct> <inf:customerNumber>123456</inf:customerNumber> <inf:titleCode>IT</inf:titleCode> <inf:startDate>2015-10-01<inf:startDate> <inf:endDate>2015-11-01<inf:endDate> <inf:productCode>P6TEMP</inf:productCode> </inf:SaveTemporaryProduct>
When a customer wants the product to be delivered to another address for a limited amount of time, the method SaveTemporaryMove is to be used. Because the newspaper might already have been delivered today, and it must be possible to order a address change in the future, the start date of the address change cannot be before the next distribution date.
The method takes the following parameters: A customer number, title code, an addressInfo object with the new address details, and a start date and end date for the period the temporary address change shall last.
<inf:SaveTemporaryMove> <inf:customerNumber>123456</inf:customerNumber> <inf:titleCode>IT</inf:titleCode> <inf:addressInfo> <inf:ErrorMessage></inf:ErrorMessage> <inf:Address_Id></inf:Address_Id> <inf:CustomerNumber>123456</inf:CustomerNumber> <inf:TitleCode>IT</inf:TitleCode> <inf:StatusCode>00</inf:StatusCode> <inf:CoAddress></inf:CoAddress> <inf:StreetName>Østensjøveien</inf:StreetName> <inf:HouseNumber>36</inf:HouseNumber> <inf:Entrance/> <inf:Floor/> <inf:Apartment/> <inf:AddressExtension1/> <inf:AddressExtension2></inf:AddressExtension2> <inf:AddressExtension3></inf:AddressExtension3> <inf:AddressExtension4></inf:AddressExtension4> <inf:ApartmentIdentity/> <inf:ZipCode>0667</inf:ZipCode> <inf:ZipText>OSLO</inf:ZipText> <inf:CountryCode>NO</inf:CountryCode> <inf:CountryText>Norway</inf:CountryText> <inf:UniqueAddress>false</inf:UniqueAddress> <inf:NewAddress>false</inf:NewAddress> <inf:HousenumberStart>0</inf:HousenumberStart> <inf:HousenumberEnd>0</inf:HousenumberEnd> <inf:EntranceStart></inf:EntranceStart> <inf:EntranceEnd></inf:EntranceEnd> <inf:DistributionNetwork></inf:DistributionNetwork> <inf:DistributionCode/> <inf:OddEven></inf:OddEven> <inf:GateVei_Id>0</inf:GateVei_Id> <inf:DistributionCompanyCode>0</inf:DistributionCompanyCode> <inf:RouteNumber>0</inf:RouteNumber> <inf:Addressed>0</inf:Addressed> <inf:DeliveryPoint>0</inf:DeliveryPoint> <inf:DeliveryMethod>0</inf:DeliveryMethod> <inf:HouseNumberStartEnd></inf:HouseNumberStartEnd> <inf:EntranceStartEnd></inf:EntranceStartEnd> <inf:WalkingOrder></inf:WalkingOrder> </inf:addressInfo> <inf:startDate>2015-01-01</inf:startDate> <inf:endDate>$2015-03-01</inf:endDate> <inf:signature/> </inf:SaveTemporaryMove>
If you are going away for a period of time and would like the distributor to store all newspaper deliveries while you are away, you have to use the method SaveKeep.
<inf:SaveKeep> <inf:customerNumber>123456</inf:customerNumber> <inf:titleCode>IT</inf:titleCode> <inf:startDate>2015-10-01</inf:startDate> <inf:endDate>2015-11-01</inf:endDate> </inf:SaveKeep>
If a subscriber is going away for a period of time and instead of stopping or storing the newspaper at the newscompany, they want an institution to receive the newspaper,, the method SaveGift can be used. What institution that receives the newspaper is defined in the system. Aach title has either one or none.
<inf:SaveGift> <inf:customerNumber>123456</inf:customerNumber> <inf:titleCode>IT</inf:titleCode> <inf:startDate>2015-10-01</inf:startDate> <inf:endDate>2015-11-01</inf:endDate> </inf:SaveGift>