USP_DATAFORMTEMPLATE_ADD_TAXDECLARATION_2

The save procedure used by the add dataform template "Tax Declaration Add Form 2".

Parameters

Parameter	Parameter Type	Mode	Description
@ID	uniqueidentifier	INOUT	The output parameter indicating the ID of the record added.
@CHANGEAGENTID	uniqueidentifier	IN	Input parameter indicating the ID of the change agent invoking the procedure.
@CONSTITUENTID	uniqueidentifier	IN	Input parameter indicating the context ID for the record being added.
@CHARITYCLAIMREFERENCENUMBERID	uniqueidentifier	IN	Reference number
@DECLARATIONMADE	datetime	IN	Made
@DECLARATIONSTARTS	datetime	IN	Start date
@DECLARATIONENDS	datetime	IN	End date
@DECLARATIONINDICATORCODE	tinyint	IN	Indicator
@DECLARATIONSOURCECODEID	uniqueidentifier	IN	Source
@SCANNEDDOCSEXIST	bit	IN	Scanned documents exist
@CONFIRMATIONSENT	datetime	IN	Sent
@CONFIRMATIONRETURNED	datetime	IN	Returned
@PAYSTAXCODE	tinyint	IN	Pays tax
@TAXSTATUSCODEID	uniqueidentifier	IN	Status
@COMMENTS	nvarchar(255)	IN	Comment
@CURRENTAPPUSERID	uniqueidentifier	IN	Input parameter indicating the ID of the current user.
@NAMEOPTIONCODE	tinyint	IN
@ALIASID	uniqueidentifier	IN
@ADDRESSOPTIONCODE	tinyint	IN
@ADDRESSID	uniqueidentifier	IN

Definition

Copy



                    CREATE procedure dbo.USP_DATAFORMTEMPLATE_ADD_TAXDECLARATION_2
                    (
                        @ID uniqueidentifier = null output,
                        @CHANGEAGENTID uniqueidentifier = null,    
                        @CONSTITUENTID uniqueidentifier,
                        @CHARITYCLAIMREFERENCENUMBERID uniqueidentifier,
                        @DECLARATIONMADE datetime = null,
                        @DECLARATIONSTARTS datetime = null,
                        @DECLARATIONENDS datetime = null,
                        @DECLARATIONINDICATORCODE tinyint = 0,
                        @DECLARATIONSOURCECODEID uniqueidentifier = null,
                        @SCANNEDDOCSEXIST bit = null,
                        @CONFIRMATIONSENT datetime = null,
                        @CONFIRMATIONRETURNED datetime = null,
                        @PAYSTAXCODE tinyint = 2,
                        @TAXSTATUSCODEID uniqueidentifier = null,
                        @COMMENTS nvarchar(255) = null,
                        @CURRENTAPPUSERID uniqueidentifier,
                        @NAMEOPTIONCODE tinyint = 0,
                        @ALIASID uniqueidentifier = null,
                        @ADDRESSOPTIONCODE tinyint = 0,
                        @ADDRESSID uniqueidentifier = null
                    )
                    as
                        set nocount on;

                        declare @CURRENTDATE datetime;
                        set @CURRENTDATE = getdate();

                        -- Validate the user has permission for the CCRN

                        if not exists (select PERMISSIONGRANTED from dbo.UFN_APPUSER_HASPERMISSIONFORDECLARATION(@CURRENTAPPUSERID, @CHARITYCLAIMREFERENCENUMBERID))
                        begin
                            raiserror('BBERR_PERMISSIONDENIEDFORCCRN', 13, 1)
                            return 1
                        end

                        begin try
                            if @ID is null
                                set @ID = newid();

                            if @CHANGEAGENTID is null  
                                exec dbo.USP_CHANGEAGENT_GETORCREATECHANGEAGENT @CHANGEAGENTID output;

                            if @NAMEOPTIONCODE = 0 begin
                                set @ALIASID = null
                            end

                            if @ADDRESSOPTIONCODE = 0 begin
                                set @ADDRESSID = null
                            end

                            insert into dbo.TAXDECLARATION
                            (
                                ID, 
                                CONSTITUENTID,
                                DECLARATIONMADE,
                                DECLARATIONSTARTS, 
                                DECLARATIONENDS,
                                DECLARATIONINDICATORCODE,
                                DECLARATIONSOURCECODEID,
                                CHARITYCLAIMREFERENCENUMBERID,
                                SCANNEDDOCSEXIST,
                                CONFIRMATIONSENT,
                                CONFIRMATIONRETURNED,
                                PAYSTAXCODE,
                                TAXSTATUSCODEID,
                                COMMENTS,
                                ADDRESSID,
                                ALIASID,
                                ADDEDBYID,
                                CHANGEDBYID,
                                DATEADDED, 
                                DATECHANGED
                            )
                            values
                            (
                                @ID, 
                                @CONSTITUENTID, 
                                dbo.UFN_DATE_GETEARLIESTTIME(@DECLARATIONMADE),
                                dbo.UFN_DATE_GETEARLIESTTIME(@DECLARATIONSTARTS), 
                                dbo.UFN_DATE_GETLATESTTIME(@DECLARATIONENDS),
                                @DECLARATIONINDICATORCODE,
                                @DECLARATIONSOURCECODEID,
                                @CHARITYCLAIMREFERENCENUMBERID,
                                @SCANNEDDOCSEXIST,
                                dbo.UFN_DATE_GETEARLIESTTIME(@CONFIRMATIONSENT),
                                dbo.UFN_DATE_GETEARLIESTTIME(@CONFIRMATIONRETURNED),
                                @PAYSTAXCODE,
                                @TAXSTATUSCODEID,
                                @COMMENTS,
                                @ADDRESSID,
                                @ALIASID,
                                @CHANGEAGENTID, 
                                @CHANGEAGENTID, 
                                @CURRENTDATE, 
                                @CURRENTDATE
                            );

                            -- Only update tribute gift aid amounts if this is a Yes declaration since this is the only

                            -- state that will affect gift aid eligibility

                            if @PAYSTAXCODE = 1
                                exec dbo.USP_REVENUETRIBUTETAXCLAIMAMOUNT_ADDUPDATEBYCONSTITUENT @CONSTITUENTID, @CHANGEAGENTID, @CURRENTDATE;                                 
                        end try
                        begin catch
                            exec dbo.USP_RAISE_ERROR;
                            return 1;
                        end catch

                        return 0;