SCS Contract Void API

Contract Void

This method allows a selling dealer to ‘void’ a previously submitted contract. Only the dealer who sold the contract can request the voiding of a contract. The contract can only be voided if the contract is not already in ‘active’ status in SCS or if no payment has been yet applied to it. If the contract cannot be voided for any reason other than the request coming in from a non-selling dealer, an error message is returned.

Request Schema

VoidContract Object


Tag	Format	Req/ Opt/ Cond	Attributes	Valid values	Description
TpaCode	X(4)	R			Third Party Administrator Code
UserId	X(30)	R			User ID issued to the requesting system
Password	X(255)	R			Password issued to the requesting system
RequestingUser	X(50)	R			The name of the F&I manager, office manager or other user of the system that is requesting the void.
ContractNumber	X(20)	R			Contract Number to be voided.
VIN	X(17)	R			Vehicle Identification Number.
DealerNumber	X(18)	R			Dealer Number

Response Schema

VoidContractResponse Object


Tag	Content Items	Format	Description
ContractVoid
	VoidContractResult
	ResponseCode		1 = Successful, the contract was voided; 0 = Contract was not voided. See Message Object for Type
	Messages	Message Object	Collection of Messages.

Message Object


Tag	Format	Req/ Opt/ Cond	Valid values	Description
Type	Integer	R	1 = Error, 2 = Info, 3 = Warning, 4 = Success	Message Type
Code	String	O		Reserved for future use
Text	String	R		Message Text

Error Messages


Message Type	Error code	Message Text
Error	VD0001	Invalid contract number.
Error	rfvTpaCode	TPA Code is required.
Error	VD0003	TPA is invalid.
Error	VD0004	Invalid Seller Number.
Error	rfvContractNumber	Contract Number is required.
Error	VD0001	Invalid contract number.
Error	VD0006	Only selling dealers can void contracts.
Error	VD0015	Requesting User is required.
Error	VOID_CONTRACT_BILLED	This contract cannot be voided because it has been billed.
Error	VD0007	VIN does not match VIN on the contract.
Error	VD0014	Contract # …. is locked by another user. Please unlock the contract before making changes.

07 Contract Void API

SCS Contract Void API#

Contract Void#

Request Schema#

VoidContract Object#

Response Schema#

VoidContractResponse Object#

Message Object#

Error Messages#